TApplication

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/forms.hpp

TApplication ist der Typ, der einer Borland C++Builder-Anwendung zugrundeliegt.

Beschreibung

Die Klasse TApplication kapselt eine Windows-Anwendung. Die Methoden und Eigenschaften von TApplication entsprechen den grundlegenden Elementen des Betriebssystems Windows, mit denen eine Anwendung erstellt, ausgeführt, verwaltet und freigegeben werden kann. TApplication bietet somit eine einfach zu handhabende Schnittstelle für die Programmierung unter Windows. TApplication kapselt folgendes Verhalten:

•	Verarbeitung von Windows-Botschaften

•	Kontextsensitive Online-Hilfe

•	Verarbeitung von Tastenkürzeln und Tastatureingaben

•	Exception-Behandlung

•	Verwaltung der grundlegenden Elemente, die vom Betriebssystem Windows für eine Anwendung benötigt werden, wie z.B. MainWindow, WindowClass usw.

Am Beginn jeder Borland C++Builder-Anwendung wird automatisch eine Variable namens Application vom Typ TApplication deklariert. Deshalb erscheint TApplication nicht in der Komponentenpalette. Der Typ kann auch nicht im Formular-Designer visuell verändert werden und besitzt deshalb keine als published deklarierten Eigenschaften. Trotzdem können zur Entwurfszeit einige seiner public-Eigenschaften auf der Seite Formulare und Anwendung des Dialogfeldes Projektoptionen eingestellt oder geändert werden.


Eigenschaften von TApplication

TApplication	Alphabetisch	Legende

In TApplication

Active

DialogHandle

ExeName

Handle

HelpFile

Hint

HintColor

HintHidePause

HintPause

HintShortPause

Icon

MainForm

ShowHint

ShowMainForm

Terminated

Title

UpdateFormatSettings

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Name

Owner

Tag


Eigenschaften von TApplication

TApplication	Nach Objekten	Legende

Active

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

DesignInfo

DialogHandle

ExeName

Handle

HelpFile

HintColor

HintHidePause

HintPause

HintShortPause

Hint

Icon

MainForm

Name

Owner

ShowHint

ShowMainForm

Tag

Terminated

Title

UpdateFormatSettings


TApplication::Active

TApplication	Siehe auch

Die Eigenschaft Active gibt an, ob die Anwendung aktiv ist und den Eingabefokus besitzt.

__property bool Active;

Beschreibung

Die Eigenschaft Active kann nur gelesen werden. Sie hat den Wert True, wenn die Anwendung aktiv ist. Andernfalls hat sie den Wert False. Active wird im Konstruktor auf True eingestellt.

Eine Anwendung ist aktiv, wenn das Formular oder die Anwendung den Eingabefokus besitzt. Eine Anwendung wird inaktiv, sobald ein Fenster einer anderen Anwendung aktiviert wird. Wird die Anwendung geschlossen, erhält Active im Destruktor den Wert False.


TApplication::DialogHandle

TApplication	Siehe auch

Die Eigenschaft DialogHandle bietet einen Mechanismus, mit dem fremde Dialogfelder in einer Borland C++Builder-Anwendung verwendet werden können.

__property HWND DialogHandle;

Beschreibung

Verwenden Sie DialogHandle bei der Erstellung eines nicht modalen Dialogfeldes mit der API-Funktion CreateDialog, wenn Botschaften aus der Warteschlange der Anwendung benötigt werden.

Dazu weisen Sie der Eigenschaft DialogHandle das Handle des nicht modalen Dialogfeldes zu, wenn eine Aktivierungsbotschaft empfangen wird (WM_NCACTIVATE). Erhält das Dialogfeld eine Deaktivierungsbotschaft, setzen Sie DialogHandle auf Null.

Beispiel

Im folgenden finden Sie einen Ausschnitt aus einer Fensterprozedur, in der das Windows-Dialogfeld Suchen und Ersetzen in Borland C++Builder gekapselt wird:

long SearchAndReplaceWndProc(HWnd Wnd, Word WParam, Word Msg, Longint LParam )

{

   try

   {

      switch (Msg)

      {

 case WM_DESTROY:

    Application->DialogHandle = 0;  // Handle freigeben

 case WM_NCACTIVATE:

 {

    if (WParam != NULL) 	// bei Aktivierung...

       Application->DialogHandle = Wnd;	// ...Handle zuweisen...

    else

       Application->DialogHandle = 0;	// ...andernfalls löschen

      	 ...

 }

      }

   }

   catch(...)

   {

      Application->HandleException();

   }

   return CallDefDialogProc;

}


TApplication::ExeName

TApplication	Siehe auch

Die Eigenschaft ExeName enthält den Dateinamen und den Pfad der ausführbaren Anwendung.

__property System::AnsiString ExeName;

Beschreibung

Die Eigenschaft ExeName kann nur gelesen werden. Mit ExeName können Sie den Namen der ausführbaren Datei einer Anwendung ermitteln.

Der Name der Anwendung ist der Name der Projektdatei mit der Erweiterung .EXE. Standardmäßig lautet dieser Name PROJECT1.EXE. Um den Wert von ExeName zu ändern, speichern Sie das Projekt unter einem neuen Namen und compilieren die Anwendung erneut. Der neue Name der Projektdatei wird in ExeName entsprechend geändert.


TApplication::Handle

TApplication	Siehe auch	Beispiel

Mit der Eigenschaft Handle können Sie auf das Fenster-Handle des Hauptformulars (Fensters) der Anwendung zugreifen.

__property HWND Handle;

Beschreibung

Setzen Sie Handle in Verbindung mit einer Windows-API-Funktion ein, die das Handle eines übergeordneten Fensters benötigt. Ein übergeordnetes Fenster wird beispielsweise von einer DLL benötigt, die in der höchsten Ebene eigene Popup-Fenster besitzt. Mit der Eigenschaft Application::Handle können Sie solche Fenster als Teil der Anwendung einfügen, so daß sie zusammen mit der Anwendung auf Symbolgröße verkleinert, wiederhergestellt, aktiviert und deaktiviert werden können.

Hinweis

Weisen Sie beim Schreiben einer DLL, die VCL-Formulare verwendet, ihrer Eigenschaft Application::Handle das Handle des Hauptfensters der zentralen EXE-Datei zu. Damit wird das DLL-Formular Teil der Host-Anwendung. Weisen Sie Application::Handle in einer EXE-Datei niemals einen Wert zu.


TApplication::HelpFile

TApplication	Siehe auch

Mit der Eigenschaft HelpFile können Sie den Namen der Datei bestimmen, welche die Hilfe zur Anwendung enthält.

__property System::AnsiString HelpFile;

Beschreibung

Verwenden Sie HelpFile in Verbindung mit einer anwendungsspezifischen Hilfedatei, die in das Hilfesystem von Windows eingebunden werden soll. Unter Windows wird die Datei angezeigt, die in der Eigenschaft HelpFile bezeichnet ist. Weisen Sie der Eigenschaft HelpFile entweder zur Laufzeit einen Dateinamen zu, oder geben Sie zur Entwurfszeit in der Seite Anwendung des Dialogfeldes Projektoptionen eine Hilfedatei an.

Standardmäßig enthält HelpFile einen Leerstring, so daß die Methode Help alle Anforderungen von Hilfeinformationen ignoriert. Besitzt HelpFile dagegen einen Wert, können Sie diesen mit der Methode HelpContext dem Hilfesystem von Windows als Namen der Datei übergeben, die verwendet werden soll.


TApplication::Hint

TApplication	Siehe auch	Beispiel

Mit der Eigenschaft Hint können Sie den String festlegen, der im Feld für den Hilfehinweis angezeigt wird.

__property System::AnsiString Hint;

Beschreibung

Der Eigenschaft Hint von TApplication wird der Wert von Hint des Steuerelements oder Menüeintrags zugewiesen, auf dem sich der Mauszeiger gerade befindet. Der Eigenschaft kann auch ein String zugewiesen werden, der den Benutzer über Vorgänge, Fehler oder sonstiges informiert. Mit Hint können Sie daher eine der folgenden Aktionen durchführen:

•	Mit einer Ereignisbehandlungsroutine für OnHint können Sie Hinweise von den Steuerelementen in einen anderen Bereich des Bildschirms, wie z.B. Statusleiste, verlagern. Die Eigenschaft Hint wird dabei gelesen.

•	Sie können den Status der Anwendung bei der Ausführung einer bestimmten Aktion anzeigen. Die Eigenschaft Hint wird dazu gesetzt.

Die Hilfehinweise werden angezeigt, sobald das Ereignis OnHint eintritt. Wird die Eigenschaft Hint von TApplication beispielsweise der Beschriftung einer Statusleiste zugewiesen, wird in diesem Steuerelement der aktuelle Wert der Eigenschaft Hint während des Ereignisses OnHint angezeigt.

Der String in Hint besteht aus einem kurzen und einem langen Teil. Der kurze Hinweis erscheint in Tool-Tips. Lange Hinweise werden in der Statusleiste verwendet. Beide werden durch das Zeichen | getrennt.

Hinweis

Wenn Sie Hint so verwenden wollen, daß der Benutzer eine bestimmte Meldung erhält, wenn in der Anwendung ein bestimmtes Ereignis auftritt, müssen Sie bedenken, daß der Hinweis-String eines Steuerelements angezeigt wird, sobald der Benutzer den Mauszeiger darüber bewegt. Die von Ihnen beabsichtigte Meldung ist dann nicht zu sehen.


TApplication::HintColor

TApplication	Siehe auch

Mit der Eigenschaft HintColor können Sie die Farbe der Hinweisfelder bestimmen.

__property Graphics::TColor HintColor;

Beschreibung

Mit HintColor können Sie die Farbe der Hinweisfelder festlegen. Sobald die Anwendung erstellt wird, wird im Konstruktor eine Standardfarbe für die Eigenschaft HintColor eingestellt. Um den Wert von HintColor zu ändern, weisen Sie der Eigenschaft zur Laufzeit einen neuen Wert des Typs TColor zu.


TApplication::HintHidePause

TApplication	Siehe auch

Mit der Eigenschaft HintHidePause können Sie das abzuwartende Zeitintervall vor dem Ausblenden des Hilfehinweises angeben, wenn sich der Mauscursor weiterhin auf einem Steuerelement oder einer Menüoption befindet.

__property int HintHidePause;

Beschreibung

Mit HintHidePause können Sie eine Wartezeit in Millisekunden angeben. Diese unterscheidet sich vom Standardwert, der im Konstruktor eingestellt wurde. Der Hinweistext für das Steuerelement oder die Menüoption kann mit der Eigenschaft Hint festgelegt werden.

Hinweis

Der Standardwert ist die vordefinierte Konstante HintPause, die um ein Vielfaches länger ist.


TApplication::HintPause

TApplication	Siehe auch

Mit der Eigenschaft HintPause können Sie das Zeitintervall bis zur Anzeige des Hilfehinweises des Steuerelements angeben, sobald sich der Mauszeiger auf einem Steuerelement oder einer Menüoption befindet.

__property int HintPause;

Beschreibung

Mit HintPause können Sie die standardmäßige Wartezeit ändern, die im Konstruktor eingestellt wurde. Geben Sie das Intervall für HintPause in Millisekunden an. Nach diesem Intervall wird der Hilfehinweis angezeigt, der in der Eigenschaft Hint angegeben ist.


TApplication::HintShortPause

TApplication	Siehe auch

Mit der Eigenschaft HintShortPause können Sie die Wartezeit bis zum Einblenden eines Hinweises angeben, falls bereits ein Hinweis angezeigt wurde.

__property int HintShortPause;

Beschreibung

Mit HintShortPause können Sie einen Flimmer-Effekt vermeiden, der entsteht, wenn Sie den Mauszeiger schnell über mehrere Schaltflächen bewegen, die alle mit Hilfehinweisen ausgestattet sind. Geben Sie einen Wert in Millisekunden an, der sich vom Standardwert unterscheidet, der im Konstruktor eingestellt wurde.


TApplication::Icon

TApplication	Siehe auch

Mit der Eigenschaft Icon können Sie bestimmen, durch welches Symbol die minimierte Anwendung repräsentiert wird.

__property Graphics::TIcon* Icon;

Beschreibung

Mit Icon können Sie ein bestimmtes Symbol zuweisen, von dem die Anwendung repräsentiert wird. Die Einstellung der Eigenschaft Icon kann auf zweierlei Arten erfolgen:

•	Sie können der Eigenschaft zur Laufzeit ein TIcon-Objekt zuweisen.

•	Sie können zur Entwurfszeit in der Seite Anwendung des Dialogfeldes Projektoptionen ein Symbol laden.

Das Symbol repräsentiert die Anwendung, wenn diese auf Symbolgröße verkleinert (minimiert) wird. Unter Windows 95 finden Sie das Symbol entweder auf dem Windows-Desktop oder in der Task-Leiste.


TApplication::MainForm

TApplication	Siehe auch

Die Eigenschaft MainForm gibt an, welches Formular das Hauptfenster der Anwendung ist. Dieses wird immer zuerst erstellt.

__property TForm* MainForm;

Beschreibung

Mit MainForm können Sie, abweichend vom Standard, ein Formular als Hauptfenster der Anwendung festlegen. Wird ein neues Projekt erstellt, erhält die Eigenschaft MainForm automatisch den Wert Form1. Mit der Seite Formulare des Dialogfeldes Projektoptionen können Sie der Eigenschaft MainForm zur Entwurfszeit ein anderes Formular zuweisen. MainForm kann zur Laufzeit nicht geändert, sondern nur gelesen werden.

Das Hauptformular ist das erste, das im Rumpf der Anwendung erzeugt wird. Sobald das Hauptformular geschlossen wird, wird die Anwendung beendet.


TApplication::ShowHint

TApplication	Siehe auch

Mit der Eigenschaft ShowHint können Sie die Hilfehinweise für die gesamte Anwendung aktivieren oder deaktivieren.

__property bool ShowHint;

Beschreibung

Mit ShowHints können Sie auswählen, in welchen Fällen Hilfehinweise angezeigt werden. Hat ShowHint den Wert Standardwert True, sind die Hilfehinweise aktiviert. Andernfalls sind sie deaktiviert. Die Hilfehinweise sind in der Eigenschaft Hint definiert.

Wenn Sie die Eigenschaft ShowHint der Anwendung auf False einstellen, werden unabhängig von der Eigenschaft ShowHint der einzelnen Steuerelemente alle Hilfehinweise deaktiviert.


TApplication::ShowMainForm

TApplication	Siehe auch

Mit der Eigenschaft ShowMainWindow können Sie bestimmen, ob beim Start der Anwendung das Hauptformular angezeigt wird.

__property bool ShowMainForm;

Beschreibung

Mit ShowMainForm können Sie steuern, ob und wann das Hauptformular einer Anwendung angezeigt wird.

Im Konstruktor ist der Standardwert True eingestellt. Standardmäßig wird das Hauptfenster angezeigt. In der Eigenschaft MainForm ist angegeben, welches Formular das Hauptformular ist.

Um das Hauptformular beim Start der Anwendung auszublenden, stellen Sie ShowMainForm vor dem Aufruf von Application::Run in der Haupt-Projektdatei auf False ein. Dies kann bei der Implementierung von Servern zur OLE-Automatisierung genutzt werden, um das Hauptformular des Servers auszublenden, der zu Automatisierungszwecken gestartet wurde.


TApplication::Terminated

TApplication	Siehe auch

Mit der Eigenschaft Terminated können Sie feststellen, ob die Anwendung die Windows-Botschaft WM_QUIT erhalten hat, mit der die Anwendung anschließend beendet wird.

__property bool Terminated;

Beschreibung

Die Eigenschaft Terminated kann nur gelesen werden. Sie wird beim Aufruf der Methode ProcessMessages verwendet, so daß nach der Beendigung der Anwendung keine weiteren Windows-Botschaften mehr verarbeitet werden. Von ProcessMessage wird Terminated beim Erhalt der Botschaft WM_QUIT auf True eingestellt.

Eine Borland C++Builder-Anwendung erhält die Botschaft WM_QUIT normalerweise, wenn das Hauptfenster der Anwendung geschlossen oder die Methode Terminate aufgerufen wurde. Dabei wird Windows aufgefordert, die Anwendung zu beenden.

Rufen Sie bei Anwendungen mit rechenintensiven Schleifen Application::-ProcessMessages häufiger auf. Überprüfen Sie auch Application::Terminated, und bestimmen Sie, ob die Berechnung abgebrochen werden muß, damit die Anwendung beendet werden kann.


TApplication::Title

TApplication	Siehe auch

Die Eigenschaft Title enthält den Text, der beim Verkleinern der Anwendung auf Symbolgröße unter dem Symbol angezeigt wird.

__property System::AnsiString Title;

Beschreibung

Mit der Eigenschaft Title können Sie den Text ändern, der unter dem Symbol der Anwendung angezeigt wird. Der Standardwert ist zur Laufzeit der Dateiname der DLL- bzw. EXE-Datei.

Stellen Sie den Titel zur Laufzeit ein, oder geben Sie den Wert der Eigenschaft Title in der Seite Anwendung des Dialogfeldes Projektoptionen ein.


TApplication::UpdateFormatSettings

TApplication

Mit der Eigenschaft UpdateFormatSettings können Sie festlegen, ob die Formateinstellungen beim Ändern der Systemkonfiguration automatisch aktualisiert werden.

__property bool UpdateFormatSettings;

Beschreibung

Mit UpdateFormatSettings können Sie die automatische Aktualisierung der Formateinstellungen steuern.

Im Konstruktor ist der Standardwert True eingestellt. UpdateFormatSettings wird geprüft, wenn die Anwendung die Botschaft WM_WININICHANGE erhält.

Es werden die Standardformatierungen empfohlen, die in den Ländereinstellungen von Windows festgelegt sind. Um jedoch die Einstellungen während der Programmausführung vor Änderungen zu schützen, kann UpdateFormatSettings auf False eingestellt werden.


Ereignisse von TApplication

TApplication	Alphabetisch

In TApplication

OnActivate

OnDeactivate

OnException

OnHelp

OnHint

OnIdle

OnMessage

OnMinimize

OnRestore

OnShowHint


Ereignisse von TApplication

TApplication	Nach Objekten

OnActivate

OnDeactivate

OnException

OnHelp

OnHint

OnIdle

OnMessage

OnMinimize

OnRestore

OnShowHint


TApplication::OnActivate

TApplication	Siehe auch

Das Ereignis OnActivate wird ausgelöst, wenn eine Anwendung aktiv wird.

__property Classes::TNotifyEvent OnActivate;

Beschreibung

Auf Basis von OnActivate können Sie eine Ereignisbehandlungsroutine programmieren, mit der Sie bei der Aktivierung der Anwendung bestimmte Aktionen durchführen können.

Eine Anwendung wird aktiv, wenn sie ausgeführt wird oder der Fokus von einer anderen Windows-Anwendung zu einem beliebigen Fenster der Anwendung wechselt.


TApplication::OnDeactivate

TApplication	Siehe auch

Das Ereignis OnDeactivate wird ausgelöst, wenn eine Anwendung inaktiv wird.

__property Classes::TNotifyEvent OnDeactivate;

Beschreibung

Auf Basis von OnDeactivate können Sie eine bestimmte Prozedur programmieren, die unmittelbar vor dem Deaktivieren der Anwendung durchgeführt werden soll. Das Ereignis OnDeactivate wird ausgelöst, wenn der Benutzer von der Anwendung zu einer anderen Windows-Anwendung wechselt.


TApplication::OnException

TApplication	Siehe auch

Das Ereignis OnException wird ausgelöst, wenn in der Anwendung eine Exception auftritt, der keine Behandlungsroutine zugeordnet ist.

__property TExceptionEvent OnException;

Beschreibung

Mit OnException können Sie das Standardverhalten ändern, das bei einer Exception ohne Behandlungsroutine verwendet wird. Die Ereignisbehandlungsroutine für OnException wird in der Methode HandleException automatisch aufgerufen.

Mit OnException werden nur Exceptions behandelt, die während der Bearbeitung von Botschaften auftreten. Exceptions, die vor oder nach Application::
Run auftreten, werden von Application::HandleException und OnException nicht erfaßt.

Durchläuft eine Exception die try-Blöcke des Programms, wird automatisch die Methode HandleException aufgerufen und ein Dialogfeld mit einer Fehlermeldung angezeigt. Außer bei der Exception EAbort ruft die Methode HandleException die Behandlungsroutine für OnException auf, falls vorhanden. Andernfalls wird ShowException aufgerufen und ein Dialogfeld mit einer Fehlermeldung angezeigt.

Der Typ TExceptionEvent ist der Typ des Ereignisses OnException. Er zeigt auf die Methode, mit der die Exceptions einer Anwendung behandelt werden. Der Parameter Sender ist das Objekt, von dem die Exception hervorgerufen wurde. E ist die Meldung für die Exception.


TApplication::OnHelp

TApplication	Siehe auch

OnHelp wird ausgelöst, wenn in der Anwendung Hilfe angefordert wird.

__property Classes::THelpEvent OnHelp;

Beschreibung

Auf Basis von OnHelp können Sie eine Ereignisbehandlungsroutine programmieren, mit der Sie bei der Anforderung von Hilfe bestimmte Aktionen auslösen können. Die Methoden HelpContext und HelpJump lösen das Ereignis OnHelp automatisch aus.

Setzen Sie CallHelp auf True, damit WinHelp nach dem Ereignis aufgerufen wird. Stellen Sie CallHelp auf False ein, um den Aufruf von WinHelp zu verhindern.

Alle Hilfe-Methoden der Anwendung werden über OnHelp verarbeitet. WinHelp wird nur aufgerufen, wenn der Parameter CallHelp von OnHelp den Wert True zurückgibt oder OnHelp nicht zugewiesen wird.

Die möglichen Werte für die Parameter Command und Data finden Sie unter WinHelp in der Datei Win32.HLP. In dieser Datei wird die WinHelp-API beschrieben. Die möglichen Werte des Parameters Data hängen vom Wert des Parameters Command ab.

Wird die Funktion erfolgreich ausgeführt, ist der Rückgabewert True. Andernfalls wird False zurückgegeben.


TApplication::OnHint

TApplication	Siehe auch

Das Ereignis OnHint wird ausgelöst, wenn der Mauszeiger über ein Steuerelement oder einen Menüeintrag bewegt wird, zu dem bzw. der ein Hilfehinweis angezeigt werden kann.

__property Classes::TNotifyEvent OnHint;

Beschreibung

Verwenden Sie OnHint in einer Ereignisbehandlungsroutine, die beim Ereignis OnHint bestimmte Aktionen einleitet. OnHint wird ausgelöst, wenn sich der Mauszeiger über einem Steuerelement befindet, dessen Eigenschaft Hint nicht den Leerstring ("") enthält.

Häufig wird nach dem Ereignis OnHint der Wert der Eigenschaft Hint eines Steuerelements oder eines Menüeintrags als Beschriftung einer Tafel (TStatusBar) angezeigt. Dabei wird die Tafel in die Statusleiste integriert. In der Eigenschaft Hint ist ein aus zwei Teilen bestehender Hilfehinweis definiert. Der längere Teil wird beim Auslösen des Ereignisses OnHint normalerweise an einer anderen Stelle angezeigt.

Beispiel

In diesem Beispiel wird eine Statusleiste, ein Menü und ein Eingabefeld in einem Formular verwendet. Legen Sie für jeden Menüeintrag und für das Eingabefeld einen Wert für Hint fest.

Um eine Ereignisbehandlungsroutine für OnHint zu programmieren, erzeugen Sie eine Methode für das Objekt TForm1 und benennen Sie entsprechend, z.B. DisplayHint. Schreiben Sie die Methode in den Implementierungsteil der Unit, und deklarieren Sie die Methode in der Typdeklaration von TForm1 im public-Abschnitt.

Weisen Sie in der Methode DisplayHint der Eigenschaft Caption der Tafel die Eigenschaft Hint der Anwendung zu.

Richten Sie diese neue Methode als Methode ein, die vom Ereignis OnHint verwendet wird. In diesem Beispiel geschieht dies in der Ereignisbehandlungsroutine für OnCreate.

Im folgenden Programm finden Sie die komplette Typdeklaration, die neue Methode und die Ereignisbehandlungsroutine für OnCreate. Sobald die Anwendung ausgeführt und der Cursor über das Eingabefeld oder einen Menüeintrag bewegt wird, erscheint der Hinweis als Beschriftung der Tafel am unteren Rand des Formulars.

class TForm1 : public TForm

{

TButton* Button1;

TStatusBar* Statusbar1;

TEdit* Edit1;

private:

// private declarations

public:

__fastcall TForm1(TComponent* Owner);

void __fastcall DisplayHint(TObject* Sender);

}

__fastcall TForm1::TForm1(TObject* Sender): TForm(Owner)

{

  Button1 = new TButton(this);

  Statusbar1 = new TStatusBar(this);

  Edit1 = new TEdit(this);

  Application->OnHint = DisplayHint();

}

void __fastcall TForm1::DisplayHint(TObject* Sender)

{

  Statusbar1.Caption = Application::Hint();

}


TApplication::OnIdle

TApplication

OnIdle wird ausgelöst, wenn eine Anwendung inaktiv wird.

__property TIdleEvent OnIdle;

Beschreibung

Auf Basis von OnIdle können Sie eine Ereignisbehandlungsroutine programmieren, mit der Sie bestimmte Aktionen auslösen können, wenn sich die Anwendung im Leerlauf befindet. Eine Anwendung befindet sich beispielsweise im Leerlauf, wenn eine Benutzereingabe erwartet wird.

OnIdle wird nur einmal aufgerufen, wenn die Anwendung in den Leerlauf übergeht. Das Ereignis wird nur dann fortlaufend ausgelöst, wenn Done auf False gesetzt wird. Hat Done den Wert False, wird WaitMessage nicht aufgerufen. Das bedeutet, daß diese Anwendung übermäßig viel CPU-Zeit beansprucht, was die Leistung des gesamten Systems beeinträchtigt.

Der Typ TIdleEvent ist der Typ des Ereignisses OnIdle. Er zeigt auf eine Methode, die im Leerlauf der Anwendung ausgeführt wird. Der boolesche Parameter Done von TIdleEvent hat den Standardwert True. In diesem Fall wird nach Beendigung von OnIdle die Funktion WaitMessage der Windows-API aufgerufen. WaitMessage übergibt die Steuerung an andere Anwendungen, bis in der Botschaftswarteschlange der Anwendung eine neue Botschaft plaziert wird.


TApplication::OnMessage

TApplication	Siehe auch

Mit OnMessage können Sie Windows-Botschaften verarbeiten, die von einer Anwendung empfangen werden.

__property TMessageEvent OnMessage;

Beschreibung

Mit OnMessage können Sie beliebige oder alle Windows-Botschaften abfangen, die an alle Fenster der Anwendung gesendet werden. Das Ereignis OnMessage wird ausgelöst, wenn eine Anwendung eine Windows-Botschaft erhält. Indem Sie eine Ereignisbehandlungsroutine für OnMessage erstellen, wird es weiteren Routinen möglich, auf andere Botschaften als diejenigen zu antworten, die in den Ereignissen für TApplication deklariert sind. Besitzt die Anwendung keine speziellen Behandlungsroutinen für eingehende Botschaften, wird die Botschaft an das vorgesehene Fenster weitergeleitet und von Windows verarbeitet.

Der Typ TMessageEvent ist der Typ des Ereignisses OnMessage. Er zeigt auf eine Methode, mit der eingehende Windows-Botschaften verarbeitet werden. Der Parameter Msg bezeichnet die Windows-Botschaft, und der Parameter Handled bestimmt, ob die Botschaft verarbeitet wird oder nicht. Stellen Sie Handled auf True ein, wenn die Botschaft komplett verarbeitet wurde. Damit können Sie die übliche Verarbeitung der Botschaft unterdrücken.

Hinweis

Mit OnMessage können Sie nur Botschaften empfangen, die in die Botschaftswarteschlange gestellt wurden. Die Botschaften, die direkt mit der API-Funktion SendMessage gesendet werden, können nicht empfangen werden.

Achtung

Über dieses Ereignis fließen einige tausend Botschaften pro Sekunde. Gehen Sie bei der Programmierung der Behandlungsroutine sorgfältig vor, da die Leistungsfähigkeit der gesamten Anwendung beeinflußt werden kann.


TApplication::OnMinimize

TApplication	Siehe auch

Das Ereignis OnMinimize wird ausgelöst, wenn eine Anwendung auf Symbolgröße verkleinert (minimiert) wird.

__property Classes::TNotifyEvent OnMinimize;

Beschreibung

Mit OnMinimize können Sie eine Ereignisbehandlungsroutine programmieren, mit der Sie bei der Verkleinerung der Anwendung auf Symbolgröße bestimmte Aktionen durchführen können. Die Anwendung wird auf Symbolgröße verkleinert, wenn entweder das Hauptfenster auf Symbolgröße verkleinert oder die Methode Minimize aufgerufen wird. In der Eigenschaft Icon wird das Symbol festgelegt, das die minimierte Anwendung repräsentiert.


TApplication::OnRestore

TApplication	Siehe auch

Das Ereignis OnRestore wird ausgelöst, wenn eine auf Symbolgröße verkleinerte (minimierte) Anwendung wieder auf normale Größe gebracht wird.

__property Classes::TNotifyEvent OnRestore;

Beschreibung

Auf Basis von Mit OnRestore können Sie eine Ereignisbehandlungsroutine programmieren, mit der Sie bestimmte Aktionen durchführen können, wenn die auf Symbolgröße verkleinerte Anwendung wiederhergestellt wird. Eine Anwendung kann entweder durch eine entsprechende Eingabe des Benutzers oder durch Aufruf der Methode Restore wiederhergestellt werden.

Hinweis

Verwechseln Sie das Wiederherstellen einer Anwendung nicht mit dem Wiederherstellen eines Formulars oder eines Fensters auf seine ursprüngliche Größe. Um ein Fenster oder ein Formular auf Symbolgröße zu verkleinern, als Vollbild anzuzeigen oder wiederherzustellen, ändern Sie den Wert der Eigenschaft WindowState.


TApplication::OnShowHint

TApplication	Siehe auch

Das Ereignis OnShowHint wird ausgelöst, bevor ein Hinweisfenster zu einem bestimmten Steuerelement angezeigt wird.

__property TShowHintEvent OnShowHint;

Beschreibung

Auf Basis von OnShowHint können Sie eine Ereignisbehandlungsroutine programmieren, mit der Sie das Aussehen und das Verhalten von Hilfehinweisen ändern können.

Der Typ TShowHintEvent ist der Typ des Ereignisses OnShowHint. Er zeigt auf eine Methode, mit der ein Hilfehinweis zu einem Steuerelement angezeigt wird. Im Parameter HintStr können Sie den Text des Hilfehinweises vorgeben. Um den Text eines Hinweises zu einem bestimmten Steuerelement zu ermitteln, rufen Sie die Funktion GetLongHint oder GetShortHint auf und weisen das Ergebnis dem Parameter HintStr zu. Um den Text zu ändern, bearbeiten Sie diesen String.

Mit der Variable CanShow können Sie die Anzeige des Hilfehinweises aktivieren oder verhindern. Hat CanShow den Wert True, wird der Hilfehinweis angezeigt. Andernfalls wird er nicht angezeigt.

Der Parameter HintInfor ist ein Datensatz, der Informationen über das Aussehen und das Verhalten des Hilfefensters enthält.

Das Feld HintColor des Datensatzes enthält den Namen des Steuerelements, dessen Hinweis bearbeitet wird.

Mit dem Feld HintPos können Sie die standardmäßigen Bildschirmkoordinaten der linken oberen Ecke des Hinweisfensters bestimmen. Sie können die Position des Fensters verschieben, indem Sie diesen Wert ändern.

Mit dem Feld HintMaxWidth können Sie die maximale Breite des Fensters bestimmen, bei der noch kein Zeilenumbruch vorgenommen wird. Standardmäßig ist der Wert die Breite des Bildschirms (Screen::Width).

Mit dem Feld CursorRect können Sie das Rechteck bestimmen, in dem sich der Mauszeiger befinden muß, damit das Hinweisfenster angezeigt wird. Der Standardwert von CursorRect ist das Client-Rechteck des Steuerelements. In einer Anwendung kann dieser Wert geändert werden, so daß ein Steuerelement in mehrere Hinweisbereiche aufgeteilt werden kann. Sobald sich der Mauszeiger außerhalb des Rechtecks befindet, wird das Hinweisfenster ausgeblendet.

Das Feld CursorPos enthält die Position des Mauszeigers innerhalb des Steuerelements.


Methoden von TApplication

TApplication	Alphabetisch

In TApplication

~TApplication

BringToFront

CancelHint

ControlDestroyed

CreateForm

CreateHandle

HandleException

HandleMessage

HelpCommand

HelpContext

HelpJump

HideHint

HintMouseMessage

HookMainWindow

Initialize

MessageBox

Minimize

NormalizeTopMosts

ProcessMessages

Restore

RestoreTopMosts

Run

ShowException

TApplication

Terminate

UnhookMainWindow

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TApplication

TApplication	Nach Objekten

~TApplication

Assign

BringToFront

CancelHint

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

ControlDestroyed

CreateForm

CreateHandle

DefaultHandler

DestroyComponents

Destroying

Dispatch

FieldAddress

FindComponent

FreeInstance

FreeNotification

Free

GetParentComponent

HandleException

HandleMessage

HasParent

HelpCommand

HelpContext

HelpJump

HideHint

HintMouseMessage

HookMainWindow

InheritsFrom

Initialize

InitInstance

InsertComponent

InstanceSize

MessageBox

MethodAddress

MethodName

Minimize

NewInstance

NormalizeTopMosts

ProcessMessages

RemoveComponent

Restore

RestoreTopMosts

Run

ShowException

TApplication

Terminate

UnhookMainWindow


TApplication::~TApplication

TApplication	Siehe auch

Der Destruktor ~TApplication gibt den Speicher frei, der für das TApplication-Objekt reserviert war. Rufen Sie ~TApplication nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TApplication automatisch aufgerufen wird.

__fastcall virtual ~TApplication(void);

Beschreibung

~TApplication signalisiert, daß die Anwendung deaktiviert wurde, und ruft dann den Destruktor des übergeordneten Objekts auf. Anschließend wird der Speicher für verknüpfte Fenster sowie die Instanz des Objekts und diejenigen Objekte und Listen freigegeben, die beim Start der Anwendung erstellt oder die während der Ausführung gebildet wurden.

Da die Anwendung Eigentümer aller Formulare ist, werden in ihrem Destruktor alle Formulare freigegeben.


TApplication::BringToFront

TApplication	Siehe auch

Mit der Methode BringToFront können Sie das letzte aktive Fenster auf dem Desktop in den Vordergrund bringen.

void __fastcall BringToFront(void);

Beschreibung

Mit BringToFront können Sie das Fenster ermitteln, das Eigentum von MainForm ist und zuletzt aktiv war, und es in den Vordergrund bringen. Vorher überprüft BringToFront auch, ob das Fenster sichtbar und aktiv ist.


TApplication::CancelHint

TApplication	Siehe auch

Die Methode CancelHint bricht die Anzeige eines Hinweises zu einem Steuerelement ab.

void __fastcall CancelHint(void);

Beschreibung

CancelHint wird von Anwendungen selten direkt aufgerufen. Mit CancelHint wird in der VCL intern die Anzeige der Hinweise zu den entsprechenden Zeitpunkten abgebrochen. Dies ist beispielsweise der Fall, wenn ein Fenster nicht gültig ist oder die Anwendung geschlossen wird. Von CancelHint wird eine Reihe von Routinen aufgerufen, mit denen die Anzeige und der zeitliche Ablauf gesteuert wird.


TApplication::ControlDestroyed

TApplication	Siehe auch

Die Methode ControlDestroyed benachrichtigt eine Anwendung, daß ein Steuerelement freigegeben wurde.

void __fastcall ControlDestroyed(Controls::TControl* Control);

Beschreibung

Über ControlDestroyed wird die Anwendung benachrichtigt, daß das als Parameter Control übergebene Steuerelement freigegeben wurde. Somit können anwendungsinterne Zeiger wie MainForm und ActiveForm aktualisiert werden. Diese zeigen dann auf ein gültiges Steuerelement oder auf NULL.

ControlDestroyed wird von TControl::Destroy aufgerufen. Rufen Sie die Methode nicht direkt auf.


TApplication::CreateForm

TApplication	Siehe auch

Die Methode CreateForm erzeugt ein neues Formular.

void __fastcall CreateForm(System::TMetaClass* InstanceClass, void *Reference);

Beschreibung

In Anwendungen wird die Methode CreateForm immer aufgerufen. Von Borland C++Builder-Programmierern muß CreateForm jedoch selten direkt aufgerufen werden.

Im Hauptanweisungsteil eines Borland C++Builder-Projekts sind üblicherweise ein oder mehrere Aufrufe von CreateForm enthalten. Im Formular-Designer wird die Erstellung eines Formulars automatisiert. In einer Anwendung wird CreateForm möglicherweise aufgerufen, um ein Formular zur Laufzeit zu erstellen.

Mit CreateForm wird ein neues Formular des Typs erstellt, der im Parameter FormClass angegeben ist. Das Formular wird dann der Variablen zugewiesen, die der Parameter Reference bezeichnet. Der Eigentümer des neuen Formulars ist die Anwendung. Standardmäßig wird das Formular zum Hauptformular des Projekts, das mit dem ersten Aufruf von CreateForm erzeugt wurde.


TApplication::CreateHandle

TApplication	Siehe auch

Die Methode CreateHandle erzeugt einen Wert für die Eigenschaft Handle der Anwendung, wenn die Anwendung noch kein Handle besitzt.

void __fastcall CreateHandle(void);

Beschreibung

Rufen Sie CreateHandle nicht direkt auf. In EXE-Dateien wird CreateHandle von TApplication::TApplication aufgerufen. In DLL-Dateien ist dies nicht der Fall.

CreateHandle ist hauptsächlich eine Kapselung wesentlicher Merkmale der Windows-API-Funktion WinMain. Beispielsweise registriert CreateHandle die Klasse Window und legt fest, wie das Anwendungsfenster angezeigt wird.


TApplication::HandleException

TApplication	Siehe auch

Die Methode HandleException bietet in einer Anwendung die standardisierte Behandlung von Exceptions.

void __fastcall HandleException(System::TObject* Sender);

Beschreibung

Ein direkter Aufruf von HandleException ist in der Regel nicht erforderlich.

Mit der Ereignisbehandlungsroutine für OnException können Sie weiteren Exception-Code in die Anwendung einfügen.

Durchläuft eine Exception alle try-Blöcke des Programms, wird automatisch die Methode HandleException aufgerufen und ein Dialogfeld mit einer Fehlermeldung angezeigt. Außer bei dem Exception-Objekt EAbort ruft die Methode HandleException die Behandlungsroutine für OnException auf, falls vorhanden. Andernfalls wird ShowException aufgerufen und ein Dialogfeld mit einer Fehlermeldung angezeigt.


TApplication::HandleMessage

TApplication	Siehe auch

Die Methode HandleMessage unterbricht die Ausführung einer Anwendung, damit eine Botschaft aus der Botschaftswarteschlange von Windows verarbeitet werden kann. Anschließend geht die Kontrolle wieder an die Anwendung zurück.

void __fastcall HandleMessage(void);

Beschreibung

Ist die Botschaftswarteschlange leer, wird von HandleMessage die Methode Idle der Anwendung aufgerufen. Diese wiederum ruft die Ereignisbehandlungsroutine für OnIdle auf, wenn eine solche definiert ist.

Hinweis

Wenn die Anwendung in den Leerlauf übergeht, kann es einige Zeit dauern, bis HandleMessage zurückkehrt. Rufen Sie daher HandleMessage nicht auf, wenn auf eine botschaftsgesteuerte Operation gewartet werden soll, während gleichzeitig Aktionen mit höherer Priorität ausgeführt werden müssen. In solchen Situationen ist die Methode ProcessMessages die geeignete Wahl.


TApplication::HelpCommand

TApplication	Siehe auch

Die Methode HelpCommand bietet schnellen Zugriff auf die spezifischen Befehle der WinHelp-API.

bool __fastcall HelpCommand(int Command, long Data);

Beschreibung

Mit HelpCommand erlangen Sie Zugriff auf WinHelp.

HelpCommand dient als Kapselung für den Aufruf einer Methode, die das Ereignis OnHelp auslöst.

Informationen über diese Befehle und die übergebenen Daten finden Sie im Hilfesystem von Windows unter dem Thema WinHelp.


TApplication::HelpContext

TApplication	Siehe auch

Mit HelpContext können Sie die Hilfedatei zu einer Anwendung anzeigen.

bool __fastcall HelpContext(Classes::THelpContext Context);

Beschreibung

Mit HelpContext können Sie die Hilfedatei öffnen, die in der Eigenschaft HelpFile der Anwendung bezeichnet ist. HelpContext ruft direkt die Methode OnHelp auf.

Dabei wird der Dateiname, den die Eigenschaft HelpFile enthält, und die Kontextnummer übergeben, die im Parameter Context steht. Ist beispielsweise der Wert von Context 714, wird der Bildschirm mit der Kontext-ID 714 angezeigt.

Der Rückgabewert von HelpContext ist False, falls HelpFile einen leeren String enthält. Dies bedeutet, daß der Anwendung keine Hilfedatei zugewiesen wurde. In allen anderen Fällen gibt die Methode den Wert True zurück.


TApplication::HelpJump

TApplication	Siehe auch

Die Methode HelpJump ruft indirekt die Methode OnHelp auf.

bool __fastcall HelpJump(const System::AnsiString JumpID);

Beschreibung

Mit HelpJump können Sie Hilfe zu einem bestimmten Thema anzeigen. Dabei wird der Dateiname, den die Eigenschaft HelpFile enthält, und der Kontext-String übergeben, der im Parameter JumpID steht. Hat JumpID beispielsweise den Wert ‘vclDefaultProperty’, zeigt die Methode HelpJump den Hilfebildschirm mit dem Kontext-String vclDefaultProperty an.

Der Rückgabewert von HelpJump ist False, falls HelpFile einen Leerstring enthält. Dies bedeutet, daß der Anwendung keine Hilfedatei zugewiesen wurde. In allen anderen Fällen gibt die Methode den Wert True zurück.


TApplication::HideHint

TApplication	Siehe auch

Mit der Methode HideHint können Sie den aktuellen Hinweis ausblenden.

void __fastcall HideHint(void);

Beschreibung

HideHint wird in Anwendungen selten direkt aufgerufen. HideHint wird intern in Borland C++Builder verwendet, um das Hinweisfenster zu bestimmten Zeitpunkten und unter bestimmten Bedingungen auszublenden. Beispielsweise wird HideHint von CancelHint aufgerufen.


TApplication::HintMouseMessage

TApplication	Siehe auch

Die Methode HintMouseMessage koordiniert die Anzeige von Hinweisfenstern.

void __fastcall HintMouseMessage(Controls::TControl* Control, Messages::TMessage &Message);

Beschreibung

HintMouseMessage wird von Anwendungen selten direkt aufgerufen. HintMouseMessage wird intern in Borland C++Builder verwendet, um die Anzeige von Hinweisfenstern zu steuern.


TApplication::HookMainWindow

TApplication	Siehe auch

Mit HookMainWindow wird es externen Dialogfeldern (die nicht in Borland C++Builder existieren) möglich, Botschaften zu empfangen, die an deren übergeordnetes Objekt gesendet wurden. Dieses Objekt wird mit der Eigenschaft Handle des Anwendungsobjekts referenziert.

void __fastcall HookMainWindow(TWindowHook Hook);

Beschreibung

Mit HookMainWindow wird sichergestellt, daß sich das externe Dialogfeld korrekt als untergeordnetes Fenster der Anwendung verhält, und nicht als Standalone-Fenster. Das hat beispielsweise zur Folge, daß beim Umschalten zwischen den Anwendungen mit ALT+TAB das externe Dialogfeld nach dem Aufruf von HookMainWindow nicht mehr als separate Task angesehen wird.

Der Typ TWindowHook ist der Parametertyp für die Methode HookMainWindow. Es handelt sich um einen Methodenzeigertyp, der für die Dialogprozeduren von externen Dialogfeldern verwendet wird. Die Dialogprozedur entspricht in etwa der Fensterprozedur für ein Fenster, da Botschaften für das Dialogfeld verarbeitet werden. Die Syntax unterscheidet sich jedoch etwas.

Ein Dialogfeld kann auch für längere Zeit mit dem Hauptfenster verknüpft bleiben. Sollte jedoch das Dialogfeld geschlossen werden, heben Sie die Verknüpfung mit UnhookMainWindow wieder auf.

Weitere Informationen über Verknüpfungen dieser Art (sogenannte Hooks) finden Sie in der Hilfe unter SetWindowsHookEx und UnhookWindowsEx.


TApplication::Initialize

TApplication

Initialize ist der erste Methodenaufruf eines jeden Borland C++Builder-Projekts und gleichzeitig eine Möglichkeit, eine OLE-Automatisierungsprozedur aufzurufen.

void __fastcall Initialize(void);

Beschreibung

Mit Initialize können Sie eine Prozedur zur OLE-Automatisierung starten. Durch Initialize wird automatisch der Prozedurzeiger InitProc aufgerufen, ein Zeiger auf eine Prozedur, welche die OLE-Automatisierung abwickelt.

Da Initialize als erste Methode einer Borland C++Builder-Anwendung aufgerufen wird, muß der Zeiger InitProc irgendwie vordefiniert werden. Standardmäßig hat der Aufruf von Initialize für die Anwendung keinen Effekt, da der Zeiger InitProc per Vorgabe auf NULL zeigt.

Um eine OLE-Automatisierungsprozedur aufzurufen, führen Sie daher eine der folgenden Aktionen durch:

•	Fügen Sie eine Unit ein, die InitProc definiert, wie z.B. die Unit OleAuto.

•	Definieren Sie selbst eine Prozedur zur OLE-Automatisierung, weisen Sie diese dem Zeiger InitProc zu, und fügen Sie diese Zuweisung in die erste Zeile des Programms ein, also vor dem Aufruf von Initialize.

Bei Projekten, die keinen Server für die OLE-Automatisierung enthalten, kann der Aufruf von Initialize gelöscht werden.

Hinweis

Obwohl Initialize die erste im Hauptprogramm aufgerufene Methode ist, ist der Aufruf nicht der erste ausgeführte Programmschritt einer Anwendung.


TApplication::MessageBox

TApplication

Mit der Methode MessageBox können Sei eine bestimmte Meldung für den Benutzer anzeigen.

int __fastcall MessageBox(char * Text, char * Caption, unsigned short Flags);

Beschreibung

Mit MessageBox können Sie ein generisches Dialogfeld mit einer Meldung und einer oder mehreren Schaltflächen anzeigen. Der Parameter Caption ist der Titel des Dialogfeldes und ist optional.

MessageBox ist eine Kapselung der Funktion MessageBox der Windows-API. Das für die API benötigte Fenster-Handle wird automatisch bereitgestellt.

Der Wert des Parameters Text ist die Meldung, die gegebenenfalls länger als 255 Zeichen sein kann. Überlange Meldungen werden im Meldungsfeld automatisch umbrochen. Der Wert der Eigenschaft Caption ist der Titel, der in der Titelleiste des Dialogfeldes angezeigt wird. Titel können länger als 255 Zeichen sein. Sie werden jedoch nicht umbrochen. Ein langer Titel führt zu einem breiten Meldungsfeld.

Die möglichen Werte des Parameters Flags finden Sie in der Hilfedatei der Windows-API unter der Funktion MesageBox. Der entsprechende Parameter dieses Hilfebildschirms heißt TextType. Die Werte bestimmen die Schaltflächen, die im Meldungsfeld angezeigt werden, sowie das Verhalten des Fensters. Um den gewünschten Effekt zu erzielen, können die Werte auch kombiniert werden.

Der Rückgabewert der Methode MessageBox ist 0, falls nicht genügend Speicher zur Erstellung des Meldungsfeldes vorhanden war. Andernfalls wird einer der folgenden Werte zurückgegeben:

Wert	Numerischer Wert	Bedeutung

IDABORT	         3	Es wurde die Schaltfläche Abbruch gewählt.

IDCANCEL	         2	Es wurde die Schaltfläche Abbrechen gewählt.

IDIGNORE	         5	Es wurde die Schaltfläche Ignorieren gewählt.

IDNO	         7	Es wurde die Schaltfläche Nein gewählt.

IDOK	         1	Es wurde die Schaltfläche OK gewählt.

IDRETRY	         4	Es wurde die Schaltfläche Wiederholen gewählt.

IDYES	         6	Es wurde die Schaltfläche Ja gewählt.


TApplication::Minimize

TApplication	Siehe auch

Mit der Methode Minimize können Sie eine Anwendung auf dem Windows-Desktop auf Symbolgröße verkleinern (minimieren).

void __fastcall Minimize(void);

Beschreibung

Mit Minimize können Sie die Anwendung programmgesteuert auf Symbolgröße verkleinern. Wenn der Benutzer die Anwendung auf Symbolgröße verkleinert, wird die Methode Minimize automatisch aufgerufen.

Hinweis

Verwechseln Sie die Methode Minimize nicht mit dem Verkleinern eines Formulars oder eines Fensters. Um ein Fenster oder ein Formular auf Symbolgröße zu verkleinern, als Vollbild anzuzeigen oder wiederherzustellen, ändern Sie den Wert der Eigenschaft WindowState.


TApplication::NormalizeTopMosts

TApplication	Siehe auch

Mit der Methode NormalizeTopMosts können Sie bewirken, daß sich Formulare, die als oberstes Formular (FormStyle hat den Wert fsStayOnTop) vorgesehen sind, dennoch ein Fenster auf einer darüberliegenden Ebene zulassen.

void __fastcall NormalizeTopMosts(void);

Beschreibung

Mit NormalizeTopMosts können Sie ein Meldungsfeld oder ein Dialogfeld, das mit Funktionen der Windows-API (wie z.B. MessageBox und MessageDlg) direkt angezeigt wird, noch über einem Formular anzeigen, das sich im Vordergrund befindet. Normalerweise verbleibt das Formular im Vordergrund, wodurch das Meldungsfeld verdeckt würde.

Wenn Sie für die Anzeige von Meldungsfeldern Methoden und Funktionen von Borland C++Builder verwenden, benötigen Sie die Methode NormalizeTopMosts nicht.

Mit RestoreTopMosts können Sie das Formular wieder in den Vordergrund bringen, das in seiner Eigenschaft FormStyle den Wert fsStayOnTop hat.


TApplication::ProcessMessages

TApplication	Siehe auch

Mit der Methode ProcessMessages können Sie eine Anwendung unterbrechen, so daß Windows auf Ereignisse antworten kann.

void __fastcall ProcessMessages(void);

Beschreibung

Diese Ereignisse können zum Zeitpunkt des Aufrufs von ProcessMessages von Windows verarbeitet werden. Mit der Methode ProcessMessages kann die Botschaftswarteschlange von Windows durchlaufen werden, bis diese leer ist. Anschließend wird die Ablaufsteuerung wieder auf die Anwendung übertragen.

Hinweis

ProcessMessages ermöglicht nicht, daß die Anwendung in den Leerlauf übergeht. Hier liegt ein Unterschied zu HandleMessages.


TApplication::Restore

TApplication	Siehe auch

Mit der Methode Restore können Sie eine zum Symbol verkleinerte Anwendung wieder auf normale Größe bringen.

void __fastcall Restore(void);

Beschreibung

Mit Restore können Sie eine Anwendung in genau der Größe wiederherstellen, die sie vor der Verkleinerung zum Symbol besaß. Wenn der Benutzer diese Größenänderung veranlaßt, wird die Methode Restore automatisch aufgerufen.

Hinweis

Verwechseln Sie die Methode Restore nicht mit dem Wiederherstellen eines Formulars oder eines Fensters. Um ein Fenster oder ein Formular auf Symbolgröße zu verkleinern, als Vollbild anzuzeigen oder wiederherzustellen, ändern Sie den Wert der Eigenschaft WindowState.


TApplication::RestoreTopMosts

TApplication	Siehe auch

Mit RestoreTopMosts können Sie Formulare wieder in den Vordergrund bringen, deren Eigenschaft FormStyle den Wert fsStayOnTop hat.

void __fastcall RestoreTopMosts(void);

Beschreibung

Mit RestoreTopMosts können Sie Formulare wieder in den Vordergrund bringen, die ursprünglich als oberstes Formular vorgesehen waren (FormStyle hat den Wert fsStayOnTop), aber vorübergehend mit der Methode NormalizeTopMosts in einer tiefere Darstellungsebene verlagert wurden.


TApplication::Run

TApplication	Siehe auch

Die Methode Run startet die Anwendung.

void __fastcall Run(void);

Beschreibung

Die Methode Run enthält die Haupt-Botschaftswarteschlange der Anwendung und wird solange ausgeführt, bis die Botschaftsschleife der Anwendung beendet ist.

Bei der Erstellung eines neuen Projekts wird in der Projektdatei automatisch ein Hauptprogrammblock erstellt, in dem die Methode Run aufgerufen wird, sobald die Anwendung ausgeführt wird.


TApplication::ShowException

TApplication	Siehe auch

Mit der Methode ShowException können Sie eine aufgetretene Exception in einem Meldungsfeld anzeigen.

void __fastcall ShowException(Sysutils::Exception* E);

Beschreibung

ShowException wird standardmäßig von HandleException aufgerufen, falls für das Ereignis OnException keine Behandlungsroutine vorgesehen ist.

Falls Exceptions gefiltert werden, muß ShowException für die Exceptions aufgerufen werden, die nicht gefiltert wurden.

Um die Verarbeitung von Exceptions in einer Anwendung festzulegen, schreiben Sie eine Behandlungsroutine für das Ereignis OnException.

Hinweis

Ein Aufruf von ShowException ist in einer Borland C++Builder-Anwendung selten erforderlich, da dies von der VCL-Standardroutine für Exceptions übernommen wird.


TApplication::TApplication

TApplication	Siehe auch

Der Konstruktor TApplication erzeugt ein neues TApplication-Objekt.

__fastcall virtual TApplication(Classes::TComponent* AOwner);

Beschreibung

In Anwendungen wird TApplication nicht direkt aufgerufen. In jeder Borland C++Builder-Anwendung wird automatisch die Instanz eines Anwendungsobjekts erzeugt.

TApplication belegt einige Eigenschaften mit Standardwerten. Außerdem wird die Anwendung vorbereitet. Dazu werden folgende Elemente eingerichtet: Hinweisfenster, das Anwendungssysmbol, das Handle des Hauptfensters, die HInstance-Struktur, Listen für die Verwaltung untergeordneter Fenster des Hauptfensters (Formulars) und so weiter.


TApplication::Terminate

TApplication	Siehe auch

Die Methode Terminate beendet eine Anwendung.

void __fastcall Terminate(void);

Beschreibung

Terminate ruft die Funktion PostQuitMessage der Windows-API auf, um die Anwendung kontrolliert zu beenden. Die Methode Terminate wirkt somit nicht direkt.

Terminate wird als Reaktion auf die Botschaft WM_QUIT und beim Schließen des Hauptformulars automatisch aufgerufen.


TApplication::UnhookMainWindow

TApplication	Siehe auch

Mit UnhookMainWindow wird eine Dialogprozedur freigegeben, zu der vorher mit der Methode HookMainWindow eine Verknüpfung hergestellt wurde.

void __fastcall UnhookMainWindow(TWindowHook Hook);

Beschreibung

Mit UnhookMainWindow wird das verknüpfte Fenster freigegeben. Geben Sie die Dialogprozedur als Wert des Parameters Hook an.

Der Typ TWindowHook ist der Parametertyp für die Methode InookMainWindow. Es handelt sich dabei um einen Methodenzeigertyp, der für die Dialogprozeduren von externen Dialogfeldern (die nicht in Borland C++Builder existieren) verwendet wird. Die Dialogprozedur entspricht in etwa der Fensterprozedur, da Botschaften für das Dialogfeld verarbeitet werden. Die Syntax unterscheidet sich jedoch etwas.

Weitere Informationen über Verknüpfungen dieser Art (sogenannte Hooks) finden in der Hilfedatei von Windows unter den Funktionen SetWindowsEx und UnhookWindowsEx.


Gültigkeitsbereich

Published

Zugriff

Read-only


Hierarchie

TObject

TPersistent

TComponent


TApplication Beispiel

TApplication


TAutoIncField

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/dbtables.hpp

Ein TAutoInc-Objekt repräsentiert ein Autoinkrement-Feld in einer Datenmenge.

Beschreibung

Autoinkrement-Felder können Werte im Bereich von -2.147.483.648 bis 2.147.483.647 enthalten und fungieren als Zähler für die Datensätze in einer Datenmenge. Alle Datensätze weisen in einem Autoinkrement-Feld einen eindeutigen Wert auf. Jedem neuen Datensatz wird ein Integer zugewiesen, der um 1 höher ist, als der des vorher eingefügten Datensatzes. Autoinkrement-Felder werden normalerweise für die Bereitstellung eines eindeutigen Primärschlüsselwertes für einen Datensatz verwendet. TAutoInc besitzt keine neuen Eigenschaften, Ereignisse oder Methoden, die über diejenigen der Klasse TInteger hinausreichen. Für die Repräsentation von DataType für ein Autoinkrement-Feld existiert eine eigene Klasse.


Eigenschaften von TAutoIncField

TAutoIncField	Alphabetisch	Legende

Abgeleitet von TIntegerField

MaxValue

MinValue

Value

Abgeleitet von TNumericField

DisplayFormat

EditFormat

Abgeleitet von TField

Alignment

AsBoolean

AsCurrency

AsDateTime

AsFloat

AsInteger

AsString

AsVariant

AttributeSet

BDECalcField

Calculated

CanModify

DataSet

DataSize

DataType

DisplayLabel

DisplayName

DisplayText

DisplayWidth

EditMask

EditMaskPtr

FieldKind

FieldName

FieldNo

Index

IsIndexField

IsNull

KeyFields

Lookup

LookupDataSet

LookupKeyFields

LookupResultField

NewValue

OldValue

ReadOnly

Required

Size

Text

Visible

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Name

Owner

Tag


Eigenschaften von TAutoIncField

TAutoIncField	Nach Objekten	Legende

Alignment

AsBoolean

AsCurrency

AsDateTime

AsFloat

AsInteger

AsString

AsVariant

AttributeSet

BDECalcField

Calculated

CanModify

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

DataSet

DataSize

DataType

DesignInfo

DisplayFormat

DisplayLabel

DisplayName

DisplayText

DisplayWidth

EditFormat

EditMaskPtr

EditMask

FieldKind

FieldName

FieldNo

Index

IsIndexField

IsNull

KeyFields

LookupDataSet

LookupKeyFields

LookupResultField

Lookup

MaxValue

MinValue

Name

NewValue

OldValue

Owner

ReadOnly

Required

Size

Tag

Text

Value

Visible


Ereignisse von TAutoIncField

TAutoIncField	Alphabetisch

Abgeleitet von TField

OnChange

OnGetText

OnSetText

OnValidate


Ereignisse von TAutoIncField

TAutoIncField	Nach Objekten

OnChange

OnGetText

OnSetText

OnValidate


Methoden von TAutoIncField

TAutoIncField	Alphabetisch

In TAutoIncField

~TAutoIncField

TAutoIncField

Abgeleitet von TIntegerField

IsValidChar

Abgeleitet von TField

Assign

AssignValue

Clear

FocusControl

GetData

SetData

SetFieldType

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TAutoIncField

TAutoIncField	Nach Objekten

~TAutoIncField

Assign

AssignValue

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

Clear

DefaultHandler

DestroyComponents

Destroying

Dispatch

FieldAddress

FindComponent

FocusControl

FreeInstance

FreeNotification

Free

GetData

GetParentComponent

HasParent

InheritsFrom

InitInstance

InsertComponent

InstanceSize

IsValidChar

MethodAddress

MethodName

NewInstance

RemoveComponent

SetData

SetFieldType

TAutoIncField


TAutoIncField::~TAutoIncField

TAutoIncField

Der Destruktor ~TAutoIncField gibt den Speicher frei, der für das TAutoIncField-Objekt reserviert war. Rufen Sie ~TAutoIncField nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TAutoIncField automatisch aufgerufen wird.

__fastcall virtual ~TAutoIncField(void);


TAutoIncField::TAutoIncField

TAutoIncField

TAutoIncField erstellt eine Instanz von TAutoIncField.

__fastcall virtual TAutoIncField(Classes::TComponent* AOwner);

Beschreibung

Rufen Sie TAutoIncField auf, wenn Sie eine Instanz von TAutoIncField erstellen und initialisieren wollen. Nach dem Aufruf des Konstruktors des übergeordneten Objekts wird mit TAutoIncField die Eigenschaft DataType auf ftAutoInc gesetzt.


Gültigkeitsbereich

Published

Zugriff

Read-only


Hierarchie

TObject

TPersistent

TComponent

TField

TNumericField

TIntegerField


TAutoIncField Beispiel

TAutoIncField


TAutomation

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/oleauto.hpp

Beschreibung

Das Objekt TAutomation verwaltet die OLE-Automatisierung.


Eigenschaften von TAutomation

TAutomation	Alphabetisch	Legende

In TAutomation

AutoObjectCount

IsInprocServer

StartMode


Eigenschaften von TAutomation

TAutomation	Nach Objekten	Legende

AutoObjectCount

IsInprocServer

StartMode


TAutomation::AutoObjectCount

TAutomation

Beschreibung

__property int AutoObjectCount;

Die Eigenschaft gibt an, wieviele Instanzen von OLE-Automatisierungsobjekten gegenwärtig verwaltet werden.

Jedesmal, wenn der Automatisierungs-Manager eine Instanz der von ihm verwalteten Server-Objekte erzeugt, wird dessen interner Zähler inkrementiert. Anwendungen können den Wert dieses Zählers über die Nur-Lesen-Eigenschaft AutoObjectCount ermitteln.


TAutomation::IsInprocServer

TAutomation

Beschreibung

__property bool IsInprocServer;

Die Eigenschaft signalisiert, ob der OLE-Automatisierungs-Server ein prozeßinterner Server ist.

In Borland C++Builder wird vorausgesetzt, daß alle OLE-Automatisierungs-Server in DLLs prozeßinterne Server sind, und solche in Anwendungen dagegen nicht.


TAutomation::StartMode

TAutomation

Beschreibung

__property TStartMode StartMode;

Die Eigenschaft bezeichnet den Modus, in dem ein OLE-Automatisierungs-Server gestartet wurde: als interaktive Standalone-Anwendung, als eingebettetes Objekt oder zur Registrierung bzw. Deregistrierung.

Auf Basis von StartMode entscheidet der Automatisierungs-Manager, was mit dem Server geschieht, wenn dessen Controller-Anwendungen beendet sind. Details hierzu finden Sie unter OnLastRelease.

Der Typ TStartMode enthält die möglichen Werte für die Eigenschaft StartMode. Damit werden die verschiedenen Gründe bezeichnet, warum ein OLE-Automatisierungs-Server gestartet wurde.

Die folgende Tabelle beschreibt die möglichen Startmodi und die zugehörigen Kommandozeilenoptionen:

Startmodus	Kommandozeilenoption	Bedeutung

smAutomation	embedding	Die Anwendung wurde von Windows gestartet, weil von einem Automatisierungs-Controller eine entsprechende Anforderung einging.

smRegServer	regserver	Die Anwendung wurde nur gestartet, um den Server in die Registrierdatenbank einzufügen.

smStandalone	---	Die Anwendung wurde vom Benutzer als interaktive Standalone-Anwendung gestartet.

smUnregServer	unregserver	Die Anwendung wurde nur gestartet, um den Server aus der Registrierdatenbank zu entfernen.


Ereignisse von TAutomation

TAutomation	Alphabetisch

In TAutomation

OnLastRelease


Ereignisse von TAutomation

TAutomation	Nach Objekten

OnLastRelease


TAutomation::OnLastRelease

TAutomation

Beschreibung

__property TLastReleaseEvent OnLastRelease;

Dieses Ereignis wird ausgelöst, wenn der Automatisierungs-Manager die letzte Instanz eines OLE-Automatisierungsobjekts freigibt.

Bei prozeßinternen Servern wird OnLastRelease nicht ausgelöst.

Der Parameter Shutdown des Ereignisses ist eine Variable, so daß eine Ereignisbehandlungsroutine das Schließen des Automatisierungs-Managers bewirken oder verhindern kann (mit den Werten True bzw. False). Per Vorgabe ist Shutdown nur dann True, wenn die Eigenschaft StartMode des Servers den Wert smAutomation hat, das heißt, es werden nur solche Server automatisch geschlossen, die explizit in diesem Modus gestartet wurden.

Der Typ TLastReleaseEvent ist ein Methodenzeiger-Typ für das Ereignis OnLastRelease. Der variable Parameter Shutdown ermöglicht es der Anwendung, das Standardverhalten zu überschreiben, um zu steuern, ob die Anwendung nach Freigabe aller Instanzen geschlossen wird.


Methoden von TAutomation

TAutomation	Alphabetisch

In TAutomation

~TAutomation

RegisterClass

TAutomation

UpdateRegistry

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TAutomation

TAutomation	Nach Objekten

~TAutomation

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance

RegisterClass

TAutomation

UpdateRegistry


TAutomation::~TAutomation

TAutomation

Der Destruktor ~TAutomation gibt den Speicher frei, der für das TAutomation-Objekt reserviert war. Rufen Sie ~TAutomation nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TAutomation automatisch aufgerufen wird.

__fastcall virtual ~TAutomation(void);


TAutomation::RegisterClass

TAutomation

Beschreibung

void __fastcall RegisterClass(const TAutoClassInfo &AutoClassInfo);

Die Methode registriert eine Klasse, die einen OLE-Automatisierungs-Server kapselt, beim OLE-Automatisierungs-Manager.

Jede Unit, die eine solche Server-Klasse definiert (ein von TAutoObject abgeleitetes Objekt), muß in ihrem Initialisierungsabschnitt einen Aufruf von Automation.RegisterClass enthalten und dabei einen Datensatz mit Informationen zur Registrierung der Klasse enthalten.


TAutomation::UpdateRegistry

TAutomation

Beschreibung

void __fastcall UpdateRegistry(bool Register);

Die Methode aktualisiert die Registrierdatenbank für alle OLE-Automatisierungsobjekte, die vom OLE-Automatisierungs-Manager verwaltet werden, das heißt, für alle Objekte dieser Art in einer bestimmten Server-Anwendung.

Wenn der Parameter Register den Wert True hat, registriert UpdateRegistry die Server. Andernfalls wird die Registrierung aufgehoben.

Die Funktion DllRegisterServer ruft UpdateRegistry automatisch auf, so daß ein expliziter Aufruf nicht nötig ist.


TAutomation::TAutomation

TAutomation

Beschreibung

__fastcall TAutomation(void);

Der Konstruktor erzeugt eine Instanz des Automatisierungs-Managers und bestimmt dann, ob dieser in einer DLL läuft.

Wenn dies der Fall ist, wird dessen Eigenschaft IsInprocServer auf True gesetzt. Schließlich sucht das TAutomation-Objekt die OLE-Kommandozeilenoptionen und setzt den entsprechenden Wert für StartMode.


Zugriff

Read-only


Hierarchie

TObject


TAutomation Beispiel

TAutomation


TAutoObject

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/oleauto.hpp

TAutoObject ist die Basisklasse für alle Objekte in C++Builder-Automatisierungs-Servern. Wenn Sie ein neues Automatisierungsobjekt erzeugen, leiten Sie dieses zunächst von TAutoObject ab und deklarieren anschließend die Eigenschaften und Methoden in einem automated-Abschnitt der neuen Klasse.

Beschreibung

Um ein Automatisierungsobjekt für externe OLE-Automatisierungs-Controller bereitzustellen, muß die Unit, welche das Automatisierungsobjekt implementiert, in ihrem Initialisierungsbereich die Methode Automation::RegisterClass aufrufen und dabei einen TAutoClassInfo-Datensatz übergeben. Sobald das Automatisierungsobjekt registriert ist, übernimmt das globale Automatisierungsobjekt mit Hilfe der OLE-Automatisierungsfunktionen der API die gesamte Verwaltung der Objektschnittstelle.

Wenn ein externer OLE-Automatisierungs-Controller eine Instanz des Automatisierungsobjekts anfordert, wird diese vom Automatisierungs-Manager durch einen Aufruf des Konstruktors erzeugt. Wenn keine externen Referenzen auf das Objekt mehr existieren, ruft der Automatisierungs-Manager den Destruktor auf, um die Instanz aufzulösen. Das Automatisierungsobjekt stellt mit Hilfe eines Referenzzählers fest, ob noch Referenzen vorhanden sind.


Eigenschaften von TAutoObject

TAutoObject	Alphabetisch	Legende

In TAutoObject

AutoDispatch

OleObject

RefCount


Eigenschaften von TAutoObject

TAutoObject	Nach Objekten	Legende

AutoDispatch

OleObject

RefCount


TAutoObject::AutoDispatch

TAutoObject	Siehe auch

__property TAutoDispatch* AutoDispatch;

Beschreibung

Die Eigenschaft AutoDispatch stellt eine IDispatch-Schnittstelle für das Automatisierungsobjekt bereit, die eine Übergabe an OLE-API-Funktionen ermöglicht.


TAutoObject::OleObject

TAutoObject

__property System::Variant OleObject;

Beschreibung

Die Eigenschaft OleObject stellt eine Variante bereit, die das Automatisierungsobjekt enthält.

Wenn Ihr Server ein OLE-Objekt an einen Controller übergeben muß, erwartet dieser die Übergabe einer Variante. Deshalb sollten Referenzen nie auf das Objekt selbst, sondern immer auf die OleObject-Eigenschaft eines Automatisierungsobjekts verweisen.


TAutoObject::RefCount

TAutoObject

__property int RefCount;

Beschreibung

Die Eigenschaft RefCount enthält den aktuellen Referenzzähler des OLE-Automatisierungsobjekts.

Mit den Methoden AddRef und Release kann der Referenzzähler erhöht bzw. verringert werden.


Methoden von TAutoObject

TAutoObject	Alphabetisch

In TAutoObject

~TAutoObject

AddRef

Release

TAutoObject

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TAutoObject

TAutoObject	Nach Objekten

~TAutoObject

AddRef

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance

Release

TAutoObject


TAutoObject::~TAutoObject

TAutoObject

Der Destruktor ~TAutoObject gibt den Speicher frei, der für das TAutoObject-Objekt reserviert war. Rufen Sie ~TAutoObject nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TAutoObject automatisch aufgerufen wird.

__fastcall virtual ~TAutoObject(void);


TAutoObject::AddRef

TAutoObject

int __fastcall AddRef(void);

Beschreibung

Die Methode AddRef erhöht den Referenzzähler eines OLE-Automatisierungsobjekts und gibt den aktuellen Stand des Zählers zurück.


TAutoObject::Release

TAutoObject

int __fastcall Release(void);

Beschreibung

Die Methode Release verringert den Referenzzähler eines OLE-Automatisierungsobjekts und gibt den aktuellen Stand des Zählers zurück.

Wenn der neue Zählerstand Null ist, gibt Release das Objekt durch einen Aufruf von Free frei.


TAutoObject::TAutoObject

TAutoObject

Der Konstruktor TAutoObject erzeugt ein neues TAutoObject-Objekt.

Beschreibung

TAutoObject erzeugt eine Instanz eines OLE-Automatisierungsobjekts, das von einem Automatisierungs-Server exportiert werden kann.

TAutoObject erhöht den Objektzähler des Automatisierungs-Managers, setzt den eigenen Referenzzähler auf 1 und erzeugt die IDispatch-Schnittstelle.


Zugriff

Read-only


Hierarchie

TObject


TAutoObject Beispiel

TAutoObject


 TBatchMove

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/dbtables.hpp

Mit Hilfe von TBatchMove können in Anwendungen Datenbankoperationen mit Datensatzgruppen oder gesamten Tabellen ausgeführt werden.

Beschreibung

Durch Instantiieren eines Objekts der Klasse TBatchMove können Sie folgende Aktionen durchführen:

•	Datensätze einer Datenmenge in eine Datenbanktabelle einfügen.

•	Datensätze einer Datenmenge aus einer Datenbanktabelle löschen.

•	Eine Datenmenge kopieren, um eine neue Datenbanktabelle zu erstellen oder eine bestehende Tabelle zu überschreiben.

Um die gewünschte Operation festzulegen, stellen Sie die Eigenschaften des TBatchMove-Objekts ein. Mit der Methode Execute wird die eigentliche Operation ausgeführt. Mit den Objekten der Klasse TTable können dieselben Batch-Operationen durchgeführt werden, allerdings nur mit den Optionen, die von den Standardwerten der Eigenschaften von TBatchMove festgelegt sind.

TBatchMove besitzt mehrere Eigenschaften, mit denen gesteuert wird, wie die Borland Database Engine (BDE) Probleme behandelt, die bei der Ausführung der Batch-Operation auftreten. Außerdem kann in Anwendungen mit Hilfe eines TBDECallback-Objekts die Reaktion auf vorkommende Probleme weiter detailliert werden.


Eigenschaften von TBatchMove

TBatchMove	Alphabetisch	Legende

In TBatchMove

AbortOnKeyViol

AbortOnProblem

ChangedCount

ChangedTableName

CommitCount

Destination

KeyViolCount

KeyViolTableName

Mappings

Mode

MovedCount

ProblemCount

ProblemTableName

RecordCount

Source

Transliterate

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Name

Owner

Tag


Eigenschaften von TBatchMove

TBatchMove	Nach Objekten	Legende

AbortOnKeyViol

AbortOnProblem

ChangedCount

ChangedTableName

CommitCount

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

DesignInfo

Destination

KeyViolCount

KeyViolTableName

Mappings

Mode

MovedCount

Name

Owner

ProblemCount

ProblemTableName

RecordCount

Source

Tag

Transliterate


TBatchMove::AbortOnKeyViol

TBatchMove	Siehe auch

Die Eigenschaft AbortOnKeyViol gibt an, ob die Batch-Operation bei einer Integritäts- oder Schlüsselverletzung sofort beendet wird.

__property bool AbortOnKeyViol;

Beschreibung

Um die Batch-Operation bei einer Integritäts- oder Schlüsselverletzung in der Zieltabelle abzubrechen, stellen Sie AbortOnKeyViol auf True ein. Wenn Sie der Eigenschaft den Wert False zuweisen, werden die für die Verletzung verantwortlichen Datensätze statt dessen in eine Schlüsselverletzungstabelle geschrieben. Geben Sie in der Eigenschaft KeyViolTableName einen Namen für die Schlüsselverletzungstabelle an, wenn Sie AbortOnKeyViol auf False einstellen. Wird die Eigenschaft KeyViolTableName nicht definiert, kann AbortOnKeyViol trotzdem auf False eingestellt werden. In diesem Fall werden die problematischen Datensätze gezählt, aber in keiner Tabelle gespeichert.

Schlüsselverletzungen treten auf, wenn Datensätze an eine Tabelle mit einem Primärschlüssel angefügt werden. In einer Tabelle mit einem Primärschlüssel darf es keine zwei Datensätze geben, die in allen Schlüsselfeldern dieselben Werte besitzen. Es kann kein Datensatz angefügt werden, der in allen Schlüsselfeldern dieselben Werte wie ein Datensatz der Zieltabelle besitzt.

Integritätsverletzungen treten auf, wenn Datensätze aus einer Tabelle gelöscht, an eine Tabelle angefügt werden oder wenn eine Tabelle aktualisiert wird und die Tabelle referentielle Integrität besitzt. Zur Festlegung der referentiellen Integrität müssen bestimmte Felder einer Tabelle Werte enthalten, die in einem bestimmten Feld einer anderen Tabelle vorhanden sind. Datensätze, die den Anforderungen der referentiellen Integrität nicht entsprechen, können nicht eingefügt werden. Ein Datensatz kann nicht gelöscht werden, wenn dadurch die Beschränkungen der referentiellen Integrität verschärft würden, die eine andere Tabelle nicht erfüllen kann.


TBatchMove::AbortOnProblem

TBatchMove	Siehe auch

Die Eigenschaft AbortOnProblem legt fest, ob die Batch-Operation sofort beendet wird, wenn Daten abgeschnitten werden müssen, damit sie in den angegebenen Zielbereich passen.

__property bool AbortOnProblem;

Beschreibung

Durch Einstellen von AbortOnProblem auf True können Sie die Batch-Operation abbrechen, wenn die Feldtypen von Datensätzen der Quelltabelle nicht mit den Feldtypen von Datensätzen der Zieltabelle übereinstimmen. Weisen Sie der Eigenschaft den Wert False zu, um die nicht übereinstimmenden Felder anzupassen. In diesem Fall können Sie durch Einstellen der Eigenschaft ProblemTableName alle ursprünglichen Versionen von verkürzten Datensätzen in einer eigenen Tabelle speichern.

Das Anpassen eines Feldes bedeutet, daß sein Wert so umgewandelt wird, daß er zum Typ des Zielfeldes kompatibel ist. Ist beispielsweise in einem Feld der Zieltabelle ein String mit zehn Zeichen gespeichert und enthält das entsprechende Feld der Quelltabelle einen String mit 15 Zeichen, müssen alle Werte der Quelltabelle mit mehr als zehn Zeichen abgeschnitten werden. Nicht konvertierbare Werte bewirken, daß TBatchMove eine Exception generiert.

Die Anpassung erfolgt nicht, wenn die Eigenschaft Mode auf batCopy eingestellt ist. Das Anpassen von Feldern bei einer Löschung bedeutet, daß möglicherweise Datensätze der Zieltabelle gelöscht werden, die nicht exakt mit den Werten der Quelltabelle übereinstimmen.

Hinweis

Mit einem TBDECallback-Objekt können Sie eine Anpassung feldweise durchführen.


TBatchMove::ChangedCount

TBatchMove	Siehe auch

Die Eigenschaft ChangedCount gibt die Anzahl der Datensätze an, die in der Zieltabelle im Verlauf einer Batch-Operation geändert wurden.

__property long ChangedCount;

Beschreibung

Mit ChangedCount können Sie die Anzahl der aktualisierten Datensätze der Zieltabelle ermitteln, falls Mode den Wert batUpdate oder batAppendUpdate hat. Wurde die Eigenschaft auf Mode batDelete eingestellt, können Sie die Anzahl der gelöschten Datensätze ermitteln.

Um die ursprünglichen Versionen der geänderten Datensätze in einer eigenen Tabelle zu speichern, verwenden Sie die Eigenschaft ChangedTableName ein. ChangedCount ist dann die Anzahl der Datensätze in dieser Tabelle.


TBatchMove::ChangedTableName

TBatchMove	Siehe auch

Die Eigenschaft ChangedTableName gibt den Namen der lokalen Paradox-Tabelle an, in der Kopien aller Datensätze der Zieltabelle gespeichert werden, die im Verlauf einer Batch-Operation geändert werden.

__property System::AnsiString ChangedTableName;

Beschreibung

Durch Einstellen von ChangedTableName können Sie eine Tabelle aufbauen, in der alle ursprünglichen Versionen von Datensätzen gespeichert werden, die bei einer Batch-Operation geändert wurden. Für ChangedTableName muß der Name einer Paradox-Tabelle angegeben werden. Damit ist sichergestellt, daß beim Ändern oder Löschen von Datensätzen keine Daten der Zieltabelle verloren gehen.

Hat die Eigenschaft Mode den Wert batUpdate oder batAppendUpdate, werden in der neuen Tabelle alle aktualisierten Datensätze gespeichert. Wurde die Eigenschaft Mode auf batDelete eingestellt, werden in der neuen Tabelle alle gelöschten Datensätze gespeichert.

Die Eigenschaft ChangedCount gibt die Anzahl der Datensätze in der neuen Tabelle an.


TBatchMove::CommitCount

TBatchMove	Siehe auch

Die Eigenschaft CommitCount gibt an, wieviele Datensätze vor einem Commit in einer Batch-Operation bearbeitet werden.

__property int CommitCount;

Beschreibung

Mit CommitCount können Sie eine Batch-Operation in mehrere kleinere Schritte aufteilen. Damit können in einer Anwendung die Transaktionsprotokolle des Servers angepaßt werden, die für die gesamte Batch-Operation nicht groß genug sind. Durch Einstellen von CommitCount auf 0 werden die Datensätze in Gruppen zu je 32 Kbyte aufgeteilt.

Hinweis

Wird die Methode Execute in einer expliziten Transaktion der Datenbank aufgerufen, welche die Tabellen enthält, wird CommitCount ignoriert.


TBatchMove::Destination

TBatchMove	Siehe auch

Die Eigenschaft Destination legt das Objekt TTable der Datenbanktabelle fest, die das Ziel der Batch-Operation ist.

__property TTable* Destination;

Beschreibung

Mit Destination können Sie die Datenbanktabelle anzeigen, die von der Batch-Operation erstellt oder geändert wird. Die Batch-Operation wirkt sich abhängig von Mode verschieden auf die Eigenschaft die Zieltabelle aus:

Modus	Auswirkung auf Zieltabelle

batAppend	Datensätze werden in die Zieltabelle eingefügt. Bestehende Datensätze werden nicht geändert. Die Zieltabelle muß bereits existieren.

batUpdate	Es werden die Datensätze der Zieltabelle geändert, deren Schlüsselfelder mit den entsprechenden Feldern der Quelltabelle übereinstimmen, so daß sie insgesamt mit den Datensätzen der Quelltabelle übereinstimmen. Es werden keine neuen Datensätze eingefügt. Die Zieltabelle muß bereits existieren und mit einem Index versehen sein.

batAppendUpdate	Es werden die Datensätze der Zieltabelle geändert, deren Schlüsselfelder mit den entsprechenden Feldern der Quelltabelle übereinstimmen, so daß sie insgesamt mit den Datensätzen der Quelltabelle übereinstimmen. Die Datensätze der Quelltabelle, deren Schlüsselfelder nicht übereinstimmen, werden in die Zieltabelle eingefügt. Die Zieltabelle muß bereits existieren und mit einem Index versehen sein.

batDelete	Es werden die Datensätze der Zieltabelle gelöscht, die mit Datensätzen der Quelltabelle übereinstimmen. Die Zieltabelle muß bereits existieren und mit einem Index versehen sein.

batCopy	Es wird eine Zieltabelle erstellt, die mit der Quelltabelle übereinstimmt. Existiert die Zieltabelle bereits, wird sie durch eine Kopie der Quelltabelle ersetzt.


TBatchMove::KeyViolCount

TBatchMove	Siehe auch

Die Eigenschaft KeyViolCount gibt die Anzahl der Datensätze an, die aufgrund von Integritäts- oder Schlüsselverletzungen nicht ersetzt, eingefügt oder aus der Zieltabelle gelöscht werden konnten.

__property long KeyViolCount;

Beschreibung

Mit KeyViolCount können Sie die Anzahl der Datensätze der Quelltabelle ermitteln, die aufgrund von Integritäts- oder Schlüsselverletzungen nicht in die Zieltabelle eingetragen werden konnten. Um eine Tabelle mit diesen Datensätzen anzulegen, legen Sie in der Eigenschaft KeyViolTableName einen Tabellennamen fest.

Schlüsselverletzungen treten auf, wenn Datensätze in eine Tabelle mit einem Primärschlüssel eingefügt werden. In einer Tabelle mit einem Primärschlüssel darf es keine zwei Datensätze geben, die dieselben Werte besitzen. Es kann kein Datensatz eingefügt werden, der in allen Schlüsselfeldern dieselben Werte wie ein Datensatz der Zieltabelle besitzt.

Integritätsverletzungen treten auf, wenn Datensätze aus einer Tabelle gelöscht, an eine Tabelle angefügt werden oder wenn eine Tabelle aktualisiert wird und die Tabelle referentielle Integrität besitzt. Für die Festlegung der referentiellen Integrität müssen bestimmte Felder einer Tabelle Werte enthalten, die in einem bestimmten Feld einer anderen Tabelle vorhanden sind. Datensätze, die den Anforderungen der referentiellen Integrität nicht entsprechen, können nicht eingefügt werden. Ein Datensatz kann nicht gelöscht werden, wenn dadurch die Beschränkungen der referentiellen Integrität verschärft würden, die eine andere Tabelle nicht erfüllen kann.

Hinweis

Hat AbortOnKeyViol den Wert True, ist KeyViolCount niemals größer als eins, da die Batch-Operation nach der ersten Verletzung abgebrochen wird.


TBatchMove::KeyViolTableName

TBatchMove	Siehe auch

Die Eigenschaft KeyViolTableName gibt den Namen einer zu erstellenden Paradox-Tabelle an. In dieser sind alle Datensätze der Quelltabelle enthalten, die aufgrund von Integritäts- oder Schlüsselverletzungen nicht in die Batch-Operation einbezogen werden können.

__property System::AnsiString KeyViolTableName;

Beschreibung

Mit KeyViolTableName können Sie den Namen einer Tabelle mit Datensätzen festlegen, die aufgrund von Integritäts- oder Schlüsselverletzungen nicht in die Zieltabelle eingetragen werden konnten. In KeyViolCount ist die Anzahl der Datensätze gespeichert, die in der erstellten Tabelle enthalten sind.

Schlüsselverletzungen treten auf, wenn Datensätze in eine Tabelle mit einem Primärschlüssel eingefügt werden. In einer Tabelle mit einem Primärschlüssel darf es keine zwei Datensätze geben, die dieselben Werte besitzen. Es kann kein Datensatz eingefügt werden, der in allen Schlüsselfeldern dieselben Werte wie ein Datensatz der Zieltabelle besitzt.

Integritätsverletzungen treten auf, wenn Datensätze aus einer Tabelle gelöscht, an eine Tabelle angefügt werden oder wenn eine Tabelle aktualisiert wird und die Tabelle referentielle Integrität besitzt. Für die Festlegung der referentiellen Integrität müssen bestimmte Felder einer Tabelle Werte enthalten, die in einem bestimmten Feld einer anderen Tabelle vorhanden sind. Datensätze, die den Anforderungen der referentiellen Integrität nicht entsprechen, können nicht eingefügt werden. Ein Datensatz kann nicht gelöscht werden, wenn dadurch die Beschränkungen der referentiellen Integrität verschärft würden, die eine andere Tabelle nicht erfüllen kann.

Hinweis

Hat AbortOnKeyViol den Wert True, enthält diese Tabelle höchstens einen Datensatz, da die Operation mit diesem ersten Datensatz beendet wird.


TBatchMove::Mappings

TBatchMove	Siehe auch

Die Eigenschaft legt die Spaltenzuordnungen für eine Batch-Operation fest.

__property Classes::TStrings* Mappings;

Beschreibung

Durch Einstellen von Mappings können Sie die Zuordnungen zwischen den Feldern der Quelltabelle und den Feldern der Zieltabelle festlegen. Per Voreinstellung wird eine Zuordnung vorausgesetzt, die sich aus der Position der Felder in der Quell- und Zieltabelle ergibt. Mit Mappings kann in einer Anwendung diese Vorgabe umgangen werden.

Die Eigenschaft Mappings ist eine Liste der Spaltenzuordnungen (eine pro Zeile) in einem von zwei Formularen. Um die Spalte ColName der Quelltabelle der Spalte der Zieltabelle mit demselben Namen zuzuordnen, verwenden Sie folgende Syntax:

Um die Spalte SourceColName der Quelltabelle der Spalte DestColName der Zieltabelle zuzuordnen, verwenden Sie folgende Syntax:

Beim Einfügen oder Anhängen von Datensätzen werden die Felder in der Zieltabelle auf NULL gesetzt, die in Mappings nicht eingetragen sind. In der Kopie einer Datenmenge erscheinen dann solche Felder auch nicht als Spalten.

Stimmen die Datentypen der Spalten von Quell- und Zieltabelle nicht überein, kann TBatchMove entweder die Batch-Operation abbrechen oder eine bestmögliche Anpassung vornehmen. Hat AbortOnProblem den Wert True, wird die Stapelverarbeitung durch nicht übereinstimmende Feldtypen beendet. Andernfalls werden, wenn möglich, die Feldwerte der Quelltabelle umgewandelt, so daß sie zur Zieltabelle kompatibel sind.


TBatchMove::Mode

TBatchMove	Siehe auch

Die Eigenschaft Mode gibt das Verhalten des Objekts TBatchMode nach dem Aufruf der Methode Execute an.

__property TBatchMode Mode;

Beschreibung

Mit der Eigenschaft Mode können Sie festlegen, ob das Objekt TBatchMove Datensätze einfügen, ersetzen oder löschen oder die Quelltabelle kopieren soll. Im folgenden finden Sie die möglichen Werte für Mode:

Wert	Bedeutung

batAppend	Die Datensätze der Quelltabelle werden in die Zieltabelle eingefügt. Die Zieltabelle muß bereits existieren. Dies ist der Standardmodus.

batUpdate	Die Datensätze der Zieltabelle werden durch die übereinstimmenden Datensätze der Quelltabelle ersetzt. Die Zieltabelle muß existieren und mit einem geeigneten Index versehen sein.

batAppendUpdate	Falls in der Zieltabelle ein übereinstimmender Datensatz enthalten ist, wird er ersetzt. Andernfalls werden die Datensätze in die Zieltabelle eingefügt. Die Zieltabelle muß existieren und mit einem geeigneten Index versehen sein.

batCopy	Die Zieltabelle wird mit der Struktur der Quelltabelle erstellt. Falls die Zieltabelle bereits existiert, wird sie bei der Operation gelöscht und durch die neue Kopie der Quelltabelle ersetzt.

batDelete	Es werden die Datensätze der Zieltabelle gelöscht, die mit Datensätzen der Quelltabelle übereinstimmen. Die Zieltabelle muß bereits existieren und mit einem Index versehen sein.


TBatchMove::MovedCount

TBatchMove	Siehe auch

Die Eigenschaft MovedCount gibt die Anzahl der Datensätze der Quelltabelle an, die in die Zieltabelle eingetragen wurden.

__property long MovedCount;

Beschreibung

Mit der Eigenschaft MovedCount können Sie die Anzahl der Datensätze der Quelltabelle ermitteln, die während der Ausführung der Methode Execute gelesen wurden. Der Wert von MovedCount enthält alle Datensätze, die Schlüssel- oder Integritätsverletzungen hervorgerufen haben, oder die angepaßt wurden.


TBatchMove::ProblemCount

TBatchMove	Siehe auch

Die Eigenschaft ProblemCount gibt die Anzahl der Datensätze an, die wegen fehlender Übereinstimmung des Feldtyps nicht ohne Datenverlust in die Zieltabelle eingefügt werden konnten.

__property long ProblemCount;

Beschreibung

Mit ProblemCount können Sie die Anzahl der Datensätze der Quelltabelle mit Feldwerten ermitteln, die keinem Feld der Zieltabelle zugeordnet werden konnten, ohne daß sie abgeschnitten wurden. Ist in der Eigenschaft ProblemTableName ein Tabellenname festgelegt, enthält ProblemCount die Anzahl der Datensätze dieser Tabelle.

Das Anpassen eines Feldes bedeutet, daß sein Wert so umgewandelt wird, daß er zum Typ des Zielfeldes kompatibel ist. Ist beispielsweise in einem Feld der Zieltabelle ein String mit zehn Zeichen gespeichert und enthält das entsprechende Feld der Quelltabelle einen String mit 15 Zeichen, müssen alle Werte der Quelltabelle mit mehr als zehn Zeichen abgeschnitten werden. Nicht konvertierbare Werte bewirken, daß TBatchMove eine Exception generiert.

Die Anpassung erfolgt nicht, wenn die Eigenschaft Mode auf batCopy eingestellt ist. Das Anpassen von Feldern bei einer Löschung bedeutet, daß möglicherweise Datensätze der Zieltabelle gelöscht werden, die nicht exakt mit den Werten der Quelltabelle übereinstimmen.

Hinweis

Hat AbortOnProblem den Wert True, ist der Wert von ProblemCount höchstens eins, da die Operation beim Auftreten des Problems abgebrochen wird.


TBatchMove::ProblemTableName

TBatchMove	Siehe auch

Die Eigenschaft ProblemTableName legt den Namen der zu erstellenden Paradox-Tabelle fest. In dieser sind alle Datensätze der Quelltabelle enthalten, die angepaßt wurden, damit sie mit dem entsprechenden Feldtyp der Zieltabelle übereinstimmen.

__property System::AnsiString ProblemTableName;

Beschreibung

Mit ProblemTableName können Sie eine Tabelle erstellen. In dieser werden die Datensätze der Quelltabelle mit Feldern gespeichert, die beim Eintragen in die Zieltabelle angepaßt werden mußten. Die Eigenschaft ProblemCount enthält die Anzahl der Datensätze dieser neuen Tabelle. Wird ProblemTableName kein Wert zugewiesen, werden die Daten des Datensatzes beim Eintragen in die Zieltabelle trotzdem angepaßt. Die veränderten Werte können jedoch später nur sehr schwer identifiziert werden.

Das Anpassen eines Feldes bedeutet, daß sein Wert so umgewandelt wird, daß er zum Typ des Zielfeldes kompatibel ist. Ist beispielsweise in einem Feld der Zieltabelle ein String mit zehn Zeichen gespeichert und enthält das entsprechende Feld der Quelltabelle einen String mit 15 Zeichen, müssen alle Werte der Quelltabelle mit mehr als zehn Zeichen abgeschnitten werden. Nicht konvertierbare Werte bewirken, daß TBatchMove eine Exception generiert.

Die Anpassung erfolgt nicht, wenn die Eigenschaft Mode auf batCopy eingestellt ist. Das Anpassen von Feldern bei einer Löschung bedeutet, daß möglicherweise Datensätze der Zieltabelle gelöscht werden, die nicht exakt mit den Werten der Quelltabelle übereinstimmen.

Hinweis

Hat AbortOnKeyProblem den Wert True, enthält diese Tabelle höchstens einen Datensatz, da die Operation mit dem ersten problematischen Datensatz abgebrochen wird.


TBatchMove::RecordCount

TBatchMove	Siehe auch

Die Eigenschaft RecordCount legt die maximale Anzahl von Datensätzen fest, die bei einem Aufruf von Execute in die Zieltabelle eingetragen werden.

__property long RecordCount;

Beschreibung

Mit RecordCount können Sie die Anzahl der Quelldatensätze begrenzen, die in die Zieltabelle eingetragen werden. Hat die Eigenschaft den Wert Null, werden alle Datensätze beginnend mit dem ersten Datensatz der Quelltabelle eingefügt, entfernt oder kopiert. Ist RecordCount größer als Null, wird maximal die eingestellte Anzahl von Datensätzen in die Zieltabelle eingetragen. Begonnen wird mit dem aktuellen Datensatz der Datenmenge. Ist RecordCount größer als die Anzahl der verbleibenden Datensätze der Quelltabelle, wird die Operation beendet und nicht am Anfang der Tabelle fortgesetzt.


TBatchMove::Source

TBatchMove	Siehe auch

Die Eigenschaft Source gibt die Datenmenge an, die als Quelle der Batch-Operation verwendet wird.

__property Db::TDataSet* Source;

Beschreibung

Mit Source können Sie die Datenmenge mit den Datensätzen festlegen, die in die Zieltabelle eingefügt, aus der Zieltabelle entfernt oder in die Zieltabelle kopiert werden. Der Ablauf der Operation wird durch diese Konstanten gesteuert:

Modus	Auswirkung auf Zieltabelle

batAppend	Datensätze werden in die Zieltabelle eingefügt.

batUpdate	Es werden die Datensätze der Zieltabelle geändert, deren Schlüsselfelder mit den entsprechenden Feldern der Quelltabelle übereinstimmen, so daß sie mit den Datensätzen der Quelltabelle übereinstimmen.

batAppendUpdate	Es werden die Datensätze der Zieltabelle geändert, deren Schlüsselfelder mit den entsprechenden Feldern der Quelltabelle übereinstimmen, so daß sie mit den Datensätzen der Quelltabelle übereinstimmen. Die Datensätze der Quelltabelle, deren Schlüsselfelder nicht übereinstimmen, werden in die Zieltabelle eingefügt.

batDelete	Es werden die Datensätze der Zieltabelle gelöscht, die mit Datensätzen der Quelltabelle übereinstimmen.

batCopy	Es wird eine Zieltabelle erstellt, die mit der Quelltabelle übereinstimmt.


TBatchMove::Transliterate

TBatchMove	Siehe auch

Die Eigenschaft Transliterate legt fest, ob die Daten der Quelldatensätze beim Aufruf der Methode Execute vom Zeichensatz der Quelltabelle zum Zeichensatz der Zieltabelle konvertiert werden sollen.

__property bool Transliterate;

Beschreibung

Stellen Sie Transliterate auf True ein, wenn für die Quelldatenmenge und die Zieltabelle verschiedene Sprachtreiber verwendet werden und die Daten möglicherweise Zeichen des erweiterten ASCII-Codes enthalten. Stellen Sie Transliterate auf False ein, um den Zusatzaufwand der Zeichensatzumwandlung zu vermeiden, wenn für die Quelle und das Ziel derselbe Sprachtreiber verwendet wird oder die Daten keine Zeichen des erweiterten ASCII-Codes enthalten.


Methoden von TBatchMove

TBatchMove	Alphabetisch

In TBatchMove

~TBatchMove

Execute

TBatchMove

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TBatchMove

TBatchMove	Nach Objekten

~TBatchMove

Assign

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

DestroyComponents

Destroying

Dispatch

Execute

FieldAddress

FindComponent

FreeInstance

FreeNotification

Free

GetParentComponent

HasParent

InheritsFrom

InitInstance

InsertComponent

InstanceSize

MethodAddress

MethodName

NewInstance

RemoveComponent

TBatchMove


TBatchMove::~TBatchMove

TBatchMove	Siehe auch

Der Destruktor ~TBatchMove gibt den Speicher frei, der für das TBatchMove-Objekt reserviert war. Rufen Sie ~TBatchMove nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TBatchMove automatisch aufgerufen wird.

__fastcall virtual ~TBatchMove(void);

Beschreibung

Vor dem Aufruf des geerbten Destruktors gibt ~TBatchMove das TStringList-Objekt frei, das die Eigenschaft Mappings implementiert.


TBatchMove::Execute

TBatchMove	Siehe auch

Mit der Methode Execute können Sie die Batch-Operation durchführen, die in Mode festgelegt ist.

void __fastcall Execute(void);

Beschreibung

Nachdem Sie in den Eigenschaften angegeben haben, welche Batch-Operation wie durchgeführt werden soll, können Sie die Operation mit Execute starten. Sie müssen mindestens die Eigenschaften Mode, Source und Destination einstellen.

Nach dem Aufruf von Execute sind die Werte der Eigenschaften ChangedCount, KeyViolCount, MovedCount, ProblemCount und RecordCount verfügbar. Diese Eigenschaften zeigen an, welche Ergebnisse Execute gebracht hat. Zusätzliche Informationen über die Batch-Operationen können Sie erhalten, wenn Sie gegebenenfalls eine Änderungstabelle, eine Schlüsselverletzungstabelle und/oder eine Problemtabelle erstellen.


TBatchMove::TBatchMove

TBatchMove	Siehe auch

TBatchMove erzeugt eine Instanz von TBatchMove.

__fastcall virtual TBatchMove(Classes::TComponent* AOwner);

Beschreibung

Mit TBatchMove können Sie eine Instanz von TBatchMove erstellen, um eine Batch-Operation durchzuführen. Dem Objekt TBatchMove wird Speicher zugewiesen. Außerdem werden folgende Initialisierungen vorgenommen:

•	AbortOnKeyViolation wird auf True eingestellt.

•	AbortOnProblem wird auf True eingestellt.

•	Transliterate wird auf True eingestellt.

•	Es wird ein Objekt der Klasse TStringList erstellt, in dem die Zuordnungen gespeichert werden.

Von TBatchMove werden in den Eigenschaften die Werte eingestellt, die von einem TTable-Objekt bei der Durchführung von Batch-Operationen mit der Methode BatchMove verwendet werden.


Gültigkeitsbereich

Published

Zugriff

Read-only


Hierarchie

TObject

TPersistent

TComponent


TBatchMove Beispiel

TBatchMove


TBCDField

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/dbtables.hpp

Ein TBCDField-Objekt repräsentiert ein binärcodiertes Dezimalfeld (BCD) in einer Datenmenge.

Beschreibung

BCD-Werte bieten eine größere Präzision und Genauigkeit als Gleitkommazahlen. BCD-Felder werden normalerweise für die Speicherung und Bearbeitung von Währungswerten eingesetzt. Diese Werte werden in den meisten Fällen in der dezimalen Form (Basis zehn) gespeichert und verwaltet. Borland C++Builder verfügt jedoch nicht über einen eigenen binärcodierten Dezimaltyp. Aus diesem Grund wird in TBCDField der Typ Currency zur Bearbeitung von BCD-Werten verwendet. Currency ist ein binäres Format (Basis zwei):

Da in TBCDField der Typ Currency zur Bearbeitung von Daten aus BCD-Feldern eingesetzt wird, ist die Genauigkeit von BCD-Feldern auf 4 Dezimalstellen und 20 signifikante Stellen beschränkt. Die zugrundeliegende Datenbanktabelle kann Werte enthalten, die eine größere Genauigkeit erfordern. Wenn TBCDField auf derartige Werte trifft, tritt eine Exception auf.

TBCDField umfaßt als Nachkomme von TNumericField viele Eigenschaften, Methoden und Ereignisse, die für die Bearbeitung von Werten und Eigenschaften numerischer Felder in einer Datenbank von Nutzen sind.


Eigenschaften von TBCDField

TBCDField	Alphabetisch	Legende

In TBCDField

Currency

MaxValue

MinValue

Value

Abgeleitet von TNumericField

DisplayFormat

EditFormat

Abgeleitet von TField

Alignment

AsBoolean

AsCurrency

AsDateTime

AsFloat

AsInteger

AsString

AsVariant

AttributeSet

BDECalcField

Calculated

CanModify

DataSet

DataSize

DataType

DisplayLabel

DisplayName

DisplayText

DisplayWidth

EditMask

EditMaskPtr

FieldKind

FieldName

FieldNo

Index

IsIndexField

IsNull

KeyFields

Lookup

LookupDataSet

LookupKeyFields

LookupResultField

NewValue

OldValue

ReadOnly

Required

Size

Text

Visible

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Name

Owner

Tag


Eigenschaften von TBCDField

TBCDField	Nach Objekten	Legende

Alignment

AsBoolean

AsCurrency

AsDateTime

AsFloat

AsInteger

AsString

AsVariant

AttributeSet

BDECalcField

Calculated

CanModify

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

Currency

DataSet

DataSize

DataType

DesignInfo

DisplayFormat

DisplayLabel

DisplayName

DisplayText

DisplayWidth

EditFormat

EditMaskPtr

EditMask

FieldKind

FieldName

FieldNo

Index

IsIndexField

IsNull

KeyFields

LookupDataSet

LookupKeyFields

LookupResultField

Lookup

MaxValue

MinValue

Name

NewValue

OldValue

Owner

ReadOnly

Required

Size

Tag

Text

Value

Visible


TBCDField::Currency

TBCDField	Siehe auch

Die Eigenschaft Currency legt fest, ob der Wert im Feld als Währungswert formatiert werden soll.

__property System::Currency MinValue;

Beschreibung

Mit Hilfe der Eigenschaft Currency können Sie festlegen, wie der Wert im Feld für die Anzeige und die Bearbeitung in einen datensensitiven Steuerelement formatiert werden soll.

Für Anzeigezwecke wird das Feld mit der Eigenschaft DisplayFormat formatiert, falls diese zugewiesen ist.  Wurde DisplayFormat nicht zugewiesen, legt Currency fest, wie das Feld für die Anzeige formatiert wird. Wenn Curreny True ist, wird der Wert für die Anzeige über die Funktion FloatToText mit dem Formatierungscode ffCurrency formatiert. Ist Currency False, wird der Wert mit dem Format ffGeneral formatiert.

Für Bearbeitungszwecke wird das Feld mit der Eigenschaft EditFormat (oder DisplayFormat) formatiert, falls diese zugewiesen ist.  Ist weder EditFormat noch DisplayFormat zugewiesen, wird mit Currency festgelegt, wie das Feld für die Bearbeitung formatiert wird. Wenn Curreny True ist, wird der Wert für die Bearbeitung über die Funktion FloatToText mit dem Formatierungscode ffFixed formatiert. Ist Currency False, wird der Wert mit dem Format ffGeneral formatiert.


TBCDField::MaxValue

TBCDField	Siehe auch

Die Eigenschaft MaxValue legt den maximalen Wert in einem binärcodierten Dezimalfeld fest.

__property System::Currency MaxValue;

Beschreibung

Mit MaxValue ermitteln oder bestimmen Sie den Maximalwert, der in das Feld eingegeben werden kann. Wird ein Wert eingegeben, der größer als MaxValue ist, tritt eine EDatabaseError-Exception auf.

Neu erstellte BCD-Felder setzen MaxValue auf den Maximalwert, der mit dem Datentyp Currency dargestellt werden kann.


TBCDField::MinValue

TBCDField	Siehe auch

Die Eigenschaft MinValue legt den minimalen Wert für ein binärcodiertes Dezimalfeld fest.

__property System::Currency MinValue;

Beschreibung

Mit MinValue ermitteln oder bestimmen Sie den Minimalwert, der in das Feld eingegeben werden kann. Wird ein Wert eingegeben, der kleiner als MinValue ist, tritt eine EDatabaseError-Exception auf.

Neu erstellte Integer-Felder setzen MinValue auf den Minimalwert, der mit dem Datentyp Currency dargestellt werden kann.


Size

Die Eigenschaft Size gibt die Anzahl der Dezimalstellen an, die in der binärcodierten Dezimaldarstellung der Felddaten unterstützt wird.

__property Size;

Beschreibung

Mit Size wird die Anzahl der Dezimalstellen in der binärcodierten Dezimalrepräsentation der Felddaten in den physischen Datenbanktabellen festgelegt. Der Standardwert von Size für BCD-Felder beträgt 4 Dezimalstellen.

Hinweis

Verwechseln Sie die Eigenschaft Size nicht mit der Eigenschaft DataSize. Letztere gibt die Anzahl der Bytes an, die für die Speicherung des Wertes im BCD-Feld erforderlich sind.


TBCDField::Value

TBCDField	Siehe auch

Die Eigenschaft Value ist der Wert des BCD-Feldes in Form eines Währungswertes.

__property System::Currency Value;

Beschreibung

Im Unterschied zu anderen Feldtypen entspricht der Typ Value eines BCD-Feldes nicht genau dem physischen Format der Daten, die in der zugrundeliegenden Datenbanktabelle gespeichert sind. Borland C++Builder besitzt keinen eigenen Typ für binärcodierte Dezimalzahlen. Aus diesem Grund konvertiert TBCDField die Daten aus einem binärcodierten Dezimalwert in einen Währungswert, wenn die Daten aus der Datenbanktabelle abgerufen werden, und die Daten aus einem Währungswert in einen binärcodierten Dezimalwert, wenn sie in die Datenbanktabelle eingetragen werden. Für BCD-Felder hat die Eigenschaft Value dieselbe Funktion wie die Eigenschaft AsCurrency.

Hinweis

Da TBCDField seine Daten als Währungswert bearbeitet, kann das einfache Ermitteln eines Feldwertes und das Zurückschreiben dieses Wertes in die Datenbanktabelle den Inhalt des Feldes ändern. Also wird durch die Codezeile

MyBCDField.SetData(MyBCDField.Value);

der Inhalt des Feldes in der Datenbanktabelle unter Umständen geändert.


Ereignisse von TBCDField

TBCDField	Alphabetisch	Legende

Abgeleitet von TField

OnChange

OnGetText

OnSetText

OnValidate


Ereignisse von TBCDField

TBCDField	Nach Objekten	Legende

OnChange

OnGetText

OnSetText

OnValidate


Methoden von TBCDField

TBCDField	Alphabetisch

In TBCDField

~TBCDField

IsValidChar

SetCurrency

SetMaxValue

SetMinValue

TBCDField

Abgeleitet von TField

Assign

AssignValue

Clear

FocusControl

GetData

SetData

SetFieldType

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TBCDField

TBCDField	Nach Objekten

~TBCDField

Assign

AssignValue

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

Clear

DefaultHandler

DestroyComponents

Destroying

Dispatch

FieldAddress

FindComponent

FocusControl

FreeInstance

FreeNotification

Free

GetData

GetParentComponent

HasParent

InheritsFrom

InitInstance

InsertComponent

InstanceSize

IsValidChar

MethodAddress

MethodName

NewInstance

RemoveComponent

SetCurrency

SetData

SetFieldType

SetMaxValue

SetMinValue

TBCDField


TBCDField::~TBCDField

TBCDField

Der Destruktor ~TBCDField gibt den Speicher frei, der für das TBCDField-Objekt reserviert war. Rufen Sie ~TBCDField nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TBCDField automatisch aufgerufen wird.

__fastcall virtual ~TBCDField(void);


TBCDField::IsValidChar

TBCDField	Siehe auch

Die Methode IsValidChar stellt fest, ob das angegebene Zeichen für ein binärcodiertes Dezimalfeld gültig ist.

virtual bool __fastcall IsValidChar(char Ch);

Beschreibung

Rufen Sie IsValidChar auf, wenn festgestellt werden soll, ob ein Zeichen, das als Wert für den Parameter InputChar angegeben wird, ein gültiges Zeichen für ein binärcodiertes Dezimalfeld ist.

Folgende Zeichen sind in einem binärcodierten Dezimalfeld zulässig: +, -, die Ziffern 0 bis 9 und das Zeichen, das in Windows als Dezimaltrennzeichen definiert ist. Wenn es sich bei InputChar um eines dieser Zeichen handelt, liefert IsValidChar True zurück. Für alle anderen Zeichen liefert IsValidChar False zurück.

Mit Hilfe von IsValidChar prüfen viele datensensitive Steuerelemente, ob ein in ein Feld eingegebenes Zeichen gültig ist.


TBCDField::TBCDField

TBCDField	Siehe auch

TBCDField erzeugt eine Instanz von TBCDField.

__fastcall virtual TBCDField(Classes::TComponent* AOwner);

Beschreibung

Mit dem Konstruktor TBCDField wird eine Instanz von TBCDField erzeugt und initialisiert. Nach dem Aufurf des geerbten Konstruktors setzt TBCDField die Eigenschaft DataType auf ftBCD und initialisiert die Eigenschaft Size mit 4.

Es ist nur selten notwendig, TBCDField explizit aufzurufen, da für alle BCD-Felder in einer Datenmenge die entsprechenden Komponenten automatisch instantiiert werden.


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TField

TNumericField


TBCDField Beispiel

TBCDField


TBDECallback

Hierarchie	Methoden	Siehe auch

Header

vcl/dbtables.hpp

TBDECallback kapselt eine Callback-Funktion der Borland Database Engine (BDE).

Beschreibung

Mit einem TBDECallback-Objekt wird eine Callback-Funktion bei der BDE registriert. Mit einer solchen Funktion steuert die Anwendung, wie die BDE auf bestimmte Ereignisse reagiert, die während eines BDE-Funktionsaufrufs ausgelöst werden.

Beispielsweise könnte es zu einem Problem kommen, während das TBatchMove-Objekt die zugehörige BDE-Stapeloperation ausführt. Eine Callback-Funktion kann auf solche Probleme reagieren, indem die BDE angewiesen wird, die Situation zu protokollieren oder die Daten so anzupassen, daß die Operation erfolgreich abgeschlossen wird.

Die Verwendung eines TBDECallback-Objekts erfordert die folgenden Schritte:

1	Erzeugen Sie eine Instanz von TBDECallback, um die Callback-Funktion bei der BDE zu registrieren.

2	Rufen Sie die BDE-Funktion auf, in der die passenden Ereignisse stattfinden. Erzeugen Sie beispielsweise eine Instanz von TBatchMove, und rufen Sie deren Methode Execute auf.

3	Sobald die BDE-Funktion zurückkehrt, geben Sie das TBDECallback-Objekt frei, um die Registrierung der Callback-Funktion aufzuheben.


Methoden von TBDECallback

TBDECallback	Alphabetisch

In TBDECallback

~TBDECallback

TBDECallback

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TBDECallback

TBDECallback	Nach Objekten

~TBDECallback

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance

TBDECallback


TBDECallback::~TBDECallback

TBDECallback	Siehe auch

Der Destruktor ~TBDECallback gibt den Speicher frei, der für das TBDECallback-Objekt reserviert war. Rufen Sie ~TBDECallback nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TBDECallback automatisch aufgerufen wird.

__fastcall virtual ~TBDECallback(void);

Beschreibung

~TBDECallback hebt die Registrierung der Callback-Funktion auf und gibt dann den Speicher frei, der dem TBDECallback-Objekt zugeordnet war. Eine eventuell vorher vorhandene Callback-Funktion wird wieder aktiviert.


TBDECallback::TBDECallback

TBDECallback	Siehe auch

Die Methode TBDECallback erzeugt eine Instanz von TBDECallback und registriert die angegebene Callback-Funktion bei der Borland Database Engine (BDE).

__fastcall TBDECallback(System::TObject* AOwner, Bde::hDBICur Handle, Bde::CBType CBType, void * CBBuf, int CBBufSize, TBDECallbackEvent CallbackEvent, bool Chain);

Beschreibung

Mit TBDECallback wird eine Callback-Funktion bei der BDE registriert. Erzeugen Sie ein TBDECallback-Objekt, bevor eine BDE-Funktion aufgerufen wird, die bei der Reaktion auf Ereignisse auf diese Callback-Funktion zugreift.

Sobald die BDE auf den Ereignistyp stößt, der mit dem Parameter CBType bezeichnet ist, wird die vom Parameter CallbackEvent vorgegebene Funktion aufgerufen. Diese empfängt einen Zeiger auf den Deskriptor einer Callback-Funktion. Der Typ des Deskriptors richtet sich nach CBType. Die Borland C++Builder-Anwendung muß ihm Speicher zuweisen. Ein Zeiger auf diesen Speicher wird im Parameter CBBuf übergeben, und seine Größe wird von CBBufSize festgelegt.

Der Parameter Chain steuert, ob diese Callback-Funktion andere desselben Typs (CBType) ersetzen soll. Wenn Chain den Wert False hat, ersetzt die mit CallbackEvent bezeichnete Funktion alle Callback-Funktionen, die als CBType registriert sind. Wenn Chain den Wert True hat, wird die Callback-Funktion zusätzlich zu anderen registrierten Funktionen aufgerufen.

Der Parameter Handle ist optional und bezeichnet den Datenbank-Cursor, der zu der BDE-Funktion gehört, welche die Callback-Funktion auslöst.

Der Parameter CBType definiert verschiedene Deskriptoren für die Callback-Funktion (siehe Tabelle). Weitere Informationen finden Sie in der BDE-Dokumentation:

CBType	Verwendung	Deskriptor

cbGENPROGRESS	Auswertung von Informationen über umfangreichere Batch-Operationen. Dazu kann beispielsweise eine Fortschrittsanzeige oder eine Abbruch-Schaltfläche implementiert werden. Für den Abbruch muß cbrABORT zurückgegeben werden, für die Fortsetzung cbrCONTINUE.	CBPROGRESSDesc

cbRESTRUCTURE	Festlegen, wie die BDE Situationen verarbeitet, die während der Umstrukturierung einer Tabelle auftreten. Für die Fortsetzung der Standardverarbeitung muß cbrYES zurückgegeben werden. Die Fortsetzung ohne Standardverhalten wird mit cbrNO signalisiert. Der Abbruch der Umstrukturierung wird mit cbrABORT ausgelöst.	CBRESTCbDesc

cbBATCHRESULT	Festlegen, wie die BDE bestimmte Situationen verarbeitet, die während einer Batch-Operation auftreten. Für die Fortsetzung der Standardverarbeitung muß cbrYES zurückgegeben werden. Die Fortsetzung ohne Standardverhalten wird mit cbrNO signalisiert. Der Abbruch der Batch-Operation wird mit cbrABORT ausgelöst.	CBRESTDbDesc

cbTABLECHANGED	Auf Benachrichtigungen reagieren, die besagen, daß sich die Tabelle geändert hat. Der Rückgabewert wird ignoriert.	nicht verwendet

cbCANCELQRY	Eine längere Abfrage mit cbrABORT abbrechen oder mit cbrCONTINUE fortsetzen. Die Callback-Funktion wird in regelmäßigen Abständen aufgerufen, während die Abfrage ausgeführt wird.	nicht verwendet

cbINPUTREQ	Festlegen, wie die BDE auf fehlende Dateien, z.B. eine fehlende Lookup-Tabelle, reagieren soll. Das gewählte Verhalten wird in CBInputDesc angegeben, und cbrCONTINUE wird zurückgegeben.	CBInputDesc

cbDBASELOGIN	Kennwort für eine verschlüsselte dBASE-Tabelle übergeben und cbrCONTINUE zurückgeben.	CBLoginDesc

cbFIELDRECALC	Auf Benachrichtigungen reagieren, daß Felder neu berechnet werden müssen. Der Rückgabewert wird ignoriert.	nicht verwendet

cbTRACE	Auf Protokollinformationen reagieren, die nach BDE-Aktionen angefertigt wurden. Der Rückgabewert wird ignoriert.	TRACEDesc

cbDBLOGIN	Anmelden bei einem Datenbank-Server. Rückgabewert cbrCONTINUE.	nicht verwendet

cbDELAYEDUPD	Auf Benachrichtigungen reagieren, wenn während des Eintragens von zwischengespeicherten Aktualisierungen ein geänderter Datensatz nicht in die Datenbank geschrieben werden kann. Mit dem Rückgabewert cbrABORT wird die Aktualisierung abgebrochen, mit cbrSKIP fortgesetzt, und mit cbrCONTINUE wird die fehlgeschlagene Aktualisierung verworfen und mit dem Eintragen fortgefahren. Der Rückgabewert cbrRETRY löst einen erneuten Commit-Versuch aus.	DELAYUPDCbDesc

Hinweis

Borland C++Builder verwendet viele BDE-Callback-Funktionen. Wenn TBDECallback aufgerufen wird und Chain den Wert False hat, verhalten sich einige Objekte eventuell nicht so wie gewünscht.


Hierarchie

TObject


TBDECallback Beispiel

TBDECallback


 TBevel

Hierarchie	Eigenschaften	Methoden

Header

vcl/extctrls.hpp

TBevel repräsentiert eine Umrandung mit einer abgeschrägten Kante.

Beschreibung

Mit der Komponente TBevel lassen sich Rechtecke, Rahmen oder Linien mit einer Schrägkante erzeugen. Die Schrägkante kann erhaben oder abgesenkt angezeigt werden. Die Darstellungsweise wird über die Eigenschaft Style angegeben. Die Eigenschaft Shape legt fest, ob ein Rechteck, ein Rahmen oder eine Linie mit Schrägkante erstellt wird.


Eigenschaften von TBevel

TBevel	Alphabetisch	Legende

In TBevel

Shape

Style

Abgeleitet von TControl

Align

BoundsRect

ClientHeight

ClientOrigin

ClientRect

ClientWidth

ControlState

ControlStyle

Cursor

Enabled

Height

Hint

Left

Name

Parent

ParentShowHint

ShowHint

Top

Visible

Width

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TBevel

TBevel	Nach Objekten	Legende

Align

BoundsRect

ClientHeight

ClientOrigin

ClientRect

ClientWidth

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlState

ControlStyle

Cursor

DesignInfo

Enabled

Height

Hint

Left

Name

Owner

ParentShowHint

Parent

Shape

ShowHint

Style

Tag

Top

Visible

Width


TBevel::Shape

TBevel

Shape legt den Umriß des Bevel-Objekts fest.

__property TBevelShape Shape;

Beschreibung

Folgende Werte stehen für die Eigenschaft Shape zur Verfügung:

Wert	Bedeutung

bsBox	Rechteck

bsFrame	Rahmen

bsTopLine	Die Schrägkante wird als Linie am oberen Rand des Steuerelements gezeichnet.

bsBottomLine	Die Schrägkante wird als Linie am unteren Rand des Steuerelements gezeichnet.

bsLeftLine	Die Schrägkante wird als Linie am linken Rand des Steuerelements gezeichnet.

bsRightLine	Die Schrägkante wird als Linie am rechten Rand des Steuerelements gezeichnet.


TBevel::Style

TBevel

Die Eigenschaft Style legt fest, ob die Schrägkante erhaben oder abgesenkt dargestellt wird.

__property TBevelStyle Style;

Beschreibung

Folgende Werte stehen für die Eigenschaft Style zur Verfügung:

Wert	Bedeutung

bsLowered	Die Schrägkante wird abgesenkt dargestellt.

bsRaised	Die Schrägkante wird erhaben dargestellt.


Methoden von TBevel

TBevel	Alphabetisch

In TBevel

~TBevel

TBevel

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

GetTextLen

Hide

Invalidate

Perform

Refresh

Repaint

ScreenToClient

SendToBack

SetBounds

SetTextBuf

Show

Update

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TBevel

TBevel	Nach Objekten

~TBevel

Assign

BeginDrag

BringToFront

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

ClientToScreen

DefaultHandler

DestroyComponents

Destroying

Dispatch

DragDrop

Dragging

EndDrag

FieldAddress

FindComponent

FreeInstance

FreeNotification

Free

GetParentComponent

GetTextBuf

GetTextLen

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InstanceSize

Invalidate

MethodAddress

MethodName

NewInstance

Perform

Refresh

RemoveComponent

Repaint

ScreenToClient

SendToBack

SetBounds

SetTextBuf

Show

TBevel

Update


TBevel::~TBevel

TBevel

Der Destruktor ~TBevel gibt den Speicher frei, der für das TBevel-Objekt reserviert war. Rufen Sie ~TBevel nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TBevel automatisch aufgerufen wird.

__fastcall virtual ~TBevel(void);


TBevel::TBevel

TBevel	Siehe auch

TBevel erzeugt und initialisiert ein TBevel-Objekt.

__fastcall virtual TBevel(Classes::TComponent* AOwner);

Beschreibung

TBevel erzeugt eine neue Instanz von TBevel. Die Eigenschaft Style ist auf bsLowered gesetzt, während für die Eigenschaft Shape bsBox festgelegt ist.


Gültigkeitsbereich

Published

Zugriff

Read-only


Hierarchie

TObject

TPersistent

TComponent

TControl

TGraphicControl


TBevel Beispiel

TBevel


TBinaryField

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/dbtables.hpp

Ein TBinaryField-Objekt repräsentiert ein nicht typisiertes binäres Feld in einer Datenmenge.

Beschreibung

TBinaryField ist ein abstraktes Objekt, in dem das fundamentale Verhalten gekapselt ist, das allen nicht typisierten binären Feldern gemeinsam ist. Neben den Eigenschaften, Methoden und Ereignissen, die allen Feldern gemeinsam sind und die von der Klasse TField bereitgestellt werden, implementiert TBinaryField auch die Eigenschaften, die zum Lesen und Schreiben von binären Daten aus der oder in die zugrundeliegende Datenbanktabelle erforderlich sind.

Erstellen Sie keine Instanzen von TBinaryField. TBinaryField-Nachkommen werden automatisch erstellt, sobald eine Datenmenge aktiviert wird.


Eigenschaften von TBinaryField

TBinaryField	Alphabetisch	Legende

In TBinaryField

Size

Abgeleitet von TField

Alignment

AsBoolean

AsCurrency

AsDateTime

AsFloat

AsInteger

AsString

AsVariant

AttributeSet

BDECalcField

Calculated

CanModify

DataSet

DataSize

DataType

DisplayLabel

DisplayName

DisplayText

DisplayWidth

EditMask

EditMaskPtr

FieldKind

FieldName

FieldNo

Index

IsIndexField

IsNull

KeyFields

Lookup

LookupDataSet

LookupKeyFields

LookupResultField

NewValue

OldValue

ReadOnly

Required

Text

Value

Visible

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Name

Owner

Tag


Eigenschaften von TBinaryField

TBinaryField	Nach Objekten	Legende

Alignment

AsBoolean

AsCurrency

AsDateTime

AsFloat

AsInteger

AsString

AsVariant

AttributeSet

BDECalcField

Calculated

CanModify

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

DataSet

DataSize

DataType

DesignInfo

DisplayLabel

DisplayName

DisplayText

DisplayWidth

EditMaskPtr

EditMask

FieldKind

FieldName

FieldNo

Index

IsIndexField

IsNull

KeyFields

LookupDataSet

LookupKeyFields

LookupResultField

Lookup

Name

NewValue

OldValue

Owner

ReadOnly

Required

Size

Tag

Text

Value

Visible


TBinaryField::Size

TBinaryField

Die Eigenschaft Size bezeichnet die Größe des binären Feldes.

__property Size;


Ereignisse von TBinaryField

TBinaryField	Alphabetisch	Legende

Abgeleitet von TField

OnChange

OnGetText

OnSetText

OnValidate


Ereignisse von TBinaryField

TBinaryField	Nach Objekten	Legende

OnChange

OnGetText

OnSetText

OnValidate


TBinaryField methods

TBinaryField	Alphabetish

In TBinaryField

~TBinaryField

TBinaryField

Derived from TField

Assign

AssignValue

Clear

FocusControl

GetData

IsValidChar

SetData

SetFieldType

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von BinaryField

TBinaryField	Nach Objekten

~TBinaryField

Assign

AssignValue

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

Clear

DefaultHandler

DestroyComponents

Destroying

Dispatch

FieldAddress

FindComponent

FocusControl

FreeInstance

FreeNotification

Free

GetData

GetParentComponent

HasParent

InheritsFrom

InitInstance

InsertComponent

InstanceSize

IsValidChar

MethodAddress

MethodName

NewInstance

RemoveComponent

SetData

SetFieldType

TBinaryField


TBinaryField::~TBinaryField

TBinaryField

Der Destruktor ~TBinaryField gibt den Speicher frei, der für das TBinaryField-Objekt reserviert war. Rufen Sie ~TBinaryField nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TBinaryField automatisch aufgerufen wird.

__fastcall virtual ~TBinaryField(void);


TBinaryField::TBinaryField

TBinaryField	Siehe auch

Der Konstruktor TBinaryField erzeugt ein neues TBinaryField-Objekt.

__fastcall virtual TBinaryField(Classes::TComponent* AOwner);

Beschreibung

Die Methode TBinaryField erzeugt und initialisiert eine Instanz von TBinaryField. Dazu wird die Methode TField::TField aufgerufen.


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TField


TBinaryField Beispiel

TBinaryField


 TBitBtn

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/buttons.hpp

TBitBtn ist eine Schaltfläche, die auf ihrer Oberfläche ein Bitmap darstellen kann.

Beschreibung

Bitmap-Schaltflächen verhalten sich wie gewöhnliche Schaltlfächen. Auch mit ihnen kann der Benutzer in Formularen und Dialogfeldern Aktionen auslösen.

Bitmap-Schaltflächen verfügen über zusätzliche Eigenschaften, die das Bitmap, die Art seiner Anzeige und seine Position auf der Schaltfläche festlegen. Sie können eine der vordefinierten Bitmap-Schaltflächen verwenden oder einer Schaltfläche eines Ihrer eigenen Bitmaps zuweisen. Jeder Schaltfläche wird genau ein Bitmap zugeordnet. Dieses Bitmap (Eigenschaft Glyph) kann jedoch in vier gleich große Teile unterteilt werden, die in Abhängigkeit vom Status der Schaltfläche angezeigt werden. Eine Schaltfläche kann gedrückt, nicht gedrückt oder deaktiviert sein (Mauspalettenschalter verwenden für den Status "dauerhaft gedrückt" den vierten Teil des Bitmaps).

Mit Hilfe der Eigenschaft Kind von TBitBtn können Sie auf einfache Weise Schaltflächen mit allgemeinen Funktionen wie OK, Abbrechen, Hilfe usw. erzeugen. Diese Schaltflächen verfügen bereits über die entsprechenden Bilder und Standardfunktionen, so daß Sie sie ohne viel Programmieraufwand in Ihrer Anwendung verwenden können.


Eigenschaften von TBitBtn

TBitBtn	Alphabetisch	Legende

In TBitBtn

Glyph

Kind

Layout

Margin

NumGlyphs

Spacing

Style

Abgeleitet von TButton

Cancel

ModalResult

Vorgabe

Abgeleitet von TWinControl

Brush

ClientOrigin

ClientRect

ControlCount

Controls

Handle

HelpContext

Showing

TabOrder

TabStop

Abgeleitet von TControl

Align

BoundsRect

Caption

ClientHeight

ClientWidth

ControlState

ControlStyle

Cursor

DragCursor

DragMode

Enabled

Font

Height

Hint

Left

Name

Parent

ParentFont

ParentShowHint

PopupMenu

ShowHint

Top

Visible

Width

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TBitBtn

TBitBtn	Nach Objekten	Legende

Align

BoundsRect

Brush

Cancel

Caption

ClientHeight

ClientOrigin

ClientRect

ClientWidth

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlCount

ControlState

Controls

ControlStyle

Cursor

DesignInfo

DragCursor

DragMode

Enabled

Font

Glyph

Handle

Height

HelpContext

Hint

Kind

Layout

Left

Margin

ModalResult

Name

NumGlyphs

Owner

ParentFont

ParentShowHint

Parent

PopupMenu

ShowHint

Showing

Spacing

Style

TabOrder

TabStop

Tag

Top

Visible

Vorgabe

Width


TBitBtn::Glyph

TBitBtn	Siehe auch	Beispiel

Die Eigenschaft Glyph gibt an, welches Bitmap auf der Schaltfläche angezeigt wird.

__property Graphics::TBitmap* Glyph;

Beschreibung

Im Dialogfeld öffnen, das mit der Ellipsen-Schaltfläche dieser Eigenschaft aufgerufen wird, können Sie die Bitmap-Datei (Erweiterung BMP) auswählen, die auf der Schaltfläche angezeigt werden soll. Sie können die Bitmap-Datei aber auch zur Laufzeit zuweisen.

In einem Bitmap können bis zu vier Bilder für eine Bitmap-Schaltfläche oder einen Mauspalettenschalter zur Verfügung gestellt werden. Abhängig vom Status der Schaltfläche zeigt Borland C++Builder eines dieser Bilder an.

Position des Bildes im Bitmap	Status der Schaltfläche	Beschreibung

Erstes Bild	Nicht gedrückt	Dieses Bild wird angezeigt, wenn die Schaltfläche nicht gedrückt ist (der normale Status der Schaltfläche), oder wenn sie den Fokus hat. In diesem Fall ist die Schaltfläche von einem Rechteck umgeben. Enthält das Bitmap keine weiteren Bilder, wird dieses Bild auch für alle anderen Zustände verwendet.

Zweites Bild	Deaktiviert	Dieses Bild wird normalerweise grau dargestellt, was bedeutet, daß die Schaltfläche nicht ausgewählt werden kann.

Drittes Bild	Gedrückt	Dieses Bild wird angezeigt, wenn auf eine Schaltfläche geklickt wird. Sobald die Maustaste losgelassen wird, erscheint wieder das Bild für den Status „nicht gedrückt“.

Wenn im Bitmap nur ein Bild vorhanden ist, versucht Borland C++Builder dieses für alle anderen Zustände jeweils leicht zu verändern. Der Status „dauerhaft gedrückt“ ist jedoch immer mit dem Status „nicht gedrückt“ identisch. Wenn Ihnen das Ergebnis nicht zusagt, können Sie zusätzliche Bilder in das Bitmap einfügen.

Wenn in einem Bitmap mehrere Bilder enthalten sind, müssen Sie ihre Anzahl in der Eigenschaft NumGlyphs angeben. Alle Bilder müssen gleich groß sein und nebeneinander liegen.

Hinweis

Das linke untere Pixel des Bitmaps ist für die Farbe „Transparent“ reserviert. Alle Pixel des Bitmaps, die mit dem Pixel links unten übereinstimmen, sind transparent.


TBitBtn::Kind

TBitBtn	Siehe auch	Beispiel

Die Eigenschaft Kind legt fest, um welche Art von Bitmap-Schaltfläche es sich handelt.

__property TBitBtnKind property Kind: TBitBtnKind;

Beschreibung

Der Typ TBitBtnKind definiert die Werte, die die Eigenschaft Kind einer Bitmap-Schaltfläche annehmen kann.

Die folgende Tabelle enthält diese Werte und ihre Bedeutung:

Wert	Bedeutung

bkCustom	Sie können das Bitmap für die Schaltfläche festlegen, indem Sie der Eigenschaft Glyph ein Bitmap Ihrer Wahl zuweisen. Wie bei gewöhnlichen Schaltflächen können Sie entweder einen Wert für ModalResult festlegen oder dem Ereignis OnClick Code zuweisen.

bkOK	Auf der Schaltfläche wird eine grüne Checkmarke und der Text "OK" angezeigt. Die Schaltfläche wird zur Standardschaltfläche (die Eigenschaft Default wird automatisch auf True gesetzt). Wenn der Benutzer auf die Schaltfläche klickt, wird das Dialogfeld geschlossen. Der ModalResult-Wert dieser Schaltfläche ist mrOK.

bkCancel	Auf der Schaltfläche wird ein rotes X und der Text "Abbrechen" angezeigt. Mit dieser Schaltfläche können Vorgänge abgebrochen werden (die Eigenschaft Cancel wird automatisch auf True gesetzt). Wenn der Benutzer auf die Schaltfläche klickt, wird das Dialogfeld geschlossen. Der ModalResult-Wert dieser Schaltfläche ist mrCancel.

bkYes	Auf der Schaltfläche wird eine grüne Checkmarke und der Text "Ja" angezeigt. Die Schaltfläche wird zur Standardschaltfläche (die Eigenschaft Default wird automatisch auf True gesetzt). Wenn der Benutzer auf die Schaltfläche klickt, werden alle im Dialogfeld vorgenommenen Änderungen akzeptiert, und das Dialogfeld wird geschlossen. Der ModalResult-Wert dieser Schaltfläche ist mrYes.

bkNo	Auf der Schaltfläche wird ein rotes Verbotszeichen und der Text "Nein" angezeigt. Mit dieser Schaltfläche können Vorgänge abgebrochen werden (die Eigenschaft Cancel wird automatisch auf True gesetzt). Wenn der Benutzer auf die Schaltfläche klickt, werden alle im Dialogfeld vorgenommenen Änderungen verworfen, und das Dialogfeld wird geschlossen. Der ModalResult-Wert dieser Schaltfläche ist mrNo.

bkHelp	Auf der Schaltfläche wird ein hellblaues Fragezeichen und der Text "Hilfe" angezeigt. Wenn der Benutzer auf die Schaltfläche klickt, wird ein Hilfethema aus der Hilfedatei der Anwendung angezeigt. Die Hilfedatei ist in der Eigenschaft HelpFile der Anwendung festgelegt. Der Wert der Eigenschaft HelpContext der Schaltfläche gibt an, welches Hilfethema angezeigt wird.

bkClose	Auf der Schaltfläche wird eine Tür mit einem angedeuteten grünen Schriftzug und der Text "Schließen" angezeigt. Wenn der Benutzer auf die Schaltfläche klickt, wird das Formular geschlossen. Die Eigenschaft Default der Schaltfläche ist True.

bkAbort	Auf der Schaltfläche wird ein rotes X und der Text "Abbruch" angezeigt.

bkRetry	Auf der Schaltfläche wird ein kreisförmiger grüner Pfeil und der Text "Wiederholen" angezeigt.

bkIgnore	Auf der Schaltfläche wird eine desinteressierte grüne Figur und der Text "Ignorieren" angezeigt. Mit dieser Schaltfläche können Sie dem Benutzer erlauben, die Bearbeitung nach einem Fehler fortzusetzen.

bkAll	Auf der Schaltfläche wird eine doppelte grüne Checkmarke und der Text "Alles" angezeigt.


TBitBtn::Layout

TBitBtn	Siehe auch	Beispiel

Diese Eigenschaft bestimmt die Position des Bildes auf der Schaltfläche.

__property TButtonLayout Layout;

Beschreibung

Der Typ TButtonLayout definiert die Werte, die die Eigenschaft Layout einer Bitmap-Schaltfläche annehmen kann. Die folgende Tabelle enthält diese Werte:

Wert	Bedeutung

blGlyphLeft	Das Bild wird links vom Text oder der Beschriftung angezeigt.

blGlyphRight	Das Bild wird rechts vom Text oder der Beschriftung angezeigt.

blGlyphTop	Das Bild wird oberhalb des Textes oder der Beschriftung angezeigt.

blGlyphBottom	Das Bild wird unterhalb des Textes oder der Beschriftung angezeigt.


TBitBtn::Margin

TBitBtn	Siehe auch	Beispiel

Die Eigenschaft Margin legt die Anzahl der Pixel fest, die zwischen dem in der Eigenschaft Glyph festgelegten Bild und dem Rand der Schaltfläche liegen.

__property int Margin;

Beschreibung

Auf welchen Abstand sich diese Eigenschaft bezieht, hängt von der in der Eigenschaft Layout festgelegten Anordnung des Bildes und des Textes ab. Wenn Layout beispielsweise blGlyphLeft ist, gibt Margin den Abstand zwischen dem linken Rand des Bildes und dem linken Rand der Schaltfläche an. Hat Margin den Wert 3, liegen zwischen dem Bild und dem Rand der Schaltfläche drei Pixel. Bei einem Wert von 0 liegt das Bild direkt am Rand der Schaltfläche an.

Bei einem Wert von -1 (Vorgabe) werden Bild und Text (Eigenschaft Caption) zentriert. Das Bild ist vom Rand der Schaltfläche genauso weit entfernt wie der Text vom gegenüberliegenden Rand.


TBitBtn::NumGlyphs

TBitBtn	Siehe auch	Beispiel

Die Eigenschaft NumGlyphs gibt an, wieviele Bilder in dem Bitmap enthalten sind, das in der Eigenschaft Glyph festgelegt ist.

__property TNumGlyphs NumGlyphs;

Beschreibung

Wenn ein Bitmap mehrere Bilder enthält, müssen Sie die Anzahl in der Eigenschaft NumGlyphs angeben. Alle Bilder müssen gleich groß sein und nebeneinander liegen. Gültige Werte für NumGlyphs sind 1 bis 4. Der Standardwert ist 1.

Sie können in einem Bitmap maximal vier Bilder für eine Bitmap-Schaltfläche oder einen Mauspalettenschalter zur Verfügung stellen. Abhängig vom Status der Schaltfläche zeigt Borland C++Builder eines dieser Bilder an. Ein Bitmap kann aber auch nur ein einziges Bild enthalten.

Position des Bildes im Bitmap	Status der Schaltfläche	Beschreibung

Erstes Bild	Nicht gedrückt	Dieses Bild wird angezeigt, wenn die Schaltfläche nicht gedrückt ist. Enthält das Bitmap keine weiteren Bilder, wird dieses Bild auch für alle anderen Zustände verwendet.

Zweites Bild	Deaktiviert	Dieses Bild wird normalerweise grau angezeigt, was bedeutet, daß die Schaltfläche nicht ausgewählt werden kann.

Drittes Bild	Gedrückt	Dieses Bild wird angezeigt, wenn auf eine Schaltfläche geklickt wird. Sobald die Maustaste losgelassen wird, erscheint wieder das Bild für den Status „nicht gedrückt“.

Wenn im Bitmap nur ein Bild vorhanden ist, versucht Borland C++Builder dieses für alle anderen Zustände jeweils leicht zu verändern. Der Status „dauerhaft gedrückt“ ist jedoch immer mit dem Status „nicht gedrückt“ identisch. Wenn Sie mit dem Ergebnis nicht zufrieden sind, können Sie zusätzliche Bilder in das Bitmap einfügen.

Der Typ TNumGlyphs definiert den Bereich der Werte (1 - 4), die die Eigenschaft NumGlyphs einer Bitmap-Schaltfläche (TBitBtn) annehmen kann.


TBitBtn::Spacing

TBitBtn	Siehe auch	Beispiel

Die Eigenschaft Spacing legt den Abstand zwischen Bild und Text einer Bitmap-Schaltfläche oder eines Mauspalettenschalters fest.

__property int Spacing;

Beschreibung

Mit der Eigenschaft Spacing können Sie den Abstand in Pixel zwischen dem Bild (Eigenschaft Glyph) und dem Text (Eigenschaft Caption) festlegen. Der Standardwert ist 4.

Wenn Spacing eine positive Zahl enthält, ist dies die Anzahl der Pixel zwischen Bild und Text. Hat Spacing den Wert 0, grenzen Bild und Text direkt aneinander. Bei einem Wert von -1 wird der Text zwischen dem Bild und dem Rand der Schaltfläche zentriert. Das Bild ist vom Text genauso weit entfernt wie der Text vom Rand der Schaltfläche.


TBitBtn::Style

TBitBtn	Siehe auch	Beispiel

Die Eigenschaft Style legt das Aussehen einer Bitmap-Schaltfläche fest.

__property TButtonStyle Style;

Beschreibung

Der Typ TButtonStyle enthält die Werte, die die Eigenschaft Style einer Bitmap-Schaltfläche annehmen kann.

Die folgende Tabelle enthält die möglichen Werte für TButtonStyle:

Wert	Bedeutung

bsAutoDetect	Unter Windows 3.x nimmt die Bitmap-Schaltfläche das Standardaussehen von Windows 3.x an. Wenn Sie eine höhere Version von Windows verwenden, zeigt sich die Schaltfläche in einem neueren Aussehen.

bsWin31	Die Schaltfläche nimmt unabhängig von der Windows-Version das Standardaussehen von Windows 3.1 an.

bsNew	 Die Schaltfläche zeigt sich unabhängig von der Windows-Version im neuesten Aussehen.


Ereignisse von TBitBtn

TBitBtn	Alphabetisch	Legende

Abgeleitet von TWinControl

OnEnter

OnExit

OnKeyDown

OnKeyPress

OnKeyUp

Abgeleitet von TControl

OnClick

OnDragDrop

OnDragOver

OnEndDrag

OnMouseDown

OnMouseMove

OnMouseUp

OnStartDrag


Ereignisse von TBitBtn

TBitBtn	Nach Objekten	Legende

OnClick

OnDragDrop

OnDragOver

OnEndDrag

OnEnter

OnExit

OnKeyDown

OnKeyPress

OnKeyUp

OnMouseDown

OnMouseMove

OnMouseUp

OnStartDrag


Methoden von TBitBtn

TBitBtn	Alphabetisch

In TBitBtn

~TBitBtn

Click

TBitBtn

Abgeleitet von TWinControl

Broadcast

CanFocus

ContainsControl

ControlAtPos

DisableAlign

EnableAlign

Focused

GetTabOrderList

HandleAllocated

HandleNeeded

InsertControl

Invalidate

PaintTo

Realign

RemoveControl

Repaint

ScaleBy

ScrollBy

SetBounds

SetFocus

Update

UpdateControlState

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

GetTextLen

Hide

Perform

Refresh

ScreenToClient

SendToBack

SetTextBuf

Show

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TBitBtn

TBitBtn	Nach Objekten

~TBitBtn

Assign

BeginDrag

BringToFront

Broadcast

CanFocus

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

Click

ClientToScreen

ContainsControl

ControlAtPos

DefaultHandler

DestroyComponents

Destroying

DisableAlign

Dispatch

DragDrop

Dragging

EnableAlign

EndDrag

FieldAddress

FindComponent

Focused

FreeInstance

FreeNotification

Free

GetParentComponent

GetTabOrderList

GetTextBuf

GetTextLen

HandleAllocated

HandleNeeded

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InsertControl

InstanceSize

Invalidate

MethodAddress

MethodName

NewInstance

PaintTo

Perform

Realign

Refresh

RemoveComponent

RemoveControl

Repaint

ScaleBy

ScreenToClient

ScrollBy

SendToBack

SetBounds

SetFocus

SetTextBuf

Show

TBitBtn

UpdateControlState

Update


TBitBtn::~TBitBtn

TBitBtn	Siehe auch

Der Destruktor ~TBitBtn gibt den Speicher frei, der für das TBitBtn-Objekt reserviert war. Rufen Sie ~TBitBtn nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TBitBtn automatisch aufgerufen wird.

__fastcall virtual ~TBitBtn(void);

Beschreibung

~TBitBtn gibt die Objekte TGlyph und TCanvas frei und ruft dann die geerbte Version von ~TBitBtn auf.


TBitBtn::Click

TBitBtn	Siehe auch

Die Methode Click simuliert einen Mausklick auf die Schaltfläche.

virtual void __fastcall Click(void);

Beschreibung

Ein Aufruf dieser Methode führt den Code aus, der dem Ereignis OnClick zugewiesen ist.

Wenn die Eigenschaft Kind den Wert bkClose hat, schließt Click das Formular. Bei bkHelp zeigt Click den Hilfebildschirm an, der in der Eigenschaft HelpContex angegeben ist. Bei jedem anderen Wert von Kind wird die geerbte Methode Click aufgerufen.


TBitBtn::TBitBtn

TBitBtn	Siehe auch

TBitBtn erzeugt eine Instanz der Schaltfläche und initialisiert ihre Werte.

__fastcall virtual TBitBtn(Classes::TComponent* AOwner);

Beschreibung

Mit TBitBtn können Sie eine Schaltfläche programmseitig instantiieren. Für Schaltflächen, die im Formulardesigner von Borland C++Builder erzeugt werden, wird TBitBtn automatisch aufgerufen.

Die Methode führt folgende Aktionen durch:

•	Sie ruft den Konstruktor des übergeordneten Objekts auf.

•	Sie erzeugt das Bild der Schaltfläche.

•	Sie weist dem Ereignis OnChange die Methode GlyphChanged zu.

•	Sie erzeugt ein TCanvas-Objekt für die Schaltfläche.

•	Sie setzt die Eigenschaft Style auf bsAutoDetect.

•	Sie setzt die Eigenschaft Kind auf bkCustom.

•	Sie setzt die Eigenschaft Layout auf blGlyphLeft.

•	Sie setzt die Eigenschaft Spacing auf 4.

•	Sie setzt die Eigenschaft Margin auf -1.


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TControl

TWinControl

TButtonControl

TButton


TBitBtn Beispiel

TBitBtn


TBitmap

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/graphics.hpp

Das Objekt TBitmap kapselt die Windows-Strukturen HBITMAP und HPALETTE.

Beschreibung

TBitmap enthält ein internes Abbild der Bitmap-Grafik und übernimmt den automatischen Aufbau der Palette. Ein Bitmap ist ein sehr vielseitiges Grafikobjekt, mit dem Bilder in Dateiform bearbeitet werden können. Die möglichen Operationen beinhalten Skalierung, Verschiebung des sichtbaren Bildausschnitts, Rotation sowie den eigentlichen Zeichenvorgang.

Um ein Bitmap auf einer Zeichenfläche darzustellen, werden die Methoden Draw oder StretchDraw eines TCanvas-Objekts aufgerufen, wobei ein TBitmap-Objekt als Parameter übergeben wird.

Ein TBitmap-Objekt kann sehr schnell kopiert werden, da nicht das Bild selbst, sondern nur das Handle kopiert wird. Wenn das Bild verändert werden soll und das Handle im Zugriff von mehreren TBitmap-Objekten liegt, wird das Bild kopiert, bevor die Änderungen durchgeführt werden.


Eigenschaften von TBitmap

TBitmap	Alphabetisch	Legende

In TBitmap

Canvas

Empty

Handle

Height

IgnorePalette

Monochrome

Palette

TransparentColor

Width

Abgeleitet von TGraphic

Modified


Eigenschaften von TBitmap

TBitmap	Nach Objekten	Legende

Canvas

Empty

Handle

Height

IgnorePalette

Modified

Monochrome

Palette

TransparentColor

Width


TBitmap::Canvas

TBitmap	Siehe auch

Die Nur-Lesen-Eigenschaft Canvas ermöglicht den Zugriff auf eine Zeichenfläche, die das Bitmap optisch sichtbar macht.

__property TCanvas* Canvas;

Beschreibung

Canvas stellt ein TCanvas-Objekt bereit, damit das Bitmap gezeichnet werden kann. Modifikationen in der Zeichenfläche wirken sich auf das zugrundeliegende Bitmap aus. Die Eigenschaft Canvas wird in einem Aufruf der Methoden Draw und StretchDraw des Zeichenflächen-Objekts verwendet, auf das die Eigenschaft Canvas verweist. Das Bitmap-Objekt wird dabei als Parameter an diese Methoden übergeben.

Die Zeichenfläche wird für das Bitmap automatisch erzeugt. Die Eigenschaft kann nur gelesen werden.


TBitmap::Empty

TBitmap	Siehe auch

Die Eigenschaft Empty signalisiert, ob das Bitmap-Objekt tatsächlich ein Bitmap enthält.

Beschreibung

Mit Empty kann festgestellt werden, ob ein Bitmap in das Bitmap-Objekt geladen wurde.

Wenn das Bitmap-Objekt gefüllt ist, hat Empty den Wert True, ansonsten False.


TBitmap::Handle

TBitmap	Beispiel

Mit der Eigenschaft Handle erhält man Zugriff auf das Handle des Windows-GDI-Bitmaps. Dieses Handle wiederum ermöglicht den Zugriff auf das GDI-Bitmap-Objekt selbst.

__property HBITMAP Handle;

Beschreibung

Mit Hilfe der Eigenschaft Handle wird eine Windows-API-Funktion aufgerufen, die das Handle eines Bitmap-Objekts anfordert. Übergeben Sie Handle an diese Funktionen als Parameter.

Der Wert der Eigenschaft Handle bezeichnet die HBITMAP-Struktur, das vom Bitmap-Objekt gekapselt wird. Ein direkter Zugriff auf das Handle sollte vermieden werden, weil das HBITMAP-Objekt sonst kopiert wird, wenn das Handle von mehreren TBitmap-Objekten verwendet wird.


TBitmap::Height

TBitmap	Siehe auch	Beispiel

Die Eigenschaft Height bestimmt die vertikale Größe des Bitmaps in Pixel.

Beschreibung

Mit Height kann die Höhe des Bitmaps ermittelt oder festgelegt werden. Wenn sich Height ändert, wird eine Kopie des Bitmap-Bildes mit der neuen Höhe erzeugt.


TBitmap::IgnorePalette

TBitmap	Siehe auch

Die Eigenschaft IgnorePalette steuert, ob beim Zeichnen des Bitmap-Bildes dessen Palette aufgebaut wird.

__property bool IgnorePalette;

Beschreibung

Setzen Sie IgnorePalette auf True, wenn die Geschwindigkeit des Zeichenvorgangs Priorität gegenüber der Bildqualität hat. Der Wert True bedeutet, daß beim Zeichnen des Bitmaps dessen Palette nicht aufgebaut wird. Das führt bei Grafiktreibern mit 256 Farben zu einer verringerten Farbtiefe, wobei aber die Bildschirmdarstellung beschleunigt wird.

Hinweis

Borland C++Builder verwendet IgnorePalette nur, wenn ein TDBImage-Objekt in einem TDBCtrlGrid-Objekt dupliziert wird.


TBitmap::Monochrome

TBitmap

Die Eigenschaft Monochrome legt fest, ob das Bitmap monochrom (einfarbig) dargestellt wird.

__property bool Monochrome;

Beschreibung

Der Wert True bedeutet, daß das Bitmap monochrom erscheint. Bei False wird das Bitmap farbig dargestellt.


TBitmap::Palette

TBitmap

Die Eigenschaft Palette steuert die Farbzuordnung eines Bitmaps.

__property HPALETTE Palette;

Beschreibung

Mit dieser Eigenschaft wird die Palette geändert, die für das Bitmap definiert ist.

Die Eigenschaft repräsentiert das HPALETTE-Objekt, das vom Bitmap aufgebaut wird. Es sollte vermieden werden, das Handle direkt abzurufen, weil das HPALETTE-Objekt sonst mehrmals kopiert wird, wenn das Handle von mehreren TBitmap-Objekten verwendet wird.

Benutzerdefinierte Paletten, die mit CreatePalette erzeugt werden, können dieser Eigenschaft zugewiesen werden. Eine Palette kann bis zu 256 Farben für die Bildschirmdarstellung des Bitmaps enthalten.

Wenn ein Grafikmodus mit 256 Farben aktiv ist und die Anwendung, die das Bitmap zeichnet, im Vordergrund läuft, werden alle Farben der Palette in die Windows-Systempalette eingefügt. Wenn die Anwendung im Hintergrund läuft, und die Systempalette von einer anderen Anwendung neu definiert wurde, werden die Farben des Bitmaps an die Systempalette angeglichen. Die Eigenschaft hat den Wert 0, wenn das Bitmap keine Palette besitzt.


TBitmap::TransparentColor

TBitmap	Siehe auch

Die Eigenschaft TransparentColor gibt die Farbe des Bitmaps zurück, wenn es transparent dargestellt wird.

__property TColor TransparentColor;

Beschreibung

Mit TransparentColor kann ermittelt werden, welche Farbeinstellung bewirkt, daß das Bitmap transparent erscheint. Diese Eigenschaft kann nur gelesen, aber nicht verändert werden.


TBitmap::Width

TBitmap	Beispiel

Die Eigenschaft Width bestimmt die Breite des Bitmaps in Pixel.

Beschreibung

Mit Width läßt sich die Breite des Bitmaps ermitteln oder festlegen.


Ereignisse von TBitmap

TBitmap	Alphabetisch

Abgeleitet von TGraphic

OnChange


Ereignisse von TBitmap

TBitmap	Nach Objekten

OnChange


Methoden von TBitmap

TBitmap	Alphabetisch

In TBitmap

~TBitmap

Assign

Dormant

FreeImage

LoadFromClipboardFormat

LoadFromResourceID

LoadFromResourceName

LoadFromStream

ReleaseHandle

ReleasePalette

SaveToClipboardFormat

SaveToStream

TBitmap

Abgeleitet von TGraphic

LoadFromFile

SaveToFile

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TBitmap

TBitmap	Nach Objekten

~TBitmap

Assign

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

Dormant

FieldAddress

FreeImage

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

LoadFromClipboardFormat

LoadFromFile

LoadFromResourceID

LoadFromResourceName

LoadFromStream

MethodAddress

MethodName

NewInstance

ReleaseHandle

ReleasePalette

SaveToClipboardFormat

SaveToFile

SaveToStream

TBitmap


TBitmap::~TBitmap

TBitmap	Siehe auch

Der Destruktor ~TBitmap gibt den Speicher frei, der für das TBitmap-Objekt reserviert war. Rufen Sie ~TBitmap nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TBitmap automatisch aufgerufen wird.

__fastcall virtual ~TBitmap(void);

Beschreibung

~TBitmap gibt erst das interne Abbild des Bitmaps frei (TBitmapImage) und dann die Zeichenfläche. Zuletzt wird der Destruktor des übergeordneten Objekts aufgerufen.


TBitmap::Assign

TBitmap	Siehe auch

Die Methode Assign kopiert ein neues Bitmap-Bild in das Bitmap-Objekt.

virtual void __fastcall Assign(Classes::TPersistent* Source);

Beschreibung

Assign kopiert das Bitmap-Bild, das im Quellobjekt (Source) enthalten ist, in das Bitmap-Objekt.

Assign ruft die geerbte Version der Methode Assign auf.

Hinweis

Ein Objekt bestimmten Typs kann immer einem anderen Objekt desselben Typs zugeordnet werden. Demnach kann das Quellobjekt (Source) vom Typ TPicture sein, wenn die Eigenschaft Graphic des Bildes ein Bitmap bezeichnet.


TBitmap::Dormant

TBitmap	Siehe auch

Die Methode Dormant erzeugt ein Abbild des Bitmaps im Speicher, um das Bitmap-Handle freigeben zu können und Ressourcen zu sparen.

void __fastcall Dormant(void);

Beschreibung

Mit Dormant läßt sich die Menge an GDI-Ressourcen reduzieren, die von der Anwendung belegt werden. Dormant erzeugt im Speicher mit Hilfe eines Stream-Objekts ein Abbild des Bitmaps. Das bleibt so erhalten, und das Bitmap kann das zugewiesene HBITMAP-Objekt freigeben, das über die Eigenschaft Handle referenziert wurde.


TBitmap::FreeImage

TBitmap

Die Methode FreeImage gibt die vom Bitmap-Objekt zwischengespeicherte Version der Bilddatei frei.

void __fastcall FreeImage(void);

Beschreibung

Mit FreeImage kann der Speicherbedarf einer Anwendung reduziert werden, wenn nicht viel Wert auf Farbtiefe gelegt wird. Die Methode bewirkt, daß der Speicher freigegeben wird, der für das zwischengespeicherte Abbild der Bitmap-Datei reserviert war. Damit reduziert sich allerdings die Farbtiefe des Bitmaps.

Wenn Bitmap-Daten in ein Bitmap-Objekt geladen werden, erzeugt Borland C++Builder im Speicher ein Abbild davon. Wenn das Bitmap zwischenzeitlich nicht verändert wurde, wird dieses Abbild auch zum Speichern des Bitmaps ohne Qualitätsverlust verwendet.


TBitmap::LoadFromClipboardFormat

TBitmap	Siehe auch

Die Methode LoadFromClipboardFormat lädt Bitmap-Daten aus der Zwischenablage in das Bitmap-Objekt.

virtual void __fastcall LoadFromClipboardFormat(unsigned short AFormat, int AData, HPALETTE APalette);

Beschreibung

LoadFromClipboardFormat wird aufgerufen, wenn das Bitmap bei dem TPicture-Objekt registriert wird, das die Methode RegisterClipboardFormat verwendet.

Mit LoadFromClipboardFormat wird das aktuelle Bild durch die Daten ersetzt, auf die der Parameter AData verweist. Die für das Bitmap gültige Palette wird über den Parameter APalette bezeichnet.


TBitmap::LoadFromResourceID

TBitmap	Siehe auch

Die Methode LoadFromResourceID lädt Bitmap-Daten aus einer Ressource in das Bitmap-Objekt.

void __fastcall LoadFromResourceID(int Instance, int ResID);

Beschreibung

Mit LoadFromResourceID wird die angegebene Bitmap-Ressource zusammen mit den Paletteninformationen aus der ausführbaren Datei eines Moduls geladen. Der Parameter ResID bezeichnet die Ressourcen-ID für das Bitmap.


TBitmap::LoadFromResourceName

TBitmap	Siehe auch

Die Methode LoadFromResourceName lädt eine Bitmap-Ressource in das Bitmap-Objekt.

void __fastcall LoadFromResourceName(int Instance, const System::AnsiString ResName);

Beschreibung

Mit LoadFromResourceName wird die angegebene Bitmap-Ressource zusammen mit den Paletteninformationen aus der ausführbahren Datei eines Moduls geladen. Der Parameter ResName enthält den Namen der Ressource.


TBitmap::LoadFromStream

TBitmap	Siehe auch

Die Methode LoadFromStream lädt das Bitmap aus einem Stream in das Bitmap-Objekt.

virtual void __fastcall LoadFromStream(Classes::TStream* Stream);

Beschreibung

Im Parameter Stream wird der Stream benannt, aus dem das Bitmap geladen werden soll.


TBitmap::ReleaseHandle

TBitmap

Die Methode ReleaseHandle gibt das Handle auf das Bitmap frei.

HBITMAP __fastcall ReleaseHandle(void);

Beschreibung

Mit ReleaseHandle wird das Bitmap vom zugehörigen Handle getrennt.


TBitmap::ReleasePalette

TBitmap

Die Methode ReleasePalette gibt das Handle auf die Palette des Bitmaps zurück und hebt die Zuordnung der Palette zum TBitmap-Objekt auf.

HPALETTE __fastcall ReleasePalette(void);

Beschreibung

Mit ReleasePalette wird die Zuordnung der Palette zum Bitmap-Bild aufgehoben.


TBitmap::SaveToClipboardFormat

TBitmap	Siehe auch

Die Methode SaveToClipboardFormat speichert ein Bitmap in einem Format, das von der Zwischenablage verarbeitet werden kann.

virtual void __fastcall SaveToClipboardFormat(unsigned short &Format, int &Data, HPALETTE &APalette);

Beschreibung

Mit SaveToClipboardFormat in einem passenden Format für die Zwischenablage gespeichert. Dazu wird die Palette im Parameter APalette übergeben. Das Format wird in AFormat bestimmt, und die zu speichernden Daten in AData. Bevor das Bitmap gespeichert werden kann, muß die Anwendung das Format beim TBitmap-Objekt registriert haben. Dazu dient die Methode RegisterClipboardFormat.


TBitmap::SaveToStream

TBitmap

Die Methode SaveToStream speichert die Bitmap-Daten in einem Stream.

virtual void __fastcall SaveToStream(Classes::TStream* Stream);

Beschreibung

Mit SaveToStream kann das Bitmap in dem Stream gespeichert werden, der im Parameter Stream benannt ist.


TBitmap::TBitmap

TBitmap	Siehe auch

Der Konstruktor TBitmap erzeugt ein neues TBitmap-Objekt.

__fastcall virtual TBitmap(void);

Beschreibung

Mit TBitmap wird zur Laufzeit ein Bitmap-Objekt instantiiert. TBitmap wird außerdem automatisch aufgerufen, sobald Bilddaten in ein TImage-Objekt geladen werden.

TBitmap reserviert Speicher und ruft den Konstruktor seines übergeordneten Objekts auf. Dann wird zur Repräsentation des internen Abbilds ein TBitmapImage-Objekt erzeugt.


Zugriff

Read-only


Hierarchie

TObject

TPersistent

TGraphic


TBitmap Beispiel

TBitmap


TBits

Hierarchie	Eigenschaften	Methoden

Header

vcl/classes.hpp

Das Objekt TBits speichert ein Array boolescher Werte.

Beschreibung

Mit Hilfe von TBits kann eine theoretisch unbegrenzte Anzahl von booleschen Werten gespeichert werden. Die Kapazität eines TBits-Objekts ist nur durch den verfügbaren Speicher begrenzt. Das Objekt sorgt selbst für die nötige Erweiterung des jeweils belegten Speicherbereichs. Wenn in bestimmten Situationen nicht mehr als 32 boolesche Werte benötigt werden, läßt sich dieselbe Funktionalität mit den logischen Operatoren AND und OR sowie einer Integer-Variablen erreichen.


Eigenschaften von TBits

TBits	Alphabetisch

In TBits

Bits

Size


Eigenschaften von TBits

TBits	Nach Objekten

Bits

Size


TBits::Bits

TBits	Siehe auch

Die Eigenschaft Bits ist ein Array boolescher Werte, die das TBits-Objekt repräsentiert.

__property bool Bits[int Index];

Beschreibung

Mit Bits kann ein bestimmter boolescher Wert gelesen oder gesetzt werden. Der Wert wird dabei über den Parameter Index identifiziert. Wenn Index nicht im Bereich von 0..Size-1 liegt, wird eine EBitsError-Exception ausgelöst.


TBits::Size

TBits	Siehe auch

Die Eigenschaft Size bezeichnet die Anzahl der booleschen Werte, die in einem TBits-Objekt Platz finden.

__property int Size;

Beschreibung

Mit Hilfe von Size kann die Größe des Arrays erweitert oder verkleinert werden. Beim Vergrößern werden neue Einträge auf False gesetzt. Beim Verkleinern bleiben nur diejenigen Werte erhalten, deren Indexpositionen kleiner oder gleich der neuen Größe sind.


Methoden von TBits

TBits	Alphabetisch

In TBits

~TBits

OpenBit

TBits

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TBits

TBits	Nach Objekten

~TBits

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance

OpenBit

TBits


TBits::~TBits

TBits	Siehe auch

Der Destruktor ~TBits gibt den Speicher frei, der für das TBits-Objekt reserviert war. Rufen Sie ~TBits nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TBits automatisch aufgerufen wird.

__fastcall virtual ~TBits(void);

~TBits gibt den Speicher frei, der für das Array reserviert war.


TBits::OpenBit

TBits	Siehe auch

Die Methode OpenBit gibt den Index des ersten Wertes zurück, der auf False steht.

int __fastcall OpenBit(void);

Beschreibung

Mit OpenBit finden Sie das erste Bit im Array, das nicht auf True gesetzt wurde.


TBits::TBits

TBits	Siehe auch

Der Konstruktor TBits erzeugt ein neues TBits-Objekt.

__fastcall TBits(void);

Beschreibung

Die Methode instantiiert ein TBits-Objekt.


Hierarchie

TObject


TBits Beispiel

TBits


TBlobField

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/dbtables.hpp

Das TBlobField-Objekt repräsentiert ein Feld in einer Datenmenge, das eine Referenz auf ein BLOB enthält.

Beschreibung

BLOB-Felder sind Datenbankfelder, die binäre Daten von beliebiger Länge enthalten können. Im Unterschied zu binären Feldern speichern BLOB-Felder die binären Daten nicht direkt in der Datenbanktabelle. Statt dessen enthält das Feld in der physischen Datenbanktabelle eine Referenz auf eine Datei, in der der jeweilige BLOB-Wert für das Feld enthalten ist.

TBlobField besitzt neue Methoden, die dabei helfen, Daten im BLOB-Feld in einen Stream zu stellen.

TBlobField umfaßt als Nachkomme von TField viele Eigenschaften, Methoden und Ereignisse, die für die Verwaltung des Wertes und der Eigenschaften der Felder in einer Datenbank hilfreich sind.

BLOB-Feldkomponenten können unterschiedliche Datentypen von beliebiger Länge repräsentieren. Diese Datentypen werden im Header der binären Daten angegeben. Neben den direkt unterstützten Feldtypen ist TBlobField der direkte Vorfahr zweier BLOB-Feldkomponenten: TMemoField (ftMemo) und TGraphicField (ftGraphic).


Eigenschaften von TBlobField

TBlobField	Alphabetisch	Legende

In TBlobField

BlobType

Size

Value

Abgeleitet von TField

Alignment

AsBoolean

AsCurrency

AsDateTime

AsFloat

AsInteger

AsString

AsVariant

AttributeSet

BDECalcField

Calculated

CanModify

DataSet

DataSize

DataType

DisplayLabel

DisplayName

DisplayText

DisplayWidth

EditMask

EditMaskPtr

FieldKind

FieldName

FieldNo

Index

IsIndexField

IsNull

KeyFields

Lookup

LookupDataSet

LookupKeyFields

LookupResultField

NewValue

OldValue

ReadOnly

Required

Size

Text

Visible

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Name

Owner

Tag


Eigenschaften von TBlobField

TBlobField	Nach Objekten	Legende

Alignment

AsBoolean

AsCurrency

AsDateTime

AsFloat

AsInteger

AsString

AsVariant

AttributeSet

BDECalcField

BlobType

Calculated

CanModify

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

DataSet

DataSize

DataType

DesignInfo

DisplayLabel

DisplayName

DisplayText

DisplayWidth

EditMaskPtr

EditMask

FieldKind

FieldName

FieldNo

Index

IsIndexField

IsNull

KeyFields

LookupDataSet

LookupKeyFields

LookupResultField

Lookup

Name

NewValue

OldValue

Owner

ReadOnly

Required

Size

Tag

Text

Value

Visible


TBlobField::BlobType

TBlobField	Siehe auch

Die Eigenschaft BlobType identifiziert den Typ des BLOB-Feldes, das mit einem BLOB-Feldobjekt verbunden ist.

__property TBlobType BlobType;

Beschreibung

Mit BlobType wird der Datentyp für die BLOB-Daten, die mit der Feldkomponente verbunden sind, gesetzt oder gelesen.

Geben Sie BlobType an, wenn mit einem TBlobField-Objekt ein BLOB-Feldtyp repräsentiert werden soll, der nicht direkt unterstützt wird (wie beispielsweise ein formatiertes Memo-BLOB-Feld). BlobType stellt sicher, daß der BLOB-Typ in der Tabelle mit dem erwarteten Feldtyp übereinstimmt.

TBlobType ist ein Bereich von TFieldType-Werten.  Dabei handelt es sich um die Werte im folgenden Bereich:

Wert	Beschreibung

ftBlob	BLOB-Feld

ftMemo	Memo-Feld

ftGraphic	Bitmap-Feld

ftFmtMemo	Formatiertes Memo-Feld

ftParadoxOle	Paradox-OLE-Feld

ftDBaseOle	dBase-OLE-Feld

ftTypedBinary	Typisiertes binäres Feld


TBlobField::Size

TBlobField

Size ist die Größe des BLOB-Feldes.

__property Size;


TBlobField::Value

TBlobField	Siehe auch

Die Eigenschaft Value enthält die Daten im BLOB-Feld.

property System::AnsiString Value;

Beschreibung

Mit Value werden Daten zur Laufzeit direkt aus einer BLOB-Feldkomponente gelesen oder direkt dorthin geschrieben. Bei BLOB-Feldern entspricht die Eigenschaft Value der Eigenschaft AsString.

Hinweis

Der Datentyp String kann sowohl binäre Daten als auch Text speichern. Deshalb können sogar BLOB-Felder für nicht zeichenorientierte BLOB-Typen, wie ftGraphic oder ftTypedBinary, ihre Daten über einen String abrufen oder schreiben.


Ereignisse von TBlobField

TBlobField	Alphabetisch	Legende

Abgeleitet von TField

OnChange

OnGetText

OnSetText

OnValidate


Ereignisse von TBlobField

TBlobField	Nach Objekten	Legende

OnChange

OnGetText

OnSetText

OnValidate


Methoden von TBlobField

TBlobField	Alphabetisch

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance

In TBlobField

~TBlobField

Assign

Clear

LoadFromFile

LoadFromStream

SaveToFile

SaveToStream

SetFieldType

SetText

TBlobField

Abgeleitet von TField

AssignValue

FocusControl

GetData

IsValidChar

SetData

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent


Methoden von TBlobField

TBlobField	Nach Objekten

~TBlobField

Assign

AssignValue

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

Clear

DefaultHandler

DestroyComponents

Destroying

Dispatch

FieldAddress

FindComponent

FocusControl

FreeInstance

FreeNotification

Free

GetData

GetParentComponent

HasParent

InheritsFrom

InitInstance

InsertComponent

InstanceSize

IsValidChar

LoadFromFile

LoadFromStream

MethodAddress

MethodName

NewInstance

RemoveComponent

SaveToFile

SaveToStream

SetData

SetFieldType

SetText

TBlobField


TBlobField::~TBlobField

TBlobField

Der Destruktor ~TBlobField gibt den Speicher frei, der für das TBlobField-Objekt reserviert war. Rufen Sie ~TBlobField nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TBlobField automatisch aufgerufen wird.

__fastcall virtual ~TBlobField(void);


TBlobField::Assign

TBlobField	Siehe auch

Die Methode Assign kopiert einen Wert in das BLOB-Feld.

virtual void __fastcall Assign(Classes::TPersistent* Source);

Beschreibung

Mit Assign können Daten in das BLOB-Feld kopiert werden. Assign kopiert den Wert eines BLOB-Feldes aus

•	einem anderen BLOB-Feld,

•	einem TStrings-Objekt,

•	einem TBitmap-Objekt, wenn BlobType ftGraphic oder ftTypedBinary ist,

•	einem TPicture-Objekt, wenn BlobType ftGraphic oder ftTypedBinary ist,

•	jedem Objekt, das TBlobField mit seiner Methode AssignTo unterstützt.


TBlobField::Clear

TBlobField	Siehe auch

Die Methode Clear löscht den aktuellen Wert im BLOB-Feld.

virtual void __fastcall Clear(void);

Beschreibung

Mit Clear wird der aktuelle Wert im Feld gelöscht.


TBlobField::LoadFromFile

TBlobField	Siehe auch

Die Methode LoadFromFile lädt einen BLOB-Wert aus einer Datei in das Feld.

void __fastcall LoadFromFile(const System::AnsiString FileName);

Beschreibung

Mit LoadFromFile wird der Inhalt einer Datei in ein BLOB-Feld geladen. Geben Sie den Namen der Datei, die in das Feld geladen werden soll, als Wert des Parameters FileName an.


TBlobField::LoadFromStream

TBlobField	Siehe auch

Die Methode LoadFromStream lädt einen BLOB-Wert aus einem Stream in das Feld.

void __fastcall LoadFromStream(Classes::TStream* Stream);

Beschreibung

Mit LoadFromStream wird der Inhalt eines Streams in ein BLOB-Feld kopiert. Geben Sie den Stream, aus dem der Feldwert kopiert werden soll, als Wert des Parameters Stream an.


TBlobField::SaveToFile

TBlobField	Siehe auch

Die Methode SaveToFile speichert den Inhalt des BLOB-Feldes in einer Datei.

void __fastcall SaveToFile(const System::AnsiString FileName);

Beschreibung

SaveToFile speichert den Inhalt des BLOB-Feldes in einer Datei. Geben Sie den Namen der Datei als Wert des Parameters FileName an.


TBlobField::SaveToStream

TBlobField	Siehe auch

Die Methode SaveToStream speichert den Inhalt des BLOB-Feldes in einem Stream.

void __fastcall SaveToStream(Classes::TStream* Stream);

Beschreibung

Mit SaveToStream wird der Inhalt des BLOB-Feldes in einen Stream kopiert. Geben Sie den Namen des Streams, in dem der Feldwert gespeichert werden soll, als Wert des Parameters Stream an.


TBlobField::SetFieldType

TBlobField	Siehe auch

Die Methode SetFieldType bestimmt den Typ des BLOB-Feldes.

virtual void __fastcall SetFieldType(Db::TFieldType Value);

Beschreibung

Mit SetFieldType läßt sich der Feldtyp eines BLOB-Feldes ändern, wobei der Standardtyp überschrieben wird.

Normalerweise wird der Typ des physischen Datenbankfeldes überprüft und ein TFieldType ausgewählt, der die größtmögliche Übereinstimmung aufweist. BLOB-Felder können expliziter angeben, welche Art von BLOB-Wert in der Datenbank vorhanden ist. Geben Sie den BLOB-Typ als Wert des Parameters Value an.

Die folgende Tabelle enthält die möglichen Werte für BLOB-Felder. Wenn SetFieldType mit einem anderen Datentyp aufgerufen wird, erfolgt keine Aktion.

Wert	Beschreibung

ftBlob	BLOB-Feld

ftMemo	Memo-Feld

ftGraphic	Bitmap-Feld

ftFmtMemo	Formatiertes Memo-Feld

ftParadoxOle	Paradox-OLE-Feld

ftDBaseOle	dBase-OLE-Feld

ftTypedBinary	Typisiertes binäres Feld

Hinweis

Der Aufruf von SetFieldType entspricht dem Setzen der Eigenschaft BlobType.


TBlobField::SetText

TBlobField	Siehe auch

Die Methode SetText verursacht für BLOB-Feldobjekte eine Exception.

virtual void __fastcall SetText(const System::AnsiString Value);

Beschreibung

SetText hindert datensensitive Steuerelemente daran, den String „(Feldname)“ in die Datenmenge zurückzuschreiben. Verwenden Sie die Eigenschaft AsString, wenn der Wert eines BLOB-Feldes aus Textdaten besteht.


TBlobField::TBlobField

TBlobField	Siehe auch

TBlobField erzeugt und initialisiert eine Instanz einer BLOB-Feldkomponente.

__fastcall virtual TBlobField(Classes::TComponent* AOwner);

Beschreibung

Mit TBlobField wird eine Instanz von TBlobField erzeugt und initialisert. TBlobField setzt die Eigenschaft DataType auf ftBlob, nachdem der geerbte Konstruktor aufgerufen wurde.

Es ist nur selten nötig, TBlobField explizit aufzurufen, weil die Komponente für alle BLOB-Felder in einer Datenmenge automatisch instantiiert wird.


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TField


TBlobField Beispiel

TBlobField


TBlobStream

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/dbtables.hpp

TBlobStream ist ein Stream-Objekt, mit dessen Hilfe Anwendungen in Stream-Objekte schreiben bzw. daraus lesen können, die BLOB-Felder repräsentieren (BLOB = Binary Large OBject).

Beschreibung

Mit TBlobStream können die Werte eines BLOB-Feldobjekts verfügbar gemacht und bearbeitet werden. Nachkommen von TBlobField, wie TGraphicField und TMemoField.BLOB, implementieren viele ihrer Datenzugriffseigenschaften und -methoden über BLOB-Streams.

TBlobStream bietet eine einheitliche Stream-Schnittstelle für solche Objekte, die keine Informationen darüber besitzen, wie Daten in einem BLOB-Feld gespeichert werden.

Einen BLOB-Stream zu verwenden, bedeutet, eine Instanz von TBlobStream zu erzeugen, die Stream-Methoden zum Lesen und Schreiben der Daten aufzurufen und den BLOB-Stream dann freizugeben.


Eigenschaften von TBlobStream

TBlobStream	Alphabetisch	Legende

Abgeleitet von TStream

Position

Size


Eigenschaften von TBlobStream

TBlobStream	Nach Objekten	Legende

Position

Size


Methoden von TBlobStream

TBlobStream	Alphabetisch

In TBlobStream

~TBlobStream

Read

Seek

TBlobStream

Truncate

Write

Abgeleitet von TStream

CopyFrom

ReadBuffer

ReadComponent

ReadComponentRes

ReadResHeader

WriteBuffer

WriteComponent

WriteComponentRes

WriteDescendent

WriteDescendentRes

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TBlobStream

TBlobStream	Nach Objekten

~TBlobStream

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

CopyFrom

DefaultHandler

Dispatch

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance

ReadBuffer

ReadComponentRes

ReadComponent

ReadResHeader

Read

Seek

TBlobStream

Truncate

WriteBuffer

WriteComponentRes

WriteComponent

WriteDescendentRes

WriteDescendent

Write


TBlobStream::~TBlobStream

TBlobStream	Siehe auch

Der Destruktor ~TBlobStream gibt den Speicher frei, der für das TBlobStream-Objekt reserviert war. Rufen Sie ~TBlobStream nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TBlobStream automatisch aufgerufen wird.

__fastcall virtual ~TBlobStream(void);

Beschreibung

~TCustomRichEdit löst ein OnDataChange-Ereignis aus, wenn mit Hilfe des BLOB-Streams Felddaten überschrieben oder geändert wurden. TCustomRichEdit gibt dann alle Puffer frei, die für die Verarbeitung der Daten reserviert waren.


TBlobStream::Read

TBlobStream	Siehe auch

Die Methode Read liest, beginnend an der aktuellen Position, so viele Bytes in den Puffer (Buffer), wie von Count vorgegeben.

virtual long __fastcall Read(void *Buffer, long Count);

Beschreibung

Mit Read können Daten aus dem BLOB-Feld gelesen werden, wenn die Byte-Anzahl der Felddaten nicht bekannt ist. Die Puffergröße muß mindestens dem Wert von Count entsprechen, damit alle gelesenen Daten Platz finden.

Beginnend an der aktuellen Position, werden maximal so viele Bytes aus dem BLOB-Stream in den Puffer gelesen, wie mit Count angegeben. Anschließend wird die aktuelle Position an die tatsächlich übertragene Byte-Anzahl angepaßt. Diese Anzahl wird zurückgegeben. Sie ist eventuell kleiner als der Wert von Count.

Wenn das BLOB-Feld eine Instanz von TMemoField ist, überprüft Read die Eigenschaft Transliterate des Feldes. Wenn diese den Wert True hat, werden alle Daten vom ANSI-Code in den Zeichensatz konvertiert, den die Datenmenge erfordert.

Alle anderen Methoden eines BLOB-Feldes zum Lesen von Daten (ReadBuffer, ReadComponent) rufen Read für den eigentlichen Schreibvorgang auf.

Hinweis

Rufen Sie Read nicht auf, wenn das TBlobStream-Objekt im Modus bmWrite erzeugt wurde.


TBlobStream::Seek

TBlobStream	Siehe auch

Die Methode Seek setzt die aktuelle Position im BLOB-Stream auf einen neuen Wert .

virtual long __fastcall Seek(long Offset, unsigned short Origin);

Beschreibung

Mit Seek wird die aktuelle Position innerhalb der BLOB-Daten entsprechend dem Wert von Offset angepaßt. Seek ermöglicht es einer Anwendung, an einer beliebigen Position innerhalb der BLOB-Daten eine Schreib- oder Leseoperation auszuführen.

Der Parameter Origin legt fest, wie der Parameter Offset interpretiert werden soll. Für Origin sind folgende Werte möglich:

Wert	Bedeutung

soFromBeginning	Offset bezieht sich auf den Anfang der BLOB-Daten. Seek verschiebt zur Position Offset. Offset muß größer oder gleich Null sein.

soFromCurrent	Offset bezieht sich auf die aktuelle Position innerhalb der BLOB-Daten. Seek verschiebt zu <aktuelle Position> + Offset.

soFromEnd	Offset bezieht sich auf das Ende der BLOB-Daten. Offset muß kleiner oder gleich Null sein und bezeichnet die Anzahl der Bytes vor dem Ende des BLOB.

Seek gibt den neuen Wert der Eigenschaft Position zurück.


TBlobStream::Truncate

TBlobStream	Siehe auch

Die Methode Truncate verwirft alle Daten im BLOB-Feld, die hinter der aktuellen Position stehen.

void __fastcall Truncate(void);

Beschreibung

Mit Truncate kann der Umfang der BLOB-Daten begrenzt werden. Wenn die aktuelle Position beim Aufruf von Truncate auf 0 zeigt, wird das BLOB-Feld vollständig geleert.

Hinweis

Rufen Sie Truncate nicht auf, wenn das TBlobStream-Objekt im Modus bmRead erzeugt wurde.


TBlobStream::Write

TBlobStream	Siehe auch

Die Methode Write schreibt die mit Count vorgegebene Anzahl von Bytes aus dem Puffer (Buffer) an die aktuelle Position im Feld und aktualisiert die Position entsprechend dem Wert von Count.

virtual long __fastcall Write(const void *Buffer, long Count);

Beschreibung

Mit Write werden, beginnend an der aktuellen Position, so viele Bytes in das BLOB-Feld geschrieben, wie in Count vorgegeben. Der Wert von Count wird immer genau berücksichtigt, weil BLOB-Daten nicht unbedingt ein abschließendes Endezeichen haben müssen. Write ist damit das €quivalent zur Methode WriteBuffer.

Wenn das BLOB-Feld eine Instanz von TMemoField ist, überprüft Write die Eigenschaft Transliterate des Feldes. Wenn diese den Wert True hat, werden alle Daten von ANSI in den Zeichensatz konvertiert, den die Datenmenge erfordert.

Alle anderen Methoden eines BLOB-Streams zum Schreiben von Daten (WriteBuffer, WriteComponent) rufen Write für den eigentlichen Schreibvorgang auf.

Hinweis

Rufen Sie Write nicht auf, wenn das TBlobStream-Objekt im Modus bmRead erzeugt wurde.


TBlobStream::TBlobStream

TBlobStream	Siehe auch

TBlobStream erzeugt eine Instanz von TBlobStream.

__fastcall TBlobStream(TBlobField* Field, TBlobStreamMode Mode);

Beschreibung

Mit TBlobStream wird eine Instanz von TBlobStream erzeugt, so daß der Datenaustausch mit einem bestimmten TBlobField-Objekt möglich wird.

TBlobStream verknüpft das TBlobStream-Objekt mit dem Feldobjekt, das der Parameter Field bezeichnet. Der Parameter Mode steuert, wie der Stream verwendet wird. Folgende Werte sind möglich:

Wert	Bedeutung

bmRead	Der BLOB-Stream kann Daten aus dem Feld lesen.

bmWrite	Der BLOB-Stream kann die Felddaten ersetzen.

bmReadWrite	Der BLOB-Stream kann Felddaten lesen und schreiben.


Zugriff

Read-only


Hierarchie

TObject

TStream


TBlobStream Beispiel

TBlobStream


TBitmapImage

Hierarchie	Methoden	Siehe auch

Header

vcl/graphics.hpp

TBitmapImage ist die interne Repräsentation eines Bitmaps für ein TBitmap-Objekt.

Beschreibung

TBitmapImage wird nur für die interne Implementierung in Borland C++Builder verwendet. Das Objekt repräsentiert die interne Darstellung eines Bitmaps, das von einem TBitmap-Objekt gekapselt wird. Alle Eigenschaften und Methoden, die in TBitmapImage eingeführt werden, sind als public deklariert. Sie enthalten Informationen über das spezielle HBITMAP-Objekt, einschließlich der Zeiger auf die von Windows definierten Standard-HBITMAP-Strukturen. TBitmapImage wird im Konstruktor des TBitmap-Objekts referenziert, wenn das Bitmap-Abbild erzeugt wird.


Methoden von TBitmapImage

TBitmapImage	Alphabetisch

In TBitmapImage

~TBitmapImage

TBitmapImage

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TBitmapImage

TBitmapImage	Nach Objekten

~TBitmapImage

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance

TBitmapImage


TBitmapImage::~TBitmapImage

TBitmapImage

Der Destruktor ~TBitmapImage gibt den Speicher frei, der für das TBitmapImage-Objekt reserviert war. Rufen Sie ~TBitmapImage nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TBitmapImage automatisch aufgerufen wird.

__fastcall virtual ~TBitmapImage(void);


TBitmapImage::TBitmapImage

TBitmapImage

Der Konstruktor TBitmapImage erzeugt ein neues TBitmapImage-Objekt.

__fastcall TBitmapImage(void);


Hierarchie

TObject

TInternalImage


TBitmapImage Beispiel

TBitmapImage


TBooleanField

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/dbtables.hpp

Ein TBooleanField-Objekt repräsentiert ein Feld, das einen booleschen Wert enthält.

Beschreibung

Boolesche Felder können die Werte True und False enthalten.

TBooleanField besitzt neue Eigenschaften, mit denen Konvertierungen zwischen booleschen Werten und anderen Datentypen durchgeführt werden können. Außerdem stellen sie Anzeigestrings zur Verfügung, die verschiedene Interpretationen der Daten repräsentieren. TBooleanField umfaßt als Nachkomme von TField viele Eigenschaften, Methoden und Ereignisse, die für die Verwaltung des Wertes und der Eigenschaften von Feldern in einer Datenbank hilfreich sind.


Eigenschaften von TBooleanField

TBooleanField	Alphabetisch	Legende

In TBooleanField

DisplayValues

Value

Abgeleitet von TField

Alignment

AsBoolean

AsCurrency

AsDateTime

AsFloat

AsInteger

AsString

AsVariant

AttributeSet

BDECalcField

Calculated

CanModify

DataSet

DataSize

DataType

DisplayLabel

DisplayName

DisplayText

DisplayWidth

EditMask

EditMaskPtr

FieldKind

FieldName

FieldNo

Index

IsIndexField

IsNull

KeyFields

Lookup

LookupDataSet

LookupKeyFields

LookupResultField

NewValue

OldValue

ReadOnly

Required

Size

Text

Visible

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Name

Owner

Tag


Eigenschaften von TBooleanField

TBooleanField	Nach Objekten	Legende

Alignment

AsBoolean

AsCurrency

AsDateTime

AsFloat

AsInteger

AsString

AsVariant

AttributeSet

BDECalcField

Calculated

CanModify

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

DataSet

DataSize

DataType

DesignInfo

DisplayLabel

DisplayName

DisplayText

DisplayValues

DisplayWidth

EditMaskPtr

EditMask

FieldKind

FieldName

FieldNo

Index

IsIndexField

IsNull

KeyFields

LookupDataSet

LookupKeyFields

LookupResultField

Lookup

Name

NewValue

OldValue

Owner

ReadOnly

Required

Size

Tag

Text

Value

Visible


TBooleanField::DisplayValues

TBooleanField	Siehe auch

Die Eigenschaft DisplayValues steuert die Art und Weise, in der das boolesche Feld in das oder aus dem Anzeigeformat übersetzt wird.

__property System::AnsiString DisplayValues;

Beschreibung

Mit DisplayValues lassen sich die Strings angeben, mit denen die booleschen Werte dargestellt werden sollen. Verwenden Sie dazu ein beliebiges Wortpaar, das durch ein Semikolon voneinander getrennt ist. Wenn beispielsweise die Werte True und False den Buchstaben T und F entsprechen sollen, setzen Sie DisplayValues auf T;F. Wenn Sie die Werte True und False auf die Strings Ja und Nein einstellen wollen, setzen Sie DisplayValues auf Ja;Nein.

Der True oder False zugeordnete String darf auch ein leerer String sein. Wenn der Wert für True ein leerer String sein soll, setzen Sie DisplayValues auf einen String, der mit einem Semikolon beginnt. Wollen Sie z.B. False mit dem Wert Fail verbinden und True mit einem leeren String, setzen Sie DisplayValues auf ;Fail. Wenn Sie False mit einem leeren String verbinden wollen, setzen Sie DisplayValues auf den String für True, verwenden aber kein Semikolon.

Die über DisplayValues mit True und False verbundenen Strings werden in den datensensitiven Steuerelementen angezeigt, wenn diese Daten für ein boolesches Feld anzeigen. Sollte einer der Strings leer sein, werden die mit diesem String verbundenen booleschen Werte als Leerzeichen in den datensensitiven Steuerelementen angezeigt.

Diese Strings werden außerdem verwendet, um die Eigenschaft AsString des booleschen Feldes zu ermitteln oder zu setzen.


TBooleanField::Value

TBooleanField	Siehe auch

Die Eigenschaft Value enthält die Daten im booleschen Feld.

__property bool Value;

Beschreibung

Mit Value werden Daten zur Laufzeit direkt aus einem booleschen Feldobjekt gelesen oder in das Objekt geschrieben. Der Einsatz von Value entspricht der Verwendung der Eigenschaft AsBoolean. Verwenden Sie Value, wenn es sich bei der Feldkomponenten um ein boolesches Feld handelt. Setzen Sie AsBoolean ein, wenn Sie mit einer generischen Feldkomponente arbeiten.


Ereignisse von TBooleanField

TBooleanField	Alphabetisch	Legende

Abgeleitet von TField

OnChange

OnGetText

OnSetText

OnValidate


Ereignisse von TBooleanField

TBooleanField	Nach Objekten	Legende

OnChange

OnGetText

OnSetText

OnValidate


Methoden von TBooleanField

TBooleanField	Alphabetisch

In TBooleanField

~TBooleanField

TBooleanField

Abgeleitet von TField

Assign

AssignValue

Clear

FocusControl

GetData

IsValidChar

SetData

SetFieldType

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TBooleanField

TBooleanField	Nach Objekten

~TBooleanField

Assign

AssignValue

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

Clear

DefaultHandler

DestroyComponents

Destroying

Dispatch

FieldAddress

FindComponent

FocusControl

FreeInstance

FreeNotification

Free

GetData

GetParentComponent

HasParent

InheritsFrom

InitInstance

InsertComponent

InstanceSize

IsValidChar

MethodAddress

MethodName

NewInstance

RemoveComponent

SetData

SetFieldType

TBooleanField


TBooleanField::~TBooleanField

TBooleanField

Der Destruktor ~TBooleanField gibt den Speicher frei, der für das TBooleanField-Objekt reserviert war. Rufen Sie ~TBooleanField nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TBooleanField automatisch aufgerufen wird.

__fastcall virtual ~TBooleanField(void);


TBooleanField::TBooleanField

TBooleanField	Siehe auch

TBooleanField instantiiert ein boolesches Feldobjekt.

__fastcall virtual TBooleanField(Classes::TComponent* AOwner);

Beschreibung

Rufen Sie TBooleanField auf, wenn Sie eine Instanz von TBooleanField erstellen und initialisieren wollen. Nach dem Aufruf des geerbten Konstruktors setzt TBooleanField DataType auf ftBoolean und initialisiert die den booleschen Werten zugeordneten Strings mit ‘True’ und ‘False’.

TBooleanField muß nur in seltenen Fällen explizit aufgerufen werden, weil ein boolesches Feldobjekt automatisch für alle booleschen Felder in einer Datenmenge instantiiert wird.


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TField


TBooleanField Beispiel

TBooleanField


TBrush

Hierarchie	Eigenschaften	Methoden	Ereignisse

Header

vcl/graphics.hpp

Ein Objekt der Klasse TBrush füllt geschlossene Flächen mit einer Farbe oder einem Muster.

Beschreibung

TBrush kapselt die Windows-Struktur HBRUSH und wird zum Füllen geschlossener Flächen (z.B. Rechtecke und Ellipsen) mit einer Farbe oder einem Muster verwendet.


Eigenschaften von TBrush

TBrush	Alphabetisch	Legende

In TBrush

Bitmap

Color

Handle

Style


Eigenschaften von TBrush

TBrush	Nach Objekten	Legende

Bitmap

Color

Handle

Style


TBrush::Bitmap

TBrush	Siehe auch

Die Eigenschaft Bitmap bezeichnet ein externes Bitmap, in dem ein Muster für den Pinsel definiert ist.

__property TBitmap* Bitmap;

Beschreibung

Bitmap zeigt auf ein TBitmap-Objekt, das ein BMP-Bild enthält. Wenn Bitmap nicht leer ist, wird das Füllmuster für den Pinsel durch das BMP-Bild definiert (anstatt durch die Eigenschaft Style). Das Bild muß acht Pixel hoch und acht Pixel breit sein.

Eine Änderung des Bildes wirkt sich erst dann auf den Pinsel aus, wenn das TBitmap-Objekt der Bitmap-Eigenschaft neu zugewiesen wird. Die Freigabe des TBitmap-Objekts erfolgt nicht automatisch durch TBrush. Es muß deshalb explizit freigegeben werden, wenn der Pinsel nicht mehr benötigt wird.


TBrush::Color

TBrush	Siehe auch

Die Eigenschaft Color bestimmt die Farbe des Pinsels.

__property TColor Color;

Beschreibung

Mit der Eigenschaft Color kann die Pinselfarbe festgelegt werden.


TBrush::Handle

TBrush	Beispiel

Die Eigenschaft Handle ruft ein Windows-Handle für den Pinsel ab.

__property HBRUSH Handle;

Beschreibung

Die Eigenschaft Handle ermöglicht den Zugriff auf das Objekt-Handle der Windows-GDI.


TBrush::Style

TBrush	Siehe auch

Die Eigenschaft Style bestimmt das Muster für den Pinsel.

__property TBrushStyle Style;

Beschreibung

Style legt das Füllmuster fest, das mit dem Pinsel gezeichnet wird (vorausgesetzt, der Eigenschaft Bitmap ist kein Wert zugewiesen).


Ereignisse von TBrush

TBrush	Alphabetisch

Abgeleitet von TGraphicsObject

OnChange


Ereignisse von TBrush

TBrush	Nach Objekten

OnChange


Methoden von TBrush

TBrush	Alphabetisch

In TBrush

~TBrush

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TBrush

TBrush	Nach Objekten

~TBrush

Assign

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


TBrush::~TBrush

TBrush

Der Destruktor ~TBrush gibt den Speicher frei, der für das TBrush-Objekt reserviert war. Rufen Sie ~TBrush nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TBrush automatisch aufgerufen wird.

__fastcall virtual ~TBrush(void);


TBrush::Assign

TBrush	Siehe auch

Die Methode Assign kopiert den Inhalt eines Pinsels in einen anderen.

virtual void __fastcall Assign(Classes::TPersistent* Source);

Beschreibung

Mit Assign wird der Inhalt eines Pinsels in eine andere Instanz von TBrush kopiert.


 TBrush

Der Konstruktor TBrush erzeugt und initialisiert eine Instanz von TBrush.

__fastcall TBrush(void);

Beschreibung

Mit TBrush wird eine neue Instanz von TBrush erstellt.


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TGraphicsObject


TBrush Beispiel

TBrush


TButtonControl

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/stdctrls.hpp

TButtonControl ist der Basisklassentyp für Schaltflächenobjekte von Borland C++Builder, die als Kapselung für die Schaltflächen-Steuerelemente von Windows fungieren.

Beschreibung

TButtonControl kapselt das Verhalten, das in Borland C++Builder allen Schaltflächen-Steuerelementen, Kontrollfeldern und Optionsfeldern gemeinsam ist.

TButtonControl überschreibt die Methode WndProc, um eine spezielle Behandlung des Fokuswechsels in Schaltflächen zu ermöglichen.


Eigenschaften von TButtonControl

TButtonControl	Alphabetisch	Legende

Abgeleitet von TWinControl

Brush

ClientOrigin

ClientRect

ControlCount

Controls

Handle

HelpContext

Showing

TabOrder

TabStop

Abgeleitet von TControl

Align

BoundsRect

ClientHeight

ClientWidth

ControlState

ControlStyle

Cursor

Enabled

Height

Hint

Left

Name

Parent

ShowHint

Top

Visible

Width

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TButtonControl

TButtonControl	Nach Objekten	Legende

Align

BoundsRect

Brush

ClientHeight

ClientOrigin

ClientRect

ClientWidth

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlCount

ControlState

Controls

ControlStyle

Cursor

DesignInfo

Enabled

Handle

Height

HelpContext

Hint

Left

Name

Owner

Parent

ShowHint

Showing

TabOrder

TabStop

Tag

Top

Visible

Width


Methoden von TButtonControl

TButtonControl	Alphabetisch	Legende

In TButtonControl

~TButtonControl

TButtonControl

WndProc

Abgeleitet von TWinControl

Broadcast

CanFocus

ContainsControl

ControlAtPos

DisableAlign

EnableAlign

Focused

GetTabOrderList

HandleAllocated

HandleNeeded

InsertControl

Invalidate

PaintTo

Realign

RemoveControl

Repaint

ScaleBy

ScrollBy

SetBounds

SetFocus

Update

UpdateControlState

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

GetTextLen

Hide

Perform

Refresh

ScreenToClient

SendToBack

SetTextBuf

Show

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TButtonControl

TButtonControl	Nach Objekten	Legende

~TButtonControl

Assign

BeginDrag

BringToFront

Broadcast

CanFocus

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

ClientToScreen

ContainsControl

ControlAtPos

DefaultHandler

DestroyComponents

Destroying

DisableAlign

Dispatch

DragDrop

Dragging

EnableAlign

EndDrag

FieldAddress

FindComponent

Focused

FreeInstance

FreeNotification

Free

GetParentComponent

GetTabOrderList

GetTextBuf

GetTextLen

HandleAllocated

HandleNeeded

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InsertControl

InstanceSize

Invalidate

MethodAddress

MethodName

NewInstance

PaintTo

Perform

Realign

Refresh

RemoveComponent

RemoveControl

Repaint

ScaleBy

ScreenToClient

ScrollBy

SendToBack

SetBounds

SetFocus

SetTextBuf

Show

TButtonControl

UpdateControlState

Update

WndProc


TButtonControl::~TButtonControl

TButtonControl

Der Destruktor ~TButtonControl gibt den Speicher frei, der für das TButtonControl-Objekt reserviert war. Rufen Sie ~TButtonControl nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TButtonControl automatisch aufgerufen wird.

__fastcall virtual ~TButtonControl(void);


TButtonControl::TButtonControl

TButtonControl

Der Konstruktor TButtonControl erzeugt ein neues TButtonControl-Objekt.

__fastcall virtual TButtonControl(Classes::TComponent* AOwner);


TButtonControl::WndProc

TButtonControl	Siehe auch

Die Methode WndProc überschreibt die geerbte Methode zur Bearbeitung von Schalflächenbotschaften.

virtual void __fastcall WndProc(Messages::TMessage &Message);

Beschreibung

WndProc ermöglicht es, daß Schaltflächenobjekte den Eingabefokus erhalten, wenn die Botschaft WM_LBUTTONDOWN oder WM_LBUTTONDBLCLK auftritt.


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Protected


Hierarchie

TObject

TPersistent

TComponent

TControl

TWinControl


TButtonControl Beispiel

TButtonControl


 TButton

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/stdctrls.hpp

TButton kapselt ein Schaltflächen-Steuerelement von Windows.

Die Benutzer können durch Auswahl eines Schaltflächen-Steuerelements eine Aktion auslösen. Schaltflächen finden vor allem in Dialogfeldern Verwendung.

Beschreibung

Unter der Standardschaltfläche versteht man die Schaltfläche, deren Behandlungsroutine für das Ereignis OnClick aufgerufen wird, sobald der Benutzer in einem Dialogfeld die EINGABE-Taste drückt. Um eine Schaltfläche als Standardschaltfläche zu deklarieren, setzen Sie ihre Default-Eigenschaft auf True.

Die Abbruch-Schaltfläche ist die Schaltfläche, deren Behandlungsroutine für das Ereignis OnClick aufgerufen wird, sobald der Benutzer in einem Dialogfeld die Taste ESC drückt. Um eine Schaltfläche zur Abbruch-Schaltfläche zu machen, setzen Sie ihre Eigenschaft Cancel auf True.

Sie können mit einer Schaltfläche das Schließen eines modalen Formulars veranlassen, ohne eine Ereignisbehandlungsroutine mit entsprechendem Programmcode zu schreiben. Setzen Sie dazu einfach die Eigenschaft ModalResult der Schaltfläche auf einen (zulässigen) Wert ungleich 0.


Eigenschaften von TButton

TButton	Alphabetisch	Legende

In TButton

Cancel

Default

ModalResult

Abgeleitet von TWinControl

Brush

ClientOrigin

ClientRect

ControlCount

Controls

Handle

HelpContext

Showing

TabOrder

TabStop

Abgeleitet von TControl

Align

BoundsRect

Caption

ClientHeight

ClientWidth

ControlState

ControlStyle

Cursor

DragCursor

DragMode

Enabled

Font

Height

Hint

Left

Name

Parent

ParentFont

ParentShowHint

PopupMenu

ShowHint

Top

Visible

Width

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TButton

TButton	Nach Objekten	Legende

Align

BoundsRect

Brush

Cancel

Caption

ClientHeight

ClientOrigin

ClientRect

ClientWidth

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlCount

ControlState

Controls

ControlStyle

Cursor

Default

DesignInfo

DragCursor

DragMode

Enabled

Font

Handle

Height

HelpContext

Hint

Left

ModalResult

Name

Owner

ParentFont

ParentShowHint

Parent

PopupMenu

ShowHint

Showing

TabOrder

TabStop

Tag

Top

Visible

Width


TButton::Cancel

TButton	Siehe auch	Beispiel

Mit der Eigenschaft Cancel kann eine Schaltfläche zur Abbruch-Schaltfläche gemacht werden.

__property bool Cancel;

Beschreibung

Ist Cancel auf True gesetzt, wird die OnClick-Ereignisbehandlungsroutine für die Schaltfläche jedesmal ausgeführt, wenn der Benutzer die Taste ESC drückt. In einer Anwendung können mehrere Schaltflächen als Abbruch-Schaltflächen deklariert sein. Das Formular ruft die OnClick-Ereignisbehandlungsroutine aber immer nur für die erste sichtbare Schaltfläche in der Tabulatorreihenfolge auf.


TButton::Default

TButton	Siehe auch

Diese Eigenschaft gibt an, ob eine Push- oder Bitmap-Schaltfläche die Standardschaltfläche ist.

__property bool Default;

Beschreibung

Ist Default auf True gesetzt, wird jedesmal die OnClick-Ereignisbehandlungsroutine für diese Schaltfläche ausgeführt, wenn der Benutzer die EINGABE-Taste drückt. Dies ist nur dann nicht der Fall, wenn der Benutzer vor dem Drücken der EINGABE-Taste eine andere Schaltfläche auswählt (dann wird die OnClick-Ereignisbehandlungsroutine für diese Schaltfläche ausgeführt). In einer Anwendung können mehrere Schaltflächen als Standardschaltflächen deklariert sein. Das Formular ruft die Ereignisbehandlungsroutine für OnClick immer für die erste Schaltfläche in der Tabulatorreihenfolge auf.

Jede Schaltfläche, die den Fokus besitzt, wird vorübergehend zur Standardschaltfläche. Wenn der Fokus an ein Steuerelement weitergegeben wird, das keine Schaltfläche ist, wird diejenige Schaltfläche wieder zur Standardschaltfläche, deren Default-Eigenschaft auf True gesetzt ist.


TButton::ModalResult

TButton	Siehe auch	Beispiel

ModalResult bestimmt, ob die Auswahl der Schaltfläche den modalen Zustand des Formulars beendet.

__property Forms::TModalResult ModalResult;

Beschreibung

Verwenden Sie die Eigenschaft ModalResult einer Schaltfläche, wenn das Klicken auf diese Schaltfläche zum Schließen eines modalen Formulars führen soll. Angenommen, Sie erstellen ein Dialogfeld mit den beiden Schaltern OK und Abbrechen und setzen die ModalResult-Eigenschaft für die OK-Schaltfläche auf mrOK und für die Abbrechen-Schaltfläche auf mrCancel. Da ModalResult signifikanter als mrNone ist, führt die Auswahl einer dieser Schaltflächen durch den Benutzer zur Beendigung des modalen Zustands des Dialogfeldes, und das Dialogfeld wird ausgeblendet. Die Verwendung von ModalResult macht das Schreiben einer Ereignisbehandlungsroutine zum Schließen des Dialogfeldes überflüssig.

Die folgenden Konstanten können als Werte für ModalResult verwendet werden:

Konstante	Wert

mrNone	0

mrOk	idOK

mrCancel	idCancel

mrAbort	idAbort

mrRetry	idRetry

mrIgnore	idIgnore

mrYes	idYes

mrNo	idNo

mrAll	mrNo + 1


Ereignisse von TButton

TButton	Alphabetisch	Legende

Abgeleitet von TWinControl

OnEnter

OnExit

OnKeyDown

OnKeyPress

OnKeyUp

Abgeleitet von TControl

OnClick

OnDragDrop

OnDragOver

OnEndDrag

OnMouseDown

OnMouseMove

OnMouseUp

OnStartDrag


Ereignisse von TButton

TButton	Nach Objekten	Legende

OnClick

OnDragDrop

OnDragOver

OnEndDrag

OnEnter

OnExit

OnKeyDown

OnKeyPress

OnKeyUp

OnMouseDown

OnMouseMove

OnMouseUp

OnStartDrag


Methoden von TButton

TButton	Alphabetisch

In TButton

~TButton

Click

TButton

Abgeleitet von TWinControl

Broadcast

CanFocus

ContainsControl

ControlAtPos

DisableAlign

EnableAlign

Focused

GetTabOrderList

HandleAllocated

HandleNeeded

InsertControl

Invalidate

PaintTo

Realign

RemoveControl

Repaint

ScaleBy

ScrollBy

SetBounds

SetFocus

Update

UpdateControlState

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

GetTextLen

Hide

Perform

Refresh

ScreenToClient

SendToBack

SetTextBuf

Show

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TButton

TButton	Nach Objekten

~TButton

Assign

BeginDrag

BringToFront

Broadcast

CanFocus

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

Click

ClientToScreen

ContainsControl

ControlAtPos

DefaultHandler

DestroyComponents

Destroying

DisableAlign

Dispatch

DragDrop

Dragging

EnableAlign

EndDrag

FieldAddress

FindComponent

Focused

FreeInstance

FreeNotification

Free

GetParentComponent

GetTabOrderList

GetTextBuf

GetTextLen

HandleAllocated

HandleNeeded

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InsertControl

InstanceSize

Invalidate

MethodAddress

MethodName

NewInstance

PaintTo

Perform

Realign

Refresh

RemoveComponent

RemoveControl

Repaint

ScaleBy

ScreenToClient

ScrollBy

SendToBack

SetBounds

SetFocus

SetTextBuf

Show

TButton

UpdateControlState

Update


TButton::~TButton

TButton

Der Destruktor ~TButton gibt den Speicher frei, der für das TButton-Objekt reserviert war. Rufen Sie ~TButton nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TButton automatisch aufgerufen wird.

__fastcall virtual ~TButton(void);


TButton::Click

TButton	Siehe auch

Die Methode Click simuliert einen Mausklick durch den Benutzer auf eine Schaltfläche.

virtual void __fastcall Click(void);

Beschreibung

Ein Aufruf von Click weist dem Formular den Wert der ModalResult-Eigenschaft der Schaltfläche zu und sorgt dann für den Aufruf der geerbten Click-Methode.


TButton::TButton

TButton	Siehe auch

TButton erzeugt eine Instanz des Schaltflächen-Steuerelements und initialisiert seine Werte.

__fastcall virtual TButton(Classes::TComponent* AOwner);

Beschreibung

Verwenden Sie TButton, um per Programmcode eine Schaltfläche zu instantiieren. Für Schaltflächen, die im Formular-Designer von Borland C++Builder erstellt werden, wird TButton automatisch aufgerufen.

TButton führt folgende Aktionen aus:

•	Der Konstruktor des übergeordneten Objekts wird aufgerufen.

•	Die ControlStyle-Eigenschaft der Schaltfläche wird auf die Werte csSetCaption, csOpaque, csDoubleClicks gesetzt.

•	Die Width-Eigenschaft wird auf 75 Pixel und die Height-Eigenschaft auf 25 Pixel gesetzt.

•	Die Eigenschaft TabStop wird auf True gesetzt.


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TControl

TWinControl

TButtonControl


TButton Beispiel

TButton


TBytesField

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/dbtables.hpp

Ein TBytesField-Objekt repräsentiert ein Byte-Feld in einer Datenmenge.

Beschreibung

Ein Byte-Feldwert ist eine Menge von unformatierten Bytes mit fester Länge.

TBytesField unterscheidet sich von seinem direkten Vorfahren TBinaryField nur in dessen Methode TBinaryFields, mit der der Datentyp auf ftBytes gesetzt wird. Als Nachkomme von TBinaryField erbt TBytesField viele Eigenschaften, Ereignisse und Methoden, die sich für die Verwaltung unformatierter Binärfelder in einer Datenmenge eignen.


Eigenschaften von TBytesField

TBytesField	Alphabetisch	Legende

Abgeleitet von TField

Alignment

AsBoolean

AsCurrency

AsDateTime

AsFloat

AsInteger

AsString

AsVariant

AttributeSet

BDECalcField

Calculated

CanModify

DataSet

DataSize

DataType

DisplayLabel

DisplayName

DisplayText

DisplayWidth

EditMask

EditMaskPtr

FieldKind

FieldName

FieldNo

Index

IsIndexField

IsNull

KeyFields

Lookup

LookupDataSet

LookupKeyFields

LookupResultField

NewValue

OldValue

ReadOnly

Required

Size

Text

Value

Visible

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Name

Owner

Tag


Eigenschaften von TBytesField

TBytesField	Nach Objekten	Legende

Alignment

AsBoolean

AsCurrency

AsDateTime

AsFloat

AsInteger

AsString

AsVariant

AttributeSet

BDECalcField

Calculated

CanModify

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

DataSet

DataSize

DataType

DesignInfo

DisplayLabel

DisplayName

DisplayText

DisplayWidth

EditMaskPtr

EditMask

FieldKind

FieldName

FieldNo

Index

IsIndexField

IsNull

KeyFields

LookupDataSet

LookupKeyFields

LookupResultField

Lookup

Name

NewValue

OldValue

Owner

ReadOnly

Required

Size

Tag

Text

Value

Visible


Ereignisse von TBytesField

TBytesField	Alphabetisch	Legende

Abgeleitet von TField

OnChange

OnGetText

OnSetText

OnValidate


Ereignisse von TBytesField

TBytesField	Nach Objekten	Legende

OnChange

OnGetText

OnSetText

OnValidate


Methoden von TBytesField

TBytesField	Alphabetisch

In TBytesField

~TBytesField

TBytesField

Abgeleitet von TField

Assign

AssignValue

Clear

FocusControl

GetData

IsValidChar

SetData

SetFieldType

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TBytesField

TBytesField	Nach Objekten

~TBytesField

Assign

AssignValue

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

Clear

DefaultHandler

DestroyComponents

Destroying

Dispatch

FieldAddress

FindComponent

FocusControl

FreeInstance

FreeNotification

Free

GetData

GetParentComponent

HasParent

InheritsFrom

InitInstance

InsertComponent

InstanceSize

IsValidChar

MethodAddress

MethodName

NewInstance

RemoveComponent

SetData

SetFieldType

TBytesField


TBytesField::~TBytesField

TBytesField

Der Destruktor ~TBytesField gibt den Speicher frei, der für das TBytesField-Objekt reserviert war. Rufen Sie ~TBytesField nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TBytesField automatisch aufgerufen wird.

__fastcall virtual ~TBytesField(void);


TBytesField::TBytesField

TBytesField

TBytesField erstellt eine Instanz von TBytesField.

Beschreibung

Rufen Sie TBytesField auf, wenn Sie eine Instanz von TBytesField erstellen und initialisieren wollen. Nach dem Aufruf des geerbten Konstruktors wird mit TBytesField die Eigenschaft DataType auf ftBytes gesetzt.

TBytesField muß nur selten explizit aufgerufen werden, weil ein Byte-Feldobjekt automatisch für alle Bytes-Felder in einer Datenmenge instantiiert wird.


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TField

TBinaryField


TBytesField Beispiel

TBytesField


TCanvas

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/graphics.hpp

Die Klasse TCanvas stellt eine abstrakte Zeichenfläche für Objekte dar, die sich selbst zeichnen müssen.

Beschreibung

TCanvas dient als Zeichenfläche für Objekte, die sich selbst zeichen. Die unter Windows üblichen Steuerelemente wie z.B. Eingabe- oder Listenfelder benötigen keine Zeichenfläche, da sie von Windows gezeichnet werden.

TCanvas stellt Eigenschaften, Ereignisse und Methoden zur Verfügung, die beim Erzeugen von Bildern hilfreich sind, indem sie

•	die Art des verwendeten Pinsels und Stiftes sowie die Schriftart festlegen.

•	eine Vielzahl von Fomen und Linien zeichnen und füllen.

•	Text ausgeben.

•	Grafiken zeichnen.

•	eine Reaktion auf Änderungen am aktuellen Bild ermöglichen.

TCanvas hat zwei Nachkommen, TControlCanvas und TMetafileCanvas, die beim Zeichnen von Steuerelementen und beim Erzeugen von Metafile-Βildern für Objekte hilfreich sind.


Eigenschaften von TCanvas

TCanvas	Alphabetisch	Legende

In TCanvas

Brush

ClipRect

CopyMode

Font

Handle

Pen

PenPos

Pixels


Eigenschaften von TCanvas

TCanvas	Nach Objekten	Legende

Brush

ClipRect

CopyMode

Font

Handle

PenPos

Pen

Pixels


TCanvas::Brush

TCanvas	Siehe auch	Beispiel

Die Eigenschaft Brush legt fest, welche Farbe und welches Muster die Zeichenfläche zum Füllen von graphischen Formen und Hintergründen verwendet.

__property TBrush* Brush;

Beschreibung

Indem Sie der Eigenschaft Brush einen Wert zuweisen, legen Sie die Farbe und das Muster fest, das beim Zeichnen des Hintergrunds oder beim Füllen grafischer Formen verwendet wird. Der Wert von Brush ist ein TBrush-Objekt. Über die Eigenschaften des TBrush-Objekts können Sie festlegen, welche Farbe, welches Muster oder welches Bitmap auf der Zeichenfläche verwendet wird.

Hinweis

Wenn Sie der Eigenschaft Brush einen Wert zuweisen, ersetzen Sie dadurch nicht das aktuelle TBrush-Objekt, sondern weisen nur das angegebene TBrush-Objekt zu.


TCanvas::ClipRect

TCanvas	Siehe auch

Die Eigenschaft ClipRect legt die Begrenzung des Clipping-Rechtecks fest.

__property Windows::TRect ClipRect;

Beschreibung

Mit ClipRect läßt sich der Zeichnungsbereich auf der Zeichenfläche begrenzen. Alle Zeichenvorgänge, die außerhalb der Koordinaten von ClipRect stattfinden, werden abgeschnitten und nicht auf dem Bildschirm angezeigt. Um beispielsweise einen Teil eines großen Kreises in einem kleineren Feld zu zeichnen, zeichnen Sie zuerst das Feld und definieren anschließend ClipRect entsprechend den inneren Abgrenzungen des Feldes. Wenn Sie nun den gesamten Kreis zeichnen, ist nur der Teil sichtbar, der sich innerhalb des Feldes befindet.

Bei der Bearbeitung des Ereignisses OnPaint eines Formulars wird der Eigenschaft ClipRect das Rechteck zugewiesen, das gezeichnet werden soll. Die Teile des Bildes, die außerhalb des Clipping-Rechtecks liegen, brauchen nicht gezeichnet zu werden. Deshalb können OnPaint-Routinen die Eigenschaft ClipRect zur Optimierung des Zeichenvorgangs und zum Beschleunigen der Anwendung verwenden.


TCanvas::CopyMode

TCanvas	Siehe auch

Die Eigenschaft CopyMode legt fest, wie die Grafik auf die Zeichenfläche kopiert wird.

__property long CopyMode;

Beschreibung

Mit dieser Eigenschaft können Sie beeinflussen, wie Grafiken auf der Zeichenfläche gezeichnet werden. CopyMode wird verwendet, wenn ein Bild mit der Methode CopyRect von einer anderen Zeichenfläche kopiert wird. Auch TBitmap-Objekte bedienen sich dieser Eigenschaft, wenn sie sich selbst auf einer Zeichenfläche zeichnen.

Mit CopyMode lassen sich beim Erzeugen eines Bildes eine Vielzahl von Effekten erzielen. Durch das Kombinieren von mehreren Bildern mit unterschiedlichen CopyModes können Sie Spezialeffekte erzielen, indem Sie beispielsweise Bilder mischen oder Teile eines Bitmaps transparent anzeigen.

Die folgende Tabelle zeigt und beschreibt die möglichen Werte für CopyMode:

Wert	Bedeutung

cmBlackness	Füllt das Zielrechteck auf der Zeichenfläche mit schwarzer Farbe.

cmDstInvert	Invertiert das Bild auf der Zeichenfläche und ignoriert die Quelle.

cmMergeCopy	Kombiniert das Bild auf der Zeichenfläche und das Quell-Bitmap unter Verwendung des booleschen Operators AND.

cmMergePaint	Kombiniert das invertierte Quell-Bitmap unter Verwendung des booleschen Operators OR mit dem Bild auf der Zeichenfläche.

cmNotSrcCopy	Kopiert das invertierte Quell-Bitmap auf die Zeichenfläche.

cmNotSrcErase	Kombiniert das Muster auf der Zeichenfläche und das Quell-Bitmap unter Verwendung des booleschen Operators OR und invertiert das Ergebnis.

cmPatCopy	Kopiert das Quellmuster auf die Zeichenfläche.

cmPatInvert	Kombiniert das Quellmuster unter Verwendung des booleschen Operators XOR mit dem Bild auf der Zeichenfläche.

cmPatPaint	Kombiniert das invertierte Quell-Bitmap unter Verwendung des booleschen Operators OR mit dem Quellmuster. Das Ergebnis dieses Vorgangs wird unter Verwendung des booleschen Operators OR mit dem Bild auf der Zeichenfläche kombiniert.

cmSrcAnd	Kombiniert unter Verwendung des booleschen Operators AND das Bild auf der Zeichenfläche und das Quell-Bitmap.

cmSrcCopy	Kopiert das Quell-Bitmap auf die Zeichenfläche.

cmSrcErase	Invertiert das Bild auf der Zeichenfläche und kombiniert das Ergebnis unter Verwendung des booleschen Operators OR mit dem Quell-Bitmap.

cmSrcInvert	Kombiniert unter Verwendung des booleschen Operators XOR das Bild auf der Zeichenfläche und das Quell-Bitmap.

cmSrcPaint	Kombiniert unter Verwendung des booleschen Operators OR das Bild auf der Zeichenfläche und das Quell-Bitmap.

cmWhiteness	Füllt das Zielrechteck auf der Zeichenfläche mit weißer Farbe.


TCanvas::Font

TCanvas	Siehe auch

Die Eigenschaft Font legt fest, welche Schriftart bei der Ausgabe von Text im Bildbereich verwendet wird.

__property TFont* Font;

Beschreibung

Mit Font können Sie festlegen, welche Schriftart bei der Ausgabe von Text im Bildbereich verwendet wird. Der Wert von Font ist ein TFont-Objekt. Über die Eigenschaften des TFont-Objekts können Sie Art, Farbe, Größe und Stil der Schrift festlegen.

Hinweis

Wenn Sie der Eigenschaft Font einen Wert zuweisen, ersetzen Sie dadurch nicht das aktuelle TFont-Objekt, sondern weisen nur das angegebene TFont-Objekt zu.


TCanvas::Handle

TCanvas	Siehe auch	Beispiel

Die Eigenschaft Handle ist das GDI-Handle von Windows für den Gerätekontext dieser Zeichenfläche.

__property HDC Handle;

Beschreibung

Setzen Sie Handle auf das HDC für den Gerätekontext, in dem die Zeichenfläche zeichnen soll. Wenn ein Steuerelement auf eine Paint-Botschaft von Windows reagiert, wird das HDC an die Methode PaintWindow übergeben. Andernfalls kann das HDC eines Fensters ermittelt werden, indem die Methode GetDeviceContext eines Steuerelements aufgerufen wird. Außerdem stellt Windows API-Aufrufe zur Verfügung, um ein HDC für einen Drucker oder ein gespeichertes Bild zu ermitteln.

Durch einen Lesezugriff auf die Eigenschaft Handle können Sie die im TCanvas-Objekt verfügbaren Zeichenfunktionen um API-Aufrufe ergänzen, die ein Handle für einen Gerätekontext erfordern. Fast alle Funktionen der Windows-GDI erwarten, daß ihnen ein HDC übergeben wird.

TCanvas ist nicht der Eigentümer des HDC. Das HDC muß von der Anwendung erzeugt und die Eigenschaft Handle explizit gesetzt werden. Außerdem muß das HDC von der Anwendung freigegeben werden, wenn es von der Zeichenfläche nicht mehr benötigt wird. Das Setzen der Eigenschaft Handle einer Zeichenfläche, die bereits über ein gültiges HDC verfügt, gibt das ursprüngliche HDC nicht automatisch frei.

Hinweis

Einige Nachkommen von TCanvas wie z.B. TControlCanvas sind Eigentümer des HDC. Bei diesen Objekten sollte die Eigenschaft Handle nicht gesetzt werden. Sie holen sich ihr Handle selbst und geben es auch selbst wieder frei.


TCanvas::Pen

TCanvas	Siehe auch

Die Eigenschaft Pen legt fest, welchen Stift die Zeichenfläche zum Zeichnen von Linien und Umrissen verwendet.

__property TPen* Pen;

Beschreibung

Mit Pen können Sie festlegen, welcher Stift zum Zeichnen von Linien und Umrissen im Bildbereich verwendet wird. Der Wert von Pen ist ein TPen-Objekt. Über die Eigenschaften des TPen-Objekts können Sie Farbe, Stil, Breite und Modus des Stifts festlegen.

Hinweis

Wenn Sie der Eigenschaft Pen einen Wert zuweisen, ersetzen Sie dadurch nicht das aktuelle TPen-Objekt, sondern weisen nur das angegebene TPen-Objekt zu.


TCanvas::PenPos

TCanvas	Siehe auch

Die Eigenschaft PenPos gibt die gegenwärtige Position des Stifts wieder.

__property POINT PenPos;

Beschreibung

Mit einem Lesezugriff auf PenPos können Sie die gegenwärtige Position des Stifts ermitteln. Diese Position bildet den Anfangspunkt einer Linie, die von der Methode LineTo gezeichnet wird. Ein Schreibzugriff auf PenPos ist mit einem Aufruf der Methode MoveTo identisch.


TCanvas::Pixels

TCanvas	Siehe auch

Die Eigenschaft Pixels gibt die Farbe der Pixel innerhalb des aktuellen Clipping-Rechtecks an.

__property TColor Pixels[int X][int Y];

Beschreibung

Mit einem Lesezugriff auf diese Eigenschaft können Sie ermitteln, welche Farbe die Zeichenfläche an einer bestimmten Stelle hat. Ein Schreibzugriff auf Pixels ändert die Farbe eines einzelnen Pixel auf der Zeichenfläche. Sie können mit dieser Eigenschaft also gezielte Änderungen an einem Bild vornehmen. Außerdem können Sie mit Pixels die Farbe festlegen, die für die Methode FillRect verwendet werden soll.

Der Wert von Pixels ist ein TColor-Wert. Wenn das vom Handle repräsentierte Gerät dies unterstützt, kann jeder vier Byte große RGB-Wert verwendet werden. Wenn Sie nicht die in der Unit Graphics definierten Konstanten verwenden, sondern TColor als RGB-Wert angeben, repräsentieren die drei niederwertigen Bytes die RGB-Farbintensität von Blau, Grün und Rot. Der Wert 0x00FF0000 steht für reines, intensives Blau, 0x0000FF00 ist reines Grün und 0x000000FF reines Rot. 0x00000000 entspricht Schwarz, 0x00FFFFFF Weiß.

Wenn das höchstwertige Byte Null ist (0x00), wird diejenige Farbe der Systempalette verwendet, die der gewünschten Farbe am nächsten kommt. Wenn das höchstwertige Byte Eins ist (0x01), wird diejenige Farbe der aktuellen Palette verwendet, die der gewünschten Farbe am nächsten kommt. Wenn das höchstwertige Byte Zwei ist (0x02), wird diejenige Farbe der logischen Palette des aktuellen Gerätekontexts verwendet, die der gewünschten Farbe am nächsten kommt.

Die folgende Tabelle enthält die Konstanten für Farbwerte, die in der Unit Graphics definiert sind.

Wert	Bedeutung

clBlack	Schwarz

clMaroon	Rotbraun

clGreen	Grün

clOlive	Olivgrün

clNavy	Marineblau

clPurple	Violett

clTeal	Blaugrün

clGray	Grau

clSilver	Silbergrau

clRed	Rot

clLime	Limonengrün

clBlue	Blau

clFuchsia	Pink

clAqua	Türkis

clWhite	Weiß

clBackground	Aktuelle Hintergrundfarbe des Windows Desktop

clActiveCaption	Aktuelle Farbe der Titelleiste des aktiven Fensters

clInactiveCaption	Aktuelle Farbe der Titelleiste inaktiver Fenster

clMenu	Aktuelle Hintergrundfarbe der Menüs

clWindow	Aktuelle Hintergrundfarbe der Fenster

clWindowFrame	Aktuelle Farbe der Fensterrahmen

clMenuText	Aktuelle Farbe von Menütext

clWindowText	Aktuelle Farbe von Fenstertext

clCaptionText	Aktuelle Farbe des Textes in der Titelleiste des aktiven
Fensters

clActiveBorder	Aktuelle Rahmenfarbe des aktiven Fensters

clInactiveBorder	Aktuelle Rahmenfarbe inaktiver Fenster

clAppWorkSpace	Aktuelle Farbe des Arbeitsbereichs der Anwendung

clHighlight	Aktuelle Hintergrundfarbe von markiertem Text

clHightlightText	Aktuelle Farbe von markiertem Text

clBtnFace	Aktuelle Farbe einer Schaltfläche

clBtnShadow	Aktuelle Farbe des Schattens einer Schaltfläche

clGrayText	Aktuelle Farbe von grau dargestelltem Text

clBtnText	Aktuelle Farbe von Text auf einer Schaltfläche

clInactiveCaptionText	Aktuelle Farbe des Textes in der Titelleiste eines inaktiven Fensters

clBtnHighlight	Aktuelle Farbe des Markierungsrahmens einer Schaltfläche

cl3DDkShadow 	Nur Windows 95 oder NT 4.0: dunkler Schatten für dreidimensionale Dialogelemente

cl3DLight 	Nur Windows 95 oder NT 4.0: helle Farbe für dreidimensionale Dialogelemente (für Kanten, die dem Licht zugewandt sind)

clInfoText 	Nur Windows 95 oder NT 4.0: Textfarbe für Tool-Tip-Steuerelemente

clInfoBk 	Nur Windows 95 oder NT 4.0: Hintergrundfarbe für Tool-Tip-Steuerelemente

Wenn der vorliegende Gerätekontext die Eigenschaft Pixels nicht unterstützt, gibt ein Lesezugriff den Wert -1 zurück. Die Zuweisung eines Wertes bleibt ohne Wirkung.

Hinweis

Die Eigenschaft Pixels bezieht sich nur auf Pixel, die innerhalb des aktuellen Clipping-Rechtecks liegen.


Ereignisse von TCanvas

TCanvas	Alphabetisch

In TCanvas

OnChange

OnChanging


Ereignisse von TCanvas

TCanvas	Nach Objekten

OnChange

OnChanging


TCanvas::OnChange

TCanvas	Siehe auch

Das Ereignis OnChange tritt unmittelbar nach jeder Änderung am Bild auf.

__property Classes::TNotifyEvent OnChange;

Beschreibung

Mit einer Ereignisbehandlungsroutine für OnChange können Sie bestimmte Aktionen durchführen, wenn sich das Bild auf der Zeichenfläche geändert hat. Wenn eine Anwendung eine der Zeichenmethoden von TCanvas aufruft, geschieht folgendes:

1	Das Ereignis OnChanging tritt auf.

2	Die Methode von TCanvas nimmt eine Änderung am Bild vor.

3	Das Ereignis OnChange tritt auf.

OnChange-Ereignisse werden durch Änderungen am Bild ausgelöst, nicht durch Änderungen an den Eigenschaften der Zeichenfläche. Anwendungen können auf Änderungen an den Eigenschaften Font, Brush und Pen reagieren, in dem Sie den entsprechenden TFont-, TBrush- und TPen-Objekten Ereignisbehandlungsroutinen für OnChange zuweisen. Allerdings weist TCanvas diesen Objekten seine eigenen Ereignisbehandlungsroutinen für OnChange zu. Bevor Sie also einem dieser Objekte eine solche Routine zuweisen, sollten Sie die bestehende ermitteln. Mit diesem Wert können Sie dann aus der neuen Ereignisbehandlungsroutine heraus die Ereignisbehandlungsroutine für TCanvas aufrufen.


TCanvas::OnChanging

TCanvas	Siehe auch

Das Ereignis OnChanging tritt unmittelbar vor einer Änderung am Bild auf.

__property Classes::TNotifyEvent OnChanging;

Beschreibung

Mit einer Ereignisbehandlungsroutine für OnChange können Sie bestimmte Schritte durchführen, bevor sich das Bild auf der Zeichenfläche ändert. Wenn eine Anwendung eine Zeichenmethode von TCanvas aufruft, geschieht folgendes:

1	Das Ereignis OnChanging tritt auf.

2	Die Methode von TCanvas nimmt eine Änderung am Bild vor.

3	Das Ereignis OnChange tritt auf.


Methoden von TCanvas

TCanvas	Alphabetisch

In TCanvas

~TCanvas

Arc

BrushCopy

Chord

CopyRect

Draw

DrawFocusRect

Ellipse

FillRect

FloodFill

FrameRect

LineTo

MoveTo

Pie

Polygon

Polyline

Rectangle

Refresh

RoundRect

StretchDraw

TCanvas

TextHeight

TextOut

TextRect

TextWidth

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TCanvas

TCanvas	Nach Objekten

~TCanvas

Arc

Assign

BrushCopy

Chord

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

CopyRect

DefaultHandler

Dispatch

DrawFocusRect

Draw

Ellipse

FieldAddress

FillRect

FloodFill

FrameRect

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

LineTo

MethodAddress

MethodName

MoveTo

NewInstance

Pie

Polygon

Polyline

Rectangle

Refresh

RoundRect

StretchDraw

TCanvas

TextHeight

TextOut

TextRect

TextWidth


TCanvas::~TCanvas

TCanvas	Siehe auch

Der Destruktor ~TCanvas gibt den Speicher frei, der für das TCanvas-Objekt reserviert war. Rufen Sie ~TCanvas nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TCanvas automatisch aufgerufen wird.

__fastcall virtual ~TCanvas(void);


TCanvas::Arc

TCanvas	Siehe auch

Die Methode Arc zeichnet einen Bogen entlang der Peripherie einer Ellipse, die von dem angegebenen Rechteck umgeben wird.

void __fastcall Arc(int X1, int Y1, int X2, int Y2, int X3, int Y3, int X4, int Y4);

Beschreibung

Mit der Methode Arc können Sie mit dem aktuellen Stift einen elliptischen Bogen zeichnen. Der Bogen liegt auf der Peripherie einer Ellipse, die durch die Koordinaten (X1,Y1) und (X2,Y2) definiert ist. Die Zeichnung verläuft gegen den Uhrzeigersinn und folgt vom Anfangs- bis zum Endpunkt der Peripherie der Ellipse. Der Anfangspunkt wird durch den Schnittpunkt der Ellipse mit einer Linie definiert, die durch den Mittelpunkt der Ellipse und durch den Punkt (X3,Y3) führt. Der Endpunkt wird durch den Schnittpunkt der Ellipse mit einer Linie definiert, die durch den Mittelpunkt der Ellipse und durch den Punkt (X4,Y4) führt.

Hinweis

Unter Windows 95 dürfen die Summen X1 + X2 und Y1 + Y2 den Wert 32768 nicht überschreiten. Das gleiche gilt für die Summe X1 + X2 + Y1 + Y2.

Unter NT kann die Zeichenrichtung mit der API-Funktion SetArcDirection geändert werden (die Zeichnung erfolgt dann im Uhrzeigersinn).


TCanvas::BrushCopy

TCanvas	Siehe auch

Die Methode BrushCopy kopiert einen Teil eines Bitmaps in ein Rechteck auf der Zeichenfläche, wobei eine der Farben des Bitmaps durch die Farbe des Pinsels der Zeichenfläche ersetzt wird.

void __fastcall BrushCopy(const Windows::TRect &Dest, TBitmap* Bitmap, const Windows::TRect &Source, TColor Color);

Beschreibung

Mit BrushCopy können Sie Spezialeffekte erzielen, indem Sie beispielsweise das kopierte Bild teilweise transparent machen. BrushCopy dient hauptsächlich der Abwärtskompatibilität. Verwenden Sie stattdessen ein TImageList-Objekt.

Der Parameter Dest gibt den rechteckigen Teil der Zeichenfläche an, in den das Bitmap kopiert werden soll. Bitmap gibt die Grafik an, die kopiert werden soll. Source ist der rechteckige Bereich innerhalb der Grafik, der kopiert werden soll. Color gibt an, welche Farbe im Bitmap durch die Farbe des Pinsels der Zeichenfläche ersetzt werden soll.

Mit BrushCopy können Sie das kopierte Bild teilweise transparent machen. Zu diesem Zweck weisen Sie die Farbe der Zeichenoberfläche (beispielsweise clBackground) der Eigenschaft Brush als Farbe zu und rufen anschließend BrushCopy auf.

Informationen über mögliche Werte des Parameters Color finden Sie in der Beschreibung der Eigenschaft Pixels.


TCanvas::Chord

TCanvas	Siehe auch

Die Methode Chord zeichnet einen geschlossenen Umriß, der von einer Linie und einer Ellipse begrenzt wird.

void __fastcall Chord(int X1, int Y1, int X2, int Y2, int X3, int Y3, int X4, int Y4);

Beschreibung

Mit Chord können Sie einen Umriß erzeugen, der von einem Bogen und einer Linie gebildet wird, die die Endpunkte des Bogens miteinander verbindet. Der Umriß besteht aus dem Teil einer Ellipse, die durch die Koordinaten (X1,Y1) und (X2,Y2) definiert ist. Die Ellipse wird durch eine Line geteilt, die durch die Punkte (X3,Y3) und (X4,Y4) verläuft.

Die Peripherie des Umrisses verläuft gegen den Uhrzeigersinn vom Punkt (X3,Y3) entlang der Ellipse nach (X4,Y4) und als gerade Linie zurück zu (X3,Y3). Wenn die Punkte (X3,Y3) und (X4,Y4) nicht auf der Oberfläche der Ellipse liegen, ergeben sich die Ecken des Umrisses aus den nächstliegenden Schnittpunkten der Peripherie und der Linie. Der Umriß wird mit dem aktuellen Stift gezeichnet und mit dem aktuellen Pinsel gefüllt.

Hinweis

Unter Windows 95 dürfen die Summen X1 + X2 und Y1 + Y2 den Wert 32768 nicht überschreiten. Das gleiche gilt für die Summe X1 + X2 + Y1 + Y2.

Unter NT kann die Zeichenrichtung mit der API-Funktion SetArcDirection geändert werden (die Zeichnung erfolgt dann im Uhrzeigersinn).


TCanvas::CopyRect

TCanvas	Siehe auch

Die Methode CopyRect kopiert einen Teil eines Bildes aus einer anderen Zeichenfläche in die Zeichenfläche.

void __fastcall CopyRect(const Windows::TRect &Dest, TCanvas* Canvas, const Windows::TRect &Source);

Beschreibung

Mit CopyRect können Sie einen Teil eines Bildes aus einer anderen Zeichenfläche in das Bild des TCanvas-Objekts kopieren. Die Eigenschaft Dest legt fest, in welches Rechteck innerhalb der Zeichenfläche das Quellbild kopiert werden soll. Der Parameter Canvas gibt die Zeichenfläche an, die das zu kopierende Bild enthält. Source legt das Rechteck fest, das den zu kopierenden Teil der Zeichenfläche enthält.

Der Kopiervorgang erfolgt in dem Modus, der durch CopyMode festgelegt ist.


TCanvas::Draw

TCanvas	Siehe auch

Die Methode Draw zeichnet am Punkt (X,Y) der Zeichenfläche die im Parameter Graphic angegebene Grafik.

void __fastcall Draw(int X, int Y, TGraphic* Graphic);

Beschreibung

Mit Draw können Sie auf der Zeichenfläche eine Grafik zeichnen. Draw ruft die Methode Draw der Grafik auf. Das Bild wird in einem Rechteck plaziert, das sich aus der Größe der Grafik ergibt. Die obere linke Ecke befindet sich am Punkt (X, Y).

Grafiken können Bitmaps, Symbole oder Metadateien sein. Wenn die Grafik ein TBitmap-Objekt ist, wird das Bitmap mit dem Wert von CopyMode gezeichnet.


TCanvas::DrawFocusRect

TCanvas	Siehe auch

Die Methode DrawFocusRect zeichnet ein Rechteck, wie es normalerweise fokussierte Objekte umgibt.

void __fastcall DrawFocusRect(const Windows::TRect &Rect);

Beschreibung

Mit DrawFocusRect können Sie die Peripherie eines Steuerelements, das gerade den Eingabefokus erhält oder weitergibt, mit einem gestrichelten Rahmen versehen. Da DrawFocusRect mit einer XOR-Funktion arbeitet, führt ein zweiter Aufruf mit dem gleichen Parameter dazu, daß der Rahmen wieder vom Bildschirm verschwindet.

Mit einem von dieser Funktion gezeichneten Rechteck kann kein Bildlauf durchgeführt werden. Wenn Sie in einem Bereich einen Bildlauf durchführen wollen, der ein von DrawFocusRect gezeichnetes Rechteck enthält, rufen Sie DrawFocusRect auf, um das Rechteck vom Bildschirm zu entfernen, und führen dann den Bildlauf durch. Am Ende zeichnen Sie das Rechteck mit DrawFocusRect noch einmal an der neuen Position.


TCanvas::Ellipse

TCanvas	Siehe auch

Die Methode Ellipse zeichnet auf der Zeichenfläche eine Ellipse, die durch ein umgebendes Rechteck definiert ist.

void __fastcall Ellipse(int X1, int Y1, int X2, int Y2);

Beschreibung

Mit Ellipse können Sie auf der Zeichenfläche einen Kreis oder eine Ellipse zeichnen. Die linke obere Ecke des umgebenden Rechtecks befindet sich an den Pixel-Koordinaten (X1, Y1), die rechte untere Ecke an den Koordinaten (X2, Y2). Wenn die Ecken des Recktecks ein Quadrat bilden, wird ein Kreis gezeichnet.

Die Ellipse wird mit dem aktuellen Stift gezeichnet und mit dem aktuellen Pinsel gefüllt.

Hinweis

Unter Windows 95 dürfen die Summen X1 + X2 und Y1 + Y2 den Wert 32768 nicht überschreiten. Das gleiche gilt für die Summe X1 + X2 + Y1 + Y2.


TCanvas::FillRect

TCanvas	Siehe auch

Die Methode FillRect füllt unter Verwendung des aktuellen Pinsels das angegebene Rechteck auf der Zeichenfläche.

void __fastcall FillRect(const Windows::TRect &Rect);

Beschreibung

Mit FillRect können Sie unter Verwendung des aktuellen Pinsels einen rechteckigen Bereich füllen. Die Operation schließt die obere und die linke, nicht jedoch die untere und die rechte Begrenzungslinie des Rechtecks mit ein.


TCanvas::FloodFill

TCanvas	Siehe auch

Die Methode FloodFill füllt unter Verwendung des aktuellen Pinsels einen Bereich der Zeichenfläche.

void __fastcall FloodFill(int X, int Y, TColor Color, TFillStyle FillStyle);

Beschreibung

Mit FloodFill können Sie unter Verwendung des aktuellen Pinsels einen (nicht unbedingt rechteckigen) Bereich des Bildes füllen. Als Begrenzung des Bereichs wird ausgehend vom Punkt (X,Y) jede Änderung der im Parameter Color angegebenen Farbe angesehen.

Die folgende Tabelle zeigt, welche Art von Farbänderung als Bereichsgrenze interpretiert wird.

Wert	Bedeutung

fsSurface	Füllt den Bereich, solange er die im Parameter Color angegebene Farbe hat. Bei jeder anderen Farbe wird der Vorgang beendet.

fsBorder	Füllt den Bereich, solange er nicht die im Parameter Color angegebene Farbe hat. Bei der angegebenen Farbe wird der Vorgang beendet.

Wenn Sie fsSurface als FillStyle verwenden, können Sie mit der Eigenschaft Pixels den genauen Wert der Farbe am Punkt (X,Y) ermitteln. Bei fsBorder können Sie mit derselben Eigenschaft den genauen Farbwert der Begrenzung ermitteln, wenn einer der Begrenzungspunkte bekannt ist.


TCanvas::FrameRect

TCanvas	Siehe auch

Die Methode FrameRect zeichnet ein Rechteck und verwendet für den Rahmen die Eigenschaft Brush der Zeichenfläche.

void __fastcall FrameRect(const Windows::TRect &Rect);

Beschreibung

Mit FrameRect können Sie einen Rahmen von einem Pixel Breite um einen rechteckigen Bereich ziehen. FrameRect füllt das Rechteck nicht mit dem in der Eigenschaft Brush festgelegten Muster.

Um eine Begrenzung mit dem Stift zu zeichnen, verwenden Sie die Methode Polygon.


TCanvas::LineTo

TCanvas	Siehe auch

Die Methode LineTo zeichnet ausgehend von der aktuellen Stiftposition (PenPos) eine Linie zum Punkt (X,Y) und setzt PenPos anschließend auf (X, Y).

void __fastcall LineTo(int X, int Y);

Beschreibung

Mit LineTo können Sie eine Line von PenPos zum Punkt (X,Y) ziehen. Der Zielpunkt selbst gehört jedoch nicht mehr zur Linie. LineTo ändert den Wert von PenPos in (X,Y).

Die Linie wird mit dem aktuellen Stift gezeichnet.


TCanvas::MoveTo

TCanvas	Siehe auch

Die Methode MoveTo macht den Punkt (X,Y) zur aktuellen Zeichenposition.

void __fastcall MoveTo(int X, int Y);

Beschreibung

Mit MoveTo können Sie vor dem Aufruf von LineTo den Wert von PenPos setzen. Ein Aufruf von MoveTo ist mit der Zuweisung eines Wertes an PenPos identisch.


TCanvas::Pie

TCanvas	Siehe auch

Die Methode Pie zeichnet einen Abschnitt der Ellipse, die durch das Rechteck (X1, Y1) und (X2, Y2) begrenzt ist.

void __fastcall Pie(int X1, int Y1, int X2, int Y2, int X3, int Y3, int X4, int Y4);

Beschreibung

Mit dieser Methode können Sie einen Umriß zeichnen, dessen Form einem Stück Torte ähnelt. Der Umriß wird durch die Ellipse definiert, die vom Rechteck (X1, Y1) und (X2, Y2) umgeben ist. Den zu zeichnenden Abschnitt begrenzen zwei Linien, die vom Zentrum der Ellipse ausgehen und durch die Punkte (X3, Y3) und (X4, Y4) führen.

Der Umriß wird mit dem aktuellen Stift gezeichnet und mit dem aktuellen Pinsel gefüllt.

Hinweis

Unter Windows 95 dürfen die Summen X1 + X2 und Y1 + Y2 den Wert 32768 nicht überschreiten. Das gleiche gilt für die Summe X1 + X2 + Y1 + Y2.


TCanvas::Polygon

TCanvas	Siehe auch

Die Methode Polygon zeichnet eine Reihe von Linien auf der Zeichenfläche, die die als Parameter übergebenen Punkte der Reihe nach verbinden. Eine Linie vom letzten zum ersten Punkt schließt den Umriß.

void __fastcall Polygon(const POINT *Points, const int Points_Size);

Beschreibung

Mit dieser Methode könne Sie unter Verwendung des aktuellen Stifts eine in sich geschlossene, vieleckige Form zeichnen. Die Form wird mit dem aktuellen Pinsel gefüllt.

Mit der Methode Polyline können Sie ein Polygon zeichnen, ohne es zu füllen, indem Sie den ersten Punkt am Ende nochmals angeben.

Mit Hilfe der Funktion Slice kann der Methode Polygon ein Teil eines Arrays von Punkten übergeben werden. Um beispielsweise aus den ersten zehn Punkten eines Arrays mit insgesamt 100 Punkten ein Polygon zu bilden, verwenden Sie die Funktion Slice wie folgt:


TCanvas::Polyline

TCanvas	Siehe auch

Die Methode Polyline zeichnet mit dem aktuellen Stift einen Linienzug, indem die im Parameter Points übergebenen Punkte miteinander verbunden werden.

void __fastcall Polyline(const POINT *Points, const int Points_Size);

Beschreibung

Mit dieser Methode können Sie auf der Zeichenfläche eine Reihe von Punkten miteinander verbinden. Wenn nur zwei Punkte zu verbinden sind, zeichnet Polyline eine Linie.

Ein Aufruf der Funtion MoveTo mit dem Wert des ersten Punktes und wiederholte Aufrufe von LineTo mit allen weiteren Punkten führen zum selben Ergebnis. Im Gegensatz zu LineTo ändert Polyline jedoch nicht den Wert von PenPos.

Mit Hilfe der Funktion Slice kann der Methode Polygon ein Teil eines Arrays von Punkten übergeben werden. Um beispielsweise aus den ersten zehn Punkten eines Arrays mit insgesamt 100 Punkten ein Polygon zu bilden, verwenden Sie die Funktion Slice wie folgt:

$$


TCanvas::Rectangle

TCanvas	Siehe auch

Die Methode Rectangle zeichnet ein Rechteck mit der linken oberen Ecke am Punkt (X1, Y1) und der rechten unteren Ecke am Punkt (X2, Y2).

void __fastcall Rectangle(int X1, int Y1, int X2, int Y2);

Beschreibung

Mit Rectangle können Sie unter Verwendung des aktuellen Stifts ein Rechteck zeichnen und es mit dem aktuellen Pinsel füllen. Um einen rechteckigen Bereich zu füllen, ohne für den Umriß den aktuellen Pinsel zu verwenden, bedienen Sie sich der Methode FillRect. Mit FrameRect oder Polygon können Sie den Umriß eines rechteckigen Bereichs zeichnen, ohne diesen zu füllen. Mit RoundRect können Sie ein Rechteck mit abgerundeten Ecken zeichnen.


TCanvas::Refresh

TCanvas	Siehe auch

Die Methode Refresh trennt die Eigenschaften Pen, Brush und Font vom Gerätekontext.

void __fastcall Refresh(void);

Beschreibung

Mit Refresh können Sie das von der Zeichenfläche verwendete HDC auf einen Vorgabewert zurücksetzen. Die Werte der Eigenschaften Font, Brush oder Pen ändern sich durch den Aufruf nicht. Nach Refresh weist der Aufruf einer beliebigen Zeichenmethode des TCanvas-Objekts dem HDC wieder die Eigenschaften Font, Brush oder Pen zu, sofern sie von der Zeichenmethode verwendet werden.


TCanvas::RoundRect

TCanvas	Siehe auch

Die Methode RoundRect zeichnet ein Rechteck mit abgerundeten Ecken.

void __fastcall RoundRect(int X1, int Y1, int X2, int Y2, int X3, int Y3);

Beschreibung

Mit RoundRect können Sie unter Verwendung des aktuellen Stifts ein Rechteck mit abgerundeten Ecken zeichnen. Das Rechteck wird mit dem aktuellen Pinsel gefüllt. Die Punkte (X1,Y1), (X2,Y1), (X2,Y2) und (X1,Y2) bilden die Eckpunkte des Rechtecks. Die Ecken sind leicht abgerundet.

Wenn Sie eine Ellipse zeichnen wollen, verwenden Sie die Methode Ellipse. Zum Zeichnen eines richtigen Rechtecks verwenden Sie Rectangle.


TCanvas::StretchDraw

TCanvas	Siehe auch

Die Methode StretchDraw zeichnet die im Parameter Graphic angegebene Grafik in dem Rechteck, das im Parameter Rect angegeben ist.

void __fastcall StretchDraw(const Windows::TRect &Rect, TGraphic* Graphic);

Beschreibung

Mit StretchDraw können Sie eine Grafik genau in ein angegebenes Reckteck einpassen. StretchDraw ruft die Methode Draw der Grafik auf. Auf welche Weise die Grafik in das Rechteck eingepasst wird, hängt vom jeweiligen Grafikobjekt ab. Unter Umständen ändert sich dabei der Vergrößerungsfaktor und/oder das Seitenverhältnis.

Um die Grafik in ihrer ursprünglichen Größe zu zeichnen, verwenden Sie die Methode Draw.

Grafiken können Bitmaps, Symbole oder Metadateien sein. Wenn die Grafik ein TBitmap-Objekt ist, wird das Bitmap mit dem Wert von CopyMode gezeichnet.


TCanvas::TCanvas

TCanvas	Siehe auch

Der Konstruktor TCanvas erzeugt ein neues TCanvas-Objekt.

__fastcall TCanvas(void);

Beschreibung

Mit TCanvas wird ein TCanvas-Objekt instantiiert. TCanvas reserviert Speicher für die Instanz von TCanvas und erzeugt die Objekte TFont, TBrush und TPen für die Eigenschaften Font, Brush und Pen. TCanvas initialisiert die außerdem die Eigenschaft CopyMode mit cmSrcCopy.


TCanvas::TextHeight

TCanvas	Siehe auch

Die Methode TextHeight gibt die Höhe eines Strings, der in der aktuellen Schriftart ausgegeben wird, in der Einheit Pixel zurück.

int __fastcall TextHeight(const System::AnsiString Text);

Beschreibung

Mit TextHeight können Sie feststellen, welche Höhe ein String im Bild einnehmen wird. Andere Elemente des Bildes wie beispielsweise Linien, Felder oder weitere Textzeilen können dann entsprechend dieser Texthöhe positioniert werden.


TCanvas::TextOut

TCanvas	Siehe auch

Die Methode TextOut gibt beginnend am Punkt (X,Y) einen String auf der Zeichenfläche aus und setzt die Eigenschaft PenPos auf das Ende des Strings.

void __fastcall TextOut(int X, int Y, const System::AnsiString Text);

Beschreibung

Mit TextOut können Sie einen String auf der Zeichenfläche ausgeben. Als Schriftart wird dabei der aktuelle Wert von Font verwendet. Mit den Methoden TextHeight und TextWidth können Sie feststellen, wieviel Platz der Text im Bild belegt. Wenn Sie nur denjenigen Teil eines Textes ausgeben wollen, der innerhalb eines Clipping-Rechtecks liegt, verwenden Sie stattdessen die Methode TextRect.


TCanvas::TextRect

TCanvas	Siehe auch

TextRect gibt einen String innerhalb eines Clipping-Rechtecks aus.

void __fastcall TextRect(const Windows::TRect &Rect, int X, int Y, const System::AnsiString Text);

Beschreibung

Mit TextRect können Sie einen String in einem begrenzten rechteckigen Bereich ausgeben. Alle Teile des Strings, die außerhalb des im Parameter Rect übergebenen Rechtecks liegen, werden abgeschnitten und nicht angezeigt. Die linke obere Ecke des Textes wird am Punkt (X,Y) plaziert.


TCanvas::TextWidth

TCanvas	Siehe auch

Die Methode TextWidth gibt die Breite eines Strings, der in der aktuellen Schriftart ausgegeben wird, in der Einheit Pixel zurück.

int __fastcall TextWidth(const System::AnsiString Text);

Beschreibung

Mit TextWidth können Sie feststellen, welche Breite ein String im Bild einnimmt. TextWidth gibt an, ob der verfügbare Platz für einen bestimmten String ausreicht. Andere grafische Elemente des Bildes wie beispielsweise Linien oder weitere Strings können dann entsprechend dieser Textbreite positioniert werden.


Gültigkeitsbereich

Published

Zugriff

Read-only


Hierarchie

TObject

TPersistent


TCanvas Beispiel

TCanvas


 TCheckBox

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/stdctrls.hpp

TCheckBox repräsentiert ein Kontrollfeld von Windows.

Beschreibung

Eine TCheckBox-Komponente stellt eine Option für den Benutzer bereit. Dieser kann das Kontrollfeld markieren, um die zugehörige Option auszuwählen, oder die Markierung aus dem Feld entfernen, um die Option zu deaktivieren.


Eigenschaften von TCheckBox

TCheckBox	Alphabetisch	Legende

Abgeleitet von TCustomCheckBox

Alignment

AllowGrayed

Checked

State

Abgeleitet von TWinControl

Brush

ClientOrigin

ClientRect

ControlCount

Controls

Ctl3D

Handle

HelpContext

ParentCtl3D

Showing

TabOrder

TabStop

Abgeleitet von TControl

Align

BoundsRect

Caption

ClientHeight

ClientWidth

Color

ControlState

ControlStyle

Cursor

DragCursor

DragMode

Enabled

Font

Height

Hint

Left

Name

Parent

ParentColor

ParentFont

ParentShowHint

PopupMenu

ShowHint

Top

Visible

Width

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TCheckBox

TCheckBox	Nach Objekten	Legende

Alignment

Align

AllowGrayed

BoundsRect

Brush

Caption

Checked

ClientHeight

ClientOrigin

ClientRect

ClientWidth

Color

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlCount

ControlState

Controls

ControlStyle

Ctl3D

Cursor

DesignInfo

DragCursor

DragMode

Enabled

Font

Handle

Height

HelpContext

Hint

Left

Name

Owner

ParentColor

ParentCtl3D

ParentFont

ParentShowHint

Parent

PopupMenu

ShowHint

Showing

State

TabOrder

TabStop

Tag

Top

Visible

Width


Ereignisse von TCheckBox

TCheckBox	Alphabetisch	Legende

Abgeleitet von TWinControl

OnEnter

OnExit

OnKeyDown

OnKeyPress

OnKeyUp

Abgeleitet von TControl

OnClick

OnDragDrop

OnDragOver

OnEndDrag

OnMouseDown

OnMouseMove

OnMouseUp

OnStartDrag


Ereignisse von TCheckBox

TCheckBox	Nach Objekten	Legende

OnClick

OnDragDrop

OnDragOver

OnEndDrag

OnEnter

OnExit

OnKeyDown

OnKeyPress

OnKeyUp

OnMouseDown

OnMouseMove

OnMouseUp

OnStartDrag


Methoden von TCheckBox

TCheckBox	Alphabetisch

In TCheckBox

~TCheckBox

TCheckBox

Abgeleitet von TWinControl

Broadcast

CanFocus

ContainsControl

ControlAtPos

DisableAlign

EnableAlign

Focused

GetTabOrderList

HandleAllocated

HandleNeeded

InsertControl

Invalidate

PaintTo

Realign

RemoveControl

Repaint

ScaleBy

ScrollBy

SetBounds

SetFocus

Update

UpdateControlState

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

GetTextLen

Hide

Perform

Refresh

ScreenToClient

SendToBack

SetTextBuf

Show

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TCheckBox

TCheckBox	Nach Objekten

~TCheckBox

Assign

BeginDrag

BringToFront

Broadcast

CanFocus

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

ClientToScreen

ContainsControl

ControlAtPos

DefaultHandler

DestroyComponents

Destroying

DisableAlign

Dispatch

DragDrop

Dragging

EnableAlign

EndDrag

FieldAddress

FindComponent

Focused

FreeInstance

FreeNotification

Free

GetParentComponent

GetTabOrderList

GetTextBuf

GetTextLen

HandleAllocated

HandleNeeded

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InsertControl

InstanceSize

Invalidate

MethodAddress

MethodName

NewInstance

PaintTo

Perform

Realign

Refresh

RemoveComponent

RemoveControl

Repaint

ScaleBy

ScreenToClient

ScrollBy

SendToBack

SetBounds

SetFocus

SetTextBuf

Show

TCheckBox

UpdateControlState

Update


TCheckBox::~TCheckBox

TCheckBox

Der Destruktor ~TCheckBox gibt den Speicher frei, der für das TCheckBox-Objekt reserviert war. Rufen Sie ~TCheckBox nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TCheckBox automatisch aufgerufen wird.

__fastcall virtual ~TCheckBox(void);


TCheckBox::TCheckBox

TCheckBox

Der Konstruktor TCheckBox erzeugt ein neues TCheckBox-Objekt.

__fastcall virtual TCheckBox(Classes::TComponent* AOwner);


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TControl

TWinControl

TButtonControl

TCustomCheckBox


TCheckBox Beispiel

TCheckBox


TChangeLink

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/controls.hpp

Das von der Komponente TImageList intern verwendete TChangeLink-Objekt informiert andere Objekte über Änderungen an der Bilderliste.

Beschreibung

Ein TImageList-Objekt verwaltet eine Liste seiner TChangeLink-Objekte. Jedes dieser Objekte ist mit einer bestimmten Komponente verknüpft, z.B. mit einem Baumdiagramm oder einem Listenfeld. Eine Komponente kann ihr TChangeLink-Objekt bei einem TImageList-Objekt registrieren, indem sie dessen Methode RegisterChanges aufruft. Vor der Freigabe sollte die Komponente die Methode UnregisterChanges aufrufen.

Komponentenentwickler können sich mit Hilfe eines TChangeLink-Objekts über Änderungen an der Bilderliste eines Steuerelements benachrichtigen lassen. In einer Behandlungsroutine für das Ereignis OnChange des TChangeLink-Objekts können bestimmte Anweisungen ausgeführt werden, wenn sich die Bilderliste ändert. Ein Baumdiagramm stellt beispielsweise mit Hilfe eines TChangeLink-Objekts fest, wann sich seine Bilderliste ändert.


Eigenschaften von TChangeLink

TChangeLink	Alphabetisch

In TChangeLink

Sender


Eigenschaften von TChangeLink

TChangeLink	Nach Objekten

Sender


TChangeLink::Sender

TChangeLink	Siehe auch

Die Eigenschaft Sender gibt an, welche Komponente der Bilderliste das TChangeLink-Objekt über Änderungen informiert.

__property TCustomImageList* Sender;

Beschreibung

Das TImageList-Objekt weist dieser Eigenschaft automatisch einen Wert zu, wenn RegisterChanges aufgerufen wird.


Ereignisse von TChangeLink

TChangeLink	Alphabetisch

In TChangeLink

OnChange


Ereignisse von TChangeLink

TChangeLink	Nach Objekten

OnChange


TChangeLink::OnChange

TChangeLink	Siehe auch

Das Ereignis OnChange tritt auf, wenn an einem beliebigen Bild, das in der verknüpften Bilderliste gespeichert ist, eine Änderung vorgenommen wird.

__property Classes::TNotifyEvent OnChange;

Beschreibung

Mit OnChange können Sie ein Steuerelement über Änderungen an der von ihm verwendeten Bilderliste informieren. Die Ereignisbehandlungsroutine für OnChange sollte alle Anweisungen enthalten, die zu diesem Zeitpunkt ausgeführt werden sollen.

Der Typ TNotifyEvent wird für Ereignisse verwendet, die keine Parameter haben. Solche Ereignisse benachrichtigen einfach das Objekt, wenn ein bestimmtes Ereignis, in diesem Fall OnChange, eingetreten ist.


Methoden von TChangeLink

TChangeLink	Alphabetisch

In TChangeLink

~TChangeLink

Change

TChangeLink

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TChangeLink

TChangeLink	Nach Objekten

~TChangeLink

Change

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance

TChangeLink


TChangeLink::~TChangeLink

TChangeLink	Siehe auch

Der Destruktor ~TChangeLink gibt den Speicher frei, der für das TChangeLink-Objekt reserviert war. Rufen Sie ~TChangeLink nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TChangeLink automatisch aufgerufen wird.

__fastcall virtual ~TChangeLink(void);


TChangeLink::Change

TChangeLink	Siehe auch

Die Methode Change ruft die Ereignisbehandlungsroutine für OnChange auf, falls eine solche definiert wurde.

virtual void __fastcall Change(void);

Beschreibung

Mit Change können Sie die Behandlungsroutine für das Ereignis OnChange des TChangeLink-Objekts aufrufen.


TChangeLink::TChangeLink

TChangeLink

Der Konstruktor TChangeLink erzeugt ein neues TChangeLink-Objekt.

__fastcall TChangeLink(void);


Hierarchie

TObject


TChangeLink Beispiel

TChangeLink


TClipboard

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/clipbrd.hpp

TClipboard kapselt die Zwischenablage von Windows.

Beschreibung

Die Zwischenablage von Windows bildet den Container für alle Texte und Grafiken, die in einer Anwendung ausgeschnitten, kopiert und eingefügt werden. TClipboard übernimmt in Borland C++Builder die Kapselung der Windows-Zwischenablage.

Die Unit Clipbrd deklariert die Variable für die Zwischenablage als Instanz von TClipboard. Der Zugriff auf diese Variable erfolgt durch einen Aufruf der Funktion Clipboard. Greifen Sie immer auf diese Weise auf ein Zwischenablageobjekt zu, und instantiieren Sie es nicht durch einen Aufruf des Konstruktors Create. Durch den Einsatz der Funktion Clipboard wird ein unbeabsichtigtes Löschen der Zwischenablage ausgeschlossen.

Die Eigenschaften des Zwischenablageobjekts stellt Informationen über die Formate bereit, die für die Verwaltung durch die Zwischenablage „registriert“ sind.

Mit den Methoden der Zwischenablage können folgende Aktionen durchgeführt werden:

•	Ermitteln und Abrufen von Daten im korrekten Format.

•	Verwaltung eines Referenzählers sowie öffnen und Schließen der Zwischenablage.

•	Verwalten und Bearbeiten von Formaten für die Objekte in der Zwischenablage.

Mit Hilfe der Eigenschaft AsText können Sie Text in die Zwischenablage bringen und aus ihr abrufen. Um Bilder in der Zwischenablage zu plazieren oder daraus abzurufen, verwenden Sie die Eigenschaft Assign. Durch einen Aufruf der Methoden GetComponent und SetComponent können Sie ein Komponentenobjekt zur Zwischenablage hinzufügen bzw. daraus abrufen.

Eine Liste aller aktuellen Formate in der Zwischenablage erhalten Sie über die Eigenschaft Formats. Der Wert der Eigenschaft FormatCount gibt die Anzahl der Formate an. Durch einen Aufruf der Methode HasFormat können Sie feststellen, ob ein bestimmtes Format in der Zwischenablage enthalten ist.

Jedesmal, wenn ein Element in die Zwischenablage eingefügt wird, wird automatisch ihr vorheriger Inhalt gelöscht. Verwenden Sie die Methode Open, wenn Sie mehrere Elemente in die Zwischenablage einfügen wollen. Dadurch läßt sich das Überschreiben des vorhandenen Inhalts bzw. dessen Änderung durch eine andere Anwendung verhindern. Wenn keine weiteren Elemente in die Zwischenablage eingefügt werden sollen, rufen Sie die Methode Close auf.

Wenn Sie Windows-Handles mit den Methoden GetAsHandle und SetAsHandle einsetzen, können Sie andere Formate zur Zwischenablage hinzufügen.


Eigenschaften von TClipboard

TClipboard	Alphabetisch	Legende

In TClipboard

AsText

FormatCount

Formats


Eigenschaften von TClipboard

TClipboard	Nach Objekten	Legende

AsText

FormatCount

Formats


TClipboard::AsText

TClipboard	Siehe auch

Die Eigenschaft AsText gibt den aktuellen Inhalt der Zwischenablage als String zurück.

__property System::AnsiString AsText;

Beschreibung

Mit der Eigenschaft AsText können Sie eine Kopie eines Strings in die Zwischenablage einfügen. Weisen Sie der AsText-Eigenschaft einen String als Wert zu.

Der String-Wert für die Eigenschaft AsText darf maximal 255 Zeichen lang sein. Wenn Sie mehr als 255 Zeichen in die Zwischenablage einfügen oder aus ihr abrufen wollen, verwenden Sie die TClipboard-Methoden SetTextBuf bzw. GetTextBuf.

Wenn die Zwischenablage keinen String enthält, wird eine Exception ausgelöst. Mit der Methode HasFormat kann festgestellt werden, ob die Zwischenablage einen String-Typ enthält.


TClipboard::FormatCount

TClipboard	Siehe auch

Die Eigenschaft FormatCount enthält die Anzahl der Formate in der Array-Eigenschaft Formats.

__property int FormatCount;

Beschreibung

Über die Eigenschaft FormatCount kann festgestellt werden, wie viele verschiedene Formattypen für die Zwischenablage registriert sind. FormatCount ist eine Nur-Lesen-Eigenschaft.

Verwenden Sie die Eigenschaft Formats zur Ermittlung aller Formattypen, die aktuell für die Zwischenablage registriert sind. Mit der Methode HasFormat können Sie feststellen, ob ein bestimmtes Format in der Zwischenablage enthalten ist.


TClipboard::Formats

TClipboard	Siehe auch

Formats besteht aus einer Liste mit alle Formaten, die in der Zwischenablage enthalten sind.

__property unsigned short Formats[int Index];

Beschreibung

Mit Hilfe der Eigenschaft Formats können Sie unter Verwendung des Index-Parameters auf ein Format über seine Position im Array zugreifen.

Wenn eine Anwendung ein Element in die Zwischenablage kopiert oder ausschneidet, wird das Element normalerweise in einem bestimmten Format in die Zwischenablage gebracht.

Wenn das betreffende Format im Formats-Array enthalten ist, können Elemente mit einem bestimmten Format in der Zwischenablage plaziert oder daraus abgerufen werden. Mit der Methode HasFormat können Sie feststellen, ob ein bestimmtes Format in der Zwischenablage enthalten ist.


Methoden von TClipboard

TClipboard	Alphabetisch

In TClipboard

~TClipboard

Assign

Clear

Close

GetAsHandle

GetComponent

GetTextBuf

HasFormat

Open

SetAsHandle

SetComponent

SetTextBuf

TClipboard

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TClipboard

TClipboard	Nach Objekten

~TClipboard

Assign

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

Clear

Close

DefaultHandler

Dispatch

FieldAddress

FreeInstance

Free

GetAsHandle

GetComponent

GetTextBuf

HasFormat

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance

Open

SetAsHandle

SetComponent

SetTextBuf

TClipboard


TClipboard::~TClipboard

TClipboard	Siehe auch

Der Destruktor ~TClipboard gibt den Speicher frei, der für das TClipboard-Objekt reserviert war. Rufen Sie ~TClipboard nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TClipboard automatisch aufgerufen wird.

__fastcall virtual ~TClipboard(void);


TClipboard::Assign

TClipboard	Siehe auch

Die Methode Assign weist das im Parameter Source angegebene Objekt der Zwischenablage zu.

virtual void __fastcall Assign(Classes::TPersistent* Source);

Beschreibung

Mit der Methode Assign kann ein Objekt aus der Zwischenablage abgerufen oder in sie kopiert werden. Das betreffende Objekt wird über den Parameter Source angegeben. Der folgende Code kopiert beispielsweise das Bitmap aus dem Bitmap-Objekt mit dem Namen Bitmap1 in die Zwischenablage:

????????????????

Um ein Objekt aus der Zwischenablage abzurufen, muß mit Hilfe der Methode Assign das Objekt in der Zwischenablage dem neuen Objekt (das seine eigene Assign-Methode aufruft) zugewiesen werden. Wenn sich beispielsweise ein Bitmap in der Zwischenablage befindet, kann dieses mit dem folgenden Code in ein Bitmap-Objekt namens Bitmap1 kopiert werden:

????????????????

Mit der Methode HasFormat können die Formattypen für das Kopieren eines Objekts in die Zwischenablage aufgelistet werden. Grafikobjekte wie Bitmaps und Metadateien besitzen ihr eigenes Format. Die meisten anderen Objekte, z.B. Text, verwenden ein Standardformat.


TClipboard::Clear

TClipboard

Die Methode Clear löscht den Inhalt der Zwischenablage.

void __fastcall Clear(void);

Beschreibung

Der Inhalt der Zwischenablage wird automatisch gelöscht, wenn Daten (über eine Ausschneide- oder Kopier-Operation) in sie eingefügt werden.


TClipboard::Close

TClipboard	Siehe auch

Die Methode Close schließt die Zwischenablage, wenn diese geöffnet ist.

void __fastcall Close(void);

Beschreibung

Die Zwischenablage kann durch Aufrufe der Methode Open mehrfach geöffnet worden sein. Da das Zwischenablageobjekt einen Zähler für die Öffnungen verwaltet, muß die Anwendung die Methode Close so oft aufrufen, wie vorher die Methode Open aufgerufen wurde. Erst dann wird die Zwischenablage tatsächlich geschlossen.


TClipboard::GetAsHandle

TClipboard	Siehe auch

Die Methode GetAsHandle liefert für das im Format-Parameter angegebene Format die Daten aus der Zwischenablage in einem Windows-Handle zurück. Informationen über die verfügbaren Formate finden Sie in der Windows-API-Hilfedatei.

int __fastcall GetAsHandle(unsigned short Format);

Beschreibung

Da die Anwendung nicht Eigentümer des Handles ist, sollte sie eine Kopie der Daten erstellen, bevor sie mit ihnen arbeitet.

Hinweis

Das von GetAsHandle zurückgelieferte Handle ist nur so lange gültig, wie die Zwischenablage geöffnet ist. Sobald diese geschlossen wird, hebt Windows die Zuweisung des Handles auf, so daß kein Zugriff mehr darauf möglich ist. Wenn die mit dem Handle verbundenen Daten längere Zeit benötigt werden, sollten die Daten zu einem anderen Handle kopiert werden.


TClipboard::GetComponent

TClipboard	Siehe auch

GetComponent ruft eine Komponente aus der Zwischenablage ab und plaziert sie entsprechend den Werten, die in den Parametern Owner und Parent übergeben wurden.

Classes::TComponent* __fastcall GetComponent(Classes::TComponent* Owner, Classes::TComponent* Parent );

Beschreibung

Im Parameter Owner wird der Komponente übergeben, die als Eigentümer der abgerufenen Komponente fungieren soll. Im der Regel ist dies ein Formular. Über den Parameter Parent geben Sie die Komponente an, die der abzurufenden Komponente übergeordnet sein soll. Sowohl Owner als auch Parent können NULL sein.

Bevor eine Klasse aus der Zwischenablage eingelesen werden kann, muß Sie durch einen Aufruf von RegisterClasses bei der Unit Classes registriert werden. Der Versuch, eine unregistrierte Klasse einzulesen, führt zu einer EClassNotFound-Exception.


TClipboard::GetTextBuf

TClipboard	Siehe auch	Beispiel

Die Methode GetTextBuf ermittelt den Text des Steuerelements und kopiert die in BufSize angegebene Anzahl von Zeichen in den Puffer, auf den Buffer zeigt. Anschließend wird die Zahl der kopierten Zeichen zurückgegeben.

int __fastcall GetTextBuf(char * Buffer, int BufSize);

Beschreibung

Vor dem Aufruf von GetTextBuf können Sie durch einen Aufruf der Methode GetTextLen feststellen, wie groß der Puffer sein muß, um den gesamten Text aufzunehmen.


TClipboard::HasFormat

TClipboard

Mit HasFormat kann festgestellt werden, ob das Zwischenablageobjekt ein bestimmtes Format enthält.

bool __fastcall HasFormat(unsigned short Format);

Beschreibung

Wenn HasFormat den Wert True hat, ist das Format vorhanden. Bei einem Wert von False ist dies nicht der Fall. Das Zwischenablageobjekt verwaltet eine Liste der verfügbaren Formate in der Array-Eigenschaft Formats.

Nachstehend finden Sie einige Werte, die für den Parameter Format angegeben werden können. Windows stellt viele weitere Zwischenablageformate zur Verfügung. Es können auch selbstdefinierte Formate registriert werden. Alle Formate werden von HasFormat unterstützt.

Wert	Bedeutung

CF_TEXT	Text, bei dem jede Zeile mit einer CR/LF-Kombination abgeschlossen ist. Das Textende ist durch ein NULL-Zeichen kenntlich gemacht.

CF_BITMAP	Ein Windows-Bitmap.

CF_METAFILE	Eine Windows-Metadatei.

CF_PICTURE	Ein Objekt des Typs TPicture.

CF_OBJECT	Jedes beliebige persistente Objekt.


TClipboard::Open

TClipboard	Siehe auch

Die Methode Open öffnet die Zwischenablage und verhindert, daß ihr Inhalt von anderen Anwendungen geändert wird, solange sie geöffnet ist.

void __fastcall Open(void);

Beschreibung

Zum Einfügen eines einzelnen Elements in die Zwischenablage ist kein Aufruf von Open erforderlich. Soll dagegen eine Reihe von Elementen in die Zwischenablage plaziert werden, verhindert ein Aufruf von Open, daß der jeweils aktuelle Inhalt durch die neu eingefügten Elemente überschrieben wird.

Nachdem alle gewünschten Elemente in die Zwischenablage eingefügt wurden, sollte ein Aufruf der Methode Close erfolgen.


TClipboard::SetAsHandle

TClipboard

Die Methode SetAsHandle fügt die Daten im angegebenen Format als Windows-Handle ein.

void __fastcall SetAsHandle(unsigned short Format, int Value);

Beschreibung

Nachdem die Anwendung das Handle an die Zwischenablage übergeben hat, sollte sie den Wert des Handles nicht löschen. Das Löschen des Handles erfolgt durch die Zwischenablage.

Informationen über die Formate, die für den Parameter Format angegeben werden können, finden Sie in der Windows-API-Hilfedatei.


TClipboard::SetComponent

TClipboard	Siehe auch

SetComponent kopiert eine Komponente in die Zwischenablage.

void __fastcall SetComponent(Classes::TComponent* Component);

Beschreibung

Die zu kopierende Komponente wird als Wert des Parameters Component angegeben.


TClipboard::SetTextBuf

TClipboard	Siehe auch	Beispiel

Die Methode SetTextBuf setzt den Text des Steuerelements auf den Text in dem Puffer, auf den der Parameter Buffer zeigt.

void __fastcall SetTextBuf(char * Buffer);

Beschreibung

Buffer muß auf einen nullterminierten String zeigen.


TClipboard::TClipboard

TClipboard	Siehe auch

Der Konstruktor TClipboard erzeugt ein neues TClipboard-Objekt.

__fastcall TClipboard(void);


Zugriff

Read-only


Hierarchie

TObject

TPersistent


TClipboard Beispiel

TClipboard


TComponent

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/classes.hpp

TComponent ist der gemeinsame Vorfahr aller Komponentenobjekte in Borland C++Builder.

Beschreibung

TComponent kapselt das grundlegende Verhalten, das allen Komponenten in Borland C++Builder gemeinsam ist. Mit den Methoden und Eigenschaften von TComponent können Komponenten

•	in der Komponentenpalette angezeigt und im Formular-Designer bearbeitet werden.

•	als Eigentümer andere Komponenten verwalten.

•	zusätzliche Funktionen für Streaming und Filing bereitstellen.

Erzeugen Sie keine Instanzen von TComponent. Verwenden Sie die Klasse als Basisklasse, wenn Sie nicht sichtbare Komponenten deklarieren, die in der Komponentenpalette angezeigt und im Formular-Designer bearbeitet werden sollen. Die Eigenschaften und Methoden von TComponent stellen neben einer grundlegenden Funktionalität für untergeordnete Klassen auch Funktionen bereit, die von Komponenten überschrieben werden können, um ihr Verhalten anzupassen.

Verwenden Sie als Grundlage für sichtbare Komponenten TControl oder seine Nachkommen und als Grundlage für fensterorientierte Steuerelemente TWinControl oder seine Nachkommen.


Eigenschaften von TComponent

TComponent	Alphabetisch	Legende

In TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Name

Owner

Tag


Eigenschaften von TComponent

TComponent	Nach Objekten	Legende

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

DesignInfo

Name

Owner

Tag


TComponent::ComponentCount

TComponent	Siehe auch	Beispiel

Die Eigenschaft ComponontCount gibt die Anzahl der untergeordneten Komponenten an, die im Array der Eigenschaft Components verzeichnet sind.

__property int ComponentCount;

Beschreibung

Mit ComponentCount können Sie die Anzahl der Komponenten ermitteln oder überprüfen, die einer Komponente untergeordnet sind, oder die Komponentenliste durchlaufen, um Aktionen an allen untergeordneten Komponenten durchzuführen. Borland C++Builder selbst verwendet ComponentCount intern für solche iterativen Prozeduren.

Hinweis

Die Eigenschaft ComponentCount einer Komponente entspricht der Anzahl der Elemente in der Liste Components und ist immer um 1 höher als der höchste Index dieser Liste, da der Index bei 0 beginnt.


TComponent::ComponentIndex

TComponent	Siehe auch	Beispiel

Die Eigenschaft ComponentIndex gibt die Position der Komponente in der Komponentenliste ihres Eigentümers an.

__property int ComponentIndex;

Beschreibung

Mit ComponentIndex können Sie die Komponentenliste durchlaufen, um Aktionen an untergeordneten Komponenten durchzuführen. Die Eigenschaft wird zweckmäßigerweise in Verbindung mit ComponentCount verwendet. Borland C++Builder selbst verwendet ComponentIndex intern für iterative Zuweisungsprozeduren.

Hinweis

Bei der ersten Komponente einer Liste hat den ComponentIndex den Wert 0, bei der zweiten 1 usw. Beachten Sie also bei der Verwendung von ComponentIndex und ComponentCount, daß ComponentCount immer um 1 höher ist als der höchste Komponentenindex.


TComponent::Components

TComponent	Siehe auch	Beispiel

Die Eigenschaft Components enthält eine Liste aller Komponenten, die der Komponente untergeordnet sind.

__property TComponent* Components[int Index];

Beschreibung

Mit Components können Sie auf alle der Komponente untergeordneten Komponenten zugreifen, beispielsweise auf die Steuerelemente eines Formulars. Die Eigenschaft ist besonders nützlich, wenn Sie nicht einzelne untergeordnete Komponenten, sondern die Komponenten in ihrer Gesamtheit ansprechen wollen. Borland C++Builder selbst verwendet Components intern, um iterative Prozesse an allen untergeordneten Komponenten durchzuführen.

Hinweis

Bei iterativen Prozessen verwenden Sie Components am besten zusammen mit ComponentCount. Beachten Sie aber, daß die Eigenschaft ComponentCount einer Komponente die Anzahl der Elemente in der Liste Components wiedergibt und daher immer um 1 höher ist als der höchste Komponentenindex, da dieser bei 0 beginnt.


TComponent::ComponentState

TComponent	Siehe auch

Die Eigenschaft ComponentState beschreibt den aktuellen Status der Komponente und zeigt an, ob die Ausführung bestimmter Aktionen erlaubt ist.

__property TComponentState ComponentState;

Beschreibung

Komponenten stellen anhand der Eigenschaft ComponentState fest, ob bestimmte Aktionen ausgeführt werden dürfen oder nicht. Wenn eine Komponente beispielsweise im Entwurfsmodus bestimmte Verhaltensweisen unterdrücken muß, die sie zur Laufzeit aufweisen soll, kann sie das Flag csDesigning überprüfen. ComponentState ist eine Nur-Lesen-Eigenschaft. Ihre Flags werden von verschiedenen Methoden gesetzt, jedes für einen ganz bestimmten Zweck.

Der Typ TComponentState definiert die Menge der Status-Flags für die Eigenschaft ComponentState. Die folgende Tabelle enthält die möglichen Werte für diesen Typ und die Bedeutung der einzelnen Flags:

Flag	Bedeutung

csAncestor	Dieses Flag wird gesetzt, wenn die Komponente aus einem Vorfahrformular übernommen wurde, aber nur dann, wenn csDesigning ebenfalls gesetzt ist.

csDesigning	Steht für Entwurfsmodus und bedeutet, daß sich die Komponente in einem Formular befindet und vom Formular-Designer bearbeitet wird.

csDestroying	Die Komponente wird in Kürze gelöscht.

csFixups	Dieses Flag wird gesetzt, wenn die Komponente mit einer Komponente in einem anderen Formular verknüpft ist, das noch nicht geladen wurde. Das Flag wird gelöscht, wenn alle ausstehenden Fixups aufgelöst sind.

csLoading	Die Komponente wird aus einem Dateiobjekt geladen.

csReading	Die Komponente liest ihre Eigenschaftswerte aus einem Stream.

csUpdating	Die Komponente wird aktualisiert, weil an einem Vorfahrformular Änderungen vorgenommen wurden. Das Flag wird nur gesetzt, wenn csAncestor ebenfalls gesetzt ist.

csWriting	Die Komponente schreibt ihre Eigenschaftswerte in einen Stream.


TComponent::ComponentStyle

TComponent

Die Eigenschaft ComponentStyle setzt ein Flag, das das Verhalten der Komponente beeinflußt.

__property TComponentStyle ComponentStyle;

Beschreibung

ComponentStyle legt fest, ob eine Komponente (und die Formulare, die die Komponente enthalten) erbbar ist und ob sie ihre Eigenschaften auf Lesbarkeit überprüfen muß.

Der Typ TComponentStyle definiert die Werte für die Eigenschaft ComponentStyle. TComponent setzt im Konstruktor standardmäßig das Flag csInheritable. Die meisten Standardkomponenten sind also erbbar.

Das Flag csInheritable bedeutet, daß die Komponente von einem untergeordneten Formulartyp geerbt werden kann. Wenn bei einer der Komponenten eines Formulars das Flag csInheritable nicht gesetzt ist, kann das Formular nicht als Vorfahr für andere Formulare verwendet werden.

Das Flag csCheckPropAvail besagt, daß eine Komponente ihre Eigenschaften auf Lesbarkeit überprüfen muß. Dieses Flag ist nur für OLE-Steuerelemente von Bedeutung, bei denen der Objektinspektor nicht direkt feststellen kann, ob eine Eigenschaft lesbar und damit anzeigbar ist. Ursprüngliche Borland C++Builder-Komponenten sollten dieses Flag nicht verwenden.


TComponent::DesignInfo

TComponent	Siehe auch

Die Eigenschaft DesignInfo enthält Informationen, die vom Formular-Designer verwendet werden.

__property long DesignInfo;

Beschreibung

DesignInfo wird intern von der Borland C++Builder -Umgebung verwendet. Rufen Sie diese Eigenschaft nicht direkt auf.


TComponent::Name

TComponent	Siehe auch	Beispiel

Die Eigenschaft Name enthält den Namen der Komponente, auf den sich andere Komponenten beziehen können.

__property System::AnsiString Name;

Beschreibung

Mit dieser Eigenschaft können Sie den Namen einer Komponente ändern, um ihre Aufgabe in der aktuellen Anwendung zu verdeutlichen. Borland C++Builder weist standardmäßig sequentielle Namen zu, die sich aus dem Typ der Komponente ableiten, beispielsweise Button1, Button2 usw.


TComponent::Owner

TComponent	Siehe auch

Die Eigenschaft Owner gibt an, welche Komponente der Komponente übergeordnet ist.

__property TComponent* Owner;

Beschreibung

Mit dieser Eigenschaft können Sie den Eigentümer einer Komponente ermitteln. Wenn eine Komponente einer anderen Komponente untergeordnet ist, wird ihr Speicher freigegeben, wenn auch der Speicher der übergeordneten Komponente freigegeben wird. Das bedeutet, daß alle Komponenten eines Formulars aufgelöst werden, wenn das Formular selbst aufgelöst wird.

In Borland C++Builder ist ein Formular allen in ihm enthaltenen Komponenten übergeordnet. Dem Formular wiederum ist die Anwendung übergeordnet. Daher wird der Speicher für das Formular (und alle untergeordneten Komponenten) freigegeben, wenn auch der Speicher der Anwendung freigegeben wird.

Der Eigentümer einer Komponente wird von dem Parameter bestimmt, der beim Erzeugen der Komponente an die Methode TComponent übergeben wird. Bei Komponenten, die im Borland C++Builder Formular-Designer erzeugt werden, wird der Eigentümer automatisch an den Konstruktor übergeben.


TComponent::Tag

TComponent

Die Eigenschaft Tag speichert eine Ganzzahl als Teil der Komponente.

__property long Tag;

Beschreibung

Tag hat für Borland C++Builder keine vordefinierte Bedeutung. Sie können in dieser Eigenschaft zusätzliche anwendungsspezifische Informationen in Form einer Ganzzahl oder eines Zeigers speichern. Beispielsweise lassen sich mit Tag case-Anweisungen für Komponenten implementieren.


Methoden von TComponent

TComponent	Alphabetisch	Legende

In TComponent

~TComponent

ChangeName

DefineProperties

DestroyComponents

Destroying

FindComponent

FreeNotification

GetChildOwner

GetChildParent

GetChildren

GetParentComponent

HasParent

InsertComponent

Loaded

Notification

ReadState

RemoveComponent

SetAncestor

SetChildOrder

SetDesigning

SetName

SetParentComponent

TComponent

Updated

Updating

ValidateRename

WriteState

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TComponent

TComponent	Nach Objekten	Legende

~TComponent

Assign

ChangeName

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

DefineProperties

DestroyComponents

Destroying

Dispatch

FieldAddress

FindComponent

FreeInstance

FreeNotification

Free

GetChildOwner

GetChildParent

GetChildren

GetParentComponent

HasParent

InheritsFrom

InitInstance

InsertComponent

InstanceSize

Loaded

MethodAddress

MethodName

NewInstance

Notification

ReadState

RemoveComponent

SetAncestor

SetChildOrder

SetDesigning

SetName

SetParentComponent

TComponent

Updated

Updating

ValidateRename

WriteState


TComponent::~TComponent

TComponent	Siehe auch

~TComponent gibt die Komponente und deren untergeordnete Komponenten frei.

__fastcall virtual ~TComponent(void);

Beschreibung

TComponent überschreibt ~TComponent, um die Komponente freizugeben, in der die Methode ausgeführt wird, sowie alle untergeordneten Komponenten.

Hinweis

Rufen Sie ~TComponent nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete für das Objekt, womit ~TComponent automatisch aufgerufen wird.

Geben Sie eine Komponente niemals explizit innerhalb einer Ereignisbehandlungsroutinen frei, die entweder zur Komponente selbst oder einer ihrer untergeordneten Komponenten gehört.

Ein Formular wird mit der Methode Release freigegeben. Die Methode Release löst die Formularinstanz auf und gibt den belegten Speicher frei.


TComponent::ChangeName

TComponent	Siehe auch

Die Methode ChangeName weist der als private deklarierten, internen Eigenschaft Name den im Parameter NewName übergebenen String zu.

void __fastcall ChangeName(const System::AnsiString NewName);

Beschreibung

Die Methode SetName verwendet ChangeName zur Änderung des Komponentennamens. ChangeName ist nicht virtuell. Überschreiben Sie diese Methode nicht. Wenn Sie SetName überschreiben, müssen Sie die geerbte Methode SetName aufrufen.


TComponent::DefineProperties

TComponent	Siehe auch

Die Methode DefineProperties legt Methoden fest, mit denen die nicht als published deklarierten Daten eines Objekts in einem Stream (z.B. in einer Formulardatei) gespeichert werden können.

virtual void __fastcall DefineProperties(TFiler* Filer);

Beschreibung

TComponent überschreibt die in TPersistent definierte Methode DefineProperties, um Werte für die Eigenschaften Top und Left „vorzutäuschen“. Auf diese Weise können nicht sichtbare Komponenten zur Entwurfszeit manipuliert werden. Die Eigenschaften Top und Left sind allerdings nicht als published deklariert, da solche Komponenten zur Laufzeit nicht auf dem Bildschirm sichtbar sind.

DefineProperties ist virtuell und kann somit von untergeordneten Klassen überschrieben werden. Wenn Sie die Methode DefineProperties schreiben oder überschreiben, beachten Sie, daß die Eigenschaft Ancestor von TFiler gesetzt sein könnte. Außerdem müssen vielleicht einige, aber nicht alle Eigenschaften in den Stream geschrieben werden.

DefineProperties wird automatisch als Teil des Streaming-Systems aufgerufen. Rufen Sie die Methode nicht direkt auf.


TComponent::DestroyComponents

TComponent	Siehe auch

Die Methode DestroyComponents streicht alle untergeordneten Komponenten aus der entsprechenden Liste und löst sie auf.

void __fastcall DestroyComponents(void);

Beschreibung

DestroyComponent sorgt dafür, daß alle untergeordneten Komponenten von ihrem Eigentümer automatisch aufgelöst werden.

Es ist nicht erforderlich, diese Methode direkt aufzurufen. DestroyComponents wird von ~TComponent automatisch in der Destruktor-Sequenz aufgerufen, die mit einem Aufruf von Free beginnt und mit der Auflösung des Objekts endet.


TComponent::Destroying

TComponent	Siehe auch

Die Methode Destroying setzt für die Komponente und alle ihr untergeordneten Komponenten das Flag csDestroying, das anzeigt, daß die Komponenten in Kürze aufgelöst werden.

void __fastcall Destroying(void);

Beschreibung

Destroying setzt das Flag csDestroying in der Eigenschaft ComponentState und ruft anschließend die Methode Destroying für jede untergeordnete Komponente auf, damit auch dort dieses Flag gesetzt wird. Wenn csDestroying bereits gesetzt ist, hat Destroying keine Wirkung.

Es ist nicht erforderlich, diese Methode direkt aufzurufen. Destroying wird von ~TComponent in der Destruktor-Sequenz, die mit einem Aufruf von Free beginnt und mit der Auflösung des Objekts endet, automatisch aufgerufen.


TComponent::FindComponent

TComponent	Siehe auch	Beispiel

Die Methode FindComponent gibt an, ob der Komponente die im Parameter AName angegebene Komponente untergeordnet ist.

TComponent* __fastcall FindComponent(const System::AnsiString AName);

Beschreibung

FindComponent gibt diejenige Komponente im Array Components zurück, deren Name mit dem String im Parameter AName übereinstimmt. Mit Hilfe von FindComponent können Sie feststellen, ob eine bestimmte Komponente einer anderen Komponente untergeordnet ist.

Die Methode ignoriert Groß- und Kleinschreibung.


TComponent::FreeNotification

TComponent	Siehe auch

Die Methode FreeNotification stellt sicher, daß AComponent über die bevorstehende Auflösung der Komponente unterrichtet wird.

void __fastcall FreeNotification(TComponent* AComponent);

Beschreibung

Verwenden Sie FreeNotification, wenn eine Komponente einer Eigenschaft einer anderen Komponente zugewiesen ist.

FreeNotification muß für Komponenten in anderen Formularen aufgerufen werden, die sich auf die Komponente beziehen. Für Komponenten, die sich im selben Formular befinden, wird die Methode automatisch aufgerufen.


TComponent::GetChildOwner

TComponent	Siehe auch

Die Methode GetChildOwner gibt den Eigentümer einer untergeordneten Komponente zurück, die aus einem Stream gelesen wird.

virtual TComponent* __fastcall GetChildOwner(void);

Beschreibung

In TComponent gibt GetChildOwner standardmäßig NULL zurück, da davon ausgegangen wird, daß der Eigentümer die oberste Komponente ist, die gerade gelesen wird (im Normalfall ein Formular). Der Eigentümer einer Komponente ist für ihre Auflösung verantwortlich.

Das Streaming-System von Borland C++Builder verwendet GetChildOwner intern. Es ist nur selten erforderlich, die Methode direkt aufzurufen.


TComponent::GetChildParent

TComponent	Siehe auch

Die Methode GetChildParent gibt den Vorfahr oder, wenn ein solcher nicht existiert, den Eigentümer einer untergeordneten Komponente zurück, die aus einem Stream gelesen wird.

virtual TComponent* __fastcall GetChildParent(void);

Beschreibung

Für TComponent gibt GetChildParent standardmäßig Self zurück. Wenn GetChildParent NULL zurückgibt, wird davon ausgegangen, daß der Vorfahr die oberste Komponente ist, die gerade gelesen wird (im Normalfall ein Formular).

Das Streaming-System von Borland C++Builder verwendet GetChildParent intern. Es ist nicht erforderlich, die Methode direkt aufzurufen.


TComponent::GetChildren

TComponent	Siehe auch

Die von TComponent definierte Methode GetChildren stellt lediglich eine Schnittstelle dar, über die fensterorientierte Steuerelemente die ihnen untergeordneten Komponenten zurückgeben.

virtual void __fastcall GetChildren(TGetChildProc Proc);

Beschreibung

GetChildren dient der Unterstützung des Streaming-Systems von Borland C++Builder. Abgeleitete Klassen überschreiben GetChildren, um untergeordnete Komponenten zurückzugeben, also Komponenten, die in ihrer Methode GetParentComponent ihrerseits diese Komponente zurückgeben.


TComponent::GetParentComponent

TComponent	Siehe auch

Die Methode GetParentComponent gibt für TComponent NULL zurück.

virtual TComponent* __fastcall GetParentComponent(void);

Beschreibung

GetParentComponent dient der Unterstützung des Streaming-Systems von Borland C++Builder. Untergeordnete Klassen können GetParentComponent überschreiben, um das ihrem Komponententyp entsprechende übergeordnete Objekt zurückzugeben.


TComponent::HasParent

TComponent	Siehe auch

Die Methode HasParent gibt für TComponent False zurück.

virtual bool __fastcall HasParent(void);

Beschreibung

HasParent wird von TComponent eingeführt, damit das Streaming-System feststellen kann, ob die Komponente ein übergeordnetes Objekt hat.

Der Rückgabewert True bedeutet, daß ein anderes (übergeordnetes) Objekt dafür verantwortlich ist, daß das Objekt in einen Stream geschrieben wird. Im allgemeinen handelt es sich bei dem übergeordneten Objekt um ein Formular oder eine Tafel, die ein Steuerelement enthält.

Es ist nur selten erforderlich, HasParent zu überschreiben. Jede untergeordnete Komponente, die für HasParent True zurückgibt, muß auch die Methoden GetParentComponent und SetParentComponent implementieren.


TComponent::InsertComponent

TComponent	Siehe auch

Die Methode InsertComponent macht die Komponente zum Eigentümer der im Parameter AComponent übergebenen Komponente.

void __fastcall InsertComponent(TComponent* AComponent);

Beschreibung

InsertComponent fügt die Komponente am Ende des Komponentenarrays hinzu. Die eingefügte Komponente darf entweder gar keinen Namen haben (in der Eigenschaft Name), oder der Name muß innerhalb der Komponentenliste eindeutig sein.

Wenn die übergeordnete Komponente freigegeben wird, wird auch AComponent freigegeben.

Die Komponenten, die Sie im Formular-Designer von Borland C++Builder bearbeiten, werden automatisch eingefügt und entfernt. Mit InsertComponent können sie der Komponentenliste einer übergeordneten Komponente Objekte manuell hinzufügen.


TComponent::Loaded

TComponent	Siehe auch

Die Methode Loaded löscht das Flag csLoading der Eigenschaft ComponentState und zeigt auf diese Weise an, daß die Komponente aus einem Stream geladen wurde.

virtual void __fastcall Loaded(void);

Beschreibung

Loaded gibt einer Komponente die Möglichkeit, sich selbst zu initialisieren, nachdem alle ihre Teile aus einem Stream geladen wurden.

Wenn eine Borland C++Builder-Anwendung beispielsweise ein Formular aus der entsprechenden Formulardatei lädt, erzeugt sie zuerst die Formularkomponente, indem sie ihren Konstruktor aufruft. Anschließend liest sie die Eigenschaftswerte aus der Formulardatei, die einen Stream darstellt. Nachdem alle Eigenschaftswerte aller Komponenten gelesen wurden, ruft Borland C++Builder die Methode Loaded für jede Komponente in der Reihenfolge auf, in der die Komponenten erzeugt wurden. Dadurch haben die Komponenten die Möglichkeit, alle Daten zu initialisieren, die von Werten anderer Komponenten abhängig sind.

Hinweis

Alle Referenzen auf gleichrangige Komponenten werden vor dem Aufruf von Loaded aufgelöst. Zeiger auf gleichrangige Komponenten, die aus einem Stream gelesen wurden, können frühestens in diesem Aufruf von Loaded verwendet werden.


TComponent::Notification

TComponent	Siehe auch

Die Methode Notification leitet Benachrichtigungen an alle untergeordneten Komponenten weiter.

virtual void __fastcall Notification(TComponent* AComponent, TOperation Operation);

Beschreibung

Notification teilt der Komponente mit, daß die im Parameter AComponent übergebene Komponente in Abhängigkeit vom Wert des Parameters Operation entweder eingefügt oder entfernt wird. Standardmäßig leiten Komponenten Benachrichtigungen an die ihnen untergeordneten Komponenten weiter.

Eine Komponente kann, falls erforderlich, auf die Benachrichtigung reagieren, daß eine Komponente entweder eingefügt oder entfernt wird. Wenn eine Komponente Objektfelder oder Eigenschaften enthält, die auf andere Komponenten verweisen, kann sie anhand der Benachrichtigungen prüfen, ob solche Komponenten entfernt wurden, und die entsprechenden Referenzen für ungültig erklären.


TComponent::ReadState

TComponent	Siehe auch

Die Methode ReadState wird vom Streaming-System verwendet, um die Daten der Komponente aus einem Stream zu lesen.

virtual void __fastcall ReadState(TReader* Reader);

Beschreibung

ReadState kommuniziert mit dem im Parameter Reader übergebenen TReader-Objekt, um sicherzustellen, daß die Komponente korrekt aus einem Stream eingelesen wird.

Die Methode ist Teil einer Aufrufsequenz, mit der das Streaming-System von Borland C++Builder die Werte aller als published deklarierten Eigenschaften der Komponente und andere gespeicherte Daten aus einem Stream liest. Es ist nicht erforderlich, ReadState direkt aufzurufen.

Obwohl die Methode virtuell ist, wird sie selten überschrieben. Alle untergeordneten Klassen, die ReadState überschreiben, sollten aber als letzte Anweisung die geerbte Methode ReadState von TComponent aufrufen.

ReadState liest Werte von als published deklarierten Eigenschaften der Komponente, gespeicherte Daten und untergeordnete Komponenten aus dem TReader-Objekt, das im Parameter Reader übergeben wird.


TComponent::RemoveComponent

TComponent	Siehe auch	Beispiel

Die Methode RemoveComponent entfernt die Komponente, die im Parameter AComponent übergeben wird, aus der Komponentenliste.

void __fastcall RemoveComponent(TComponent* AComponent);

Beschreibung

Die Komponenten, die Sie im Formular-Designer von Borland C++Builder bearbeiten, werden automatisch eingefügt und entfernt. Mit RemoveComponent können Sie Komponenten manuell aus einer übergeordneten Komponente entfernen.


TComponent::SetAncestor

TComponent	Siehe auch

Die Methode SetAncestor setzt oder löscht für die Komponente, in der die Methode ausgeführt wird, und für alle untergeordneten Komponenten das Flag csAncestor der Eigenschaft ComponentState.

void __fastcall SetAncestor(bool Value);

Beschreibung

SetAncestor wird in Borland C++Builder intern für das Streaming-System verwendet. Es ist nicht erforderlich, die Methode direkt aufzurufen.

SetAncestor setzt oder löscht das Flag csAncestor, das angibt, ob die Komponente in einem Vorfahrformular eingeführt wurde. Die Methode ruft dann SetAncestor für alle untergeordneten Komponenten auf und übergibt jedesmal den Parameter Value, um die Werte ihrer Eigenschaft ComponentState mit den entsprechenden Werten des Eigentümers zu synchronisieren.


TComponent::SetChildOrder

TComponent	Siehe auch

Die Methode SetChildOrder hat in TComponent keine Wirkung.

virtual void __fastcall SetChildOrder(TComponent* Child, int Order);

Beschreibung

SetChildOrder wird in TComponent zur Unterstützung des Streaming-Systems von Borland C++Builder eingeführt. Die Methode wird von untergeordneten Klassen überschrieben, um die Position der im Parameter Child übergebenen Komponente innerhalb der Liste der untergeordneten Komponenten zu ändern, die von GetChildren zurückgegeben wird.


TComponent::SetDesigning

TComponent	Siehe auch

Die Methode SetDesigning sorgt dafür, daß bei Komponenten, die zur Entwurfszeit eingefügt werden, das Flag csDesigning gesetzt ist.

void __fastcall SetDesigning(bool Value);

Beschreibung

Der Formular-Designer von Borland C++Builder verwendet SetDesigning intern. Es ist nicht erforderlich, die Methode direkt aufzurufen.

Wenn der Parameter Value True ist, setzt SetDesigning das Flag csDesigning in der Eigenschaft ComponentState. Anderfalls wird das Flag gelöscht. Anschließend ruft die Methode SetDesigning für alle untergeordneten Komponenten auf und übergibt jedesmal den Parameter Value, um den Wert der Eigenschaft ComponentState der untergeordneten Komponenten mit dem entsprechenden Wert des Eigentümers zu synchronisieren.

Die Methoden InsertComponent und RemoveComponent rufen SetDesigning auf, wenn Komponenten eingefügt oder entfernt werden. Auf diese Weise stellen sie sicher, daß das Flag csDesigning korrekt gesetzt ist.


TComponent::SetName

TComponent	Siehe auch

Die Methode SetName dient dem Schreibzugriff auf die Eigenschaft Name.

virtual void __fastcall SetName(const System::AnsiString NewName);

Beschreibung

SetName ist die virtuelle Methode, die für Schreibzugriffe auf die Eigenschaft Name verwendet wird. Sie ruft die Methode ChangeName auf, die die eigentliche Änderung des Namens durchführt. ChangeName ist nicht virtuell. Überschreiben Sie stattdessen SetName, wenn Sie das Verhalten der Eigenschaft Name ändern wollen.


TComponent::SetParentComponent

TComponent	Siehe auch

Die Methode SetParentComponent hat in TComponent keine Wirkung.

virtual void __fastcall SetParentComponent(TComponent* Value);

Beschreibung

SetParentComponent wird von TComponent zur Unterstützung Streaming-Systems von Borland C++Builder eingeführt. Die Methode wird von untergeordneten Klassen überschrieben, um den von GetParentComponent zurückgegebenen Wert mit dem Wert von Value zu synchronisieren.


TComponent::TComponent

TComponent	Siehe auch

Die Methode TComponent erzeugt eine mit Standardwerten initialisierte Instanz einer Komponente und weist ihr ausreichend Speicher zu.

__fastcall virtual TComponent(TComponent* AOwner);

Beschreibung

Alle Objekte in Borland C++Builder verfügen über eine Methode TComponent, die das Objekt erzeugt. TComponent definiert einen eigenen Konstruktor, so daß die Methode für Komponenten auch folgende Funktionen ausführt:

•	Sie richtet die Beziehung zwischen der Komponente und ihrem Eigentümer ein, der im Parameter AOwner übergeben wird.

•	Sie setzt die Eigenschaft ComponentStyle auf csInheritable, so daß die Komponente von einem abgeleiteten Formulartyp geerbt werden kann.

Für Komponenten, die im Formular-Designer erzeugt werden, braucht TComponent nicht eigens aufgerufen zu werden. Diese Komponenten werden beim Start der Anwendung automatisch erzeugt und bei deren Beendigung freigegeben.

Für manuell (also nicht im Formular-Designer) erzeugte Komponenten rufen Sie TComponent auf und übergeben die übergeordnete Komponente im Parameter AOwner. Der Eigentümer löst die Komponente auf, wenn er selbst aufgelöst wird. Wenn die Komponente keinen Eigentümer hat, rufen Sie Free auf, um sie aufzulösen.

Hinweis

Wenn Sie Self übergeben, beachten Sie, auf welche Komponente Self verweist. Wenn eine Komponente in einer ihrer Methoden eine andere Komponente erzeugt, bezieht sich Self auf die erste Komponente und nicht auf die erzeugte Komponente, die der ersten Komponente untergeordnet ist.

Hinweis

TComponent::TComponent ist virtuell, um polymorphe Instantiierungen von Klassenreferenzen zu erlauben. Diese Möglichkeit ist für das Streaming-System und für den Formular-Designer von Bedeutung. Vergessen Sie nicht, die Direktive override zu verwenden, wenn Sie den Konstruktor einer neuen Komponente deklarieren.


TComponent::Updated

TComponent	Siehe auch

Die Methode Updated löscht das Flag csUpdating der Eigenschaft ComponentState, um anzuzeigen, daß die Aktualisierung der Komponente beendet ist.

virtual void __fastcall Updated(void);

Beschreibung

Updated wird in Borland C++Builder intern zur Änderung der Eigenschaft ComponentState verwendet. Es ist nicht erforderlich, die Methode direkt aufzurufen. Ein Aufruf von Updated folgt immer auf einen Aufruf von Updating, der das Flag setzt.


TComponent::Updating

TComponent	Siehe auch

Die Methode Updating setzt das Flag csUpdating der Eigenschaft ComponentState, um anzuzeigen, daß die Komponente aktualisiert wird.

virtual void __fastcall Updating(void);

Beschreibung

Updating wird in Borland C++Builder intern zur Änderung der Eigenschaft ComponentState verwendet. Es ist nicht erforderlich, die Methode direkt aufzurufen. Auf einen Aufruf von Updating sollte immer ein Aufruf von Updated folgen, der das Flag löscht.


TComponent::ValidateRename

TComponent	Siehe auch

Die Methode ValidateRename stellt sicher, daß die Änderung des Namens einer untergeordneten Komponente keinen Namenskonflikt erzeugt.

virtual void __fastcall ValidateRename(TComponent* AComponent, const System::AnsiString CurName, const System::AnsiString  NewName);

Beschreibung

ValidateRename überprüft, ob die Komponente den Namen einer untergeordneten Komponente (übergeben im Parameter AComponent) vom aktuellen Namen (CurName) in den im Parameter NewName übergebenen String ändern kann. Wenn AComponent NULL ist oder wenn NewName bereits der Name einer Komponente in der Komponentenliste ist, löst ValidateRename eine EComponentError-Exception aus.

ValidateRename wird von Borland C++Builder intern zur Änderung der Eigenschaft Name verwendet. Es ist nicht erforderlich, die Methode direkt aufzurufen.


TComponent::WriteState

TComponent	Siehe auch

Die Methode WriteState wird vom Streaming-System verwendet, um die Daten der Komponente in einen Stream zu schreiben.

virtual void __fastcall WriteState(TWriter* Writer);

Beschreibung

WriteState ist eine interaktive Methode, die mit dem im Parameter TWriter übergebenen Objekt kommuniziert, um sicherzustellen, daß die Komponente korrekt in den Stream geschrieben wird.

Die Methode ist Teil einer Aufrufsequenz, mit der das Streaming-System von Borland C++Builder die Werte aller als published deklarierten Eigenschaften der Komponente und andere gespeicherte Daten in einen Stream schreibt. Es ist nicht erforderlich, WriteState direkt aufzurufen.

Obwohl die Methode virtuell ist, wird sie selten überschrieben. Alle untergeordneten Klassen, die WriteState überschreiben, sollten aber als letzte Anweisung die geerbte Methode WriteState von TComponent aufrufen.


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Protected


Hierarchie

TObject

TPersistent


TComponent Beispiel

TComponent


TCollection

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/classes.hpp

TCollection ist ein Container für TCollectionItem-Objekte.

Beschreibung

Jede TCollection-Komponente enthält eine Gruppe von TCollectionItem-Objekten. TCollection verwaltet einen Index der Kollektionselemente im Array Items. Die Eigenschaft Count enthält die Zahl der Elemente in der Kollektion. Mit den Methoden Add und Clear können Sie der Kollektion Elemente hinzufügen und Elemente aus ihr löschen.

Von TCollection abgeleitete Objekte können Objekte enthalten, die Nachkommen von TCollectionItem sind. Ein TDBGridColumns-Objekt enthält beispielsweise TColumn-Objekte. Beide Klassen werden von TDBGrid für die Anzeige von Gitterspalten verwendet. Die folgende Tabelle enthält für jeden Nachkommen von TCollection den entsprechenden Nachkommen von TCollectionItem und das Steuerelement (abgeleitet von TWinControl), das die beiden verwendet.

Nachkomme von TCollection	Nachkomme von TCollectionItem	Steuerelement

TDBGridColumns	TColumn	TDBGrid

THeaderSections	THeaderSection	THeaderControl

TListColumns	TListColumn	TListView

TStatusPanels	TStatusPanel	TStatusBar


Eigenschaften von TCollection

TCollection	Alphabetisch	Legende

In TCollection

Count

Items


Eigenschaften von TCollection

TCollection	Nach Objekten	Legende

Count

Items


TCollection::Count

TCollection	Siehe auch

Die Eigenschaft Count gibt die Anzahl der Elemente in der Kollektion zurück.

__property int Count;

Beschreibung

Count enthält die Anzahl der Elemente im Array Items. Da der Index von Items bei 0 beginnt, ist der Wert von Count immer um eins größer als der Index des letzten Arrayelements.


TCollection::Items

TCollection	Siehe auch

Die Eigenschaft Items ist ein Index für die Elemente der Kollektion.

__property TCollectionItem* Items[int Index];

Beschreibung

Der Wert des Parameters Index korrespondiert mit der Eigenschaft Index von TCollectionItem. Er gibt die Position des Elements in der Kollektion wieder.


Methoden von TCollection

TCollection	Alphabetisch

In TCollection

~TCollection

Add

Assign

BeginUpdate

Clear

EndUpdate

TCollection

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TCollection

TCollection	Nach Objekten

~TCollection

Add

Assign

BeginUpdate

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

Clear

DefaultHandler

Dispatch

EndUpdate

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance

TCollection


TCollection::~TCollection

TCollection	Siehe auch

Der Destruktor löst die Kollektion und jedes enthaltene Element auf.

__fastcall virtual ~TCollection(void);

Beschreibung

~TCollection ruft die Methode Clear auf und gibt damit alle im Array Items referenzierten Elemente frei. Anschließend wird die Kollektion freigegeben.


TCollection::Add

TCollection	Siehe auch

Die Methode Add erzeugt eine neue Instanz von TCollectionItem und fügt sie dem Array Items hinzu.

TCollectionItem* __fastcall Add(void);

Beschreibung

Add gibt das neue Element der Kollektion zurück.


TCollection::Assign

TCollection	Siehe auch

Die Methode Assign kopiert den Inhalt einer anderen Kollektion in das Objekt, in dem die Methode ausgeführt wird.

virtual void __fastcall Assign(TPersistent* Source);

Beschreibung

Mit Assign können Sie den Inhalt einer Instanz von TCollection in eine andere kopieren. Die Methode löscht alle Elemente aus der Zielkollektion (also aus dem Objekt, in dem sie ausgeführt wird) und fügt dann für jedes im Array Items der Quellkollektion befindliche Element eine Kopie ein.


TCollection::BeginUpdate

TCollection	Siehe auch

Die Methode BeginUpdate verzögert den Bildschirmaufbau.

void __fastcall BeginUpdate(void);

Beschreibung

BeginUpdate verzögert den Bildschirmaufbau, bis die Methode EndUpdate aufgerufen wird. Wenn Sie einer Kollektion Elemente hinfügen oder Elemente aus ihr löschen wollen, können Sie diesen Vorgang mit BeginUpdate beschleunigen.


TCollection::Clear

TCollection	Siehe auch

Die Methode Clear löscht alle Elemente aus der Kollektion.

void __fastcall Clear(void);

Beschreibung

Clear leert das Array Items und gibt alle TCollectionItem-Objekte frei.


TCollection::EndUpdate

TCollection	Siehe auch

Die Methode aktiviert wieder die Bidlschirmdarstellung wieder.

void __fastcall EndUpdate(void);

Beschreibung

Mit EndUpdate wird die Bildschirmdarstellung wieder aktiviert, wenn diese vorher mit BeginUpdate deaktiviert wurde.


TCollection::TCollection

TCollection	Siehe auch

TCollection erzeugt und initialisiert eine Kollektion.

__fastcall TCollection(System::TMetaClass* ItemClass);

Beschreibung

TCollection erwartet als Parameter den Namen einer von TCollection abgeleiteten Klasse. Dieser Parameter legt die Klasse der Elemente fest, die von der Methode Add erzeugt werden.


Zugriff

Read-only


Hierarchie

TObject

TPersistent


TCollection Beispiel

TCollection


TCollectionItem

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/classes.hpp

Ein Objekt der Klasse TCollectionItem repräsentiert ein Element in einer Kollektion.

Beschreibung

Ein TCollection-Objekt  enthält eine Gruppe von TCollectionItem-Objekten. TCollectionItem-Objekte werden von den TCollection-Methoden Add und Clear erzeugt und freigegeben. Die Eigenschaft Collection eines jeden TCollectionItem-Objekts zeigt auf das TCollection-Objekt, dem es zugeordnet ist.

Von TCollection abgeleitete Objekte können Objekte enthalten, die von TCollectionItem abgeleitet sind. Ein TDBGridColumns-Objekt enthält beispielsweise TColumn-Objekte. Beide Klassen werden von TDBGrid bei der Anzeige von Gitterspalten verwendet. Eine vollständige Liste der Nachkommen von TCollection und TCollectionItem finden Sie unter TCollection.


Eigenschaften von TCollectionItem

TCollectionItem	Alphabetisch

In TCollectionItem

Collection

Index


Eigenschaften von TCollectionItem

TCollectionItem	Nach Objekten

Collection

Index


TCollectionItem::Collection

TCollectionItem

Die Eigenschaft Collection gibt an, welcher Instanz von TCollection das TCollectionItem-Objekt zugeordnet ist.

__property TCollection* Collection;

Beschreibung

Jedes TCollectionItem-Objekt ist dem TCollection-Objekt zugeordnet, von dem es erzeugt wurde. Die Eigenschaft Collection zeigt auf das TCollection-Objekt, dem das Element zugeordnet ist.


TCollectionItem::Index

TCollectionItem	Siehe auch

Die Eigenschaft Index gibt die Position des Elements im Array Items von TCollection zurück.

__property int Index;

Beschreibung

Jedes TCollectionItem-Objekt ist im Array Items des TCollection-Objekts indiziert, dem es zugeordnet ist. Die Eigenschaft Index enthält den Index des Elements in diesem Array.

Der Index von Items beginnt bei 0. Das erste Element der Kollektion hat also den Index 0, das zweite den Index 1 usw.


Methoden von TCollectionItem

TCollectionItem	Alphabetisch

In TCollectionItem

~TCollectionItem

TCollectionItem

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TCollectionItem

TCollectionItem	Nach Objekten

~TCollectionItem

Assign

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance

TCollectionItem


TCollectionItem::~TCollectionItem

TCollectionItem	Siehe auch

~TCollectionItem gibt die Instanz von TCollectionItem und ihren Speicher frei.

__fastcall virtual ~TCollectionItem(void);

Beschreibung

~TCollectionItem wird von der Methode Clear von TCollection indirekt aufgerufen.


TCollectionItem::TCollectionItem

TCollectionItem	Siehe auch

Der Konstruktor TCollectionItem erzeugt ein neues TCollectionItem-Objekt.

__fastcall virtual TCollectionItem(TCollection* Collection);

Beschreibung

Die Methode TCollectionItem nimmt als Parameter den Namen einer Instanz von TCollection entgegen. TCollectionItem wird von der Methode TCollection::Add aufgerufen.


Hierarchie

TObject

TPersistent


TCollectionItem Beispiel

TCollectionItem


 TColorDialog

Hierarchie	Eigenschaften	Methoden	Ereignisse

Header

vcl/dialogs.hpp

TColorDialog erzeugt ein Dialogfeld zur Auswahl von Farben.

Beschreibung

Die Komponente TColorDialog zeigt ein Windows-Dialogfeld zur Farbauswahl an. Zur Laufzeit wird das Dialogfeld erst dann eingeblendet, wenn es durch einen Aufruf der Methode Execute aktiviert wird. Wenn der Benutzer nach der Auswahl einer Farbe auf OK klickt, wird das Dialogfeld geschlossen und die gewählte Farbe in der Eigenschaft Color gespeichert.


Eigenschaften von TColorDialog

TColorDialog	Alphabetisch	Legende

In TColorDialog

Color

CustomColors

Options

Abgeleitet von TCommonDialog

Ctl3D

HelpContext

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Name

Owner

Tag


Eigenschaften von TColorDialog

TColorDialog	Nach Objekten	Legende

Color

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

Ctl3D

CustomColors

DesignInfo

HelpContext

Name

Options

Owner

Tag


TColorDialog::Color

TColorDialog	Siehe auch

Die Methode Color liefert die gewählte Farbe zurück.

__property Graphics::TColor Color;

Beschreibung

Wenn der Benutzer nach der Auswahl einer Farbe auf OK klickt, wird die gewählte Farbe als Wert der Eigenschaft Color gespeichert. Durch Zuweisen eines Wertes an Color (entweder im Objektinspektor oder im Programmcode) können Sie eine Farbe festlegen, die nach dem öffnen des Dialogfeldes als Standardfarbe eingestellt ist.


TColorDialog::CustomColors

TColorDialog

Die Eigenschaft CustomColors legt fest, welche selbstdefinierten Farben im Dialogfeld verfügbar sind.

__property Classes::TStrings* CustomColors;

Beschreibung

Jede selbstdefinierte Farbe wird als String in der Form ColorX=HexValue dargestellt. Der folgende String setzt beispielsweise die erste selbstdefinierte Farbe.

ColorA=808022

Es können bis zu 16 selbstdefinierte Farben (ColorA bis ColorP) festgelegt werden.


TColorDialog::Options

TColorDialog

Die Eigenschaft Options bestimmt die Optionen und das vorgegebene Aussehen des Dialogfeldes.

__property TColorDialogOptions Options;

Beschreibung

Mit der Eigenschaft Options läßt sich das Erscheinungsbild und die Funktionalität des Dialogfeldes anpassen. Folgende Werte können für Options angegeben werden:

Wert	Bedeutung

cdFullOpen	Zeigt die Optionen für selbstdefinierte Farben an, wenn das Dialogfeld geöffnet wird.

cdPreventFullOpen	Deaktiviert die Schaltfläche Farben definieren im Dialogfeld und verhindert damit, daß der Benutzer eigene Farben definiert.

cdShowHelp	Fügt eine Hilfe-Schaltfläche zum Dialogfeld hinzu.

cdSolidColor	Weist Windows an, die Flächenfarbe zu verwenden, die der gewählten Farbe am ähnlichsten ist.

cdAnyColor	Erlaubt dem Benutzer die Auswahl von Nicht-VGA-Farben (falls diese implementiert sind).

Alle diese Optionen sind per Vorgabe deaktiviert.


Methoden von TColorDialog

TColorDialog	Alphabetisch

In TColorDialog

~TColorDialog

Execute

TColorDialog

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TColorDialog

TColorDialog	Nach Objekten

~TColorDialog

Assign

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

DestroyComponents

Destroying

Dispatch

Execute

FieldAddress

FindComponent

FreeInstance

FreeNotification

Free

GetParentComponent

HasParent

InheritsFrom

InitInstance

InsertComponent

InstanceSize

MethodAddress

MethodName

NewInstance

RemoveComponent

TColorDialog


TColorDialog::~TColorDialog

TColorDialog	Siehe auch

Der Destruktor ~TColorDialog gibt den Speicher frei, der für das TColorDialog-Objekt reserviert war. Rufen Sie ~TColorDialog nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TColorDialog automatisch aufgerufen wird.

__fastcall virtual ~TColorDialog(void);


TColorDialog::Execute

TColorDialog

Diese Methode zeigt das Dialogfeld zur Farbauswahl an.

bool __fastcall Execute(void);

Beschreibung

Execute öffnet das Dialogfeld zur Farbauswahl und gibt True zurück, sobald der Benutzer eine Farbe auswählt und auf OK klickt.


TColorDialog::TColorDialog

TColorDialog	Siehe auch

TColorDialog erzeugt und initialisiert ein Dialogfeld zur Farbauswahl.

__fastcall virtual TColorDialog(Classes::TComponent* AOwner);

Beschreibung

TColorDialog erzeugt eine Instanz von TColorDialog und initialisiert die Eigenschaft CustomColors.


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TCommonDialog


TColorDialog Beispiel

TColorDialog


TColumnTitle

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/dbgrids.hpp

Ein Objekt der Klasse TColumnTitle repräsentiert den Titel einer Datengitterspalte (TColumn).

Beschreibung

Ein TDBGrid-Objekt verwaltet mit Hilfe eines TDBGridColumns-Objekts eine Kollektion von TColumn-Objekten. Jedes TColumn-Objekt ist mit einem TColumnTitle-Objekt verknüpft, das Informationen über seinen Titel enthält. Die Instanz von TColumnTitle wird in der Eigenschaft Title der Spalte gespeichert.


Eigenschaften von TColumnTitle

TColumnTitle	Alphabetisch	Legende

In TColumnTitle

Alignment

Caption

Color

Font


Eigenschaften von TColumnTitle

TColumnTitle	Nach Objekten	Legende

Alignment

Caption

Color

Font


TColumnTitle::Alignment

TColumnTitle	Siehe auch	Beispiel

Die Eigenschaft Alignment legt fest, wie der Text im Spaltenkopf ausgerichtet wird.

__property Classes::TAlignment Alignment;

Beschreibung

Die folgende Tabelle enthält die möglichen Werte von Alignment:

Wert	Bedeutung

taLeftJustify	Richtet den Text an der linken Seite der Spalte aus.

taCenter	Zentriert den Text in der Spalte.

taRightJustify	Richtet den Text an der rechten Seite der Spalte aus.


TColumnTitle::Caption

TColumnTitle	Siehe auch	Beispiel

Die Eigenschaft Caption enthält den im Spaltenkopf angezeigten Text.

__property System::AnsiString Caption;

Beschreibung

Caption enthält einen Textstring, der die Spalte benennt. Wenn der Eigenschaft Options des Datengitters das Flag dgTitles zugewiesen wurde, wird der Titel zur Laufzeit auf dem Formular angezeigt.

Wenn der Eigenschaft FieldName des TColumn-Objekts ein Wert zugewiesen wurde, ist dies der Vorgabewert für TColumnTitle::Caption.


TColumnTitle::Color

TColumnTitle	Siehe auch

Die Eigenschaft Color legt die Hintergrundfarbe für den Spaltentitel fest.

__property Graphics::TColor Color;

Beschreibung

Color legt die Hintergrundfarbe des Spaltentitels fest. Sie können dieser Eigenschaft eine in der Unit Graphics definierte Konstante (z.B. clBlue) zuweisen oder explizit einen vier Byte großen Hexadezimalwert angeben.


TColumnTitle::Font

TColumnTitle	Siehe auch

Die Eigenschaft Font legt fest, in welcher Schriftart der Titel des Spaltenkopfs angezeigt wird.

__property Graphics::TFont* Font;

Beschreibung

Font zeigt auf ein TFont-Objekt, das die typographischen Eigenschaften des im Spaltentitel angezeigten Textes festlegt.


Methoden von TColumnTitle

TColumnTitle	Alphabetisch

In TColumnTitle

~TColumnTitle

Assign

DefaultAlignment

DefaultCaption

DefaultColor

DefaultFont

RestoreDefaults

TColumnTitle

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TColumnTitle

TColumnTitle	Nach Objekten

~TColumnTitle

Assign

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultAlignment

DefaultCaption

DefaultColor

DefaultFont

DefaultHandler

Dispatch

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance

RestoreDefaults

TColumnTitle


TColumnTitle::~TColumnTitle

TColumnTitle	Siehe auch

Der Destruktor ~TColumnTitle gibt den Speicher frei, der für das TColumnTitle-Objekt reserviert war. Rufen Sie ~TColumnTitle nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TColumnTitle automatisch aufgerufen wird.

__fastcall virtual ~TColumnTitle(void);

Beschreibung

TColumnTitle eliminiert die Instanz von TColumnTitle und hebt die Schriftartenzuordnung auf.


TColumnTitle::Assign

TColumnTitle	Siehe auch

Die Methode Assign kopiert den Inhalt eines Spaltentitels in einen anderen Spaltentitel.

virtual void __fastcall Assign(Classes::TPersistent* Source);

Beschreibung

Assign erzeugt einen neuen Spaltentitel. Die Werte für Alignment, Color, Caption und Font werden vom Quellobjekt übernommen.


TColumnTitle::DefaultAlignment

TColumnTitle	Siehe auch

Die Methode DefaultAlignment gibt den Standardwert für die Ausrichtung des Spaltentitels zurück.

Classes::TAlignment __fastcall DefaultAlignment(void);

Beschreibung

DefaultAlignment gibt immer taLeftJustify zurück.


TColumnTitle::DefaultCaption

TColumnTitle	Siehe auch

Die Methode DefaultCaption gibt den Standardtitel der Spalte zurück.

System::AnsiString __fastcall DefaultCaption(void);

Beschreibung

DefaultCaption gibt den Wert der Eigenschaft DisplayName des TField-Objekts zurück, das mit der Spalte verknüpft ist. Wenn mit der Spalte kein Feld einer Datenmenge verknüpft ist (wenn also die Eigenschaft Field der Spalte leer ist), gibt die Methode den Wert der Eigenschaft FieldName der Spalte zurück.


TColumnTitle::DefaultColor

TColumnTitle	Siehe auch

Die Methode DefaultColor gibt die Standard-Hintergrundfarbe für den Spaltentitel zurück.

Graphics::TColor __fastcall DefaultColor(void);

Beschreibung

DefaultColor gibt den Wert der Eigenschaft FixedColor des Datengitters zurück, dem die Spalte zugeordnet ist. Wenn der Spalte kein Datengitter zugeordnet ist, gibt die Methode clBtnFace zurück.


TColumnTitle::DefaultFont

TColumnTitle	Siehe auch

Die Methode DefaultFont gibt die Standard-Schriftart für den Spaltentitel zurück.

Graphics::TFont* __fastcall DefaultFont(void);

Beschreibung

DefaultFont gibt den Wert der Eigenschaft TitleFont des Datengitters zurück, dem die Spalte zugeordnet ist. Ist der Spalte kein Datengitter zugeordnet, gibt DefaultFont den aktuellen Wert der Eigenschaft Font der Spalte zurück.


TColumnTitle::RestoreDefaults

TColumnTitle	Siehe auch

Die Methode RestoreDefaults stellt die Standardeinstellungen des Spaltentitels wieder her.

virtual void __fastcall RestoreDefaults(void);

Beschreibung

RestoreDefaults initialisiert die Eigenschaften Caption und Font neu.


TColumnTitle::TColumnTitle

TColumnTitle	Siehe auch

Der Konstruktor TColumnTitle erzeugt ein neues TColumnTitle-Objekt.

__fastcall TColumnTitle(TColumn* Column);

Beschreibung

TColumnTitle nimmt eine Instanz von TColumn als Argument entgegen.


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent


TColumnTitle Beispiel

TColumnTitle


TColumn

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/dbgrids.hpp

Ein Objekt der Klasse TColumn repräsentiert eine Spalte in einem Datengitter (TDBGrid).

Beschreibung

Jedes TDBGrid-Objekt verwaltet mit Hilfe eines TDBGridColumns-Objekts eine Kollektion von TColumn-Objekten.


Eigenschaften von TColumn

TColumn	Alphabetisch	Legende

In TColumn

Alignment

AssignedValues

ButtonStyle

Color

DropDownRows

Field

FieldName

Font

PickList

ReadOnly

Title

Width

Abgeleitet von TCollectionItem

Collection

Index


Eigenschaften von TColumn

TColumn	Nach Objekten	Legende

Alignment

AssignedValues

ButtonStyle

Collection

Color

DropDownRows

FieldName

Field

Font

Index

PickList

ReadOnly

Title

Width


TColumn::Alignment

TColumn	Siehe auch	Beispiel

Die Eigenschaft Alignment legt fest, wie der Text in der Spalte ausgerichtet wird.

__property Classes::TAlignment Alignment;

Beschreibung

Die folgende Tabelle enthält die möglichen Werte von Alignment:

Wert	Bedeutung

taLeftJustify	Richtet den Text an der linken Seite der Spalte aus.

taCenter	Zentriert den Text in der Spalte.

taRightJustify	Richtet den Text an der rechten Seite der Spalte aus.


TColumn::AssignedValues

TColumn	Siehe auch

Die Eigenschaft AssignedValues gibt an, welchen Eigenschaften von TColumn und TColumnTitle ein Wert zugewiesen wurde.

__property TColumnValues AssignedValues;

Beschreibung

Diese Nur-Lesen-Eigenschaft zeigt diejenigen Eigenschaften der Spalte und ihres Titels (TColumnTitle) an, denen ein Wert zugewiesen oder deren Wert geändert wurde. AssignedValues gibt folgende Werte in beliebiger Anzahl zurück:

Wert	Bedeutung

cvColor	Die Eigenschaft Color der Spalte wurde geändert.

cvWidth	Die Eigenschaft Width der Spalte wurde geändert.

cvFont	Die Eigenschaft Font der Spalte wurde geändert.

cvAlignment	Die Eigenschaft Alignment der Spalte wurde geändert.

cvReadOnly	Die Eigenschaft ReadOnly der Spalte wurde geändert.

cvTitleColor	Die Eigenschaft Color des Spaltentitels wurde geändert.

cvTitleCaption	Die Eigenschaft Caption des Spaltentitels wurde geändert.

cvTitleAlignment	Die Eigenschaft Alignment des Spaltentitels wurde geändert.

cvTitleFont	Die Eigenschaft Font des Spaltentitels wurde geändert.

Wenn AssignedValues beispielsweise [cvColor, cvTitleCaption] zurückgibt, wurden die Schriftart und der Titeltext der Spalte geändert.


TColumn::ButtonStyle

TColumn	Siehe auch

Die Eigenschaft ButtonStyle legt fest, ob und wie der Benutzer Werte für die Spalte aus einer Liste auswählen kann.

__property TColumnButtonStyle ButtonStyle;

Beschreibung

ButtonStyle legt fest, wie der Benutzer den Inhalt einer Spalte des Datengitters auswählen kann. Die folgende Tabelle enthält die möglichen Werte von ButtonStyle:

Wert	Bedeutung

cbsAuto	Wenn die Spalte mit einem Lookup-Feld verknüft ist oder wenn ihre Eigenschaft PickList einen Wert enthält, zeigt das Gitter in der Spalte ein Kombinationsfeld an. Der Benutzer kann einen Wert aus der Dropdown-Liste auswählen.

cbsEllipsis	Die Spalte zeigt eine ovale Schaltfläche an, auf die der Benutzer klicken kann, um einen Wert auszuwählen. Der Mausklick löst das Ereignis OnEditButtonClick aus.

cbsNone	Es wird weder ein Kombinationsfeld noch eine ovale Schaltfläche angezeigt. Der Benutzer kann den Inhalt der Spalte nicht aus einer Liste auswählen.


TColumn::Color

TColumn	Siehe auch

Die Eigenschaft Color legt die Hintergrundfarbe der Spalte fest.

__property Graphics::TColor Color;

Beschreibung

Color legt die Hintergrundfarbe für die Spalte des Datengitters fest. Sie können dieser Eigenschaft eine in der Unit Graphics definierte Konstante (z.B. clBlue) zuweisen oder explizit einen vier Byte großen Hexadezimalwert angeben.


TColumn::DropDownRows

TColumn	Siehe auch

Die Eigenschaft DropDownRows gibt an, wieviele Zeilen in der Dropdown-Liste der Spalte angezeigt werden.

__property int DropDownRows;

Beschreibung

DropDownRows legt die Anzahl der Textzeilen fest, die in der mit der Spalte verknüpften Dropdown-Liste angezeigt werden. Diese Eigenschaft wirkt sich nur aus, wenn ButtonStyle den Wert cbsAuto hat und die Spalte mit einem Lookup-Feld oder einer Auswahlliste verknüpft ist.


TColumn::Field

TColumn	Siehe auch

Die Eigenschaft Field zeigt auf die von der Spalte repräsentierte Instanz von TField.

__property Db::TField* Field;

Beschreibung

Field zeigt auf das TField-Objekt, das mit dem in der Spalte angezeigten Feld der Datenmenge korrespondiert.


TColumn::FieldName

TColumn	Siehe auch

Die Eigenschaft FieldName gibt den Namen des in der Spalte angezeigten Feldes an.

__property System::AnsiString FieldName;

Beschreibung

Die Zuweisung eines Wertes an FieldName ändert den Wert der Eigenschaft Field dahingehend, daß sie auf das entsprechende Feld der Datenmenge zeigt. Wenn es in der Datenmenge kein Feld mit diesem Namen gibt, wird Field auf NULL gesetzt.


TColumn::Font

TColumn	Siehe auch

Die Eigenschaft Font legt die Schriftart fest, in der die Daten in der Spalte angezeigt werden.

__property Graphics::TFont* Font;

Beschreibung

Font zeigt auf ein TFont-Objekt, das die typographischen Eigenschaften des in der Spalte angezeigten Textes festlegt.


TColumn::PickList

TColumn	Siehe auch

Die Eigenschaft PickList repräsentiert eine Liste, aus der der Benutzer Werte für die Spalte auswählen kann.

__property Classes::TStrings* PickList;

Beschreibung

PickList zeigt auf ein TStrings-Objekt. Wenn die Eigenschaft ButtonStyle den Wert cbsAuto hat, werden diese Strings in der Dropdown-Liste der Spalte angezeigt.


TColumn::ReadOnly

TColumn	Siehe auch

Die Eigenschaft ReadOnly legt fest, ob die in der Spalte angezeigten Daten bearbeitet werden können.

__property bool ReadOnly;

Beschreibung

Wenn ReadOnly den Wert True hat, können die in der Spalte angezeigten Daten zur Laufzeit nicht geändert werden. Wenn ReadOnly False ist (und die Eigenschaft Options des Datengitters das Flag dgEditing enthält), können die Daten vom Benutzer direkt im Gitter bearbeitet werden.


TColumn::Title

TColumn	Siehe auch

Die Eigenschaft Title zeigt auf ein TColumnTitle-Objekt, das den Spaltentitel repräsentiert.

__property TColumnTitle* Title;

Beschreibung

Title zeigt auf ein TColumnTitle-Objekt, das Attribute des Spaltentitels festlegt. Wenn die Eigenschaft FieldName einen Wert enthält, wird dieser zum Vorgabewert für den Spaltentitel (TColumnTitle::Caption).

Der Titel (TColumnTitle::Caption) wird zur Laufzeit nur dann angezeigt, wenn in der Eigenschaft Options des Datengitters das Flag dgTitles gesetzt ist.


TColumn::Width

TColumn	Siehe auch	Beispiel

Die Eigenschaft Width gibt die Breite der Spalte an.

__property int Width;

Beschreibung

Width legt die Spaltenbreite in Pixel fest. Wenn in der Eigenschaft Options des Datengitters das Flag dgColumnResize gesetzt ist, kann die Spaltengröße zur Laufzeit vom Benutzer geändert werden.


Methoden von TColumn

TColumn	Alphabetisch

In TColumn

~TColumn

Assign

DefaultAlignment

DefaultColor

DefaultFont

DefaultReadOnly

DefaultWidth

RestoreDefaults

TColumn

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TColumn

TColumn	Nach Objekten

~TColumn

Assign

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultAlignment

DefaultColor

DefaultFont

DefaultHandler

DefaultReadOnly

DefaultWidth

Dispatch

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance

RestoreDefaults

TColumn


TColumn::~TColumn

TColumn	Siehe auch

Der Destruktor ~TColumn gibt den Speicher frei, der für das TColumn-Objekt reserviert war. Rufen Sie ~TColumn nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TColumn automatisch aufgerufen wird.

__fastcall virtual ~TColumn(void);

Beschreibung

Der Destruktor ~TColumn eliminiert die Instanz von TColumn sowie den Titel (TColumnTitle), die Schriftart (TFont) und die Auswahlliste (TStrings).


TColumn::Assign

TColumn	Siehe auch

Die Methode Assign kopiert den Inhalt der Quellspalte in eine neue Spalte.

virtual void __fastcall Assign(Classes::TPersistent* Source);

Beschreibung

Assign erzeugt eine neue Spalte. Die Werte für FieldName, Title, DropDownRows, ButtonStyle und PickList sind dieselben wie beim Quellobjekt. Die Werte für Color, Width, Font, Alignment und ReadOnly werden ebenfalls kopiert, wenn AssignedValues anzeigt, daß sie geändert wurden.


TColumn::DefaultAlignment

TColumn	Siehe auch

Die Methode DefaultAlignment gibt den Vorgabewert der Spaltenausrichtung zurück.

Classes::TAlignment __fastcall DefaultAlignment(void);

Beschreibung

DefaultAlignment gibt den Wert der Eigenschaft Alignment des TField-Objekts zurück, das mit der Spalte verknüpft ist. Wenn mit der Spalte kein Feld einer Datenmenge verknüpft ist, gibt DefaultAlignment den Wert taLeftJustify zurück.


TColumn::DefaultColor

TColumn	Siehe auch

Die Methode DefaultColor gibt den Vorgabewert für die Hintergrundfarbe der Spalte zurück.

Graphics::TColor __fastcall DefaultColor(void);

Beschreibung

DefaultColor gibt den Wert der Eigenschaft Color des Datengitters zurück, zu dem die Spalte gehört. Wenn der Spalte kein Datengitter zugeordnet ist, gibt DefaultColor den Wert clWindow zurück.


TColumn::DefaultFont

TColumn	Siehe auch

Die Methode DefaultFont gibt den Vorgabewert für die Schritfart zurück, in der Daten in der Spalte angezeigt werden.

Graphics::TFont* __fastcall DefaultFont(void);

Beschreibung

DefaultFont gibt den Wert der Eigenschaft Font des Datengitters zurück, zu dem die Spalte gehört. Wenn der Spalte kein Datengitter zugeordnet ist, gibt DefaultFont den aktuellen Wert der Eigenschaft Font der Spalte zurück.


TColumn::DefaultReadOnly

TColumn	Siehe auch

Die Methode DefaultReadOnly gibt den Standardwert der Eigenschaft ReadOnly der Spalte zurück.

bool __fastcall DefaultReadOnly(void);

Beschreibung

DefaultReadOnly gibt immer False zurück.


TColumn::DefaultWidth

TColumn	Siehe auch

Die Methode DefaultWidth gibt den Vorgabewert der Spaltenbreite zurück.

int __fastcall DefaultWidth(void);

Beschreibung

Der Wert von DefaultWidth ergibt sich folgendermaßen:

•	Wenn mit der Spalte kein Datengitter verknüpft ist, gibt DefaultWidth 64 zurück.

•	Wenn die Spalte mit einem Datengitter verknüpft ist, die Eigenschaft Field jedoch keinen Wert enthält, gibt DefaultWidth den Wert der als protected deklarierten Eigenschaft DefaultColWidth des Datengitters zurück (normalerweise 64).

•	Wenn die Spalte mit einem Datenfeld verknüpft ist, wird der Wert von DefaultWidth aus der Eigenschaft DisplayWidth des TField-Objekts berechnet.

•	Wenn in der Eigenschaft Options des Datengitters das Flag dgTitles gesetzt ist, wird der Wert von DefaultWidth (falls erforderlich) der Größe des Spaltentitels angepasst.


TColumn::RestoreDefaults

TColumn	Siehe auch

Die Methode RestoreDefaults stellt die Vorgabewerte der Spalte wieder her.

virtual void __fastcall RestoreDefaults(void);

Beschreibung

RestoreDefaults initialisiert die Eigenschaften AssignedValues, ButtonStyle, Font und PickList neu, gibt die bestehende Auswahlliste (TString) frei und ruft die Methode RestoreDefaults des Spaltentitels (TColumnTitle) auf. Wenn zuvor die Eigenschaft Font geändert wurde, wird der aktuelle Wert beibehalten.


TColumn::TColumn

TColumn	Siehe auch

Der Konstruktor TColumn erzeugt ein neues TColumn-Objekt.

__fastcall virtual TColumn(Classes::TCollection* Collection);

Beschreibung

TColumn nimmt eine Instanz von TDBGridColumns als Argument entgegen. Das Datengitter wird zusammen mit dem Titel (TColumnTitle) und dem Schriftobjekt (TFont) erzeugt.


Gültigkeitsbereich

Published

Zugriff

Read-only


Hierarchie

TObject

TPersistent

TCollectionItem


TColumn Beispiel

TColumn


 TComboBox

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/stdctrls.hpp

TComboBox ist eine Kombination aus einem Eingabefeld und einem bildlauffähigen Listenfeld.

Beschreibung

Eine TComboBox-Komponente ist ein Eingabefeld mit einer dazugehörigen bildlauffähigen Dropdown-Liste. Der Benutzer kann einen Eintrag aus der Liste wählen oder Eingaben direkt im Eingabefeld vornehmen.


Eigenschaften von TComboBox

TComboBox	Alphabetisch	Legende

Abgeleitet von TCustomComboBox

Canvas

DropDownCount

DroppedDown

ItemHeight

ItemIndex

Items

MaxLength

SelLength

SelStart

SelText

Sorted

Style

Abgeleitet von TWinControl

Brush

ClientOrigin

ClientRect

ControlCount

Controls

Ctl3D

Handle

HelpContext

ParentCtl3D

Showing

TabOrder

TabStop

Abgeleitet von TControl

Align

BoundsRect

ClientHeight

ClientWidth

Color

ControlState

ControlStyle

Cursor

DragCursor

DragMode

Enabled

Font

Height

Hint

Left

Name

Parent

ParentColor

ParentFont

ParentShowHint

PopupMenu

ShowHint

Text

Top

Visible

Width

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TComboBox

TComboBox	Nach Objekten	Legende

Align

BoundsRect

Brush

Canvas

ClientHeight

ClientOrigin

ClientRect

ClientWidth

Color

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlCount

ControlState

Controls

ControlStyle

Ctl3D

Cursor

DesignInfo

DragCursor

DragMode

DropDownCount

DroppedDown

Enabled

Font

Handle

Height

HelpContext

Hint

ItemHeight

ItemIndex

Items

Left

MaxLength

Name

Owner

ParentColor

ParentCtl3D

ParentFont

ParentShowHint

Parent

PopupMenu

SelLength

SelStart

SelText

ShowHint

Showing

Sorted

Style

TabOrder

TabStop

Tag

Text

Top

Visible

Width


Ereignisse von TComboBox

TComboBox	Alphabetisch	Legende

Abgeleitet von TCustomComboBox

OnChange

OnDrawItem

OnDropDown

OnMeasureItem

Abgeleitet von TWinControl

OnEnter

OnExit

OnKeyDown

OnKeyPress

OnKeyUp

Abgeleitet von TControl

OnClick

OnDblClick

OnDragDrop

OnDragOver

OnEndDrag

OnStartDrag


TComboBox events

TComboBox	Nach Objekten	Legende

OnChange

OnClick

OnDblClick

OnDragDrop

OnDragOver

OnDrawItem

OnDropDown

OnEndDrag

OnEnter

OnExit

OnKeyDown

OnKeyPress

OnKeyUp

OnMeasureItem

OnStartDrag


Methoden von TComboBox

TComboBox	Alphabetisch

In TComboBox

~TComboBox

TComboBox

Abgeleitet von TCustomComboBox

Clear

SelectAll

Abgeleitet von TWinControl

Broadcast

CanFocus

ContainsControl

ControlAtPos

DisableAlign

EnableAlign

Focused

GetTabOrderList

HandleAllocated

HandleNeeded

InsertControl

Invalidate

PaintTo

Realign

RemoveControl

Repaint

ScaleBy

ScrollBy

SetBounds

SetFocus

Update

UpdateControlState

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

GetTextLen

Hide

Perform

Refresh

ScreenToClient

SendToBack

SetTextBuf

Show

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TComboBox

TComboBox	Nach Objekten

~TComboBox

Assign

BeginDrag

BringToFront

Broadcast

CanFocus

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

Clear

ClientToScreen

ContainsControl

ControlAtPos

DefaultHandler

DestroyComponents

Destroying

DisableAlign

Dispatch

DragDrop

Dragging

EnableAlign

EndDrag

FieldAddress

FindComponent

Focused

FreeInstance

FreeNotification

Free

GetParentComponent

GetTabOrderList

GetTextBuf

GetTextLen

HandleAllocated

HandleNeeded

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InsertControl

InstanceSize

Invalidate

MethodAddress

MethodName

NewInstance

PaintTo

Perform

Realign

Refresh

RemoveComponent

RemoveControl

Repaint

ScaleBy

ScreenToClient

ScrollBy

SelectAll

SendToBack

SetBounds

SetFocus

SetTextBuf

Show

TComboBox

UpdateControlState

Update


TComboBox::~TComboBox

TComboBox

Der Destruktor ~TComboBox gibt den Speicher frei, der für das TComboBox-Objekt reserviert war. Rufen Sie ~TComboBox nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TComboBox automatisch aufgerufen wird.

__fastcall virtual ~TComboBox(void);


TComboBox::TComboBox

TComboBox

Der Konstruktor TComboBox erzeugt ein neues TComboBox-Objekt.

__fastcall virtual TComboBox(Classes::TComponent* AOwner);


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TControl

TWinControl

TCustomComboBox


TComboBox Beispiel

TComboBox


TCommonDialog

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/dialogs.hpp

Die Klasse TCommonDialog ist der Vorfahr aller Komponenten, die die in Windows üblichen Dialogfelder repräsentieren.

Beschreibung

TCommonDialog ist eine abstrakte Klasse, die die in Windows üblichen Dialogfelder repräsentiert. Zu den Nachkommen von TCommonDialog gehören visuelle Komponenten, mit denen der Benutzer beispielsweise Dateien suchen und öffnen, Schriftarten und Farben einstellen oder einen Druckvorgang steuern kann.

Neue Komponenten, die bekannte Dialogfunktionen kapseln, sollten von TCommonDialog abgeleitet werden. Die meisten anderen Dialogfelder sollten Nachkommen von TForm sein.


Eigenschaften von TCommonDialog

TCommonDialog	Alphabetisch	Legende

In TCommonDialog

Ctl3D

Handle

HelpContext

StaticRect

Template

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Name

Owner

StaticRect

Tag

Template


Eigenschaften von TCommonDialog

TCommonDialog	Nach Objekten	Legende

read-only	ComponentState

ComponentCount

ComponentIndex

Components

ComponentStyle

Ctl3D

DesignInfo

Handle

HelpContext

Name

Owner

StaticRect

Tag

Template


TCommonDialog::Ctl3D

TCommonDialog	Siehe auch	Beispiel

Die Eigenschaft Ctl3D legt fest, ob das Dialogfeld dreidimensional angezeigt wird.

__property bool Ctl3D;

Beschreibung

Wenn Ctl3D den Wert True hat, werden das Dialogfeld und die darin enthaltenen Steuerelemente dreidimensional angezeigt. Andernfalls erscheinen das Dialogfeld und seine Steuerelemente zweidimensional.

Hinweis

Damit Dialogfelder unter Windows NT 3.51 dreidimensional angezeigt werden, muß CTL3D32.DLL im Verzeichnis SYSTEM32 installiert sein.


TCommonDialog::Handle

TCommonDialog	Example

Das Fenster-Handle des Dialogs.

Beschreibung

Handle ermöglichr den Zugriff auf das Fenster-Handle desDialogs


TCommonDialog::HelpContext

TCommonDialog	Siehe auch

Die Eigenschaft HelpContext ist eine Kontextnummer für die Hilfe.

__property Classes::THelpContext HelpContext;

Beschreibung

HelpContext ist eine Ganzzahl, die festlegt, welcher Hilfebildschirm angezeigt wird, wenn der Benutzer die kontextsensitive Hilfe aufruft. Wenn HelpContext den Wert 0 hat (Vorgabe), erbt das Dialogfeld den Hilfekontext seines übergeordneten Objekts.


TCommonDialog::StaticRect

TCommonDialog	Siehe auch

Die Bildschirmkoordinaten des Dialogfensters.

Beschreibung

StaticRect enthält die Größe und die Koordinaten des Standarddialogs auf dem Bildschirms.


TCommonDialog::Template

TCommonDialog

Zeigt auf eine selbstdefinierte Vorlage für den Dialog.

Beschreibung

Template ist ein Zeiger auf eine Windows-Ressource, die die Erscheinung des Dialogfensters bestimmt.


Methoden von TCommonDialog

TCommonDialog	Alphabetisch

In TCommonDialog

~TCommonDialog

TCommonDialog

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TCommonDialog

TCommonDialog	Nach Objekten

~TCommonDialog

Assign

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

DestroyComponents

Destroying

Dispatch

FieldAddress

FindComponent

FreeInstance

FreeNotification

Free

GetParentComponent

HasParent

InheritsFrom

InitInstance

InsertComponent

InstanceSize

MethodAddress

MethodName

NewInstance

RemoveComponent

TCommonDialog


TCommonDialog::~TCommonDialog

TCommonDialog

Der Destruktor ~TCommonDialog gibt den Speicher frei, der für das TCommonDialog-Objekt reserviert war. Rufen Sie ~TCommonDialog nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TCommonDialog automatisch aufgerufen wird.

__fastcall virtual ~TCommonDialog(void);


TCommonDialog::TCommonDialog

TCommonDialog	Siehe auch

TCommonDialog erzeugt und initialisiert eine Instanz von TCommonDialog.

__fastcall virtual TCommonDialog(Classes::TComponent* AOwner);

Beschreibung

TCommonDialog ruft den geerbten Konstruktor auf und initialisiert die Eigenschaft Ctl3D mit True.


Gültigkeitsbereich

Published

Zugriff

Read-only


Hierarchie

TObject

TPersistent

TComponent


TCommonDialog Beispiel

TCommonDialog


TControl

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/controls.hpp

TControl ist die abstrakte Basisklasse für alle Steuerelemente.

Beschreibung

Steuerelemente sind visuelle Komponenten, die der Benutzer zur Laufzeit sehen und bearbeiten kann. Alle Steuerelemente besitzen gemeinsame Eigenschaften, Methoden und Ereignisse, die sich speziell auf visuelle Aspekte beziehen. Dazu gehören beispielsweise die Position des Steuerelements, der mit dem Steuerelement verbundene Cursor oder Kurzhinweis, Methoden zum Zeichnen oder Verschieben des Steuerelements und Ereignisse, die auf Mausaktionen reagieren.

Die Klasse TControl verfügt über eine große Anzahl von als protected deklarierten Eigenschaften und Methoden, die von ihren Nachkommen als published deklariert werden.


Eigenschaften von TControl

TControl	Alphabetisch	Legende

In TControl

Align

BoundsRect

Caption

ClientHeight

ClientOrigin

ClientRect

ClientWidth

Color

ControlState

ControlStyle

Cursor

DragCursor

DragMode

Enabled

Font

Height

Hint

IsControl

Left

MouseCapture

Name

Parent

ParentColor

ParentFont

ParentShowHint

PopupMenu

ScalingFlags

ShowHint

Text

Top

Visible

Width

WindowProc

WindowText

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TControl

TControl	Nach Objekten	Legende

Align

BoundsRect

Caption

ClientHeight

ClientOrigin

ClientRect

ClientWidth

Color

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlState

ControlStyle

Cursor

DesignInfo

DragCursor

DragMode

Enabled

Font

Height

Hint

IsControl

Left

MouseCapture

Name

Owner

ParentColor

ParentFont

ParentShowHint

Parent

PopupMenu

ScalingFlags

ShowHint

Tag

Text

Top

Visible

Width

WindowProc

WindowText


TControl::Align

TControl	Siehe auch

Die Eigenschaft Align bestimmt, wie die Steuerelemente in ihrem Container (oder übergeordneten Steuerelement) ausgerichtet werden.

__property TAlign Align;

Beschreibung

Mit Hilfe von Align richten Sie ein Steuerelement an der oberen, unteren, linken oder rechten Seite eines Formulars oder einer Tafel aus. Das Element bleibt auch dann an dieser Position, wenn sich die Größe des Formulars bzw. der Tafel oder Komponente ändert, in der sich das Steuerelement befindet.

Wenn Sie beispielsweise eine Tafel mit mehreren Steuerelementen als Werkzeugpalette verwenden wollen, setzen Sie Align für die Tafel auf alLeft. Dieser Wert garantiert, daß die Werkzeugpalette auf der linken Seite des Formulars bleibt und immer der Client-Höhe des Formulars entspricht.

Per Voreinstellung ist Align mit alNone belegt. Dieser Wert bewirkt, daß ein Steuerelement an der Position bleibt, an der es in das Formular oder die Tafel eingefügt wurde. Geben Sie einen anderen Wert ein, um das Steuerelement auf eine bestimmte Weise auszurichten. Folgende Werte stehen für die Eigenschaft Align zur Verfügung:

Wert	Bedeutung

alNone	Die Komponente bleibt an der Position, an der sie in das Formular bzw. in die Tafel eingefügt wurde. Dies ist der Vorgabewert.

alTop	Die Komponente wird am oberen Rand des Formulars ausgerichtet und so vergrößert, daß sie die gesamte Breite des Formulars ausfüllt. Die Höhe der Komponente bleibt unverändert.

alBottom	Die Komponente wird am unteren Rand des Formulars ausgerichtet und so vergrößert, daß sie die gesamte Breite des Formulars ausfüllt. Die Höhe der Komponente bleibt unverändert.

alLeft	Die Komponente wird an der linken Seite des Formulars ausgerichtet und so vergrößert, daß sie die gesamte Höhe des Formulars ausfüllt. Die Breite der Komponente bleibt unverändert.

alRight	Die Komponente wird an der rechten Seite des Formulars ausgerichtet und so vergrößert, daß sie die gesamte Höhe des Formulars ausfüllt. Die Breite der Komponente bleibt unverändert.

alClient	Die Komponente wird so vergrößert, daß sie den gesamten Client-Bereich des Formulars ausfüllt. Falls bereits eine andere Komponente einen Teil des Client-Bereichs bedeckt, wird die Größe der Komponente so verändert, daß sie den verbleibenden Platz einnimmt.

Hinweis

Ist Align auf alClient gesetzt, füllt das Steuerelement den gesamten Client-Bereich aus, so daß das übergeordnete Formular nicht durch Anklicken ausgewählt werden kann. In diesem Fall können Sie den Objektinspektor verwenden oder das Steuerelement im Formular markieren und die ESC-Taste drücken.

Sie können einer beliebigen Zahl von untergeordneten Komponenten den gleichen Align-Wert zuweisen. Die Komponenten stapeln sich dann im übergeordneten Formular bzw. in der übergeordneten Tafel entlang des Randes. Durch Ziehen der Steuerelemente mit der Maus können Sie den Stapel in der gewünschten Weise anordnen.


TControl::BoundsRect

TControl	Siehe auch	Beispiel

Die Methode BoundsRect liefert das umgebende Rechteck des Steuerelements zurück. Die Angabe bezieht sich auf das Koordinatensystem des übergeordneten Steuerelements.

__property Windows::TRect BoundsRect;

Beschreibung

Mit Hilfe von BoundsRec lassen sich einfach und schnell die Pixel-Positionen der Ecken eines Steuerelements ermitteln.

Beispielsweise erhalten Sie mit der Anweisung

R = Control.BoundsRect;

das gleiche Resultat wie mit den folgenden Anweisungen:

R.Left = Control->Left;

R.Top = Control->Top;

R.Right = Control->Left + Control->Width;

R.Bottom = Control->Top + Control->Height;

Der Typ TRect definiert ein Rechteck. Die Koordinaten werden entweder als vier einzelne Integer angegeben, die die Pixel-Positionen des linken, oberen, rechten und unteren Randes bestimmen, oder als zwei Punkte, die die Pixel-Positionen der oberen linken und der unteren rechten Ecke bezeichnen. Der Ursprung des Pixel-Koordinatensystems liegt in der oberen linken Ecke des Bildschirms.


TControl::Caption

TControl	Siehe auch	Beispiel

Die Eigenschaft Caption legt den Text-String fest, der das Steuerelement gegenüber dem Benutzer identifiziert.

__property System::AnsiString Caption;

Beschreibung

Mit Hilfe von Caption wird das Steuerelement mit einem Text-String verknüpft, über den es identifiziert werden kann.

Bei den meisten Steuerelementen ist Caption der Fenstertitel und wird als Beschriftung für das Steuerelement eingeblendet. Einige Objekte interpretieren Caption jedoch anders. Bei einer Schaltfläche beispielsweise stellt die Eigenschaft den Namen dar, und zwar so lange, bis ein anderer Wert eingegeben wird.

Wenn ein Zeichen in einem Caption-String unterstrichen dargestellt werden soll, stellen Sie ihm ein kaufmännisches Und (&) voran. Das unterstrichene Zeichen dient als Tastenkürzel. Der Benutzer kann die Komponente auswählen, indem er die ALT-Taste gedrückt hält und das unterstrichene Zeichen eingibt.


TControl::ClientHeight

TControl	Siehe auch	Beispiel

Die Eigenschaft ClientHeight gibt die Höhe des Client-Bereichs des Steuerelements in Pixel an.

__property int ClientHeight;

Beschreibung

Mit Hilfe von ClientHeight können Sie die Höhe des Client-Bereichs des Steuerelements abrufen oder ändern.

Bei TControl entspricht die Eigenschaft ClientHeight der Eigenschaft Height. Abgeleitete Klassen implementieren unter Umständen eine ClientHeight-Eigenschaft, die sich von der Eigenschaft Height unterscheidet. Beispielsweise entspricht die Eigenschaft ClientHeight eines Formulars der Eigenschaft Height abzüglich der Höhe der Titelleiste, des Rahmens und der Bildlaufleiste.


TControl::ClientOrigin

TControl	Siehe auch	Beispiel

Die Eigenschaft ClientOrigin legt die Bildschirmkoordinaten der oberen linken Ecke des Client-Bereichs eines Steuerelements in Pixel fest.

__property POINT ClientOrigin;

Beschreibung

Mit einem Lesezugriff auf ClientOrigin können Sie die linke obere Ecke des Client-Bereichs eines Steuerelements ermitteln. ClientOrigin liefert die X- und Y-Koordinaten als TPoint zurück, wobei der Ursprung in der oberen linken Ecke liegt. X stellt die horizontale Koordinate des Punktes dar, Y die vertikale Koordinate.

Die Bildschirmkoordinaten eines Steuerelements, das nicht von TWinControl, sondern von TControl abgeleitet ist, ergeben sich aus der Addition seiner Eigenschaften Left bzw. Top und der Bildschirmkoordinaten seines übergeordneten Steuerelements. Wenn dem Steuerelement kein Objekt übergeordnet ist, tritt beim Lesen von ClientOrigin eine EInvalidOperation-Exception auf.


TControl::ClientRect

TControl	Siehe auch 	Beispiel

Die Eigenschaft ClientRect liefert die Größe des Client-Bereichs des Steuerelements in Pixel zurück.

__property Windows::TRect ClientRect;

Beschreibung

Mit einem Lesezugriff auf ClientRect können Sie die Größe des Client-Bereichs in einem Steuerelement ermitteln. ClientRect liefert ein Rechteck zurück, dessen Felder Top und Left auf Null gesetzt sind. Die Felder Bottom und Right sind mit den Werten der Eigenschaft Height bzw. Width des Steuerelements belegt. ClientRect entspricht Rect(0, 0, ClientWidth, ClientHeight).

Der Typ TRect definiert ein Rechteck. Die Koordinaten werden entweder als vier einzelne Integerwerte angegeben, die die Pixel-Positionen des linken, oberen, rechten und unteren Randes bestimmen, oder als zwei Punkte, die die Pixel-Positionen der oberen linken und der unteren rechten Ecke bezeichnen.


TControl::ClientWidth

TControl	Siehe auch	Beispiel

Die Eigenschaft ClientWidth gibt die Breite des Client-Bereichs des Steuerelements in Pixel an.

__property int ClientWidth;

Beschreibung

Mit Hilfe von ClientWidth können Sie die Breite des Client-Bereichs des Steuerelements abrufen oder ändern. ClientWidth entspricht der Eigenschaft ClientRect::Right.


TControl::Color

TControl	Siehe auch

Die Eigenschaft Color gibt die Hintergrundfarbe des Steuerelements an.

__property Graphics::TColor Color;

Beschreibung

Mit Color können Sie die Hintergrundfarbe des Steuerelements abrufen oder ändern.

Folgende Werte stehen für die Eigenschaft Color zur Verfügung:

Wert	Bedeutung

clBlack	Schwarz

clMaroon	Rotbraun

clGreen	Grün

clOlive	Olivgrün

clNavy	Marineblau

clPurple	Violett

clTeal	Blaugrün

clGray	Grau

clSilver	Silbergrau

clRed	Rot

clLime	Limonengrün

clBlue	Blau

clFuchsia	Pink

clAqua	Türkis

clWhite	Weiß

clBackground	Aktuelle Farbe des Windows-Desktop

clActiveCaption	Aktuelle Farbe der Titelleiste von aktiven Fenstern

clInactiveCaption	Aktuelle Farbe der Titelleiste inaktiver Fenster

clMenu	Aktuelle Hintergrundfarbe der Menüs

clWindow	Aktuelle Hintergrundfarbe der Fenster

clWindowFrame	Aktuelle Farbe der Fensterrahmen

clMenuText	Aktuelle Farbe von Menütext

clWindowText	Aktuelle Farbe von Fenstertext

clCaptionText	Aktuelle Farbe des Textes in der Titelleiste des aktiven Fensters

clActiveBorder	Aktuelle Rahmenfarbe des aktiven Fensters

clInactiveBorder	Aktuelle Rahmenfarbe inaktiver Fenster

clAppWorkSpace	Aktuelle Farbe des Arbeitsbereichs der Anwendung

clHighlight	Aktuelle Hintergrundfarbe von markiertem Text

clHightlightText	Aktuelle Farbe von markiertem Text

clBtnFace	Aktuelle Farbe einer Schaltfläche

clBtnShadow	Aktuelle Farbe des Schattens einer Schaltfläche

clGrayText	Aktuelle Farbe von grau dargestelltem Text

clBtnText	Aktuelle Farbe von Text auf einer Schaltfläche

clInactiveCaptionText	Aktuelle Farbe des Textes in der Titelleiste eines inaktiven Fensters

clBtnHighlight	Aktuelle Farbe des Markierungsrahmens einer Schaltfläche

cl3DDkShadow 	Nur Windows 95 oder NT 4.0: dunkler Schatten für dreidimensionale Dialogelemente

cl3DLight 	Nur Windows 95 oder NT 4.0: helle Farbe für dreidimensionale Dialogelemente (für Kanten, die dem Licht zugewandt sind)

clInfoText 	Nur Windows 95 oder NT 4.0: Textfarbe für Tool-Tip-Steuerelemente

clInfoBk 	Nur Windows 95 oder NT 4.0: Hintergrundfarbe für Tool-Tip-Steuerelemente

Die Farben in der zweiten Hälfte dieser Liste sind Windows-Systemfarben. Welche Farbe tatsächlich angezeigt wird, hängt davon ab, welches Farbschema der Benutzer für Windows verwendet. Die Farben können über die Systemsteuerung geändert werden. Die angezeigte Farbe ist von System zu System verschieden. Beispielsweise kann die Systemfarbe clBtnFace in einem Farbschema Grau, in einem anderen Hellbraun ergeben.

Hinweis

Wenn die Eigenschaft ParentColor eines Steuerelements den Wert True hat, wirkt sich eine €nderung der Eigenschaft Color des übergeordneten Steuerelements automatisch auch auf die Eigenschaft Color des untergeordneten Steuerelements aus. Wenn Sie der Eigenschaft Color eines Steuerelements einen Wert zuweisen, wird die Eigenschaft ParentColor des Steuerelements automatisch auf False gesetzt.


TControl::ControlState

TControl	Siehe auch

Die Eigenschaft ControlState enthält eine Reihe von Werten, die den aktuellen Status eines Steuerelements zur Laufzeit angeben.

__property TControlState ControlState;

Beschreibung

Mit Hilfe von ControlState können Sie die verschiedenen Zustände des Steuerelements ermitteln, beispielsweise ob darauf geklickt wurde oder ob eine Ausrichtung erforderlich ist. ControlState spiegelt einen Übergangszustand eines Steuerelements wieder, im Gegensatz zu den Attributen, die seiner Klasse generell zugewiesen sind. Die Eigenschaft besteht aus einer Reihe von Flags mit folgenden Werten:

Flag	Bedeutung

csLButtonDown	Die linke Maustaste wurde gedrückt und noch nicht wieder losgelassen. Dieses Flag wird bei allen Ereignissen gesetzt, bei denen die Maustaste gedrückt wird.

csClicked	Diese Konstante ist identisch mit csLButtonDown, wird aber nur dann gesetzt, wenn ControlStyle csClickEvents enthält. Das bedeutet, daß alle Ereignisse, in denen eine Maustaste gedrückt wird, als Mausklick interpretiert werden.

csPalette	Vom Steuerelement oder einem seiner übergeordneten Steuerelemente wurde eine WM_PALETTCHANGED-Botschaft empfangen.

csReadingState	Das Steuerelement liest seinen Status aus einem Stream.

csAlignmentNeeded	Das Steuerelement muß sich selbst ausrichten, wenn eine Ausrichtung erforderlich wird.

csFocusing	Die Anwendung bearbeitet Botschaften, die dem Steuerelement den Fokus übergeben sollen. Dies ist zwar keine Garantie dafür, daß das Steuerelement den Fokus erhält, verhindert aber rekursive Aufrufe.

csCreating	Das Steuerelement und/oder sein Eigentümer und seine untergeordneten Steuerelemente werden erzeugt. Sobald der Vorgang beendet ist, wird dieses Flag gelöscht.

csPaintCopy	Das Steuerelement wird reproduziert, d.h. es wird eine Kopie von ihm angelegt. Damit dieser Status eintreten kann, muß das Flag csReplicatable von ControlStyle gesetzt sein.

Die Flags in ControlState beziehen sich nur auf Steuerelemente und ergänzen die Status-Flags der Eigenschaft ComponentState, die für alle Komponenten wirksam sind.

ControlState wird in erster Linie zur Implementierung von Komponenten verwendet, die von TControl abgeleitet sind.


TControl::ControlStyle

TControl	Siehe auch

Die Eigenschaft ControlStyle enthält eine Reihe von Werten, die die Stilattribute des Steuerelements festlegen.

__property TControlStyle ControlStyle;

Beschreibung

Mit ControlStyle können Sie die verschiedenen Attribute des Steuerelements ermitteln, beispielsweise, ob das Steuerelement Mausereignisse abfangen kann oder ob es eine feste Größe hat. Die Eigenschaft ControlStyle enthält eine Reihe von Stil-Flags, die diese Attribute festlegen. Die folgende Tabelle enthält die Flags und deren Bedeutung.

Flag	Bedeutung

csAcceptsControls	Das Steuerelement wird zum übergeordneten Steuerelement aller Elemente, die zur Entwurfszeit in ihm abgelegt werden.

csCaptureMouse	Das Steuerelement fängt Mausereignisse ab, wenn es angeklickt wird.

csDesignInteractive	Das Steuerelement bildet zur Entwurfszeit einen Klick mit der rechten Maustaste als Klick mit der linken Maustaste ab.

csClickEvents	Das Steuerelement kann Mausklicks empfangen und darauf reagieren.

csFramed	Das Steuerelement besitzt einen 3D-Rahmen.

csSetCaption	Das Steuerelement übernimmt seinen Titel aus der Eigenschaft Name. Dies gilt jedoch nicht, wenn dem Titel explizit ein anderer Wert zugewiesen wurde.

csOpaque	Das Steuerelement füllt seinen Client-Bereich vollständig aus.

csDoubleClicks	Das Steuerelement kann Doppelklick-Botschaften empfangen und darauf reagieren. Andernfalls werden Doppelklicks in einfache Klicks umgewandelt.

csFixedWidth	Die Breite des Steuerelements ist nicht veränderbar.

csFixedHeight	Die Höhe des Steuerelements ist nicht veränderbar.

csNoDesignVisible	Das Steuerelement ist zur Entwurfszeit nicht sichtbar.

csReplicatable	Das Steuerelement kann mit der Methode PaintTo auf einer beliebigen Zeichenfläche neu gezeichnet (kopiert) werden.

csNoStdEvents	Standardereignisse wie Maus-, Tasten- und Klick-Ereignisse werden ignoriert. Verwenden Sie diese Einstellung, wenn Ihr Code nicht auf diese Ereignisse zu reagieren braucht. Dadurch erhöht sich die Ausführungsgeschwindigkeit der Anwendung.

csDisplayDragImage	Wenn sich der Mauszeiger über dem Steuerelement befindet, wird ein Bild aus einer Bildliste angezeigt. Verwenden Sie diese Einstellung, wenn das Steuerelement eine Bildliste verarbeiten kann, sobald der Mauszeiger darauf positioniert wird.

ControlStyle beschreibt eine gesamte Klasse und spiegelt sich in all ihren Instanzen wieder. Die Flags sind für jede Instanz gleich und ändern sich auch zur Laufzeit nicht. Veränderliche Übergangszustände werden von der Eigenschaft ControlState festgelegt.

Der Konstruktor TControl von TControl initialisiert ControlStyle mit [csCaptureMouse, csClickEvents, csSetCaption, csDoubleClicks].

ControlStyle wird in erster Linie zur Implementierung von Komponenten verwendet, die von TControl abgeleitet sind.


TControl::Cursor

TControl	Siehe auch

Die Eigenschaft Cursor gibt das Bild an, mit dem der Mauszeiger dargestellt wird, sobald er in den Bereich des Steuerelements gelangt.

__property TCursor Cursor;

Beschreibung

Durch eine €nderung der Eigenschaft Cursor können Sie dem Benutzer deutlich machen, welche Aktion ausgeführt werden muß, sobald der Cursor in den Bereich des Steuerelements bewegt wird.

Der Wert der Eigenschaft Cursor gibt den Index des Cursors in der Cursor-Liste an, die von der globalen Variable Screen verwaltet wird. Zusätzlich zu den integrierten, von TScreen bereitgestellten Cursorformen können Anwendungen eigene Cursor definieren und der Liste hinzufügen. Die folgende Tabelle enthält die integrierten Cursorformen, die TScreen zur Verfügung stellt:

Wert	Darstellung

crDefault	Der Cursor, der für die Fensterklasse voreingestellt ist.
Normalerweise crArrow.

crNone

crArrow

crCross

crIBeam

crSize

crSizeNESW

crSizeNS

crSizeNWSE

crSizeWE

crUpArrow

crHourGlass

crDrag

crNoDrop

crHSplit

crVSplit

crMultiDrag

crSQLWait

crNo

crAppStart

crHelp

Hinweis

Informationen darüber, wie für diese Eigenschaft ein benutzerdefinierter Cursor erzeugt werden kann, finden Sie bei der Beschreibung der Eigenschaft Cursors der Komponente TScreen.


TControl::DragCursor

TControl	Siehe auch	Beispiel

Die Eigenschaft DragCursor enthält das Bild, das beim Ziehen des Steuerelements zur Darstellung des Mauszeigers benutzt wird.

__property TCursor DragCursor;

Beschreibung

Mit der Eigenschaft DragCursor können Sie das Bild ändern, mit dem der Mauszeiger beim Ziehen des Steuerelements dargestellt wird. Die für diese Eigenschaft verfügbaren Werte entsprechen denjenigen der Eigenschaft Cursor. Diese Werte finden Sie in der Tabelle unter der Eigenschaft Cursor.

Hinweis

Informationen darüber, wie für diese Eigenschaft ein benutzerdefinierter Cursor erzeugt werden kann, finden Sie bei der Beschreibung der Eigenschaft Cursors der Komponente TScreen.


TControl::DragMode

TControl	Siehe auch	Beispiel

Mit der Eigenschaft DragMode legen Sie das Drag-and-Drop-Verhalten eines Steuerelements fest.

__property TDragMode DragMode;

Beschreibung

Mit der Eigenschaft DragMode legen Sie fest, unter welchen Voraussetzungen der Benutzer das Steuerelement ziehen kann. Wenn die Eigenschaft den Wert dmAutomatic hat, kann die Anwendung die Möglichkeit zum Drag-and-Drop zur Laufzeit deaktivieren, indem sie den Wert von DragMode auf dmManual setzt.

Folgende Werte stehen für die Eigenschaft DragMode zur Verfügung:

Wert	Bedeutung

dmAutomatic	Bei dmAutomatic kann das Steuerelement gezogen werden. Der Benutzer braucht nur auf das Element zu klicken und es zu ziehen.

dmManual	Bei dmManual kann das Steuerelement erst gezogen werden, wenn in der Anwendung die Methode BeginDrag aufgerufen wird.


TControl::Enabled

TControl	Siehe auch	Beispiel

Die Eigenschaft Enabled legt fest, ob das Steuerelement auf Maus-, Tastatur- und ggf. Timer-Ereignisse reagiert.

__property bool Enabled;

Beschreibung

Mit Enabled können Sie festlegen, ob das Steuerelement für den Benutzer verfügbar ist. Zur Deaktivierung eines Steuerelements setzen Sie Enabled auf False. Deaktivierte Steuerelemente werden grau dargestellt. Hat Enabled den Wert False, ignoriert das Steuerelement Maus-, Tastatur- und ggf. OnTimer-Ereignisse.

Zur erneuten Aktivierung eines Steuerelements setzen Sie Enabled auf True. Das Steuerelement wird nicht mehr grau angezeigt, und der Benutzer kann es wieder verwenden.


TControl::Font

TControl	Siehe auch

Mit der Eigenschaft Font bestimmen Sie die Attribute des Textes, der im Steuerelement angezeigt wird.

__property Graphics::TFont* Font;

Beschreibung

Durch Angabe eines anderen TFont-Objekts können Sie die Schrift wechseln. Wenn Sie die Attribute einer Schrift ändern wollen, weisen Sie den Eigenschaften Color, Height, Name, Pitch, Size oder Style des TFont-Objekts andere Werte zu.


TControl::Height

TControl	Siehe auch	Beispiel

Die Eigenschaft Height gibt die Höhe des Steuerelements in Pixel an.

__property int Height;

Beschreibung

Mit der Eigenschaft Height können Sie die Höhe des Steuerelements abrufen oder ändern.


TControl::Hint

TControl	Siehe auch	Beispiel

Die Eigenschaft Hint enthält den String, der angezeigt wird, wenn der Benutzer den Mauszeiger über das Steuerelement bewegt.

__property System::AnsiString Hint;

Beschreibung

Dieser Eigenschaft können Sie einen String zuweisen, der als Kurzhinweis oder als Hilfetext an einer bestimmten Position angezeigt wird, beispielsweise in der Statusleiste.

Ein Kurzhinweis ist ein Feld mit einem Hilfetext. Dieses Feld wird eingeblendet, wenn der Benutzer den Mauszeiger eine Weile über dem Steuerelement positioniert. So erzeugen Sie Kurzhinweise:

•	Weisen Sie für jedes Steuerelement, das einen Kurzhinweis anzeigen soll, der Eigenschaft Hint einen Wert zu.

•	Setzen Sie die Eigenschaft ShowHint der betreffenden Steuerelemente auf True.

•	Setzen Sie zur Laufzeit die Eigenschaft ShowHint der Anwendung auf True.

Um den Kurzhinweis in einer Statusleiste oder an einer anderen Position anzuzeigen, verwenden Sie die Behandlungsroutine für das Ereignis OnHint der Anwendung. Sobald der Mauszeiger über das Steuerelement bewegt wird, tritt das Ereignis OnHint der Anwendung ein. Mit einer Ereignisbehandlungsroutine für OnHint können Sie den Kurzhinweis als Titel einer Tafelkomponente einblenden, die als Statusleiste dient.

Durch die Angabe von zwei Werten, die durch das Zeichen | (das Pipe- bzw. Oder-Zeichen) voneinander getrennt sind, kann ein Kurzhinweis definiert werden, der sowohl vom Hilfetextfeld als auch von einer Ereignisbehandlungsroutine für OnHint verwendet wird. Ein Beispiel:

Edit1->Hint = AnsiString(“Name|Geben Sie einen Namen ein“;

Der String „Name“ wird im Hilfetextfeld angezeigt, während der String „Geben Sie einen Namen ein“ so verwendet wird, wie es in der Ereignisbehandlungsroutine für OnHint festgelegt ist.

Wenn Sie nur einen Wert eingeben, kann dieser sowohl für den Kurzhinweis als auch für die Eigenschaft Hint der Anwendung verwendet werden. Hat die Eigenschaft ShowHint der Anwendung den Wert False, wird zwar der Kurzhinweis nicht angezeigt, die Ereignisbehandlungsroutine für OnHint aber trotzdem aufgerufen.

Wenn für ein Steuerelement kein Wert für Hint angegeben ist, aber für dessen übergeordnetes Objekt ein Kurzhinweis existiert, verwendet das Steuerelement den Wert des übergeordneten Objekts. Voraussetzung dafür ist, daß die Eigenschaft ShowHint des Steuerelements auf True gesetzt ist.


TControl::IsControl

TControl	Siehe auch

Die Eigenschaft IsControl legt fest, ob ein Formular seine formularspezifischen Eigenschaften in einen Stream schreibt.

__property bool IsControl;

Beschreibung

Mit IsControl können Sie ein Formular als komplexes Steuerelement anstatt als Desktop-Formular verwenden. IsControl beeinflußt die Art und Weise, in der das Formular gespeichert wird. Wenn IsControl True ist, werden die formularspezifischen Eigenschaften nicht zusammen mit dem Formular gespeichert. Andernfalls werden die formularspezifischen Eigenschaften zusammen mit den anderen Eigenschaften gespeichert.

IsControl ermöglicht es, mit dem Formular-Designer komplexe Steuerelemente wie z.B. Tafeln anzulegen. Sie können das Steuerelement im Formular-Designer als Formular erzeugen, in ihm die gewünschten Steuerelemente plazieren, sie benennen und den Ereignissen entsprechenden Code zuweisen. Nachdem Sie das Formular gespeichert haben, bearbeiten Sie es als Text und setzen IsControl auf True. Beim nächsten Laden und Speichern des Formulars werden nur diejenigen Formulareigenschaften gespeichert, die für Steuerelemente verwendet werden können, nicht aber diejenigen, die sich nur auf TForm beziehen. Setzen Sie anschließend (wiederum im Text) den Typ der Komponente TForm auf den gewünschten Steuerelementtyp, beispielsweise TPanel.


TControl::Left

TControl	Siehe auch	Beispiel

Die Eigenschaft Left gibt die horizontale Koordinate des linken Komponentenrandes relativ zum Formular in Pixel an.

__property int Left;

Beschreibung

Mit der Eigenschaft Left können Sie den linken Rand des Steuerelements ermitteln oder neu zuweisen.

Wenn das Steuerelement in einem anderen Steuerelement wie z.B. TPanel enthalten ist, sind die Eigenschaften Left und Top relativ zu ihrem übergeordneten Steuerelement. Ist das Steuerelement direkt in einem Formular enthalten, sind die Eigenschaftswerte relativ zu diesem Formular. Bei Formularen ist der Wert der Eigenschaft Left relativ zum gesamten Bildschirm.


TControl::MouseCapture

TControl	Siehe auch

Die Eigenschaft MouseCapture legt fest, ob das Steuerelement Mausereignisse „vereinnahmt“.

__property bool MouseCapture;

Beschreibung

Mit MouseCapture können Sie festlegen, ob ein Steuerelement Mausereignisse auf sich bezieht. Ein solches Steuerelement empfängt so lange alle nachfolgenden Mausereignisse, bis der Benutzer die Maustaste wieder losläßt.

Dieser Fall tritt beispielsweise ein, wenn der Benutzer ein anderes Element mit der Maus aus dem Steuerelement zieht. Ist in der Eigenschaft ControlStyle des Steuerelements das Flag csCaptureMouse gesetzt, fängt es auch dann alle Mausereignisse ab, wenn der Benutzer in seinem Bereich die linke Maustaste drückt, und zwar so lange, bis die Maustaste wieder losgelassen wird.


TControl::Name

TControl	Siehe auch	Beispiel

Die Eigenschaft Name bezeichnet den Namen, der im Code der Anwendung für das Steuerelement verwendet wird.

Beschreibung

Mit der Eigenschaft Name können Sie dem Steuerelement einen neuen Namen zuweisen oder seinen Namen ermitteln.

Per Voreinstellung weist die IDE Steuerelementen sequentielle Namen basierend auf dem Typ des Steuerelements zu, beispielsweise „Button1“, „Button2“ usw. Indem Sie aussagekräftigere Namen verwenden, verbessern Sie die Lesbarkeit des Codes. Der Name muß ein gültiger Bezeichner im Sinne von Object Pascal sein. Wenn die Eigenschaft Caption des Steuerelements zuvor nicht geändert wurde, wird ihr der neue Name des Steuerelements zugewiesen.

Hinweis

€ndern Sie die Namen von Steuerelementen nur zur Entwurfszeit.


TControl::Parent

TControl	Siehe auch	Beispiel

Die Eigenschaft Parent bezieht sich auf das übergeordnete Objekt des Steuerelements und legt fest, wo das Steuerelement angezeigt wird.

__property TWinControl* Parent;

Beschreibung

Mit der Eigenschaft Parent können Sie das übergeordnete Objekt eines Steuerelements ermitteln oder ihm ein Steuerelement als übergeordnetes Objekt zuweisen. Wenn Sie ein neues Steuerelement erzeugen, sollten Sie ihm immer einen Wert für Parent zuweisen. Normalerweise bezeichnet dieser Wert ein Formular, eine Tafel, ein Gruppenfeld oder ein Steuerelement, das für die Aufnahme eines anderen Steuerelements geeignet ist. Die €nderung dieser Eigenschaft verschiebt das Steuerelement auf dem Bildschirm, so daß es im übergeordneten Objekt angezeigt wird.

Das übergeordnete Objekt eines Steuerelements ist das fensterorientierte Steuerelement, in dem sich das Steuerelement befindet. Enthält ein (übergeordnetes) Steuerelement andere Steuerelemente, bezeichnet man diese als untergeordnete Steuerelemente. Wenn beispielsweise eine Anwendung drei Optionsfelder in einem Gruppenfeld enthält, ist das Gruppenfeld das übergeordnete Objekt der drei Opitonsfelder, und die Optionsfelder sind die untergeordneten Steuerelemente des Gruppenfeldes.

Verwechseln Sie die von TControl deklarierte Eigenschaft Parent nicht mit der Eigenschaft Owner von TComponent. Ein Formular ist der Eigentümer (Owner) aller Komponenten, die sich in ihm befinden, unabhängig davon, ob es sich dabei um fensterorientierte Steuerelemente handelt oder nicht. Ein untergeordnetes Steuerelement ist immer ein visuelles Steuerelement, das in einem anderen fensterorientierten Steuerelement (dem Parent) enthalten ist. Wenn Sie drei Optionsfelder in ein Gruppenfeld eines Formulars einfügen, bleibt der Eigentümer (Owner) der Optionsfelder weiterhin das Formular, während das Gruppenfeld zum übergeordneten Objekt wird.

Wenn das übergeordnete Objekt eines Steuerelements freigegeben wird, werden auch alle seine untergeordneten Steuerelemente freigegeben.


TControl::ParentColor

TControl	Siehe auch	Beispiel

Die Eigenschaft ParentColor legt fest, wo ein Steuerelement nach seinen Farbinformationen sucht.

__property bool ParentColor;

Beschreibung

Setzen Sie ParentColor auf True, wenn ein Steuerelement die Farbe seines übergeordneten Steuerelements verwenden soll. Ist beispielsweise die Eigenschaft ParentColor eines Listenfeldes in einer Tafel True, hat das Listenfeld dieselbe Farbe wie die Tafel. Ist ParentColor False, verwendet das Steuerelement seine eigene Color-Eigenschaft.

Wenn alle Steuerelemente in einem Formular einheitlich aussehen sollen, setzen Sie die Eigenschaft ParentColor für alle Elemente auf True. Ist beispielsweise ParentColor für alle Steuerelemente in einem Formular True, haben die Steuerelemente die Hintergrundfarbe Grau, wenn dies auch die Hintergrundfarbe des Formulars ist.

Wenn ein bestimmtes Steuerelement eine andere Farbe erhalten soll, weisen Sie die gewünschte Farbe der Eigenschaft Color dieses Steuerelements zu. ParentColor wird in diesem Fall automatisch mit False belegt.


TControl::ParentFont

TControl	Siehe auch	Beispiel

Die Eigenschaft ParentFont legt fest, woher ein Steuerelement seine Schriftinformationen bezieht.

__property bool ParentFont;

Beschreibung

Setzen Sie ParentFont auf True, wenn ein Steuerelement die Schrift seines übergeordneten Steuerelements verwenden soll. Ist beispielsweise die Eigenschaft ParentFont eines Listenfeldes in einer Tafel True, verwendet das Listenfeld dieselbe Schrift wie die Tafel. Ist ParentFont False, verwendet das Steuerelement seine eigene Eigenschaft Font.

Wenn alle Steuerelemente in einem Formular einheitlich aussehen sollen, setzen Sie die Eigenschaft ParentFont für alle Elemente auf True. Ist beispielsweise ParentFont für alle Steuerelemente in einem Formular True, erhalten diese Steuerelemente die Schrift Courier 12 Punkt, wenn der Eigenschaft Font des Formulars diese Schrift zugewiesen wird.

Soll ein bestimmtes Steuerelement eine andere Schrift erhalten, weisen Sie die gewünschte Schrift der Eigenschaft Font dieses Steuerelements zu. ParentFont wird in diesem Fall automatisch mit False belegt.

Ist die Eigenschaft ParentFont für ein Formular True, verwendet das Formular die Eigenschaft Font der Anwendung.


TControl::ParentShowHint

TControl	Siehe auch	Beispiel

Die Eigenschaft ParentShowHint legt fest, wie ein Steuerelement feststellt, ob ein Kurzhinweis angezeigt werden soll (der Kurzhinweis ist in der Eigenschaft Hint des Steuerelements enthalten).

__property bool ParentShowHint;

Beschreibung

Mit ParentShowHint können Sie festlegen, ob die Kurzhinweise aller Steuerelemente in einem Formular angezeigt werden oder nicht.

Wenn ParentShowHint True ist, verwendet das Steuerelement die Eigenschaft ShowHint seines übergeordneten Objekts. Andernfalls verwendet das Steuerelement den Wert seiner eigenen Eigenschaft ShowHint.

Wenn nur bestimmte Steuerelemente im Formular Kurzhinweise anzeigen sollen, setzen Sie die Eigenschaft ShowHint dieser Steuerelemente auf True. In diesem Fall wird der Eigenschaft ParentShowHint automatisch False zugewiesen.

Hinweis

Mit der Eigenschaft ShowHint der Anwendung können Sie alle Kurzhinweise in der gesamten Anwendung aktivieren oder deaktivieren.


TControl::PopupMenu

TControl	Siehe auch	Beispiel

Die Eigenschaft PopupMenu gibt das Popup-Menü an, das mit dem Steuerelement verknüpft ist.

__property Menus::TPopupMenu* PopupMenu;

Beschreibung

Wenn Sie PopupMenu einen Wert zugewiesen haben und der Benutzer das Steuerelement markiert und auf die rechte Maustaste drückt, wird ein Popup-Menü eingeblendet. Hat die Eigenschaft AutoPopup von TPopupMenu den Wert True, wird das Popup-Menü automatisch eingeblendet. Andernfalls müssen Sie das Menü durch einen Aufruf seiner Methode Popup öffnen.


TControl::ScalingFlags

TControl	Siehe auch

Die Eigenschaft ScalingFlags gibt die Attribute des Steuerelements an, die noch nicht skaliert worden sind.

__property TScalingFlags ScalingFlags;

Beschreibung

ScalingFlags besteht aus einer internen Menge von Flags, die in erster Linie zur Skalierung von geerbten Formularen und ihren Steuerelementen dienen. Eine Anwendung sollte diese Eigenschaft nur in Ausnahmefällen verwenden. Die folgende Tabelle enthält die Flags und ihre Bedeutung:

Flag	Bedeutung

sfLeft	Die linke Seite des Steuerelements ist noch nicht skaliert.

sfTop	Der obere Rand des Steuerelements ist noch nicht skaliert.

sfWidth	Die Breite des Steuerelements ist noch nicht skaliert.

sfHeight	Die Höhe des Steuerelements ist noch nicht skaliert.

sfFont	Die Schrift des Steuerelements ist noch nicht skaliert.


TControl::ShowHint

TControl	Siehe auch	Beispiel

Die Eigenschaft ShowHint legt fest, ob das Steuerelement einen Kurzhinweis anzeigen soll, wenn sich der Mauszeiger für eine gewisse Zeit über ihm aufhält.

__property bool ShowHint;

Beschreibung

Der Kurzhinweis ist der Wert der Eigenschaft Hint, der in einem Feld neben dem Steuerelement angezeigt wird. Mit ShowHint legen Sie fest, ob für das Steuerelement ein Kurzhinweis eingeblendet wird.

Wenn diese Funktion für ein bestimmtes Steuerelement aktiviert werden soll, muß die Eigenschaft ShowHint der Anwendung True sein. Zusätzlich gilt:

•	Es muß entweder die Eigenschaft ShowHint des Steuerelements True sein, oder

•	es muß sowohl die Eigenschaft ParentShowHint des Steuerelements als auch die Eigenschaft ShowHint seines übergeordneten Objekts True sein.

Angenommen, ein Gruppenfeld enthält ein Kontrollfeld. Wenn sowohl die Eigenschaft ShowHint des Gruppenfeldes als auch die Eigenschaft ParentShowHint des Kontrollfeldes True ist, die Eigenschaft ShowHint des Kontrollfeldes aber False ist, wird für das Kontrollfeld dennoch der Kurzhinweis eingeblendet.

Jede €nderung von ShowHint setzt automatisch die Eigenschaft ParentShowHint auf False.


TControl::Text

TControl	Siehe auch	Beispiel

Die Eigenschaft Text enthält einen String, der mit dem Steuerelement verbunden ist.

__property System::AnsiString Text;

Beschreibung

Mit dieser Eigenschaft können Sie

•	den Text eines Steuerelements abrufen.

•	dem Text einen neuen String zuweisen.

Per Voreinstellung enthält diese Eigenschaft, solange Sie ihr keinen anderen Wert zuweisen, den Namen des Steuerelements. Bei Eingabe- und Memofeldern wird der Text im Steuerelement angezeigt. Bei Kombinationsfeldern stellt der Wert der Eigenschaft Text den Inhalt des Eingabefeldes dar.


TControl::Top

TControl	Siehe auch	Beispiel

Die Eigenschaft Top gibt die Y-Koordinate der linken oberen Ecke eines Steuerelements in Pixel an, und zwar relativ zu dem Element, das ihm übergeordnet oder in dem es enthalten ist.

__property int Top;

Beschreibung

Mit der Eigenschaft Top können Sie den oberen Rand eines Steuerelements ermitteln oder das Steuerelement an eine andere Y-Position verschieben. Die Eigenschaft Top gibt (wie auch die Eigenschaft Left) die Position des Steuerelements relativ zu seinem Container an. Ist das Steuerelement in einer TPanel-Komponente enthalten, sind die Eigenschaften Left und Top relativ zu dieser Tafel. Wenn das Steuerelement direkt in einem Formular enthalten ist, sind Top und Left relativ zu diesem Formular. Bei Formularen ist der Wert von Left relativ zum Bildschirm.


TControl::Visible

TControl	Siehe auch	Beispiel

Die Eigenschaft Visible bestimmt, ob die Komponente auf dem Bildschirm angezeigt wird.

__property bool Visible;

Beschreibung

Mit Hilfe der Eigenschaft Visible legen Sie fest, ob ein Steuerelement zur Laufzeit sichtbar ist. Wenn Visible True ist, wird das Steuerelement angezeigt, andernfalls nicht.

Ein Aufruf der Methode Show setzt die Eigenschaft Visible auf True. Ein Aufruf der Methode Hide setzt die Eigenschaft auf False.


TControl::Width

TControl	Siehe auch	Beispiel

Die Eigenschaft Width gibt die Breite des Steuerelements oder Formulars in Pixel an.

__property int Width;

Beschreibung

Mit der Eigenschaft Width können Sie die Breite des Steuerelements abrufen oder ändern.

Hinweis

Bei Registerkarten hat die Änderung dieser Eigenschaft zur Laufzeit keine Wirkung.


TControl::WindowProc

TControl

Die Eigenschaft WindowProc enthält die Windows-Prozedur für dieses Element.

typedef void __fastcall (__closure *TWndMethod)(Messages::TMessage &Message);

__property TWndMethod WindowProc;


TControl::WindowText

TControl	Siehe auch

Die Eigenschaft WindowText enthält den Text des Steuerelements.

__property char * WindowText;

Beschreibung

Mit WindowText können Sie den Text festlegen, der mit dem Steuerelement verbunden ist.

Bei Eingabefeldern entspricht WindowText dem Inhalt des Steuerelements. Bei Kombinationsfeldern stellt der String den Inhalt des Eingabefeldes dar, bei Schaltflächen die Beschriftung. Bei allen anderen Steuerelementen legt der String den Fenstertitel fest.


Ereignisse von TControl

TControl	Alphabetisch	Legende

In TControl

OnClick

OnDblClick

OnDragDrop

OnDragOver

OnEndDrag

OnMouseDown

OnMouseMove

OnMouseUp

OnStartDrag


Ereignisse von TControl

TControl	Nach Objekten	Legende

OnClick

OnDblClick

OnDragDrop

OnDragOver

OnEndDrag

OnMouseDown

OnMouseMove

OnMouseUp

OnStartDrag


TControl::OnClick

TControl	Siehe auch	Beispiel

Das Ereignis OnClick tritt ein, wenn der Benutzer auf das Steuerelement klickt.

typedef void __fastcall (__closure *TNotifyEvent)(System::TObject* Sender);

__property Classes::TNotifyEvent OnClick;

Beschreibung

In der Ereignisbehandlungsroutine für OnClick können Sie auf Klick-Ereignisse reagieren.

Dieses Ereignis tritt normalerweise ein, wenn der Benutzer auf die primäre Maustaste drückt und sie wieder losläßt, während sich der Mauszeiger über dem Steuerelement befindet. Außerdem wird OnClick in folgenden Situationen ausgelöst:

•	Der Benutzer wählt durch Drücken einer Pfeiltaste ein Element in einem Gitter, einem Gliederungsdiagramm, einer Liste oder einem Kombinationsfeld aus.

•	Der Benutzer drückt die Leertaste, während eine Schaltfläche oder ein Kontrollfeld fokussiert ist.

•	Der Benutzer drückt die EINGABE-Taste, wenn das aktive Formular über eine Standardschaltfläche (angegeben in der Eigenschaft Default) verfügt.

•	Der Benutzer drückt die ESC-Taste, wenn im aktiven Formular eine Schaltfläche Abbrechen (angegeben in der Eigenschaft Cancel) existiert.

•	Der Benutzer gibt das Tastenkürzel für eine Schaltfläche oder ein Kontrollfeld ein. Wenn beispielsweise der Wert der Eigenschaft Caption eines Kontrollfeldes „&Fett“ lautet, wird der Buchstabe F zur Laufzeit unterstrichen dargestellt. Das Ereignis OnClick wird ausgelöst, sobald der Benutzer die Tastenkombination Alt+F drückt.

•	Die Eigenschaft Checked eines Optionsfeldes wird auf True gesetzt.

•	Der Wert der Eigenschaft Checked eines Kontrollfeldes ändert sich.

•	Die Methode Click eines Menüeintrags wird aufgerufen.

Bei einem Formular tritt das Ereignis OnClick ein, wenn der Benutzer auf einen leeren Bereich des Formulars oder auf eine deaktivierte Komponente klickt.


TControl::OnDblClick

TControl	Siehe auch	Beispiel

Das Ereignis OnDblClick tritt ein, wenn der Benutzer doppelt mit der primären Maustaste klickt, während sich der Mauszeiger über dem Steuerelement befindet.

typedef void __fastcall (__closure *TNotifyEvent)(System::TObject* Sender);

__property Classes::TNotifyEvent OnDblClick;

Beschreibung

Mit der Ereignisbehandlungsroutine für OnDblClick können Sie auf das Doppelklick-Ereignisse reagieren.


TControl::OnDragDrop

TControl	Siehe auch

Das Ereignis OnDragDrop tritt ein, wenn der Benutzer ein gezogenes Objekt ablegt.

typedef void __fastcall (__closure *TDragDropEvent)(System::TObject* Sender, System::TObject* Source, int X, int Y);

__property TDragDropEvent OnDragDrop;

Beschreibung

In der Ereignisbehandlungsroutine für OnDragDrop können Sie festlegen, welche Aktion ausgeführt wird, wenn der Benutzer ein Objekt ablegt. Der Parameter Source des Ereignisses stellt das abgelegte Objekt dar, und Sender gibt das Steuerelement an, auf dem das Objekt abgelegt wird. Die Parameter X und Y sind die Koordinaten des Mauszeigers im Steuerelement.


TControl::OnDragOver

TControl	Siehe auch

Das Ereignis OnDragOver tritt ein, wenn der Benutzer ein Objekt über ein Steuerelement zieht.

enum TDragState { dsDragEnter, dsDragLeave, dsDragMove };

typedef void __fastcall (__closure *TDragOverEvent)(System::TObject* Sender, System::TObject* Source, int X, int Y, TDragState State, bool &Accept);

__property TDragOverEvent OnDragOver;

Beschreibung

Mit Hilfe von OnDragOver können Sie festlegen, ob das Steuerelement das gezogene Objekt akzeptiert, so daß es der Benutzer ablegen kann.

Setzen Sie in der Ereignisbehandlungsroutine den Parameter Accept auf True, damit das gezogene Objekt akzeptiert wird. Wenn Sie Accept auf False setzen, kann der Benutzer das gezogene Objekt nicht auf dem Steuerelement ablegen.

Durch eine veränderte Cursorform können Sie deutlich machen, daß das Steuerelement das gezogene Objekt akzeptiert, wenn es vom Benutzer abgelegt wird. €ndern Sie dazu den Wert der Eigenschaft DragCursor des Steuerelements, bevor das Ereignis OnDragOver eintritt.

Source gibt das Objekt an, das gezogen wird, Sender ist self (der potentielle Empfänger), und X und Y bezeichnen die Bildschirmkoordinaten in Pixel. Der Typ TDragState legt den Drag-Status eines gezogenen Steuerelements in Bezug auf ein anderes Steuerelement fest. Folgende Werte sind möglich:

Wert	Bedeutung

dsDragEnter	Der Mauszeiger tritt in den Bereich des Steuerelements ein.

dsDragMove	Der Mauszeiger wird über dem Steuerelement bewegt.

dsDragLeave	Der Mauszeiger verläßt den Bereich des Steuerelements.


TControl::OnEndDrag

TControl	Siehe auch

Das Ereignis OnEndDrag tritt ein, wenn das Ziehen eines Objekts entweder durch Ablegen des Objekts oder durch Abbrechen des Vorgangs beendet wird.

typedef void __fastcall (__closure *TEndDragEvent)(System::TObject* Sender, System::TObject* Target, int X, int Y);

__property TEndDragEvent OnEndDrag;

Beschreibung

In der Ereignisbehandlungsroutine für OnEndDrag können Sie nach Beendigung des Ziehvorgangs spezielle Aktionen durchführen. Der Parameter Sender bezeichnet das Objekt, das gezogen wird, Target stellt das Objekt dar, zu dem Sender gezogen wird, und X und Y geben die Bildschirmkoordinaten in Pixel an.

Das Ereignis OnEndDrag wird von Sender empfangen. Wenn das gezogene Objekt auf einem Steuerelement abgelegt und von diesem akzeptiert wird, wird dem Parameter Target des Ereignisses OnEndDrag dieses Zielobjekt zugewiesen. Wenn das Objekt nicht erfolgreich abgelegt werden konnte, ist der Wert von Target NIL.


TControl::OnMouseDown

TControl	Siehe auch

Das Ereignis OnMouseDown tritt ein, wenn der Benutzer eine Maustaste drückt, während sich der Mauszeiger über einem Steuerelement befindet.

enum TMouseButton { mbLeft, mbRight, mbMiddle };

typedef void __fastcall (__closure *TMouseEvent)(System::TObject* Sender, TMouseButton Button,  Classes::TShiftState Shift, int X, int Y);

__property TMouseEvent OnMouseDown;

Beschreibung

In einer Ereignisbehandlungsroutine für OnMouseDown können Sie bestimmte Aktionen durchführen, wenn der Benutzer eine Maustaste drückt.

Die Routine kann auf das Drücken der linken, der rechten oder der mittleren Maustaste und auf das Drücken einer Sondertaste zusammen mit einer Maustaste reagieren. Als Sondertasten gelten die Tasten UMSCHALT, STRG und ALT. X und Y geben die Pixel-Koordinaten des Mauszeigers im Client-Bereich von Sender an.


TControl::OnMouseMove

TControl	Siehe auch	Beispiel

Das Ereignis OnMouseMove tritt ein, wenn der Benutzer den Mauszeiger bewegt, während sich dieser über einem Steuerelement befindet.

enum TMouseButton { mbLeft, mbRight, mbMiddle };

typedef void __fastcall (__closure *TMouseEvent)(System::TObject* Sender, TMouseButton Button,  Classes::TShiftState Shift, int X, int Y);

__property TMouseMoveEvent OnMouseMove;

Beschreibung

In der Ereignisbehandlungsroutine für OnMouseMove können Sie eine Aktion durchführen, wenn der Mauszeiger über dem Steuerelement bewegt wird.

Über den Parameter Shift können Sie den Status der Sonder- bzw. Maustasten ermitteln. Als Sondertasten gelten die Tasten UMSCHALT, STRG und ALT sowie Kombinationen aus Sonder- und Maustasten. X und Y geben die Pixel-Koordinaten der neuen Position des Mauszeigers im Client-Bereich von Sender an.


TControl::OnMouseUp

TControl	Siehe auch	Beispiel

Das Ereignis OnMouseDown tritt ein, wenn der Benutzer eine Maustaste losläßt, die er gedrückt hat, während sich der Mauszeiger über einem Steuerelement befand.

enum TMouseButton { mbLeft, mbRight, mbMiddle };

typedef void __fastcall (__closure *TMouseEvent)(System::TObject* Sender, TMouseButton Button,  Classes::TShiftState Shift, int X, int Y);

__property TMouseEvent OnMouseUp;

Beschreibung

In einer Ereignisbehandlungsroutine für OnMouseUp können Sie spezielle Aktionen durchführen, nachdem der Benutzer eine Maustaste losgelassen hat.

Die Routine kann auf das Drücken der linken, der rechten oder der mittleren Maustaste sowie auf das gleichzeitige Drücken einer Sondertaste und einer Maustaste reagieren. Als Sondertasten gelten die Tasten UMSCHALT, STRG und ALT. X und Y geben die Pixel-Koordinaten des Mauszeigers im Client-Bereich von Sender an.


TControl::OnStartDrag

TControl	Siehe auch

Das Ereignis OnStartDrag tritt ein, wenn der Benutzer beginnt, das Steuerelement oder ein darin befindliches Objekt mit der linken Maustaste zu ziehen.

typedef void __fastcall (__closure *TStartDragEvent)(System::TObject* Sender, TDragObject* &DragObject);

__property TStartDragEvent OnStartDrag;

Beschreibung

In einer Ereignisbehandlungsroutine für OnStartDrag können Sie bestimmte Aktionen durchführen, wenn der Benutzer beginnt, das Steuerelement oder ein darin befindliches Objekt zu ziehen. Der Parameter Sender ist self, d.h. das Steuerelement, das gerade gezogen wird bzw. das gerade gezogene Objekt enthält.

Die Ereignisbehandlungsroutine für OnStartDrag kann für den Parameter DragObject ein TDragObject-Objekt erzeugen, um den Drag-Cursor oder (optional) eine Drag-Bilderliste anzugeben. Nach Beendigung des Ziehvorgangs braucht die Methode Free für DragObject nicht aufgerufen zu werden.

Wenn die Ereignisbehandlungsroutine für OnStartDrag den Parameter DragObject auf NIL setzt, wird automatisch ein TDragControlObject-Objekt erzeugt, und der Ziehvorgang beginnt im Steuerelement selbst.


Methoden von TControl

TControl	Alphabetisch	Legende

In TControl

~TControl

BeginDrag

BringToFront

ChangeScale

Click

ClientToScreen

DblClick

DefaultHandler

DefineProperties

DoEndDrag

DoStartDrag

DragCanceled

DragDrop

Dragging

DragOver

EndDrag

GetClientOrigin

GetClientRect

GetDeviceContext

GetDragImages

GetPalette

GetParentComponent

GetPopupMenu

GetTextBuf

GetTextLen

HasParent

Hide

Invalidate

MouseDown

MouseMove

MouseUp

Notification

PaletteChanged

Perform

ReadState

Refresh

Repaint

ScreenToClient

SendCancelMode

SendToBack

SetBounds

SetDragMode

SetName

SetParent

SetParentComponent

SetTextBuf

SetZOrder

Show

TControl

Update

UpdateBoundsRect

VisibleChanging

WndProc

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TControl

TControl	Nach Objekten	Legende

~TControl

Assign

BeginDrag

BringToFront

ChangeScale

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

Click

ClientToScreen

DblClick

DefaultHandler

DefineProperties

DestroyComponents

Destroying

Dispatch

DoEndDrag

DoStartDrag

DragCanceled

DragDrop

Dragging

DragOver

EndDrag

FieldAddress

FindComponent

FreeInstance

FreeNotification

Free

GetClientOrigin

GetClientRect

GetDeviceContext

GetDragImages

GetPalette

GetParentComponent

GetPopupMenu

GetTextBuf

GetTextLen

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InstanceSize

Invalidate

MethodAddress

MethodName

MouseDown

MouseMove

MouseUp

NewInstance

Notification

PaletteChanged

Perform

ReadState

Refresh

RemoveComponent

Repaint

ScreenToClient

SendCancelMode

SendToBack

SetBounds

SetDragMode

SetName

SetParentComponent

SetParent

SetTextBuf

SetZOrder

Show

TControl

UpdateBoundsRect

Update

VisibleChanging

WndProc


TControl::~TControl

TControl	Siehe auch

Der Destruktor ~TControl gibt den Speicher frei, der für das TControl-Objekt reserviert war. Rufen Sie ~TControl nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TControl automatisch aufgerufen wird.

__fastcall virtual ~TControl(void);


TControl::BeginDrag

TControl	Siehe auch

Die Methode BeginDrag startet das Ziehen eines Steuerelements.

void __fastcall BeginDrag(bool Immediate);

Beschreibung

Mit dieser Methode können Sie den Beginn einer Drag-and-Drop-Operation steuern, wenn die Eigenschaft DragMode des Steuerelements auf dmManual gesetzt ist.

Wenn der Parameter Immediate True ist, wird dem Mauszeiger die Cursorform der Eigenschaft DragCursor zugewiesen und der Ziehvorgang umgehend gestartet. Ist der Parameter Immediate False, nimmt der Mauszeiger nicht den Wert der Eigenschaft DragCursor an, und der Ziehvorgang beginnt erst, wenn der Benutzer den Mauszeiger ein wenig (um 5 Pixel) bewegt hat. Dadurch kann das Steuerelement auch Mausklicks akzeptieren, die keine Drag-and-Drop-Operation einleiten.


TControl::BringToFront

TControl	Siehe auch

Mit der Methode BringToFront können Sie ein Steuerelement innerhalb seines übergeordneten Steuerelements in den Vordergrund bringen.

void __fastcall BringToFront(void);

Beschreibung

Mit BringToFront können Sie sicherstellen, daß ein Formular sichtbar ist. Außerdem kann die Methode für die Neuanordnung sich überlappender Steuerelemente in einem Formular eingesetzt werden.

Die Reihenfolge, in der die Steuerelemente übereinandergestapelt werden (die sogenannte Z-Reihenfolge), hängt von der Reihenfolge ab, in der die Steuerelemente in das Formular eingefügt wurden. Wenn Sie beispielsweise eine Beschriftung und ein Bild so in ein Formular einfügen, daß ein Element auf dem anderen liegt, kommt das Objekt, das zuerst plaziert wurde, zuunterst zu liegen. Da sowohl Beschriftungen als auch das Bilder nicht fensterorientierte Steuerelemente sind, werden sie in der bekannten Weise übereinandergestapelt. Durch einen Aufruf der Methode BringToFront können Sie das verdeckte Objekt in den Vordergrund bringen.

Die Stapelreihenfolge für fensterorientierte Steuerelemente ist identisch mit der Reihenfolge für nicht fensterorientierte Steuerelemente. Wenn Sie beispielsweise ein Memofeld in ein Formular einfügen und dann ein Kontrollfeld auf ihm ablegen, bleibt das Kontrollfeld oben. Erst ein Aufruf der Methode BringToFront bringt das Memofeld in den Vordergrund.

Fensterorientierte und nicht fensterorientierte Steuerelemente werden getrennt gestapelt. Wenn Sie beispielsweise ein Memofeld (ein fensterorientiertes Steuerelement) und danach eine Beschriftung (ein nicht fensterorientiertes Steuerelement) in ein Formular einfügen, verschwindet die Beschriftung hinter dem Memofeld. Fensterorientierte Steuerelemente kommen immer über nicht fensterorientierten Steuerelementen zu liegen. In diesem Beispiel bewirkt der Aufruf der Methode BringToFront nichts. Die Beschriftung bleibt hinter dem Memofeld verborgen.


TControl::ChangeScale

TControl	Siehe auch

Mit der Methode ChangeScale kann ein Steuerelement im angegebenen Verhältnis neu positioniert und in seiner Größe verändert werden.

virtual void __fastcall ChangeScale(int Z, int N);

Beschreibung

Mit ChangeScale können Sie ein Steuerelement neu skalieren. Die Methode verändert sowohl die Position als auch die Größe eines Steuerelements, indem sie den Eigenschaften Top, Left, Width und Height des Steuerelements neue Werte zuweist.

Die Parameter Z und N bilden einen Bruch, um dessen Wert das Steuerelement skaliert wird. Der Parameter Z ist der Zähler, N der Nenner. Wenn ein Steuerelement beispielsweise auf 75% seiner Größe gebracht werden soll, geben Sie Z mit 75 und N mit 100 an (75/100). Dasselbe Ergebnis erhalten Sie, wenn Sie Z mit 3 und N mit 4 angeben (3/4). Beide Brüche sind identisch und ergeben dieselbe Skalierung des Steuerelements (75%).

Um ein Steuerelement um 33% zu vergrößern, übergeben Sie für Z 133 und für N 100 (133/100). Sie können auch für Z 4 und für N 3 übergeben (4/3). 133/100 ergibt annähernd den gleichen Wert wie 4/3.

Von TControl abgeleitete Steuerelemente überschreiben ChangeScale unter Umständen. Ein Steuerelement, das zusätzliche Schrifteigenschaften definiert, könnte beispielsweise die Höhe dieser Schriften durch das Z/N-Verhältnis skalieren, so daß alle Schriften des Steuerelements gleich skaliert werden. Die Methode ChangeScale könnte auch von Steuerelementen überschrieben werden, in denen der Client-Bereich für die Anzeige von Text in Abschnitte unterteilt ist. Dadurch wäre sichergestellt, daß sich die Anzeigeabschnitte an der Schriftgröße orientieren.

Hinweis

Da die Größe und die Koordinaten von Steuerelementen Integer sind, ergibt sich bei der Skalierung im Verhältnis Z/N ein gewisser Rundungsfehler. Wiederholte Aufrufe von ChangeScale können dazu führen, daß das Steuerelement irgendwann verschwindet (wenn das Element aufgrund der Rundungsfehler immer kleiner wird) oder nach und nach über das Formular hinausragt (wenn das Element aufgrund der Rundungsfehler seine Position ändert). Bei der wiederholten Skalierung eines Steuerelements sollten Sie deshalb das Formular ab und zu freigeben und wieder laden, damit sich die Rundungsfehler bei der Skalierung der Koordinaten nicht aufsummieren.


TControl::Click

TControl	Siehe auch

Die Methode Click ruft die Behandlungsroutine für das Ereignis OnClick des Steuerelements auf.

virtual void __fastcall Click(void);

Beschreibung

Die einzige Funktion der in TControl definierten Methode Click besteht im Aufruf der Ereignisbehandlungsroutine für OnClick. Click ist die als protected deklarierte Implementierungsmethode für das Ereignis OnClick eines Steuerelements. Indem Sie Click überschreiben, können Sie Aktionen definieren, die zusätzlich zum Aufruf der geerbten Ereignisbehandlungsroutine ausgeführt werden.

Ein Steuerelement ruft Click immer dann auf, wenn es eine WM_LBUTTONUP-Botschaft erhält (linke Maustaste wurde losgelassen), die besagt, daß das Loslassen mit einem vorangegangenen Drücken der Maustaste in Verbindung steht. Viele spezielle Steuerelemente rufen Click auch in anderen Situationen auf, beispielsweise wenn ein Benutzer das Tastenkürzel für eine Schaltfläche oder einen Menüeintrag eingibt.

Unter OnClick finden Sie eine Beschreibung aller Situationen, in den Klick-Ereignisse ausgelöst werden.


TControl::ClientToScreen

TControl	Siehe auch	Beispiel

Die Methode ClientToScreen konvertiert die Koordinaten des angegebenen Punktes in globale Bildschirmkoordinaten.

POINT __fastcall ClientToScreen(const POINT &Point);

Beschreibung

Mit Hilfe von ClientToScreen können Sie die Koordinaten eines Punktes, die lokal zum Steuerelement angegeben sind, in die entsprechenden Bildschirmkoordinaten konvertieren. In Client-Koordinaten bezeichnet (0, 0) die obere linke Ecke des Client-Bereichs des Steuerelements. In Bildschirmkoordinaten entspricht (0, 0) der oberen linken Ecke des Bildschirms.

Mit den Methoden ScreenToClient und ClientToScreen können Sie Koordinaten zwischen verschiedenen Steuerelenten konvertieren.


TControl::DblClick

TControl	Siehe auch

Die Methode DblClick ruft die Behandlungsroutine für das Ereignis OnClick des Steuerelements auf.

virtual void __fastcall DblClick(void);

Beschreibung

Die einzige Funktion der in TControl definierten Methode DblClick besteht im Aufruf der Ereignisbehandlungsroutine für OnDblClick. DblClick ist die als protected deklarierte Implementierungsmethode für das Ereignis OnDblClick eines Steuerelements. Indem Sie DblClick überschreiben, können Sie Aktionen festlegen, die zusätzlich zum Aufruf der geerbten Ereignisbehandlungsroutine ausgeführt werden.

Die Methode DblClick wird von Windows durch eine WM_LBUTTONDBLCLICK-Botschaft (Doppelklick mit der linken Maustaste) ausgelöst.


TControl::DefaultHandler

TControl	Siehe auch

Die Methode DefaultHandler ermöglicht die Bearbeitung aller Botschaften, für die ein Steuerelement keine speziellen Behandlungsroutinen besitzt.

virtual void __fastcall DefaultHandler(void *Message);

Beschreibung

Durch Überschreiben von DefaultHandler können Sie die Standardbearbeitung von Botschaften erweitern. DefaultHandler bearbeitet Windows-Botschaften, die mit dem Text des Steuerelements zu tun haben, nämlich WM_GETTEXT, WM_SETTEXT und WM_GETTEXTLENGTH.


TControl::DefineProperties

TControl	Siehe auch

Mit der Methode DefineProperties kann die als protected deklarierte Eigenschaft IsControl dauerhaft definiert werden. Dadurch kann IsControl mit Hilfe bestimmter Methoden aus einem Stream (beispielsweise einer Formulardatei) gelesen oder in einen Stream geschrieben werden.

virtual void __fastcall DefineProperties(Classes::TFiler* Filer);

Beschreibung

Überschreiben Sie DefineProperties, um neue Eigenschaften zu definieren oder um nicht als published deklarierte Eigenschaften als published zu deklarieren. Rufen Sie zu zuerst die geerbte Methode DefineProperties auf, wenn Sie diese Methode überschreiben.


TControl::DoEndDrag

TControl	Siehe auch

DoEndDrag ist die als protected deklarierte Implementierungsmethode für das Ereignis OnEnter eines fensterorientierten Steuerelements.

virtual void __fastcall DoEndDrag(System::TObject* Target, int X, int Y);

Beschreibung

DoEndDrag ruft nur die Ereignisbehandlungsroutine für OnEndDrag auf. Wenn Sie eine Komponente entwickeln, die von TControl abstammt, überschreiben Sie DoEndDrag, um zusätzlich zum Aufruf der geerbten Ereignisbehandlungsroutine bestimmte Aktionen durchzuführen.


TControl::DoStartDrag

TControl	Siehe auch

DoStartDrag ist die als protected deklarierte Implementierungsmethode für das Ereignis OnEnter eines fensterorientierten Steuerelements.

virtual void __fastcall DoStartDrag(TDragObject* &DragObject);

Beschreibung

Die Methode DoStartDrag ruft nur die Ereignisbehandlungsroutine für OnStartDrag auf. Wenn Sie eine Komponente entwickeln, die von TControl abstammt, überschreiben Sie DoStartDrag, um zusätzlich zum Aufruf der geerbten Ereignisbehandlungsroutine bestimmte Aktionen durchzuführen.


TControl::DragCanceled

TControl	Siehe auch

Die Methode DragCanceled stellt lediglich eine Schnittstelle für eine Methode dar, die auf den Abbruch einer Drag-and-Drop-Operation reagiert.

virtual void __fastcall DragCanceled(void);

Beschreibung

Wenn Sie eine Komponente von TControl ableiten, können Sie DragCanceled überschreiben, um nach dem Abbruch einer Drag-and-Drop-Operation bestimmte Aktionen durchzuführen.


TControl::DragDrop

TControl	Siehe auch

Die Methode DragDrop ruft die Ereignisbehandlungsroutine für OnDragDrop auf, falls eine solche existiert.

virtual void __fastcall DragDrop(System::TObject* Source, int X, int Y);

Beschreibung

Wenn Sie eine Komponente von TControl ableiten, können Sie DragDrop überschreiben, um vor dem Aufruf der Ereignisbehandlungsroutine für OnDragDrop bestimmte Aktionen durchzuführen.

Der Parameter Source bezeichnet das Objekt, von dem die Ereignisbehandlungsroutine annimmt, daß es abgelegt wurde. Die Parameter X und Y sind die Koordinaten der Mauszeigerposition, an der das Objekt abgelegt wurde.


TControl::Dragging

TControl	Siehe auch	Beispiel

Die Methode Dragging ermittelt, ob ein Steuerelement gerade gezogen wird.

bool __fastcall Dragging(void);

Beschreibung

Mit Dragging können Sie den Drag-Status eines Steuerelements feststellen. Wenn Dragging True zurückgibt, wird das Steuerelement gezogen, andernfalls nicht.


TControl::DragOver

TControl	Siehe auch

Die Methode DragOver ruft die Ereignisbehandlungsroutine für OnDragOver auf, falls eine solche existiert.

virtual void __fastcall DragOver(System::TObject* Source, int X, int Y, TDragState State, bool &Accept );

Beschreibung

Indem Sie DragOver überschreiben, können Sie vor dem Aufruf der Ereignisbehandlungsroutine für OnDragOver bestimmte Aktionen durchführen.

Setzen Sie den Parameter Accept auf True, kann der Benutzer das gezogene Objekt auf dem Steuerelement ablegen. Wenn Sie Accept auf False setzen, kann das gezogene Objekt nicht auf dem Steuerelement abgelegt werden.

Der Parameter Source gibt das Objekt an, das gezogen wird. Der Parameter State kann folgende Werte annehmen:

Wert	Bedeutung

dsDragEnter	Der Mauszeiger tritt in den Bereich des Steuerelements ein.

dsDragMove	Der Mauszeiger wird über dem Steuerelement bewegt.

dsDragLeave	Der Mauszeiger verläßt den Bereich des Steuerelements.


TControl::EndDrag

TControl	Siehe auch	Beispiel

Die Methode EndDrag bricht das Ziehen eines Steuerelements ab.

void __fastcall EndDrag(bool Drop);

Beschreibung

Mit EndDrag können Sie eine Drag-and-Drop-Operation abbrechen, die durch einem Aufruf der Methode BeginDrag gestartet wurde.

Wenn der Parameter Drop True ist, wird das gezogene Steuerelement abgelegt. Hat Drop den Wert False, wird das Steuerelement nicht abgelegt und die Operation abgebrochen.


TControl::GetClientOrigin

TControl	Siehe auch

Die Methode GetClientOrigin ermittelt die Bildschirmkoordinaten (in Pixel) der oberen linken Ecke des Client-Bereichs eines Steuerelements.

virtual POINT __fastcall GetClientOrigin(void);

Beschreibung

Durch Überschreiben von GetClientOrigin können Sie Einfluß darauf nehmen, wie der Wert für ClientOrigin berechnet wird.

GetClientOrigin ist eine als protected deklarierte Methode für die Eigenschaft ClientOrigin. Die Methode berechnet ClientOrigin, indem sie die Werte Left und Top des Steuerelements zu den ClientOrigin-Koordinaten des übergeordneten Objekts hinzuaddiert.


TControl::GetClientRect

TControl	Siehe auch

Die Methode GetClientRect liefert ein Rechteck zurück, das den Client-Bereich des Steuerelements definiert.

virtual Windows::TRect __fastcall GetClientRect(void);

Beschreibung

Durch Überschreiben von GetClientRect können Sie Einfluß darauf nehmen, wie der Client-Bereich berechnet wird.

GetClientRect ist eine als protected deklarierte Methode für die Eigenschaft ClientRect. Die Methode liefert ein Rechteck zurück, dessen Felder Top und Left auf Null gesetzt sind. Die Felder Bottom und Right sind mit den Werten der Eigenschaft ClientHeight bzw. ClientWidth des Steuerelementes belegt.


TControl::GetDeviceContext

TControl	Siehe auch

Die Methode GetDeviceContext liefert einen Gerätekontext für das Steuerelement zurück.

virtual HDC __fastcall GetDeviceContext(HWND &WindowHandle);

Beschreibung

Durch einen Aufruf von GetDeviceContext erhalten Sie einen Gerätekontext. Durch Überschreiben von GetDeviceContext können Sie Einfluß darauf nehmen, wie der Kontext abgerufen wird.

Das Fenster-Handle des Steuerelements wird im Parameter WindowHandle übergeben. GetDeviceContext gibt den Gerätekontext zurück, den die Methode GetDeviceContext des übergeordneten Steuerelements zurückgibt.


TControl::GetDragImages

TControl	Siehe auch

Die Methode GetDragImages gibt die Bildliste zurück, die das Bild für Drag-and-Drop-Operationen enthält.

virtual TCustomImageList* __fastcall GetDragImages(void);

Beschreibung

Überschreiben Sie GetDragImages, um eine benutzerdefinierte Bildliste für das Steuerelement festzulegen. Die Methode GetDragImages von TControl gibt NIL zurück.


TControl::GetPalette

TControl	Siehe auch

Die Methode GetPalette gibt das Handle der Palette zurück, die vom Steuerelement verwendet werden soll.

virtual HPALETTE __fastcall GetPalette(void);

Beschreibung

Bei TControl gibt GetPalette ein Null-Handle zurück. Das bedeutet, daß das Steuerelement keine Palette anzugeben braucht. Durch Überschreiben von GetPalette können Sie abgeleitete Objekte implementieren, die eine Palette verwenden. Erzeugen Sie ein Paletten-Handle für das Steuerelement, indem Sie die API-Funktion CreatePalette aufrufen. GetPalette sollte das Paletten-Handle für das Steuerelement zurückgeben.

Die Angabe der Palette für ein Steuerelement hat folgende Konsequenzen:

•	Der Anwendung wird mitgeteilt, daß die Palette des Steuerelements realisiert werden muß.

•	Die zu realisierende Palette wird festgelegt.

GetPalette wird nur aufgerufen, wenn der Bildschirmmodus zur Laufzeit die Unterstützung einer Farbpalette erfordert. Dies ist beispielsweise im 256-Farben-Modus der Fall.


TControl::GetParentComponent

TControl	Siehe auch

Die Methode GetParentComponent gibt die übergeordnete Komponente des Steuerelements zurück.

virtual Classes::TComponent* __fastcall GetParentComponent(void);

Beschreibung

Mit GetParentComponent können Sie die übergeordnete Komponente des Steuerelements ermitteln. GetParentComponent ist eine als protected deklarierte Zugriffsmethode für die Eigenschaft Parent des Steuerelements.


TControl::GetPopupMenu

TControl	Siehe auch

Die Methode PopupMenu gibt das Popup-Menü zurück, das mit dem Steuerelement verknüpft ist.

virtual Menus::TPopupMenu* __fastcall GetPopupMenu(void);

Beschreibung

Durch einen Aufruf von GetPopupMenu können Sie das Popup-Menü ermitteln, das mit dem Steuerelement verknüpft ist. Sie können GetPopupMenu überschreiben, um ein anderes Popup-Menü für das Steuerelement festzulegen, oder um in Abhängigkeit vom Status des Steuerelements unterschiedliche Popup-Menüs zuweisen.

GetPopupMenu gibt den Wert der Eigenschaft Popup zurück.


TControl::GetTextBuf

TControl	Siehe auch	Beispiel

Die Methode GetTextBuf ruft den Text des Steuerelements ab, kopiert ihn in einen Puffer und liefert die Anzahl der kopierten Zeichen zurück.

int __fastcall GetTextBuf(char * Buffer, int BufSize);

Beschreibung

Mit GetTextBuf können Sie den Text eines Steuerelements in einen Puffer mit fester Länge kopieren. Der kopierte Text entspricht dem Wert der Eigenschaft Text. GetTextBuf gibt die Anzahl der Zeichen zurück, die tatsächlich kopiert wurden (entweder die Länge des Textes oder BufSize - 1, je nachdem, welcher Wert niedriger ist).

Vor dem Aufruf von GetTextBuf können Sie mit GetTextLen feststellen, wie groß der Puffer sein muß, um den gesamten Text aufnehmen zu können.

GetTextBuf dient der Kompatibilität mit 16-Bit-Code. Wenn keine Abwärtskompatibilität erforderlich ist, verwenden Sie die Eigenschaft Text.


TControl::GetTextLen

TControl	Siehe auch	Beispiel

Die Methode GetTextLen liefert die Länge des Textes des Steuerelements zurück.

int __fastcall GetTextLen(void);

Beschreibung

Mit der Methode GetTextLen können Sie die Länge des Textes des Steuerelements ermitteln. Der zurückgegebene Wert ist genau die Größe, die der von der Methode GetTextBuf verwendete Textpuffer aufweisen muß.


TControl::HasParent

TControl	Siehe auch

Die Methode HasParent gibt an, ob das Steuerelement ein übergeordnetes Objekt besitzt.

virtual bool __fastcall HasParent(void);

Beschreibung

Mit HasParent können Sie ermitteln, ob das Steuerelement ein übergeordnetes Objekt besitzt.

Das übergeordnete Objekt ist dafür verantwortlich, daß das Steuerelement in einen Stream geschrieben wird. Per Voreinstellung liefert HasParent für ein Steuerelement den Wert True zurück. Bei dem übergeordneten Objekt, von dem das Steuerelement in den Stream geschrieben wird, handelt es sich normalerweise um das Formular oder die Tafel, in dem bzw. der sich das Steuerelement befindet.

Hinweis

Ein untergeordnetes Steuerelement, das für HasParent True zurückgibt, muß die Methoden GetParentComponent und SetParentComponent implementieren.


TControl::Hide

TControl	Siehe auch	Beispiel

Die Methode Hide macht ein Steuerelement unsichtbar.

void __fastcall Hide(void);

Beschreibung

Mit Hide können Sie ein Steuerelement verbergen. Die Methode setzt die Eigenschaft Visible des Steuerelements auf False.

Obwohl ein verborgenes Steuerelement nicht sichtbar ist, stehen seine Eigenschaften und Methoden weiterhin zur Verfügung.


TControl::Invalidate

TControl	Siehe auch	Beispiel

Die Methode Invalidate weist Windows an, das Steuerelement nach der Bearbeitung anderer wichtiger Windows-Botschaften neu zu zeichnen.

virtual void __fastcall Invalidate(void);

Beschreibung

Verwenden Sie Invalidate, wenn das gesamte Steuerelement neu gezeichnet werden muß. Wenn mehrere Bereiche innerhalb des Steuerelements neu aufgebaut werden müssen, zeichnet Invalidate das gesamte Fenster ohne Bildschirmflackern neu. Es wirkt sich auch nicht negativ auf die Ausführungsgeschwindigkeit aus, wenn Invalidate vor dem Neuzeichnen des Steuerelements mehrere Male aufgerufen wird.


TControl::MouseDown

TControl	Siehe auch

Die Methode MouseDown ruft die Ereignisbehandlungsroutine für OnMouseDown auf, falls eine solche definiert ist.

virtual void __fastcall MouseDown(TMouseButton Button,  Classes::TShiftState Shift, int X, int Y);

Beschreibung

Indem Sie die als protected deklarierte Methode MouseDown überschreiben, können Sie zusätzlich zum Aufruf der Ereignisbehandlungsroutine für OnMouseDown bestimmte Aktionen durchführen.

Der Parameter Button gibt an, welche Maustaste der Benutzer gedrückt hat. Der Parameter Shift gibt an, welche Sondertaste (UMSCHALT, STRG oder ALT) gedrückt war, als das Mausereignis generiert wurde. X und Y geben die Pixel-Koordinaten des Mauszeigers im Client-Bereich des Steuerelements an.

Ein Steuerelement ruft MouseDown als Reaktion auf Windows-Botschaften auf, die aus dem Drücken einer Maustaste resultieren (WM_LBUTTONDOWN, WM_MBUTTONDOWN, WM_RBUTTONDOWN). Die Botschaftsparameter werden dekodiert und als Sondertaste und Position in den Parametern Shift, X und Y übergeben. Der Wert des Parameters Button hängt davon ab, welche Windows-Botschaft das Ereignis ausgelöst hat.


TControl::MouseMove

TControl	Siehe auch

Die Methode MouseMove ruft die Behandlungsroutine für das Ereignis OnMouseMove auf.

virtual void __fastcall MouseMove( Classes::TShiftState Shift, int X, int Y);

Beschreibung

Indem Sie die als protected deklarierte Methode MouseMove überschreiben, können Sie zusätzlich zum Aufruf der Ereignisbehandlungsroutine für OnMouseMove bestimmte Aktionen durchführen.

Ein Steuerelement ruft MouseMove als Reaktion auf Windows-Botschaften auf, die aus einer Mausbewegung resultieren (WM_MOUSEMOVE). Die Botschaftsparameter werden dekodiert und als Sondertaste und Position in den Parametern Shift, X und Y übergeben.


TControl::MouseUp

TControl	Siehe auch

Die Methode MouseUp ruft die Ereignisbehandlungsroutine für OnMouseUp auf.

virtual void __fastcall MouseUp(TMouseButton Button,  Classes::TShiftState Shift, int X, int Y);

Beschreibung

Indem Sie die als protected deklarierte Methode MouseUp überschreiben, können Sie zusätzlich zum Aufruf der Ereignisbehandlungsroutine für OnMouseUp bestimmte Aktionen durchführen.

Ein Steuerelement ruft MouseUp als Reaktion auf Windows-Botschaften auf, die aus dem Loslassen einer Maustaste resultieren (WM_LBUTTONUP, WM_MBUTTONUP, WM_RBUTTONUP). Die Botschaftsparameter werden dekodiert und als Sondertaste und Position in den Parametern Shift, X und Y übergeben. Der Wert des Parameters Button hängt davon ab, welche Windows-Botschaft das Ereignis ausgelöst hat.


TControl::Notification

TControl	Siehe auch

Die Methode Notification ermöglicht TControl die Aktualisierung seiner Eigenschaft PopupMenu, wenn das zugehörige Popup-Menü freigegeben wird.

virtual void __fastcall Notification(Classes::TComponent* AComponent, Classes::TOperation Operation );

  TOperation = (opInsert, opRemove);

Beschreibung

Durch Überschreiben von Notification können Sie Steuerelemente aktualisieren, die sich auf andere Systemressourcen beziehen. Damit lassen sich Referenzen auf Objekte vermeiden, die nicht mehr zur Verfügung stehen. Mit Notification können Sie beispielsweise datensensitive Objekte aktualisieren, deren Datenquelle entfernt wurde.

Per Voreinstellung geben Komponenten die Benachrichtigung an ihre untergeordneten Komponenten weiter (falls solche existieren).


TControl::PaletteChanged

TControl	Siehe auch

Die Methode PaletteChanged reagiert auf €nderungen an der Systempalette, indem sie die Palette des Steuerelements realisiert.

virtual bool __fastcall PaletteChanged(bool Foreground);

Beschreibung

Durch Überschreiben der Methode PaletteChanged können Sie Einfluß darauf nehmen, wie das Steuerelement auf Windows-Benachrichtigungen reagiert, die auf €nderungen an der Systempalette hindeuten. TControl reagiert auf derartige Benachrichtigungen mit dem Versuch, die Palette des Steuerelements (falls vorhanden) in den aktuellen Gerätekontext zu übernehmen. Wenn von der €nderung an der Systempalette auch die aktuelle Palette des Steuerelements betroffen ist, ruft PaletteChanged die Methode Invalidate des Steuerelements auf, die das Element mit der neuen Palette neu zeichnet.

Windows zeichnet das oberste Fenster mit einer Vordergrundpalette. Für die anderen Fenster werden Hintergrundpaletten verwendet. Hintergrundpaletten werden soweit wie möglich an die Farben angepaßt, die in der logischen Palette des Steuerelements festgelegt sind. Dabei werden die Beschränkungen berücksichtigt, die durch die Implementierung der Vordergrundpalette entstehen. Windows läßt nur eine einzige Vordergrundpalette zu.

PaletteChanged ermöglicht es einem Steuerelement, eine neue Version seiner Palette abzurufen, wenn sich die Systempalette geändert hat. Wenn ForeGround True ist, wurde das Formular aktiviert, und die Steuerelemente verwenden die neue Vordergrundpalette. Wenn ForeGround False ist, wurde die Vordergrundpalette von einer anderen Anwendung geändert. In diesem Fall müssen Steuerelemente, die sich auf die vorhandene Palette beziehen, neue Hintergrundpaletten realisieren, um eine größtmögliche Übereinstimmung mit den logischen Paletten zu erreichen.

Falls das Steuerelement keine logische Palette besitzt, die in den aktuellen Gerätekontext übernommen werden kann, gibt GetPalette False zurück. Auch PaletteChanged gibt in diesem Fall False zurück und zeigt damit an, daß keine Palette realisiert wurde. Wenn GetPalette das Handle einer logischen Palette zurückgibt, übernimmt PaletteChanged diese Palette in den aktuellen Gerätekontext und gibt True zurück.

Hinweis

PaletteChanged wird nur aufgerufen, wenn der Bildschirmmodus zur Laufzeit die Unterstützung einer Farbpalette erfordert. Dies ist beispielsweise im 256-Farben-Modus der Fall, nicht aber bei 16 Millionen Farben.


TControl::Perform

TControl	Siehe auch

Die Methode Perform versetzt ein Steuerelement in die Lage, sich selbst eine Windows-Botschaft zu senden.

long __fastcall Perform(unsigned int Msg, long WParam, long LParam);

Beschreibung

Mit Perform können Sie die Botschaftswarteschlange von Windows umgehen und eine Botschaft direkt an die Fensterprozedur des Steuerelements senden.

Perform legt einen Botschaftsdatensatz (vom Typ TMessage) an, der die im Parameter Msg übergebene Botschafts-ID, die in WParam und LParam übergebenen Botschaftsparameter und ein Ergebnisfeld mit dem Wert Null enthält. Dieser Datensatz wird an die Methode WndProc zur weiteren Bearbeitung übergeben.


TControl::ReadState

TControl	Siehe auch

Die Methode ReadState bereitet das Steuerelement auf das Lesen seiner Eigenschaftswerte aus einem Stream vor.

virtual void __fastcall ReadState(Classes::TReader* Reader);

Beschreibung

Durch Überschreiben der Methode ReadState können Sie die Vorbereitungen beeinflussen, die das Steuerelement trifft, um seine Eigenschaftswerte aus einem Stream zu lesen. Ein Steuerelement könnte beispielsweise temporäre, interne Datenstrukturen oder Objekte freigeben, bevor neue Instanzen aus dem Stream geladen werden. Vergessen Sie nicht, die geerbte Methode ReadState aufzurufen, wenn Sie ReadState überschreiben.

TControl::ReadState weist der Eigenschaft Parent des Steuerelements die Eigenschaft Parent des TReader-Objekts zu, bevor die geerbte Methode ReadState von TComponent aufgerufen wird. Abschließend synchronisiert ReadState unter Beachtung von ParentFont, ParentColor und ParentShowHint die Eigenschaften Font, Color und ShowHint mit den entsprechenden Eigenschaften des übergeordneten Steuerelements.


TControl::Refresh

TControl	Siehe auch

Die Methode Refresh zeichnet das Steuerelement auf dem Bildschirm neu.

void __fastcall Refresh(void);

Beschreibung

Durch einen Aufruf von Refresh wird das Steuerelement sofort neu gezeichnet. Refresh ruft die Methode Repaint auf. Sie können wahlweise Refresh oder Repaint verwenden.


TControl::Repaint

TControl	Siehe auch

Die Methode Repaint veranlaßt das Steuerelement dazu, sich selbst auf dem Bildschirm neu zu zeichnen.

virtual void __fastcall Repaint(void);

Beschreibung

Durch einen Aufruf von Repaint wird das Steuerelement dazu veranlaßt, sein Bild sofort neu zu zeichnen. Wenn ControlStyle den Parameter csOpaque enthält, wie dies bei von TGraphicControl abgeleiteten Steuerelementen der Fall ist, wird das Steuerelement im Gerätekontext des übergeordneten Objekts neu gezeichnet. Andernfalls ruft Repaint zunächst die Methode Invalidate und danach die Methode Update auf, damit das Steuerelement sofort neu gezeichnet wird.


TControl::ScreenToClient

TControl	Siehe auch	Beispiel

Die Methode ScreenToClient wandelt die Bildschirmkoordinaten des angegebenen Punktes in Client-Koordinaten um.

POINT __fastcall ScreenToClient(const POINT &Point);

Beschreibung

Mit ScreenToClient können Sie die Bildschirmkoordinaten eines Punktes in lokale bzw. Client-Koordinaten umwandeln. In Client-Koordinaten bezeichnet (0, 0) die obere linke Ecke des Client-Bereichs des Steuerelements. In Bildschirmkoordinaten entspricht (0, 0) der oberen linken Ecke des Bildschirms.

Mit den Methoden ScreenToClient und ClientToScreen können Sie Koordinaten zwischen verschiedenen Steuerelenten konvertieren.


TControl::SendCancelMode

TControl	Siehe auch

Die Methode SendCancelMode beendet den modalen Status eines Steuerelements.

void __fastcall SendCancelMode(TControl* Sender);

Beschreibung

Mit der Methode SendCancelMode können Sie den modalen Status eines Steuerelements beenden. Verschiedene Steuerelemente der VCL unterstützen einen modalen Status, in dem der Benutzer auf das Steuerelement reagieren muß, bevor er mit einem anderen Objekt im Formular weiterarbeiten kann. Ein Beispiel hierfür ist der Dropdown-Status eines Kombinationsfeldes, dessen Dropdown-Liste gerade geöffnet ist. Bei diesen Steuerelementen lösen bestimmte Benutzeraktionen Windows-Botschaften aus, die die Beendigung des modalen Status bewirken. Mit SendCancelMode kann eine Anwendung den modalen Status ohne Benutzeraktion beenden oder eine eigene Reaktion implementieren.


TControl::SendToBack

TControl	Siehe auch	Beispiel

Die Methode SendToBack legt ein fensterorientiertes Steuerelement hinter alle anderen fensterorientierten Steuerelemente der übergeordneten Komponente bzw. des übergeordneten Formulars. Dieselbe Operation führt sie auch mit nicht fensterorientierten Steuerelementen durch.

void __fastcall SendToBack(void);

Beschreibung

Mit SendToBack können Sie die Anordnung sich überlappender Steuerelemente oder Formulare ändern.

Die Reihenfolge, in der die Steuerelemente übereinandergestapelt werden (die sogenannte Z-Reihenfolge) hängt von der Reihenfolge ab, in der die Steuerelemente in das Formular eingefügt wurden. Wenn Sie beispielsweise eine Beschriftung und ein Bild in ein Formular einfügen, so daß ein Element über dem anderen liegt, kommt das Objekt, das zuerst im Formular plaziert wurde, zuunterst zu liegen. Da sowohl Beschriftungen als auch das Bilder nicht fensterorientierte Steuerelemente sind, werden sie in gewohnter Weise gestapelt. Rufen Sie die Methode SendToBack des oberen Objekts auf, wenn dieses unter das andere Objekt gelegt werden soll.

Die Stapelreihenfolge für zwei fensterorientierte Steuerelemente ist identisch mit derjenigen für zwei nicht fensterorientierte Steuerelemente. Wenn Sie beispielsweise ein Memofeld in ein Formular einfügen und dann ein Kontrollfeld darüberlegen, bleibt das Kontrollfeld oben. Wenn Sie SendToBack für das Kontrollfeld aufrufen, wird das Memofeld im Vordergrund angezeigt.

Fensterorientierte und nicht fensterorientierte Steuerelemente werden getrennt gestapelt. Wenn Sie beispielsweise ein Memofeld (ein fensterorientiertes Steuerelement) und danach eine Beschriftung (ein nicht fensterorientiertes Steuerelement) in ein Formular einfügen, verschwindet die Beschriftung hinter dem Memofeld. Fensterorientierte Steuerelemente kommen immer über nicht fensterorientierten Steuerelementen zu liegen. In diesem Beispiel bewirkt der Aufruf der Methode SendToBack nichts. Die Beschriftung bleibt hinter dem Memofeld verborgen.

Wenn das Steuerelement bei der Ausführung von SendToBack den Eingabefokus besitzt, gibt es diesen ab.


TControl::SetBounds

TControl	Siehe auch	Beispiel

Die Methode SetBounds setzt die Eigenschaften Left, Top, Width und Height gleichzeitig.

virtual void __fastcall SetBounds(int ALeft, int ATop, int AWidth, int AHeight);

Beschreibung

Mit der Methode SetBounds können Sie alle Eigenschaften des umgebenden Rechtecks der Komponente gleichzeitig ändern. Sie erzielen dasselbe Ergebnis, wenn Sie die Eigenschaften Left, Top, Width und Height einzeln setzen. SetBound setzt alle vier Eigenschaften gleichzeitig und stellt sicher, daß das Steuerelement zwischen den €nderungen nicht neu gezeichnet wird.

Die Werte für die Eigenschaften Left, Top, Width und Height werden in den Parametern ALeft, ATop, AWidth und AHeight übergeben.


TControl::SetDragMode

TControl	Siehe auch

Die Methode SetDragMode legt den Drag-Modus für das Steuerelement fest.

virtual void __fastcall SetDragMode(TDragMode Value);

Beschreibung

SetDragMode ist die als protected deklarierte Methode für die Eigenschaft DragMode. Indem Sie SetDragMode überschreiben, können Sie zusätzliche Aktionen durchführen, wenn sich der Wert der Eigenschaft DragMode ändert.


TControl::SetName

TControl	Siehe auch

Die Methode SetName legt den Namen des Steuerelements fest.

virtual void __fastcall SetName(const System::AnsiString Value);

Beschreibung

SetName ist die als protected deklarierte Methode zum Setzen der Eigenschaft Name. Indem Sie SetName überschreiben, können Sie bestimmte Aktionen durchführen, wenn sich der Wert der Eigenschaft Name ändert.


TControl::SetParent

TControl	Siehe auch

Mit der Methode SetParent wird das übergeordnete Objekt eines Steuerelements festgelegt.

virtual void __fastcall SetParent(TWinControl* AParent);

Beschreibung

Durch einen Aufruf von SetParent können Sie ein Fenster zum übergeordneten Objekt eines Steuerelements machen. Die Methode SetParent ist eine als protected deklarierte Methode zum Setzen der Eigenschaft Parent. Indem Sie SetParent überschreiben, können Sie bestimmte Aktionen durchführen, wenn sich der Wert Eigenschaft Parent ändert.

Übergeben Sie im Parameter AParent das Steuerelement, das zum übergeordneten Steuerelement werden soll.

Wenn für das Steuerelement bereits ein übergeordnetes Objekt existiert, entfernt die Methode das Steuerelement aus der Steuerelementliste des übergeordneten Objekts, indem sie dessen Methode RemoveControl aufruft. Wenn AParent nicht NIL ist, ruft SetParent die Methode InsertControl des Steuerelements auf, um das Element zur Liste der Steuerelemente hinzuzufügen.

Die Methode ~TControl aller Steuerelemente ruft die Methode SetParent mit dem Parameter NIL auf, um das Steuerelement aus der Steuerelementliste des übergeordneten Objekts zu entfernen. Erst dann wird die Komponente freigegeben.


TControl::SetParentComponent

TControl	Siehe auch

Die Methode SetParentComponent legt das übergeordnete Objekt des Steuerelements fest.

virtual void __fastcall SetParentComponent(Classes::TComponent* Value);

Beschreibung

Mit SetParentComponent können Sie die im Parameter Value übergebene Komponente zum übergeordneten Objekt des Steuerelements erklären.

SetParentComponent ruft die Methode SetParent nur dann auf, wenn die Komponente, die als übergeordnetes Objekte fungieren soll, ein fensterorientiertes Steuerelement ist.


TControl::SetTextBuf

TControl	Siehe auch	Beispiel

Die Methode SetTextBuf legt den Text des Steuerelements fest.

void __fastcall SetTextBuf(char * Buffer);

Beschreibung

Durch einen Aufruf von SetTextBuf weisen Sie dem Steuerelement den Text im angegebenen Textpuffer zu.

Der Textpuffer wird im Parameter Buffer übergeben. Buffer muß auf einen nullterminierten String zeigen. SetTextBuf sendet die Botschaften WM_SETTEXT und CM_TEXTCHANGED.

Hinweis

Die Methode SetTextBuf dient ausschließlich der Abwärtskompatibilität. Normalerweise legen Sie den Text eines Steuerelements mit Hilfe der Eigenschaft Text fest.


TControl::SetZOrder

TControl	Siehe auch

Die Methode SetZOrder reiht das Steuerelement in der Steuerelementliste des übergeordneten Objekts neu ein, wobei sich gleichzeitig seine Position auf dem Bildschirm ändert.

virtual void __fastcall SetZOrder(bool TopMost);

Beschreibung

Mit SetZOrder können Sie die Z-Reihenfolge des Steuerelements ändern. Wenn das Steuerelement zum obersten Element werden soll, übergeben Sie für TopMost den Wert True. Soll das Steuerelement zuunterst liegen, übergeben Sie False.

Nach der €nderung der Reihenfolge ruft SetZOrder die Methode Invalidate des Steuerelements auf, um sicherzustellen, daß bei dem erneuten Zeichnen des Elements die neue Anordnung berücksichtigt wird.

Fensterorientierte und nicht fensterorientierte Steuerelemente werden getrennt gestapelt. Wenn Sie beispielsweise ein Memofeld (ein fensterorientiertes Steuerelement) und danach eine Beschriftung (ein nicht fensterorientiertes Steuerelement) in ein Formular einfügen, verschwindet die Beschriftung hinter dem Memofeld. Fensterorientierte Steuerelemente kommen immer über nicht fensterorientierten Steuerelementen zu liegen. In diesem Beispiel bewirkt der Aufruf der Methode SetZOrder nichts. Die Beschriftung bleibt hinter dem Memofeld verborgen.


TControl::Show

TControl	Siehe auch	Beispiel

Die Methode Show macht ein Steuerelement sichtbar.

void __fastcall Show(void);

Beschreibung

Mit der Methode Show können Sie ein verborgenes Steuerelement sichtbar machen.

Die Methode Show setzt die Eigenschaft Visible des Steuerelements auf True und sorgt dafür, daß das übergeordnete Steuerelement sichtbar ist.


TControl::TControl

TControl	Siehe auch

Die Methode TControl erzeugt eine Instanz von TControl.

__fastcall virtual TControl(Classes::TComponent* AOwner);

Beschreibung

Mit TControl können Sie eine Instanz von TControl erzeugen und initialisieren.

Nach dem Aufruf der geerbten Methode initialisiert TControl die folgenden Eigenschaften:

•	Color mit clWindow.

•	ControlStyle mit [csCaptureMouse, csClickEvents, csSetCaption, csDoubleClick].

•	DragCursor mit crDrag.

•	Enabled und Visible mit True.

•	IsControl mit False.

•	ParentColor, ParentFont und ParentShowHint mit True.

•	WindowProc mit der Methode WndProc.

Wenn Sie TControl überschreiben, müssen Sie immer zuerst die geerbte Methode TControl aufrufen. Anschließend können Sie die Initialisierung des Steuerelements vornehmen. Vergessen Sie beim Überschreiben der Methode TControl nicht die Direktive override.

Wenn TControl für eine Komponente Ressourcen oder Speicher reserviert, sollten Sie auch ~TControl überschreiben, um diese wieder freizugeben.


TControl::Update

TControl	Siehe auch	Beispiel

Die Methode Update sorgt für die sofortige Bearbeitung anstehender Zeichenbotschaften.

virtual void __fastcall Update(void);

Beschreibung

Durch einen Aufruf von Update können Sie erzwingen, daß das Steuerelement neu gezeichnet wird, bevor weitere, möglicherweise zeitaufwendige Bearbeitungen durchgeführt werden. Mit Update können Sie einem Benutzer, der nicht auf die Zeichenbotschaft von Windows warten kann, eine sofortige Rückmeldung zukommen lassen. Update ruft nicht die Methode Invalidate des Steuerelements auf, sondern veranlaßt nur die Neuzeichnung von Bereichen, die bereits von Invalidate gezeichnet wurden. Wenn das gesamte Steuerelement gezeichnet werden soll, rufen Sie Repaint auf.


TControl::UpdateBoundsRect

TControl	Siehe auch

Die Methode UpdateBoundsRect ändert die Eigenschaften Top, Left, Width und Height des Steuerelements, aktualisiert aber nicht die Anzeige auf dem Bildschirm.

void __fastcall UpdateBoundsRect(const Windows::TRect &R);

Beschreibung

UpdateBoundsRect wird in erster Linie intern von Steuerelementen verwendet, um die Synchronisierung mit von Windows durchgeführten €nderungen sicherzustellen. Die Methode aktualisiert die Eigenschaften auf Grundlage des Rechtecks, das im Parameter R übergeben wird.


TControl::VisibleChanging

TControl	Siehe auch

Die Methode VisibleChanging wird aufgerufen, bevor der Wert der Eigenschaft Visible eines Steuerelements geändert wird.

virtual void __fastcall VisibleChanging(void);

Beschreibung

VisibleChanging stellt lediglich eine Schnittstelle für abgeleitete Objekte dar. Die Methode kann überschrieben werden, um auf €nderungen an der Eigenschaft Visible des Steuerelements zu reagieren. Wenn das Steuerelement beispielsweise seine Sichtbarkeit nicht ändern soll, überschreiben Sie VisibleChanging so, daß jeder €nderungsversuch eine Exception auslöst.


TControl::WndProc

TControl	Siehe auch

Die Methode WndProc erlaubt dem Steuerelement spezifische Reaktionen auf Botschaften.

virtual void __fastcall WndProc(Messages::TMessage &Message);

Beschreibung

Durch Überschreiben von WndProc können Sie bestimmte Reaktionen auf Botschaften implementieren.

WindowProc ist die erste Methode, die Botschaften für ein C++Builder-Steuerelement empfängt. Sie definiert Reaktionen auf allgemeine Mausereignisse und übergibt alle anderen Botschaften an die Methode Dispatch.

Wenn Sie WndProc überschreiben, um bestimmte Reaktionen auf Botschaften zu implementieren, müssen Sie am Ende die geerbte Methode WndProc aufrufen, damit nicht bearbeitete Botschaften weitergegeben werden.


Gültigkeitsbereich

Protected

Published

Zugriff

Read-only


Gültigkeitsbereich

Protected


Gültigkeitsbereich

Protected


Hierarchie

TObject

TPersistent

TComponent


TControl Beispiel

TControl


TConversion

Hierarchie	Methoden	Siehe auch

Header

vcl/comctrls.hpp

TConversion konvertiert RTF-Daten aus einem Codierungsformat in ein anderes. Diese Konvertierung erfolgt, wenn die Daten von einem Speichermedium mit einem bestimmten Format auf ein Speichermedium mit einem anderen Format übertragen werden.

Beschreibung

TConversion selbst führt keine Konvertierungen aus. Es liest lediglich aus einem Stream oder schreibt in einen Stream. TConversion dient in erster Linie als Schnittstelle, die von abgeleiteten Klassen überschrieben werden kann, wenn diese Text aus einem Format in ein anderes konvertieren (diese Umwandlung erfolgt, sobald der Text in einen Stream gestellt wird).

Nachkommen von TCustomRichEdit setzen TConversion ein, wenn Text in Dateien geschrieben oder aus Dateien gelesen wird. Die Dateien müssen einfachen ANSI-Text oder Text im RTF-Format enthalten. Damit RTF-Steuerelemente aus Dateien lesen und in Dateien schreiben können, die ein anderes Format aufweisen, müssen Sie eine Klasse von TConversion ableiten, die eine Konvertierung zwischen dem gewünschten Format und RTF ausführt.  RTF-Steuerelemente können die neue Klasse verwenden, wenn sie mit ihrer Methode RegisterConversionFormat registriert oder als Standardmethode zur Konvertierung deklariert wird.


Methoden von TConversion

TConversion	Alphabetisch

In TConversion

~TConversion

ConvertReadStream

ConvertWriteStream

TConversion

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TConversion

TConversion	Nach Objekten

~TConversion

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

ConvertReadStream

ConvertWriteStream

DefaultHandler

Dispatch

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance

TConversion


TConversion::~TConversion

TConversion

Der Destruktor ~TConversion gibt den Speicher frei, der für das TConversion-Objekt reserviert war. Rufen Sie ~TConversion nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TConversion automatisch aufgerufen wird.

__fastcall virtual ~TConversion(void);


TConversion::ConvertReadStream

TConversion	Siehe auch

Die Methode ConvertReadStream liest BufSize Bytes aus dem Stream in den Speicherpuffer, auf den Buffer zeigt.

virtual int __fastcall ConvertReadStream(Classes::TStream* Stream, char * Buffer, int BufSize);

Überschreiben Sie diese Methode in einer abgeleiteten Klasse, und konvertieren Sie den Text im Puffer. Um eine abgeleitete Klasse zu erstellen, die TCustomRichEdit verwenden kann, konvertieren Sie den Text in das RTF-Format.

Hinweis

ConvertReadStream sollte die Konvertierung von ConvertWriteStream in umgekehrter Richtung ausführen.


TConversion::ConvertWriteStream

TConversion	Siehe auch

Die Methode ConvertWriteStream schreibt BufSize Bytes aus dem Speicherpuffer, auf den Buffer zeigt, in den Stream.

virtual int __fastcall ConvertWriteStream(Classes::TStream* Stream, char * Buffer, int BufSize);

Überschreiben Sie diese Methode in einer abgeleiteten Klasse, und konvertieren Sie den Text im Puffer. Um eine abgeleitete Klasse zu erstellen, die TCustomRichEdit verwenden kann, konvertieren Sie den Text aus dem RTF-Format.

Hinweis

ConvertWriteStream sollte die Konvertierung von ConvertReadStream in umgekehrter Richtung ausführen.


TConversion::TConversion

TConversion

Der Konstruktor TConversion erzeugt ein neues TConversion-Objekt.

__fastcall TConversion(void);


Hierarchie

TObject


TConversion Beispiel

TConversion


TCurrencyField

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/dbtables.hpp

Ein TCurrencyField-Objekt stellt ein Feld dar, das Währungswerte in einer Datenmenge enthält.

Beschreibung

Währungsfelder können Werte (positive und negative) im Bereich zwischen 5,0 * 10-324 und 1,7 * 10 308 mit einer Genauigkeit von 15 Stellen enthalten.

TCurrencyField unterscheidet sich von seinem direkten Vorfahr TFloatField nur durch den Datentyp ftCurrency und durch die standardmäßige Formatierung des Wertes mit einem Währungsformat. TCurrencyField umfaßt als Nachkomme von TFloatField viele Eigenschaften, Methoden und Ereignisse, die für die Verwaltung von Werten und Eigenschaften der Gleitkommafelder in einer Datenbank von Nutzen sind.

Verwechseln Sie TCurrencyField nicht mit dem Datentyp Currency. Währungsfelder verwenden den Datentyp Double für die Speicherung und Bearbeitung der Werte. Bei diesem Datentyp handelt es sich um das Format, das von den physischen Datenbanktabellen für Währungsfelder eingesetzt wird. Die Klasse BCDField verwendet den Datentyp Currency zum Speichern und Bearbeiten der Werte.


Eigenschaften von TCurrencyField

TCurrencyField	Alphabetisch	Legende

In TCurrencyField

Currency

Abgeleitet von TFloatField

MaxValue

MinValue

Precision

Value

Abgeleitet von TNumericField

DisplayFormat

EditFormat

Abgeleitet von TField

Alignment

AsBoolean

AsCurrency

AsDateTime

AsFloat

AsInteger

AsString

AsVariant

AttributeSet

BDECalcField

Calculated

CanModify

DataSet

DataSize

DataType

DisplayLabel

DisplayName

DisplayText

DisplayWidth

EditMask

EditMaskPtr

FieldKind

FieldName

FieldNo

Index

IsIndexField

IsNull

KeyFields

Lookup

LookupDataSet

LookupKeyFields

LookupResultField

NewValue

OldValue

ReadOnly

Required

Size

Text

Visible

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Name

Owner

Tag


Eigenschaften von TCurrencyField

TCurrencyField	Nach Objekten	Legende

Alignment

AsBoolean

AsCurrency

AsDateTime

AsFloat

AsInteger

AsString

AsVariant

AttributeSet

BDECalcField

Calculated

CanModify

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

Currency

DataSet

DataSize

DataType

DesignInfo

DisplayFormat

DisplayLabel

DisplayName

DisplayText

DisplayWidth

EditFormat

EditMaskPtr

EditMask

FieldKind

FieldName

FieldNo

Index

IsIndexField

IsNull

KeyFields

LookupDataSet

LookupKeyFields

LookupResultField

Lookup

MaxValue

MinValue

Name

NewValue

OldValue

Owner

Precision

ReadOnly

Required

Size

Tag

Text

Value

Visible


TCurrencyField::Currency

TCurrencyField

Die Eigenschaft Currency legt fest, ob der Wert in dem Feld als Währungswert formatiert werden soll.

__property Currency;

Beschreibung

Mit Hilfe der Eigenschaft Currency können Sie festlegen, wie der Wert im Feld für die Anzeige und die Bearbeitung in einem datensensitiven Steuerelement formatiert werden soll.

Das Format des Feldes verwendet für Anzeigezwecke die Eigenschaft DisplayFormat, wenn diese zugewiesen ist. Wurde DisplayFormat nicht zugewiesen, legt Currency fest, wie das Feld für die Anzeige formatiert wird. Wenn Currency True ist, wird der Wert für die Anzeige über die Funktion FloatToText mit dem Formatierungscode ffCurrency formatiert. Ist Currency False, wird der Wert mit dem Format ffGeneral formatiert.

Das Format des Feldes verwendet für Bearbeitungszwecke die Eigenschaft EditFormat (oder DisplayFormat), wenn diese zugewiesen ist. Ist weder EditFormat noch DisplayFormat zugewiesen, wird mit Currency festgelegt, wie das Feld für die Bearbeitung formatiert wird. Wenn Currency True ist, wird der Wert für die Bearbeitung über die Funktion FloatToText mit dem Formatierungscode ffFixed formatiert. Ist Currency False, wird der Wert mit dem Format ffGeneral formatiert.

Der Standardwert von Currency für TCurrencyField-Komponenten lautet True.


Ereignisse von TCurrencyField

TCurrencyField	Alphabetisch	Legende

Abgeleitet von TField

OnChange

OnGetText

OnSetText

OnValidate


Ereignisse von TCurrencyField

TCurrencyField	Nach Objekten	Legende

OnChange

OnGetText

OnSetText

OnValidate


Methoden von TCurrencyField

TCurrencyField	Alphabetisch

In TCurrencyField

~TCurrencyField

TCurrencyField

Abgeleitet von TFloatField

IsValidChar

Abgeleitet von TField

Assign

AssignValue

Clear

FocusControl

GetData

SetData

SetFieldType

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TCurrencyField

TCurrencyField	Nach Objekten

~TCurrencyField

Assign

AssignValue

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

Clear

DefaultHandler

DestroyComponents

Destroying

Dispatch

FieldAddress

FindComponent

FocusControl

FreeInstance

FreeNotification

Free

GetData

GetParentComponent

HasParent

InheritsFrom

InitInstance

InsertComponent

InstanceSize

IsValidChar

MethodAddress

MethodName

NewInstance

RemoveComponent

SetData

SetFieldType

TCurrencyField


TCurrencyField::TCurrencyField

TCurrencyField	Siehe auch

TCurrencyField erzeugt eine Instanz von TCurrencyField.

__fastcall virtual TCurrencyField(Classes::TComponent* AOwner);

Beschreibung

Rufen Sie TCurrencyField auf, wenn Sie eine Instanz von TCurrencyField erzeugen und initialisieren wollen. Nach dem Aufruf des geerbten Konstruktors setzt TCurrencyField DataType auf ftCurrency und die Eigenschaft Currency auf True.

TCurrencyField muß nur in seltenen Fällen direkt aufgerufen werden, weil ein Währungsfeldobjekt automatisch für alle Währungsfelder in einer Datenmenge instantiiert wird.


TCurrencyField::~TCurrencyField

TCurrencyField

Der Destruktor ~TCurrencyField gibt den Speicher frei, der für das TCurrencyField-Objekt reserviert war. Rufen Sie ~TCurrencyField nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TCurrencyField automatisch aufgerufen wird.

__fastcall virtual ~TCurrencyField(void);


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TField

TNumericField

TFloatField


TCurrencyField Beispiel

TCurrencyField


TControlScrollBar

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/forms.hpp

TControlScrollBar zeigt eine horizontale oder vertikale Bildlaufleiste an.

Beschreibung

Die Eigenschaften HorzScrollBar und VertScrollBar von TForm und TScrollBox verwenden TControlScrollBar-Objekte zur Darstellung von Bildlaufleisten.


Eigenschaften von TControlScrollBar

TControlScrollBar	Alphabetisch	Legende

In TControlScrollBar

Increment

Kind

Margin

Position

Range

ScrollPos

Tracking

Visible


Eigenschaften von TControlScrollBar

TControlScrollBar	Nach Objekten	Legende

Increment

Kind

Margin

Position

Range

ScrollPos

Tracking

Visible


TControlScrollBar::Increment

TControlScrollBar

Die Eigenschaft Increment legt fest, wie weit die Anzeige verschoben wird, wenn der Benutzer auf den kleinen Pfeil in der Bildlaufleiste klickt.

__property TScrollBarInc Increment;

Beschreibung

Wenn Increment auf 1 gesetzt ist, führt jeder Klick einen Bildlauf um eine Position aus. Ist Increment auf 2 gesetzt, wird ein Bildlauf um zwei Positionen ausgeführt usw.


TControlScrollBar::Kind

TControlScrollBar	Beispiel

Die Eigenschaft Kind legt fest, ob es sich um eine horizontale oder verikale Bildlaufleiste handelt.

__property TScrollBarKind Kind;

Beschreibung

Folgende Werte stehen für die Eigenschaft Kind zur Verfügung:

Wert	Bedeutung

sbHorizontal	Es wird eine horizontale Bildlaufleiste angezeigt.

sbVertical	Es wird eine vertikale Bildlaufleiste angezeigt.


TControlScrollBar::Margin

TControlScrollBar	Siehe auch	Beispiel

Die Eigenschaft Margin bestimmt, wann eine Bildlaufleiste erzeugt werden soll.

__property unsigned short Margin;

Beschreibung

Die Eigenschaft Margin bestimmt die Mindestanzahl von Pixeln, die jedes Steuerelement vom Rand des Formulars oder der Bildlaufleiste entfernt sein muß. Wenn zur Laufzeit eine sichtbare Komponente weniger als Margin Pixel vom Rand entfernt ist, und wenn Visible auf True gesetzt ist, wird eine Bildlaufleiste angezeigt.


TControlScrollBar::Position

TControlScrollBar	Siehe auch	Beispiel

Die Eigenschaft Position gibt die Lage der Positionsmarke in der Bildlaufleiste an.

__property int Position;

Beschreibung

Wenn der Benutzer zur Laufzeit einen Bildlauf ausführt, ändert sich der Wert von Position entsprechend.


TControlScrollBar::Range

TControlScrollBar	Siehe auch

Die Eigenschaft Range legt fest, wie weit das Formular oder das Bildlauffeld verschoben werden kann.

__property int Range;

Beschreibung

Range repräsentiert die virtuelle Größe des Formulars oder des Bildlauffeldes (in Pixel). Wird beispielsweise die Eigenschaft Range für die horizontale Bildlaufleiste eines Formulars auf 500 gesetzt, und beträgt die Breite des Formulars 200, kann die Position der Bildlaufleiste zwischen 0 und 300 liegen.

Wenn der Wert von Range für eine horizontale Bildlaufleiste niedriger ist als die Breite des Formulars oder des Bildlauffeldes, wird keine horizonale Bildlaufleiste angezeigt. Ist der Wert von Range für eine vertikale Bildlaufleiste niedriger als die Höhe des Formulars oder des Bildlauffeldes, wird keine vertikale Bildlaufleiste angezeigt.

Die Werte für Range werden automatisch gesetzt, können aber mit dem Objektinspektor oder im Programmcode überschrieben werden.


TControlScrollBar::ScrollPos

TControlScrollBar	Siehe auch

Die Eigenschaft ScrollPos ist der aktuelle Wert der Eigenschaft Position.

__property int ScrollPos;

Beschreibung

Die Nur-Lesen-Eigenschaft ScrollPos liefert den aktuellen Wert von Position zurück.


TControlScrollBar::Tracking

TControlScrollBar

Die Eigenschaft Tracking legt fest, ob das Formular oder das Bildlauffeld verschoben wird, bevor die Positionsmarke losgelassen wird.

__property bool Tracking;

Beschreibung

Wenn Tracking auf True gesetzt ist, verschiebt sich das Bild im Bildlauffeld oder Formular, wenn der Benutzer die Positionsmarke zieht. Ist Tracking auf False gesetzt, bleibt das Bild stehen, bis die Positionsmarke losgelassen wird.


TControlScrollBar::Visible

TControlScrollBar	Siehe auch	Beispiel

Die Eigenschaft Visible legt fest, ob die Bildlaufleiste angezeigt wird.

__property bool Visible;

Beschreibung

Ist Visible auf True gesetzt, wird eine Bildlaufleiste angezeigt, sobald eine visuelle Komponente weniger als Margin Pixel vom Rand des Formulars oder Bildlauffeldes entfernt ist.


Methoden von TControlScrollBar

TControlScrollBar	Alphabetisch

In TControlScrollBar

~TControlScrollBar

Assign

TControlScrollBar

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TControlScrollBar

TControlScrollBar	Nach Objekten

~TControlScrollBar

Assign

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance

TControlScrollBar


TControlScrollBar::~TControlScrollBar

TControlScrollBar

Der Destruktor ~TControlScrollBar gibt den Speicher frei, der für das TControlScrollBar-Objekt reserviert war. Rufen Sie ~TControlScrollBar nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TControlScrollBar automatisch aufgerufen wird.

__fastcall virtual ~TControlScrollBar(void);


TControlScrollBar::Assign

TControlScrollBar	Siehe auch

Die Methode Assign kopiert den Inhalt einer TControlScrollBar-Instanz in eine andere TControlScrollBar-Instanz.

virtual void __fastcall Assign(Classes::TPersistent* Source);

Beschreibung

Assign kopiert die Eigenschaften Visible, Range, Position und Increment des Quellobjekts in eine andere TControlScrollBar-Instanz.


TControlScrollBar::TControlScrollBar

TControlScrollBar

Der Konstruktor TControlScrollBar erzeugt ein neues TControlScrollBar-Objekt.

__fastcall TControlScrollBar(TScrollingWinControl* AControl, TScrollBarKind AKind);


Gültigkeitsbereich

Published

Zugriff

Read-only


Hierarchie

TObject

TPersistent


TControlScrollBar Beispiel

TControlScrollBar


TControlCanvas

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/controls.hpp

TControlCanvas ist ein spezialisiertes Zeichenflächenobjekt, das mit einem Steuerelement verbunden ist.

Beschreibung

Verwenden Sie TControlCanvas als Zeichenfläche, in der das Bild eines Steuerelementes erstellt wird. Standard-Fenstersteuerelemente, wie Eingabe- und Listenfelder, werden von Windows gezeichnet und benötigen daher keine Zeichenfläche.

Als Zeichenfläche stellt TControlCanvas viele Eigenschaften, Ereignisse und Methoden für die Erstellung komplexer Bilder zur Verfügung. Zusätzlich besitzt TControlCanvas Eigenschaften und Methoden, die eine Interaktion mit einem Steuerelementobjekt und die Verwaltung des mit dem Steuerelement verbundenen Gerätekontextes ermöglichen.

TGraphicControl und TCustomControl verwenden TControlCanvas zum Anzeigen ihrer Bilder.


Eigenschaften von TControlCanvas

TControlCanvas	Alphabetisch	Legende

In TControlCanvas

Control

Abgeleitet von TCanvas

Brush

ClipRect

CopyMode

Font

Handle

Pen

PenPos

Pixels


Eigenschaften von TControlCanvas

TControlCanvas	Nach Objekten	Legende

Brush

ClipRect

Control

CopyMode

Font

Handle

PenPos

Pen

Pixels


TControlCanvas::Control

TControlCanvas	Siehe auch

Die Eigenschaft Control gibt das Steuerelement an, das mit dem Zeichenflächenobjekt verbunden ist.

__property TControl* Control;

Beschreibung

Durch das Lesen von Control erhalten Sie Zugriff auf das Steuerelement, das mit dem Zeichenflächenobjekt verbunden ist. Nachkommen von TControl, die eine Steuerelement-Zeichenfläche verwenden, stellen die Verbindung durch das Setzen der Eigenschaft Control her. Das Zeichenflächenobjekt ermittelt mit Hilfe der Eigenschaft Control Informationen über sein verbundenes Steuerelement.


Ereignisse von TControlCanvas

TControlCanvas	Alphabetisch

Abgeleitet von TCanvas

OnChange

OnChanging


Ereignisse von TControlCanvas

TControlCanvas	Nach Objekten

OnChange

OnChanging


Methoden von TControlCanvas

TControlCanvas	Alphabetisch

Abgeleitet von Tcanvas

TextWidth

In TControlCanvas

~TControlCanvas

FreeHandle

TControlCanvas

Abgeleitet von TCanvas

Arc

BrushCopy

Chord

CopyRect

Draw

DrawFocusRect

Ellipse

FillRect

FloodFill

FrameRect

LineTo

MoveTo

Pie

Polygon

Polyline

Rectangle

Refresh

RoundRect

StretchDraw

TextHeight

TextOut

TextRect

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TControlCanvas

TControlCanvas	Nach Objekten

~TControlCanvas

Arc

Assign

BrushCopy

Chord

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

CopyRect

DefaultHandler

Dispatch

DrawFocusRect

Draw

Ellipse

FieldAddress

FillRect

FloodFill

FrameRect

FreeHandle

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

LineTo

MethodAddress

MethodName

MoveTo

NewInstance

Pie

Polygon

Polyline

Rectangle

Refresh

RoundRect

StretchDraw

TControlCanvas

TextHeight

TextOut

TextRect

TextWidth


TControlCanvas::~TControlCanvas

TControlCanvas	Siehe auch

Der Destruktor ~TControlCanvas gibt den Speicher frei, der für das TControlCanvas-Objekt reserviert war. Rufen Sie ~TControlCanvas nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TControlCanvas automatisch aufgerufen wird.

__fastcall virtual ~TControlCanvas(void);

Beschreibung

~TControlCanvas gibt zunächst das Handle auf den Gerätekontext (HDC) frei, der von dem Zeichenflächenobjekt verwendet wird. Erst dann erfolgt die Freigabe des Speichers, der dem Objekt zugewiesen ist.


TControlCanvas::FreeHandle

TControlCanvas	Siehe auch

FreeHandle gibt das Handle auf den Gerätekontext (HDC) frei, der von dem Zeichenflächenobjekt verwendet wird.

void __fastcall FreeHandle(void);

Beschreibung

Durch einen Aufruf von FreeHandle geben Sie den HDC frei, den das Zeichenflächenobjekt verwendet. FreeHandle setzt die Eigenschaft Handle auf NULL. Nach dem Aufruf von FreeHandle wird ein neuer HDC angefordert, sobald eine Zeichenmethode aufgerufen wird.

Hinweis

Das Setzen der Handle-Eigenschaft auf NULL führt nicht zur Freigabe des HDC. Wenn der HDC von der Anwendung freigegeben wird, rufen Sie nicht FreeHandle auf, sondern setzen die Eigenschaft Handle auf NULL.


TControlCanvas::TControlCanvas

TControlCanvas

Der Konstruktor TControlCanvas erzeugt ein neues TControlCanvas-Objekt..

__fastcall TControlCanvas(void);


Gültigkeitsbereich

Published

Zugriff

Read-only


Hierarchie

TObject

TPersistent

TCanvas


TControlCanvas Beispiel

TControlCanvas


TCustomCheckBox

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/stdctrls.hpp

TCustomCheckBox ist der Vorfahr aller Kontrollfeld-Komponenten.

Beschreibung

TCustomCheckBox ist eine abstrakte Klasse, von der Kontrollfeld-Komponenten wie z.B. TCheckBox und TDBCheckBox abstammen. Kontrollfelder bieten dem Anwender Optionen an, die entweder aktiviert (markiert) oder deaktiviert werden können.


Eigenschaften von TCustomCheckBox

TCustomCheckBox	Alphabetisch	Legende

In TCustomCheckBox

Alignment

AllowGrayed

Checked

State

Abgeleitet von TWinControl

Brush

ClientOrigin

ClientRect

ControlCount

Controls

Handle

HelpContext

Showing

TabOrder

TabStop

Abgeleitet von TControl

Align

BoundsRect

ClientHeight

ClientWidth

ControlState

ControlStyle

Cursor

Enabled

Height

Hint

Left

Name

Parent

ShowHint

Top

Visible

Width

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TCustomCheckBox

TCustomCheckBox	Nach Objekten	Legende

Alignment

Align

AllowGrayed

BoundsRect

Brush

Checked

ClientHeight

ClientOrigin

ClientRect

ClientWidth

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlCount

ControlState

Controls

ControlStyle

Cursor

DesignInfo

Enabled

Handle

Height

HelpContext

Hint

Left

Name

Owner

Parent

ShowHint

Showing

State

TabOrder

TabStop

Tag

Top

Visible

Width


TCustomCheckBox::Alignment

TCustomCheckBox	Beispiel

Die Eigenschaft Alignment steuert die Position der Beschriftung des Kontrollfeldes.

__property Classes::TLeftRight Alignment;

Beschreibung

Wenn Alignment auf taRightJustify gesetzt ist, wird die Beschriftung rechts vom Kontrollfeld angezeigt, bei taLeftJustify links vom Kontrollfeld.


TCustomCheckBox::AllowGrayed

TCustomCheckBox	Siehe auch

Die Eigenschaft AllowGrayed legt fest, ob ein Kontrollfeld grau dargestellt werden kann.

__property bool AllowGrayed;

Beschreibung

Wenn AllowGrayed den Wert TRUE hat, gibt es für das Kontrollfeld drei mögliche Zustände: markiert, nicht markiert und grau dargestellt. Hat AllowGrayed den Wert FALSE, gibt es nur die Zustände markiert und nicht markiert.


TCustomCheckBox::Checked

TCustomCheckBox	Siehe auch	Beispiel

Die Eigenschaft Checked gibt an, ob das Kontrollfeld markiert ist.

__property bool Checked;

Beschreibung

Wenn Checked TRUE ist, wird durch ein Kreuz im Kontrollfeld angezeigt, daß die Option markiert ist (State = cbChecked). Wenn Checked den Wert FALSE hat, ist das Kontrollfeld entweder nicht markiert (State = cbUnchecked) oder grau dargestellt (State = cbGrayed).


TCustomCheckBox::State

TCustomCheckBox	Siehe auch	Beispiel

Die Eigenschaft State gibt an, ob das Kontrollfeld markiert, nicht markiert oder grau dargestellt ist.

__property TCheckBoxState State;

Beschreibung

Die folgende Tabelle enthält die möglichen Werte von State:

Wert	Bedeutung

cbUnchecked	Im Kontrollfeld wird kein Kreuz angezeigt. Der Benutzer hat die Option nicht markiert.

cbChecked	Im Kontrollfeld wird ein Kreuz angezeigt. Der Benutzer hat die Option markiert.

cbGrayed	Im Kontrollfeld wird ein Kreuz angezeigt, das Feld wird jedoch grau dargestellt.


Methoden von TCustomCheckBox

TCustomCheckBox	Alphabetisch	Legende

In TCustomCheckBox

~TCustomCheckBox

CreateParams

CreateWindowHandle

CreateWnd

TCustomCheckBox

Toggle

Abgeleitet von TWinControl

Broadcast

CanFocus

ContainsControl

ControlAtPos

DisableAlign

EnableAlign

Focused

GetTabOrderList

HandleAllocated

HandleNeeded

InsertControl

Invalidate

PaintTo

Realign

RemoveControl

Repaint

ScaleBy

ScrollBy

SetBounds

SetFocus

Update

UpdateControlState

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

GetTextLen

Hide

Perform

Refresh

ScreenToClient

SendToBack

SetTextBuf

Show

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TCustomCheckBox

TCustomCheckBox	Nach Objekten	Legende

~TCustomCheckBox

Assign

BeginDrag

BringToFront

Broadcast

CanFocus

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

ClientToScreen

ContainsControl

ControlAtPos

CreateParams

CreateWindowHandle

CreateWnd

DefaultHandler

DestroyComponents

Destroying

DisableAlign

Dispatch

DragDrop

Dragging

EnableAlign

EndDrag

FieldAddress

FindComponent

Focused

FreeInstance

FreeNotification

Free

GetParentComponent

GetTabOrderList

GetTextBuf

GetTextLen

HandleAllocated

HandleNeeded

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InsertControl

InstanceSize

Invalidate

MethodAddress

MethodName

NewInstance

PaintTo

Perform

Realign

Refresh

RemoveComponent

RemoveControl

Repaint

ScaleBy

ScreenToClient

ScrollBy

SendToBack

SetBounds

SetFocus

SetTextBuf

Show

TCustomCheckBox

Toggle

UpdateControlState

Update


TCustomCheckBox::~TCustomCheckBox

TCustomCheckBox

Der Destruktor ~TCustomCheckBox gibt den Speicher frei, der für das TCustomCheckBox-Objekt reserviert war. Rufen Sie ~TCustomCheckBox nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TCustomCheckBox automatisch aufgerufen wird.

__fastcall virtual ~TCustomCheckBox(void);


TCustomCheckBox::CreateParams

TCustomCheckBox	Siehe auch

Die Methode CreateParams initialisiert einen Parameter-Datensatz.

virtual void __fastcall CreateParams(Controls::TCreateParams &Params);

Beschreibung

CreateParams ruft die geerbte Methode auf und nimmt dann einige Anpassungen vor, die für Kontrollfelder erforderlich sind.


TCustomCheckBox::CreateWindowHandle

TCustomCheckBox	Siehe auch

Die Methode CreateWindowHandle erzeugt ein Fenster-Handle für das Kontrollfeld.

virtual void __fastcall CreateWindowHandle(const Controls::TCreateParams &Params);

Beschreibung

CreateWindowHandle implementiert ein spezielles Verfahren, das von einigen Windows NT Systemen benötigt wird, und ruft dann die geerbte Methode auf.


TCustomCheckBox::CreateWnd

TCustomCheckBox	Siehe auch

Die Methode CreateWnd erzeugt ein dem Kontrollfeld entsprechendes Windows-Steuerelement.

virtual void __fastcall CreateWnd(void);

Beschreibung

CreateWnd ruft die geerbte Methode auf und sendet die Botschaft BM_SETCHECK, um den Markierungsstatus des Steuerelements zu setzen.


TCustomCheckBox::TCustomCheckBox

TCustomCheckBox

Die Methode erzeugt und initialisiert eine Instamz von TCustomCheckBox.

__fastcall virtual TCustomCheckBox(Classes::TComponent* AOwner);

Beschreibung

Mit TCustomCheckBox wird zur Laufzeit ein Kontrollfeld erzeugt. Für alle Kontrollfelder, die zur Entwurfszeit in einem Formular plaziert wurden, wird TCustomCheckBox automatisch aufgerufen.


TCustomCheckBox::Toggle

TCustomCheckBox	Siehe auch

Die Methode Toggle ändert den Status des Kontrollfeldes.

virtual void __fastcall Toggle(void);

Beschreibung

Mit Toggle können Sie das Kontrollfeld programmseitig markieren bzw. seine Markierung aufheben. Toggle schaltet zum nächsten zulässigen Kontrollfeld-Status um - von markiert auf nicht markiert auf grau dargestellt oder von markiert auf nicht markiert.


Gültigkeitsbereich

Protected

Published

Zugriff

Read-only


Gültigkeitsbereich

Protected


Hierarchie

TObject

TPersistent

TComponent

TControl

TWinControl

TButtonControl


TCustomCheckBox Beispiel

TCustomCheckBox


TCustomComboBox

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/stdctrls.hpp

TCustomComboBox ist der Vorfahr aller Kombinationsfelder einschließlich TComboBox, TDBComboBox, TDriveComboBox und TFilterComboBox.

Beschreibung

TCustomComboBox kapselt das Verhalten, das allen Kombinationsfeldern gemeinsam ist. Ein Kombinationsfeld ist ein Eingabefeld, mit dem eine Dropdown-Liste verknüpft ist. Der Benutzer kann einen Eintrag aus der Liste wählen oder die Eingabe manuell vornehmen.

Mit Hilfe der Eigenschaft Style können Sie wahlweise eine der beiden Eingabemöglichkeiten ausschließen.


Eigenschaften von TCustomComboBox

TCustomComboBox	Alphabetisch	Legende

In TCustomComboBox

Canvas

DropDownCount

DroppedDown

EditHandle

ItemHeight

ItemIndex

Items

ListHandle

MaxLength

SelLength

SelStart

SelText

Sorted

Style

Abgeleitet von TWinControl

Brush

ClientOrigin

ClientRect

ControlCount

Controls

Handle

HelpContext

Showing

TabOrder

TabStop

Abgeleitet von TControl

Align

BoundsRect

ClientHeight

ClientWidth

ControlState

ControlStyle

Cursor

Enabled

Height

Hint

Left

Name

Parent

ParentColor

ShowHint

Top

Visible

Width

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TCustomComboBox

TCustomComboBox	Nach Objekten	Legende

Align

BoundsRect

Brush

Canvas

ClientHeight

ClientOrigin

ClientRect

ClientWidth

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlCount

ControlState

Controls

ControlStyle

Cursor

DesignInfo

DropDownCount

DroppedDown

EditHandle

Enabled

Handle

Height

HelpContext

Hint

ItemHeight

ItemIndex

Items

Left

ListHandle

MaxLength

Name

Owner

ParentColor

Parent

SelLength

SelStart

SelText

ShowHint

Showing

Sorted

Style

TabOrder

TabStop

Tag

Top

Visible

Width


TCustomComboBox::Canvas

TCustomComboBox	Siehe auch

Die Eigenschaft Canvas ermöglicht den Zugriff auf die Zeichenoberfläche eines Kombinationsfeldes.

__property Graphics::TCanvas* Canvas;

Beschreibung

Mit der Nur-Lesen-Eigenschaft Canvas können Sie auf die Zeichenoberfläche des Kombinationsfeldes zugreifen. Auf diese Weise läßt sich eine Ereignisbehandlungsroutine für OnDrawItem implementieren.


TCustomComboBox::DropDownCount

TCustomComboBox	Beispiel

Die Eigenschaft DropDownCount legt fest, wieviele Einträge eine Dropdown-Liste darstellen kann, bevor eine Bildlaufleiste angezeigt wird.

__property int DropDownCount;

Beschreibung

Ist die Anzahl der Einträge größer als DropDownCount, erscheint auf der rechten Seite der Dropdown-Liste eine Bildlaufleiste.


TCustomComboBox::DroppedDown

TCustomComboBox

Die Eigenschaft DroppedDown gibt an, ob die Dropdown-Liste gerade angezeigt wird.

__property bool DroppedDown;

Beschreibung

DroppedDown ist True, wenn die Dropdown-Liste geöffnet ist, andernfalls False.


TCustomComboBox::EditHandle

TCustomComboBox	Siehe auch

Die Eigenschaft EditHandle bezeichnet das Handle des Eingabefeldes.

__property HWND EditHandle;

Beschreibung

Mit der Nur-Lesen-Eigenschaft EditHandle können Sie das Handle des Eingabefeldes ermitteln, das zum Kombinationsfeld gehört. Aus der Sicht von Windows ist das Eingabefeld ist ein eigenes Steuerelement und von der Dropdown-Liste unabhängig.


TCustomComboBox::ItemHeight

TCustomComboBox	Siehe auch	Beispiel

Die Eigenschaft ItemHeight gibt in Pixel die Höhe des Kombinationsfeldes und der Einträge in der Dropdown-Liste an.

__property int ItemHeight;

Beschreibung

Wenn die Eigenschaft Style auf csOwnerDrawFixed oder csOwnerDrawVariable gesetzt ist, können Sie mit ItemHeight die Höhe des Kombinationsfeldes und der einzelnen Einträge in der Dropdown-Liste festlegen. Bei jedem anderen Wert von Style hat die Eigenschaft ItemHeight keine Funktion.


TCustomComboBox::ItemIndex

TCustomComboBox	Siehe auch	Beispiel

Die Eigenschaft ItemIndex bezeichnet die Position des ausgewählten Eintrags in der Dropdown-Liste.

__property int ItemIndex;

Beschreibung

ItemIndex ist eine Ordnungszahl, die die Position des momentan ausgewählten Eintrags in der Dropdown-Liste des Kombinationsfeldes angibt. Der entsprechende Eintrag wird im Eingabefeld angezeigt. Der erste Eintrag in der Liste hat den Index 0. Wenn kein Eintrag ausgewählt ist, hat ItemIndex den Wert -1.


TCustomComboBox::Items

TCustomComboBox	Siehe auch

Die Eigenschaft Items enthält die Einträge (die Strings) der Dropdown-Liste.

__property Classes::TStrings* Items;

Beschreibung

Die Eigenschaft Items enthält die Strings, die in der Dropdown-Liste des Kombinationsfeldes angezeigt werden. Bei den Nachkommen von TCustomComboBox, die diese Eigenschaft als published deklarieren (TComboBox, TDBComboBox, TDriveComboBox und TFilterComboBox), können Sie mit Hilfe des Objektinspektors Einträge einfügen und löschen.


TCustomComboBox::ListHandle

TCustomComboBox	Siehe auch

Die Eigenschaft ListHandle enthält das Handle der Dropdown-Liste.

__property HWND ListHandle;

Beschreibung

Die Nur-Lesen-Eigenschaft ListHandle gibt das Handle der Dropdown-Liste zurück, die zu dem Kombinationsfeld gehört. Aus der Sicht von Windows ist die Dropdown-Liste ein eigenes Steuerelement und vom Eingabefeld unabhängig.


TCustomComboBox::MaxLength

TCustomComboBox	Beispiel

Die Eigenschaft MaxLength legt in Zeichen die maximale Länge für manuell eingegebenen Text fest.

__property int MaxLength;

Beschreibung

Die Eigenschaft MaxLength legt fest, wieviele Zeichen der Benutzer maximal in das Eingabefeld eingeben kann. Sie wirkt sich nicht auf die Länge von Strings aus, die in der Dropdown-Liste angeboten werden.

Hinweis

Wenn MaxLength den Wert 0 hat, können beliebig viele Zeichen eingegeben werden.


TCustomComboBox::SelLength

TCustomComboBox	Siehe auch	Beispiel

Die Eigenschaft SelLength gibt in Zeichen die Länge des Textes an, der im Eingabefeld hervorgehoben dargestellt wird.

__property int SelLength;

Beschreibung

Mit SelLength können Sie ermitteln, wieviele Zeichen im Eingabefeld markiert (hervorgehoben) sind.

Wenn Sie den Wert von SelLength ändern, muß das Kombinationsfeld das aktive Steuerelement sein, da sonst keine Markierung durchgeführt wird.


TCustomComboBox::SelStart

TCustomComboBox	Siehe auch

Die Eigenschaft SelStart gibt die Position des ersten markierten Zeichens im Eingabefeld an.

__property int SelStart;

Beschreibung

Mit SelStart können Sie ermitteln, bei welchem Zeichen der markierte Textabschnitt im Eingabefeld beginnt. Der Wert 0 steht für das erste Zeichen des Eingabefeldes, 1 für das zweite usw.

Wenn Sie den Wert von SelStart ändern, muß das Kombinationsfeld das aktive Steuerelement sein, da sonst keine Markierung durchgeführt wird.


TCustomComboBox::SelText

TCustomComboBox	Siehe auch	Beispiel

Die Eigenschaft SelText enthält das im Eingabefeld markierte Textsegment.

__property System::AnsiString SelText;

Beschreibung

SelText enthält den im Eingabefeld markierten Textabschnitt. SelStart gibt das erste Zeichen des markierten Textes zurück, SelLength seine Länge. Hat beispielsweise SelStart den Wert 0 und SelLength den Wert 5, enthält SelText die ersten fünf Zeichen des Textes im Eingabefeld.

Wenn kein Text markiert ist, während dieser Eigenschaft ein Wert zugewiesen wird, wird der String von SelText an der Cursorposition in den Text eingefügt. Wenn Sie den Wert von SelText ändern, muß das Kombinationsfeld das aktive Steuerelement sein, da sonst keine Markierung durchgeführt wird.


TCustomComboBox::Sorted

TCustomComboBox	Beispiel

Mit der Eigenschaft Sorted können Sie die Dropdown-Liste alphabetisch sortieren.

__property bool Sorted;

Beschreibung

Wenn Sorted True ist, werden die Einträge der Dropdown-Liste automatisch in alphabetischer Reihenfolge angezeigt.


TCustomComboBox::Style

TCustomComboBox	Siehe auch

Mit der Eigenschaft Style können Sie festlegen, wie das Kombinationsfeld angezeigt wird.

__property TComboBoxStyle Style;

Beschreibung

Die möglichen Werte für Style sind:

Wert	Bedeutung

csDropDown	csDropDown erzeugt eine Dropdown-Liste mit einem Eingabefeld für die manuelle Eingabe von Text. Alle Einträge sind Strings und haben dieselbe Höhe.

csSimple	csSimple erzeugt ein Eingabefeld mit einem darunter fixierten Listenfeld. Die Liste ist zur Laufzeit nur sichtbar, wenn das Kombinationsfeld die entsprechende Ausdehnung hat.

csDropDownList	csDropDownList erzeugt eine Dropdown-Liste ohne Eingabefeld. Der Benutzer kann manuell keinen Text eingeben. Alle Einträge sind Strings und haben dieselbe Höhe.

csOwnerDrawFixed	csOwnerDrawFixed erzeugt eine Dropdown-Liste mit einem Eingabefeld für die manuelle Eingabe von Text. Alle Einträge des Kombinationsfeldes haben die Höhe, die in der Eigenschaft ItemHeight festgelegt ist.

csOwnerDrawVariable	csOwnerDrawVariable erzeugt eine Dropdown-Liste mit einem Eingabefeld für die manuelle Eingabe von Text. Die Einträge des Kombinationsfeldes können unterschiedlich hoch sein.

Owner-Draw-Kombinationsfelder (csOwnerDrawFixed und csOwnerDrawVariable) können zusammen mit dem Text oder anstelle des Textes Grafiken anzeigen. Sobald in einem Owner-Draw-Kombinationsfeld ein Eintrag angezeigt wird, tritt das Ereignis OnDrawItem ein. Um eine Grafik darzustellen, schreiben Sie eine Ereignisbehandlungsroutine für OnDrawItem. Wenn Style den Wert csOwnerDrawVariable hat, tritt zusätzlich das Ereignis OnMeasureItem ein. Mit einer Ereignisbehandlungsroutine für OnMeasureItem können Sie die Höhe des Eintrags festlegen. Hat Style den Wert csOwnerDrawFixed (oder ist mit OnMeasureItem keine Ereignisbehandlungsroutine verknüpft), wird die Höhe aller Einträge durch die Eigenschaft ItemHeight festgelegt.


Ereignisse von TCustomComboBox

TCustomComboBox	Alphabetisch	Legende

In TCustomComboBox

OnChange

OnDrawItem

OnDropDown

OnMeasureItem


Ereignisse von TCustomComboBox

TCustomComboBox	Nach Objekten	Legende

OnChange

OnDrawItem

OnDropDown

OnMeasureItem


TCustomComboBox::OnChange

TCustomComboBox	Siehe auch

Das Ereignis OnChange tritt ein, wenn Text in das Eingabefeld eingegeben oder ein Eintrag aus der Dropdown-Liste ausgewählt wird.

__property Classes::TNotifyEvent OnChange;

Beschreibung

Mit einer Ereignisbehandlungsroutine für OnChange können Sie bestimmte Aktionen durchführen, wenn der Text im Kombinationsfeld geändert wird.


TCustomComboBox::OnDrawItem

TCustomComboBox	Siehe auch

Das Ereignis OnDrawItem tritt ein, wenn ein Eintrag in einem Owner-Draw-Kombinationsfeld neu angezeigt werden muß.

__property TDrawItemEvent OnDrawItem;

Beschreibung

Mit einer Ereignisbehandlungsroutine für OnDrawItem können Sie die Einträge der Dropdown-Liste neu anzeigen. OnDrawItem übergibt seiner Ereignisbehandlungsroutine vier Parameter:

•	Eine Referenz auf das Kombinationsfeld, das den Eintrag enthält.

•	Den Index des Eintrags in der Eigenschaft Items (einem TStrings-Objekt).

•	Ein Rechteck (TRect), in dem gezeichnet wird.

•	Den Status des Eintrags, der einen der folgenden Werte annehmen kann:

Wert	Bedeutung

odSelected	Der Eintrag ist ausgewählt.

odGrayed	Der Eintrag wird grau dargestellt.

odDisabled	Die Dropdown-Liste ist momentan deaktiviert.

odChecked	Der Eintrag ist markiert.

odFocused	Der Eintag ist fokussiert.

OnDrawItem wird nur ausgelöst, wenn Style auf csOwnerDrawFixed oder csOwnerDrawVariable gesetzt ist.


TCustomComboBox::OnDropDown

TCustomComboBox	Siehe auch

Das Ereignis OnDropDown tritt ein, wenn der Benutzer auf den Pfeil rechts des Eingabefeldes klickt und dadurch die Dropdown-Liste öffnet.

__property Classes::TNotifyEvent OnDropDown;

Beschreibung

Mit einer Ereignisbehandlungsroutine für OnDropDown können Sie bestimmte Aktionen durchführen, wenn die Dropdown-Liste aktiviert wird.


TCustomComboBox::OnMeasureItem

TCustomComboBox

Das Ereignis OnMeasureItem tritt ein, wenn in einem Kombinationsfeld mit dem Stil csOwnerDrawVariable ein Eintrag neu angezeigt werden muß.

__property TMeasureItemEvent OnMeasureItem;

Wenn die Eigenschaft Style auf csOwnerDrawVariable gesetzt ist, geht dem Ereignis OnDrawItem immer das Ereignis OnMeasureItem voraus. Mit einer Ereignisbehandlungsroutine für OnMeasureItem können Sie die Größe eines Eintrags in der Dropdown-Liste festlegen.

OnMeasureItem übergibt seiner Ereignisbehandlungsroutine drei Parameter:

•	Eine Referenz auf das Kombinationsfeld, das den Eintrag enthält.

•	Den Index des Eintrags in der Eigenschaft Items (ein TStrings-Objekt).

•	Die Höhe des Eintrags in Pixel.

Der letzte Parameter (Height) kann von der Ereignisbehandlungsroutine auf einen geeigneten Wert zurückgesetzt werden.

Beschreibung

Eigenschaft Items, Ereignis OnDrawItem, Eigenschaft Style, Objekt TStrings, Objekt TWinControl


Methoden von TCustomComboBox

TCustomComboBox	Alphabetisch	Legende

In TCustomComboBox

~TCustomComboBox

Change

Clear

ComboWndProc

CreateParams

CreateWnd

DestroyWnd

DrawItem

DropDown

MeasureItem

SelectAll

SetStyle

TCustomComboBox

WndProc

Abgeleitet von TWinControl

Broadcast

CanFocus

ContainsControl

ControlAtPos

DisableAlign

EnableAlign

Focused

GetTabOrderList

HandleAllocated

HandleNeeded

InsertControl

Invalidate

PaintTo

Realign

RemoveControl

Repaint

ScaleBy

ScrollBy

SetBounds

SetFocus

Update

UpdateControlState

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

GetTextLen

Hide

Perform

Refresh

ScreenToClient

SendToBack

SetTextBuf

Show

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TCustomComboBox

TCustomComboBox	Nach Objekten	Legende

~TCustomComboBox

Assign

BeginDrag

BringToFront

Broadcast

CanFocus

Change

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

Clear

ClientToScreen

ComboWndProc

ContainsControl

ControlAtPos

CreateParams

CreateWnd

DefaultHandler

DestroyComponents

Destroying

DestroyWnd

DisableAlign

Dispatch

DragDrop

Dragging

DrawItem

DropDown

EnableAlign

EndDrag

FieldAddress

FindComponent

Focused

FreeInstance

FreeNotification

Free

GetParentComponent

GetTabOrderList

GetTextBuf

GetTextLen

HandleAllocated

HandleNeeded

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InsertControl

InstanceSize

Invalidate

MeasureItem

MethodAddress

MethodName

NewInstance

PaintTo

Perform

Realign

Refresh

RemoveComponent

RemoveControl

Repaint

ScaleBy

ScreenToClient

ScrollBy

SelectAll

SendToBack

SetBounds

SetFocus

SetStyle

SetTextBuf

Show

TCustomComboBox

UpdateControlState

Update

WndProc


TCustomComboBox::~TCustomComboBox

TCustomComboBox	Siehe auch

Der Destruktor ~TCustomComboBox gibt den Speicher frei, der für das TCustomComboBox-Objekt reserviert war. Rufen Sie ~TCustomComboBox nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TCustomComboBox automatisch aufgerufen wird.

__fastcall virtual ~TCustomComboBox(void);


TCustomComboBox::Change

TCustomComboBox	Siehe auch

Die Methode Change löst das Ereignis OnChange aus.

virtual void __fastcall Change(void);

Beschreibung

Change ist die als protected deklarierte Methode zur Implementierung des Ereignisses OnChange. Die Methode ruft lediglich die Ereignisbehandlungsroutine auf, der mit OnChange verknüpft ist. Überschreiben Sie Change, wenn Sie zusätzliche Bearbeitungsschritte durchführen wollen.


TCustomComboBox::Clear

TCustomComboBox

Die Methode Clear löscht den gesamten Text im Eingabefeld und alle Einträge in der Dropdown-Liste.

void __fastcall Clear(void);

Beschreibung

Mit Clear können Sie das Kombinationsfeld zur Laufzeit leeren. Die Methode löscht den gesamten Text im Eingabefeld und alle Einträge in der Dropdown-Liste.


TCustomComboBox::ComboWndProc

TCustomComboBox	Siehe auch

Die Methode ComboWndProc ermöglicht es dem Kombinationsfeld, auf Botschaften zu reagieren.

virtual void __fastcall ComboWndProc(Messages::TMessage &Message, HWND ComboWnd, void * ComboProc);

Beschreibung

Indem Sie ComboWndProc überschreiben, können Sie die Reaktion des Kombinationsfeldes auf Windows-Botschaften festlegen.


TCustomComboBox::CreateParams

TCustomComboBox	Siehe auch

Die Methode CreateParams initialisiert einen Parameterdatensatz, mit dem das Fenster erzeugt wird.

virtual void __fastcall CreateParams(Controls::TCreateParams &Params);

Beschreibung

Die Methode CreateWnd ruft CreateParams auf, um die Parameter zu initialisieren, die der Methode CreateWindowHandle übergeben werden. Indem Sie CreateParams überschreiben, können Sie festlegen, wie sich das Kombinationsfeld aus der Sicht von Windows darstellt.


TCustomComboBox::CreateWnd

TCustomComboBox	Siehe auch

Die Methode CreateWnd erzeugt ein Windows-Steuerelement, das dem Kombinationsfeld entspricht.

virtual void __fastcall CreateWnd(void);

Beschreibung

CreateWnd ruft zuerst die geerbte Methode CreateWnd auf und initialisiert anschließend die Parameter, die für ein Kombinationsfeld spezifisch sind.


TCustomComboBox::DestroyWnd

TCustomComboBox	Siehe auch

Die Methode DestroyWnd gibt das Windows-Handle des Kombinationsfeldes frei.

virtual void __fastcall DestroyWnd(void);

Beschreibung

DestroyWnd speichert den Inhalt der Dropdown-Liste, bevor die geerbte Methode DestroyWnd aufgerufen wird.


TCustomComboBox::DrawItem

TCustomComboBox	Siehe auch

Die Methode DrawItem löst das Ereignis OnDrawItem aus.

virtual void __fastcall DrawItem(int Index, const Windows::TRect &Rect,  TOwnerDrawState State);

Beschreibung

DrawItem ist die als protected deklarierte Methode zur Implementierung des Ereignisses OnDrawItem. Das Kombinationsfeld ruft diese Methode für jeden Eintrag der Liste auf und übergibt ihr den Index und den Status des Eintrags (odSelected, odGrayed, odDisabled, odChecked oder odFocused). Wenn für OnDrawItem eine Ereignisbehandlungsroutine existiert, wird diese von DrawItem aufgerufen. Andernfalls füllt DrawItem das in Rect übergebene Rechteck und stellt den Text dar, der dem betreffenden Eintrag zugeordnet ist, wobei der Parameter State ignoriert wird.


TCustomComboBox::DropDown

TCustomComboBox	Siehe auch

Die Methode DropDown löst das Ereignis OnDropDown aus.

virtual void __fastcall DropDown(void);

Beschreibung

DropDown ist die als protected deklarierte Methode zur Implementierung des Ereignisses OnDropDown. Die Methode ruft lediglich die Ereignisbehandlungsroutine auf, die mit OnDropDown verknüpft ist. Überschreiben Sie DropDown, um zusätzliche Bearbeitungsschritte durchzuführen.


TCustomComboBox::MeasureItem

TCustomComboBox	Siehe auch

Die Methode MeasureItem löst das Ereignis OnMeasureItem aus.

virtual void __fastcall MeasureItem(int Index, int &Height);

Beschreibung

MeasureItem ist die als protected deklarierte Methode zur Implementierung des Ereignisses OnMeasureItem. Die Methode ruft lediglich die Ereignisbehandlungsroutine auf, die mit OnMeasureItem verknüpft ist. Überschreiben Sie MeasureItem, um zusätzliche Bearbeitungsschritte durchzuführen.


TCustomComboBox::SelectAll

TCustomComboBox	Siehe auch	Beispiel

Die Methode SelectAll können Sie den gesamten Text im Eingabefeld markieren.

void __fastcall SelectAll(void);

Beschreibung

SelectAll markiert den gesamten Text des Eingabefeldes. Mit Hilfe der Eigenschaften SelStart und SelLength können Sie einen Text teilweise markieren.


TCustomComboBox::SetStyle

TCustomComboBox	Siehe auch

Die Methode SetStyle weist den Eigenschaften Style und ControlStyle Werte zu.

virtual void __fastcall SetStyle(TComboBoxStyle Value);

Beschreibung

SetStyle setzt die Eigenschaft Style auf den in Value übergebenen Wert und fügt anschließend der Eigenschaft ControlStyle das Flag csFixedHeight hinzu (wenn Style den Wert csSimple hat, wird csFixedHeight aus ControlStyle gelöscht). Zuletzt gibt SetStyle das Fenster-Handle des Kombinationsfeldes frei und weist ihm ein neues Handle zu.


TCustomComboBox::TCustomComboBox

TCustomComboBox

Der Konstruktor TCustomComboBox erzeugt ein neues TCustomComboBox-Objekt.

__fastcall virtual TCustomComboBox(Classes::TComponent* AOwner);

Beschreibung

Mit TCustomComboBox wird zur Laufzeit ein neues Kombinationsfeld erzeugt.


TCustomComboBox::WndProc

TCustomComboBox	Siehe auch

Die Methode WndProc empfängt Botschaften für das Kombinationsfeld und schirmt sie ab.

virtual void __fastcall WndProc(Messages::TMessage &Message);

Beschreibung

WndProc schirmt jede Botschaft ab, bevor sie an Dispatch übergeben wird. Dispatch entscheidet dann, von welcher Methode die Botschaft verarbeitet wird.


Gültigkeitsbereich

Protected

Published

Zugriff

Read-only


Gültigkeitsbereich

Protected


Gültigkeitsbereich

Protected


Hierarchie

TObject

TPersistent

TComponent

TControl

TWinControl


TCustomComboBox Beispiel

TCustomComboBox


TCustomControl

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/controls.hpp

Die Komponente TCustomControl ist die abstrakte Basisklasse, von der Fenstersteuerelemente abgeleitet werden, die für die Erstellung komplexer Bilder eine Zeichenfläche unterstützen müssen.

Beschreibung

Standard-Fenstersteuerelemente sind Bestandteil von Windows, besitzen die nötige Anzeigefunktionalität. Deshalb wird beispielsweise eine Schaltflächen- oder Kontrollkästchenkomponente direkt von TWinControl abgeleitet. Fenstersteuerelemente, die keiner Standardkomponente von Windows entsprechen, dürfen daher nicht direkt von TWinControl, sondern müssen von TCustomControl abgeleitet werden. TCustomControl stellt neben der Eigenschaft Canvas zur Verwaltung der Zeichenoberfläche eine virtuelle Methode Paint bereit, die zur Beantwortung von WM_PAINT-Botschaften aufgerufen wird. Das Zeichnen von Fenstersteuerelementen wird so erleichtert.

Benutzerdefinierte Steuerelemente, die nicht den Eingabefokus erhalten müssen, leiten Sie nicht von TCustomControl, sondern von TGraphicControl ab. Damit läßt sich der für ein Fenstersteuerelement typische Rechenaufwand vermeiden. Für das Zeichnen eines Fenstersteuerelements wird mehr Zeit benötigt, als für den Aufbau eines grafischen Steuerelements.


Eigenschaften von TCustomControl

TCustomControl	Alphabetisch	Legende

In TCustomControl

Canvas

Abgeleitet von TWinControl

Brush

ClientOrigin

ClientRect

ControlCount

Controls

Handle

HelpContext

Showing

TabOrder

TabStop

Abgeleitet von TControl

Align

BoundsRect

ClientHeight

ClientWidth

ControlState

ControlStyle

Cursor

Enabled

Height

Hint

Left

Name

Parent

ShowHint

Top

Visible

Width

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TCustomControl

TCustomControl	Nach Objekten	Legende

Align

BoundsRect

Brush

Canvas

ClientHeight

ClientOrigin

ClientRect

ClientWidth

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlCount

ControlState

Controls

ControlStyle

Cursor

DesignInfo

Enabled

Handle

Height

HelpContext

Hint

Left

Name

Owner

Parent

ShowHint

Showing

TabOrder

TabStop

Tag

Top

Visible

Width


TCustomControl::Canvas

TCustomControl	Siehe auch

Die Eigenschaft Canvas ist ein TCanvas-Objekt, das eine Zeichenoberfläche für das Steuerelement bereitstellt, in dem gezeichnet werden soll.

__property Graphics::TCanvas* Canvas;

Beschreibung

Mit den Eigenschaften des TCanvas-Objekts können Sie auf der Oberfläche des Steuerelements zeichnen. Canvas kapselt einen Windows-Gerätekontext, der alle Werkzeuge und Methoden zum Zeichnen zur Verfügung stellt.

Canvas ist eine Protected-Eigenschaft, die normalerweise in Nachkommen von TCustomControl als public neu deklariert wird.


Methoden von TCustomControl

TCustomControl	Alphabetisch	Legende

In TCustomControl

~TCustomControl

Paint

PaintWindow

TCustomControl

Abgeleitet von TWinControl

Broadcast

CanFocus

ContainsControl

ControlAtPos

DisableAlign

EnableAlign

Focused

GetTabOrderList

HandleAllocated

HandleNeeded

InsertControl

Invalidate

PaintTo

Realign

RemoveControl

Repaint

ScaleBy

ScrollBy

SetBounds

SetFocus

Update

UpdateControlState

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

GetTextLen

Hide

Perform

Refresh

ScreenToClient

SendToBack

SetTextBuf

Show

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TCustomControl

TCustomControl	Nach Objekten	Legende

~TCustomControl

Assign

BeginDrag

BringToFront

Broadcast

CanFocus

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

ClientToScreen

ContainsControl

ControlAtPos

DefaultHandler

DestroyComponents

Destroying

DisableAlign

Dispatch

DragDrop

Dragging

EnableAlign

EndDrag

FieldAddress

FindComponent

Focused

FreeInstance

FreeNotification

Free

GetParentComponent

GetTabOrderList

GetTextBuf

GetTextLen

HandleAllocated

HandleNeeded

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InsertControl

InstanceSize

Invalidate

MethodAddress

MethodName

NewInstance

Paint

PaintTo

PaintWindow

Perform

Realign

Refresh

RemoveComponent

RemoveControl

Repaint

ScaleBy

ScreenToClient

ScrollBy

SendToBack

SetBounds

SetFocus

SetTextBuf

Show

TCustomControl

UpdateControlState

Update


TCustomControl::~TCustomControl

TCustomControl	Siehe auch

Der Destruktor ~TCustomControl gibt den Speicher frei, der für das TCustomControl-Objekt reserviert war. Rufen Sie ~TCustomControl nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TCustomControl automatisch aufgerufen wird.

__fastcall virtual ~TCustomControl(void);


TCustomControl::Paint

TCustomControl	Siehe auch

Die Methode Paint erstellt das Bild eines benutzerdefinierten Steuerelements.

virtual void __fastcall Paint(void);

Beschreibung

Durch Überschreiben der Methode Paint legen Sie fest, wie das Bild des Steuerelements gezeichnet wird.

Die Methode Paint für TCustomControl stellt lediglich eine Schnittstelle für eine Methode zur Verfügung, die WM_PAINT-Botschaften beantwortet. Paint wird von der Methode PaintWindow aufgerufen, nachdem diese die Zeichenfläche mit dem Handle auf einen Gerätekontext zur Verfügung gestellt hat. Bei der Erstellung eines benutzerdefinierten Steuerelements muß die Methode Paint immer überschrieben werden, damit das Bild des Steuerelements gezeichnet wird.

Siehe auch

Methode PaintWindow, Eigenschaft Canvas, Methode TWinControl::GetDeviceContext


TCustomControl::PaintWindow

TCustomControl	Siehe auch

Die Methode PaintWindow stellt einen Gerätekontext für die Zeichenfläche zur Verfügung und erstellt das Bild des Steuerelements durch einen Aufruf der Methode Paint.

virtual void __fastcall PaintWindow(HDC DC);

Beschreibung

Durch Überschreiben von PaintWindow können sie zusätzliche Antworten auf die WM_PAINT-Botschaft bereitstellen.

Wenn ein benutzerdefiniertes Steuerelement eine WM_PAINT-Botschaft empfängt, wird diese von der Methode PaintWindow beantwortet. PaintWindow stellt einen Windows-Gerätekontext für die Zeichenfläche zur Verfügung, ruft die Methode Paint auf und entfernt anschließend den Gerätekontext wieder. Durch Überschreiben der Methode Paint zeichnen Sie das Bild des Steuerelements.


TCustomControl::TCustomControl

TCustomControl	Siehe auch

TCustomControl ist der Konstruktor für TCustomControl.

__fastcall virtual TCustomControl(Classes::TComponent* AOwner);

Beschreibung

TCustomControl erstellt und initialisiert ein neues benutzerdefiniertes Steuerelement und fügt es in seinen Eigentümer ein. Dazu wird die Methode InsertComponent des Eigentümers aufgerufen, der wiederum im Parameter AOwner angegeben wird.

Nach dem Aufruf des geerbten Konstruktors erzeugt TCustomControl die Zeichenfläche für das benutzerdefinierte Steuerelement.

Fast jedes Steuerelement überschreibt TCustomControl, um die spezifischen Eigenschaften zu initialisieren. Beim Überschreiben von TCustomControl muß zuerst die geerbte TCustomControl aufgerufen werden. Anschließend können Sie mit der Initialisierung der Komponente fortfahren.


Gültigkeitsbereich

Protected

Published

Zugriff

Read-only


Gültigkeitsbereich

Protected


Hierarchie

TObject

TPersistent

TComponent

TControl

TWinControl


TCustomControl Beispiel

TCustomControl


TCustomDBGrid

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/dbgrids.hpp

TCustomDBGrid ist die abstrakte Basisklasse für Gitter, in denen die Datensätze einer Datenmenge tabellarisch angezeigt werden.

Beschreibung

Um die Funktionalität des TCustomGrid-Objekts zur Anzeige der Felder einer Datenmenge zu erweitern, besitzt das TCustomDBGrid-Objekt neue Eigenschaften, Ereignisse und Methoden. Zur Laufzeit können die TCustomDBGrid-Objekte mit dem TDBNavigator-Objekt bearbeitet werden.

Erstellen Sie keine Instanzen von TCustomDBGrid. Mit TCustomDBGrid als Basisklasse können Sie Gitter deklarieren, in denen die Daten aus Datenmengen angezeigt werden. Die Eigenschaften und Methoden von TCustomDBGrid stellen sowohl grundlegendes Verhalten zur Verfügung, das untergeordnete Klassen erben, als auch Verhalten, das von Komponenten überschrieben werden kann, um ihr Verhalten anzupassen.


Eigenschaften von TCustomDBGrid

TCustomDBGrid	Alphabetisch	Legende

In TCustomDBGrid

Columns

DataLink

DataSource

DefaultDrawing

FieldCount

Fields

IndicatorOffset

LayoutLock

Options

ReadOnly

SelectedField

SelectedIndex

SelectedRows

TitleFont

UpdateLock

Abgeleitet von TCustomGrid

EditorMode

Abgeleitet von TWinControl

Brush

ClientOrigin

ClientRect

ControlCount

Controls

Handle

HelpContext

ParentWindow

Showing

TabOrder

TabStop

Abgeleitet von TControl

Align

BoundsRect

ClientHeight

ClientWidth

ControlState

ControlStyle

Cursor

Enabled

Height

Hint

Left

Name

Parent

ParentColor

ShowHint

Top

Visible

Width

WindowProc

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TCustomDBGrid

TCustomDBGrid	Nach Objekten	Legende

Align

BoundsRect

Brush

ClientHeight

ClientOrigin

ClientRect

ClientWidth

Columns

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlCount

ControlState

Controls

ControlStyle

Cursor

DataLink

DataSource

DefaultDrawing

DesignInfo

EditorMode

Enabled

FieldCount

Fields

Handle

Height

HelpContext

Hint

IndicatorOffset

LayoutLock

Left

Name

Options

Owner

ParentColor

Parent

ParentWindow

ReadOnly

SelectedField

SelectedIndex

SelectedRows

ShowHint

Showing

TabOrder

TabStop

Tag

TitleFont

Top

UpdateLock

Visible

Width

WindowProc


TCustomDBGrid::Columns

TCustomDBGrid	Siehe auch

Die Eigenschaft Columns beschreibt die Anzeigeattribute und die Feldzuordnungen der Spalten im TCustomDBGrid-Objekt.

__property TDBGridColumns* Columns;

Beschreibung

Mit Columns können Sie die Feldzuordnungen und Anzeigeattribute der im datensensitiven Gitter enthaltenen Spalten lesen und einstellen. Die Eigenschaft enthält eine indizierte Gruppe von TColumn-Objekten. Mit den Eigenschaften der TColumn-Objekte können Sie die Anzeigeattribute und die Feldzuordnung der einzelnen Spalten im Gitter festlegen. Die Feldzuordnung einer Spalte bezeichnet ein Feld der Datenmenge, die in der Eigenschaft DataSource angegeben wird.

Columns kann während des Entwurfs mit dem Spalteneditor und zur Laufzeit im Programm eingestellt werden.


TCustomDBGrid::DataLink

TCustomDBGrid	Siehe auch

Mit der Eigenschaft DataLink kann das datensensitive Gitter seine Verbindung zur Datenquelle verwalten und auf Ereignisse reagieren.

__property TGridDataLink* DataLink;

Beschreibung

In Anwendungen sollte die Eigenschaft DataLink nicht verwendet werden. Bei ihr handelt es sich um eine geschützte Methode. Komponentenprogrammierer können somit Datengitter erstellen, die mit den Nachkommen des TGridDataLink-Objekts auf zusätzliche Datenereignisse reagieren können.

Mit Hilfe von DataLink kann das TCustomDBGrid-Objekt folgende Aktionen durchführen:

•	Die in Columns festgelegten Feldzuordnungen der Felder der Datenmenge können gelöst werden.

•	Das Objekt kann auf €nderungen der Feldwerte reagieren.

•	Das Objekt kann auf €nderungen des aktuellen Datensatzes reagieren.

•	Das Objekt kann auf €nderungen des Bearbeitungsmodus der Datenmenge reagieren.

•	Nicht eingetragene Bearbeitungen können überwacht und gegebenenfalls verworfen oder eingetragen werden.


TCustomDBGrid::DataSource

TCustomDBGrid	Siehe auch

Die Eigenschaft DataSource bezeichnet die Verbindung zur Datenmenge, aus der das datensensitive Gitter Daten abruft.

__property Db::TDataSource* DataSource;

Beschreibung

Weisen Sie DataSource das TDataSource-Objekt zu, das mit der Datenmenge verbunden ist, aus der das datensensitive Gitter Daten abruft. Mit Hilfe von DataSource kann das datensensitive Gitter die Datenmenge lesen, beschreiben und durchsuchen. Dabei wird der Datensatzzugriff mit anderen datensensitiven Objekten, die dieselbe Datenquelle verwenden, automatisch verwaltet.


TCustomDBGrid::DefaultDrawing

TCustomDBGrid	Siehe auch 	Beispiel

Die Eigenschaft DefaultDrawing zeigt an, ob die Zellen im datensensitiven Gitter automatisch gezeichnet werden, oder ob in der Anwendung mit dem Ereignis OnDrawColumnCell eine benutzerdefinierte Anzeigeroutine bereitgestellt wird.

__property bool DefaultDrawing;

Beschreibung

Durch Einstellen von DefaultDrawing auf True kann das datensensitive Gitter die Daten in den Zellen automatisch anzeigen. Durch Einstellen der Eigenschaft auf False können Sie die Standardanzeige deaktivieren, wenn in einer Ereignisbehandlungsroutine für OnDrawColumnCell oder OnDrawDataCell eine benutzerdefinierte Anzeigeroutine bereitgestellt wird.

Ist der Wert True, entnimmt das datensensitive Gitter die Daten für die einzelnen Zellen dem entsprechenden Eintrag im Array Fields und schreibt ihn in die Zelle. Anschließend wird das Fokusrechteck angezeigt, falls die Zelle den Fokus besitzt oder falls die Eigenschaft Options den Wert dgAlwaysShowSelection enthält.

Ist der Wert False, wird die Hintergrundfarbe der Zelle angezeigt und der Pinsel und die Schrift eingerichtet, die im entsprechenden TColumn-Objekt beschrieben werden. Jedoch wird der Wert des Feldes nicht in die Zelle geschrieben, und das Fokusrechteck wird ebenfalls nicht angezeigt.


TCustomDBGrid::FieldCount

TCustomDBGrid	Siehe auch

Die Eigenschaft FieldCount enthält die Anzahl der Felder (Spalten), die im Gitter angezeigt werden.

__property int FieldCount;

Beschreibung

Mit FieldCount können Sie über die Feldkomponenten iterieren, die in der Eigenschaft Fields indiziert sind. FieldCount unterscheidet sich möglicherweise von der Anzahl der Felder in der zugrundeliegenden Datenmenge, da das Gitter berechnete Felder enthalten kann und nicht alle Felder der Datenmenge im Gitter angezeigt werden müssen. Mit dem Spalteneditor können Sie während des Entwurfs einzelne Felder entfernen und berechnete Felder einfügen.

Der Wert von FieldCount entspricht zur Laufzeit der Anzahl der Spalten. Während des Entwurfs kann das Gitter leere Spalten enthalten.


TCustomDBGrid::Fields

TCustomDBGrid	Siehe auch

Die Eigenschaft Fields enthält ein indiziertes Array der Feldkomponenten, die den Spalten des datensensitiven Gitters entsprechen.

__property Db::TField* Fields[int FieldIndex];

Beschreibung

Mit Fields können Sie direkt auf eine Feldkomponente der Datenmenge zugreifen, das einer bestimmten Spalte im Gitter entspricht. Das Feld für die erste Datenspalte hat den Index 0, das Feld für die zweite Spalte den Index 1 usw. Der Index liegt im Bereich 0...FieldCount - 1.

Die erste Datenspalte im Gitter muß nicht die erste Spalte im Gitter sein. Falls Options den Wert dgIndicator enthält, kann die erste Spalte des Gitters nicht verschoben werden. Sie enthält dann die Zeilenmarkierung.

Mit den einzelnen Feldkomponenten in Fields können Daten wie z.B. der Wert des Feldes im aktuellen Datensatz, die bevorzugte Anzeigebreite oder der String abgerufen werden, der bei der Anzeige oder bei der Bearbeitung des Feldes angezeigt wird. Mit der Feldkomponente können Sie die Werte direkt in die Datenmenge schreiben, ohne den Zelleditor zu verwenden.

Hinweis

Repräsentiert eine Spalte des Gitters ein berechnetes Feld, enthält die Datenmenge keine Feldkomponente für diese Spalte. Bezieht sich Index auf die Spalte, die ein berechnetes Feld enthält, gibt Fields den Wert NULL zurück. Mit der Methode GetColField können Sie die Feldkomponente für ein berechnetes Feld ermitteln.


TCustomDBGrid::IndicatorOffset

TCustomDBGrid	Siehe auch

Die Eigenschaft IndicatorOffset enthält den Index der ersten Spalte des Gitters, die Daten enthält.

__property unsigned char IndicatorOffset;

Beschreibung

Mit IndicatorOffset können Sie zwischen den Positionen der in der Eigenschaft Columns angegebenen Spalten und den Spalten konvertieren, die im datensensitiven Gitter angezeigt werden. Die Eigenschaft hat den Wert 1, wenn die Eigenschaft Options den Wert dgIndicator enthält, da die erste Spalte des Gitters für die Datensatzmarkierung verwendet wird. IndicatorOffset hat den Wert 0, falls alle Spalten Daten enthalten.


TCustomDBGrid::LayoutLock

TCustomDBGrid	Siehe auch

Die Eigenschaft LayoutLock enthält die Anzahl der Aufrufe der Methode BeginLayout, die nicht mit EndLayout oder CancelLayout beendet wurden.

__property unsigned char LayoutLock;

Beschreibung

Mit LayoutLock können Sie bestimmen, wann die Spaltenzuordnungen geändert werden. Sobald eine Spaltenbreite oder -zuordnung geändert wird oder die Felder der Datenquelle geändert werden, wird die Methode BeginLayout aufgerufen. BeginLayout erhöht LayoutLock um Eins, um die €nderung der Feldzuordnungen zu registrieren. Nachdem die €nderungen abgeschlossen wurden, wird die Methode EndLayout aufgerufen. EndLayout verringert LayoutLock um Eins. Hat LayoutLock wieder den Wert 0, wurden alle €nderungen abgeschlossen und die Eigenschaften Fields und Columns aktualisiert.


TCustomDBGrid::Options

TCustomDBGrid

Mit der Eigenschaft Options können Sie die verschiedenen Eigenschaften zur Anzeige und zu den Funktionen des datensensitiven Gitters festlegen.

__property TDBGridOptions Options;

Beschreibung

Fügen Sie in Options die gewünschten Eigenschaften des datensensitiven Gitters ein. Options ist eine Menge, deren Werte in folgender Tabelle beschrieben werden:

Wert	Bedeutung

dgEditing	Die Daten können mit Hilfe des Gitters bearbeitet werden. dgEditing wird ignoriert, falls Options dgRowSelect enthält.

dgAlwaysShowEditor	Der Bearbeitungsmodus kann nicht beendet werden. Der Benutzer muß also zur Bearbeitung des Inhalts einer Zelle nicht die Taste EINGABE oder F2 drücken muß. dgAlwaysShowEditor hat nur eine Funktion, wenn auch dgEditing in Options enthalten ist. dgAlwaysShowEditor wird ignoriert, wenn Options den Wert dgRowSelect enthält.

dgTitles	Die Titel werden über den Spalten im Gitter angezeigt.

dgIndicator	Ein kleiner Zeiger in der ersten Spalte zeigt an, welche Zeile aktuell ist.

dgColumnResize	Die Feldern zugeorndeten Spalten können in der Größe geändert oder verschoben werden.

 dgColLins	Die Spalten des Gitters werden durch Linien getrennt.

dgRowLines	Die Zeilen des Gitters werden durch Linien getrennt.

dgTabs	Der Benutzer kann die Zellen des Gitters mit TAB und UMSCHALT+TAB aktivieren.

dgRowSelect	Es können Zeilen oder einzelne Zellen markiert werden. Falls Options den Wert dgRowSelect enthält, werden dgEditing und dgAlwaysShowEditor ignoriert.

dgAlwaysShowSelection	Die markierte Zelle wird vom Fokusrechteck umgeben, auch wenn das Gitter den Fokus nicht besitzt.

dgConfirmDelete	Eine Meldung wird angezeigt. Der Benutzer muß bestätigen, daß eine Zeile des Gitters mit STRG+ENTF gelöscht werden soll.

dgCancelOnExit	Wenn der Benutzer das Gitter verläßt, während er sich in einem eingefügten Datensatz befindet, der nicht geändert wurde, wird der eingefügte Datensatz nicht in die Datenmenge übernommen. Dadurch wird verhindert, daß versehentlich leere Datensätze eingetragen werden.

dgMultiSelect	Es können mehrere Zeilen im Gitter gleichzeitig markiert werden.


TCustomDBGrid::ReadOnly

TCustomDBGrid	Siehe auch

Die Eigenschaft ReadOnly gibt an, ob das Gitter nur zur Anzeige verwendet wird oder der Benutzer die Daten im Gitter bearbeiten kann.

__property bool ReadOnly;

Beschreibung

Durch Einstellen von ReadOnly auf True können Sie verhindern, daß die Daten der Datenmenge geändert werden. Damit die Daten im Gitter bearbeitet werden können, setzen Sie ReadOnly auf False.

Hat ReadOnly den Wert True, können Sie weder mit der Taste EINFG eine neue Zeile in das Gitter einfügen noch mit der Taste PFEIL UNTEN eine neue Zeile am Ende des Datengitters anfügen.


TCustomDBGrid::SelectedField

TCustomDBGrid	Siehe auch

Die Eigenschaft SelectedField enthält die Feldkomponente, die der aktuell markierten Zelle des Gitters entspricht.

__property Db::TField* SelectedField;

Beschreibung

Mit SelectedField können Sie den Fokus zu einem bestimmten Feld des Gitters verschieben. Außerdem können Sie auf die Feldkomponente zugreifen, die der aktuell markierten Zelle entspricht. Ist keine Zelle markiert, hat SelectedField den Wert NULL. Dies ist der Fall, wenn beispielsweise eine Zeile markiert wurde.


TCustomDBGrid::SelectedIndex

TCustomDBGrid	Siehe auch

Die Eigenschaft SelectedIndex enthält den Index der aktuell markierten Spalte im Array Columns.

__property int SelectedIndex;

Beschreibung

Mit SelectedIndex können Sie den Fokus zu einer Spalte im Gitter verschieben, die durch ihre Position bezeichnet wird. Außerdem können Sie mit der Eigenschaft bestimmen, welche Spalte des Gitters den Fokus besitzt. Der Wert 0 bezeichnet die erste Datenspalte, 1 steht für die zweite Datenspalte usw. SelectedIndex hat den Wert -1, wenn keine Spalte markiert ist.

Enthält die Eigenschaft Options den Wert dgIndicator, unterscheidet sich der Index der in SelectedIndex angegebenen Datenspalte vom Index der physischen Spalte des Gitters.

Mit der Eigenschaft SelectedField können Sie auf die Feldkomponente der ausgewählten Spalte zugreifen.


TCustomDBGrid::SelectedRows

TCustomDBGrid	Siehe auch

Die Eigenschaft SelectedRows enthält eine Menge von Positionsmarken für alle Datensätze der Datenmenge, die den im Gitter markierten Zeilen entsprechen.

__property TBookmarkList* SelectedRows;

Beschreibung

Mit den Eigenschaften und Methoden des TBookmarkList-Objekts, das von SelectedRows zurückgegeben wird, können Sie folgende Aktionen durchführen:

•	Sie können die Anzahl der Zeilen ermitteln, die im Gitter markiert wurden.

•	Sie können bestimmen, ob der aktuelle Datensatz in der Datenmenge ausgewählt ist.

•	Sie können ermitteln, ob ein bestimmter Datensatz in der Datenmenge ausgewählt ist.

•	Sie können alle ausgewählten Zeilen aus der Datenmenge löschen.

SelectedRows hat nur eine Bedeutung, wenn die Eigenschaft Options den Wert dgRowSelect enthält. SelectedRows kann nur eine Zeile bezeichnen, sofern die Eigenschaft Options nicht den Wert dgMultiSelect enthält.


TCustomDBGrid::TitleFont

TCustomDBGrid	Siehe auch

Die Eigenschaft TitleFont gibt die Schrift an, mit der die Spaltentitel im Gitter angezeigt werden.

__property Graphics::TFont* TitleFont;

Beschreibung

Mit TitleFont können Sie die Schrift ändern, mit der die Spaltenüberschriften angezeigt werden. TitleFont hat nur eine Bedeutung, wenn die Eigenschaft Options den Wert dgTitles enthält.


TCustomDBGrid::UpdateLock

TCustomDBGrid	Siehe auch

Mit der Eigenschaft UpdateLock können Sie die Anzahl der Aufrufe der Methode BeginUpdate ermitteln, die nicht durch einen Aufruf der Methode EndUpdate abgeschlossen wurden.

__property unsigned char UpdateLock;

Beschreibung

Mit UpdateLock können Sie verhindern, daß das Gitter neu gezeichnet wird, während die Daten im Gitter geändert werden. Die Methode BeginUpdate wird aufgerufen, wenn die im Gitter angezeigten Daten geändert werden. BeginUpdate erhöht UpdateLock um Eins, um die €nderung des Gitterinhalts zu registrieren. Nachdem die €nderungen abgeschlossen wurden, wird die Methode EndUpdate aufgerufen. EndUpdate verringert UpdateLock um Eins.

Hat UpdateLock den Wert 0, können die Zellen des datensensitiven Gitters neu gezeichnet werden. Ist UpdateLock größer als 0, wird die Neuanzeige verzögert. Mit UpdateLock können Sie verhindern, daß das Gitter flimmert, wenn es in der Größe verändert oder der Bildschirmausschnitt verschoben wird.


Ereignisse von TCustomDBGrid

TCustomDBGrid	Alphabetisch	Legende

In TCustomDBGrid

OnColEnter

OnColExit

OnColumnMoved

OnDrawColumnCell

OnDrawDataCell

OnEditButtonClick


Ereignisse von TCustomDBGrid

TCustomDBGrid	Nach Objekten	Legende

OnColEnter

OnColExit

OnColumnMoved

OnDrawColumnCell

OnDrawDataCell

OnEditButtonClick


TCustomDBGrid::OnColEnter

TCustomDBGrid	Siehe auch

Das Ereignis OnColEnter wird ausgelöst, wenn der Fokus zu einer anderen Zelle des Gitters verschoben wird.

typedef void __fastcall (__closure *TNotifyEvent)(System::TObject* Sender);

__property Classes::TNotifyEvent OnColEnter;

Beschreibung

Mit einer Ereignisbehandlungsroutine für OnColEnter können Sie spezielle Aktionen durchführen, wenn eine neue Zelle markiert wird. Der Fokus wird in folgenden Fällen zu einer Zelle verschoben:

•	Der Fokus wird mit der Tastatur zu einer anderen Zelle verschoben. Dies ist beispielsweise der Fall, wenn der Benutzer die Taste TAB oder die Taste POS1 verwendet.

•	Der Benutzer klickt auf eine Zelle.

•	Die Eigenschaft SelectedField oder SelectedIndex wird gesetzt.

Der Eigenschaft SelectedField oder SelectedIndex können Sie entnehmen, welche Zelle aktiviert wurde.


TCustomDBGrid::OnColExit

TCustomDBGrid	Siehe auch

Das Ereignis OnColExit wird ausgelöst, bevor eine Zelle des Gitters den Eingabefokus abgibt.

typedef void __fastcall (__closure *TNotifyEvent)(System::TObject* Sender);

__property Classes::TNotifyEvent OnColExit;

Beschreibung

Mit einer Ereignisbehandlungsroutine für OnColExit können Sie spezielle Aktionen durchführen, bevor eine Zelle den Fokus abgibt. Mit OnColExit können Sie beispielsweise €nderungen an die zugrundeliegende Datenmenge senden, sobald der Benutzer die Zelle wechselt, und müssen nicht warten, bis der Benutzer den Datensatz verläßt.

Eine Zelle gibt den Fokus in folgenden Fällen ab:

•	Der Fokus wird mit der Tastatur zu einer anderen Zelle verschoben. Dies ist beispielsweise der Fall, wenn der Benutzer die Taste TAB oder die Taste POS1 drückt.

•	Der Benutzer klickt mit der linken Maustaste auf eine andere Zelle.

•	Die Eigenschaft SelectedField oder SelectedIndex wird gesetzt.

Bevor eine andere Zelle des datensensitiven Gitters markiert wird, wird das Ereignis OnColExit ausgelöst. Anschließend werden die Werte von SelectedField und SelectedIndex aktualisiert. Schließlich wird das Ereignis OnColEnter ausgelöst. Somit können Sie in einer Ereignisbehandlungsroutine für OnColExit der Eigenschaft SelectedField oder SelectedIndex entnehmen, welche Spalte den Fokus abgibt.


TCustomDBGrid::OnColumnMoved

TCustomDBGrid	Siehe auch

Das Ereignis OnColumnMoved wird ausgelöst, wenn der Benutzer eine Spalte mit der Maus verschiebt.

typedef void __fastcall (__closure *TMovedEvent)(System::TObject* Sender, long FromIndex, long ToIndex	);

__property Grids::TMovedEvent OnColumnMoved;

Beschreibung

Mit einer Ereignisbehandlungsroutine für OnColumnMoved können Sie spezielle Aktionen durchführen, nachdem eine Spalte im Gitter verschoben wurde. Der Parameter FromIndex bezeichnet die bisherige Position der Spalte im Array Columns. Der Parameter ToIndex gibt die neue Position der Spalte an.

OnColumnMoved kann nur ausgelöst werden, wenn die Eigenschaft Options den Wert dgColumnResize enthält.


TCustomDBGrid::OnDrawColumnCell

TCustomDBGrid	Siehe auch

Das Ereignis OnDrawColumnCell wird ausgelöst, wenn im Gitter eine Zelle gezeichnet werden muß.

typedef Set<Grids_3, gdSelected, gdFixed> TGridDrawState;

typedef void __fastcall (__closure *TDrawColumnCellEvent)(System::TObject* Sender, const Windows::TRect 	&Rect, int DataCol, TColumn* Column,  Grids::TGridDrawState State);

__property TDrawColumnCellEvent OnDrawColumnCell;

Beschreibung

Mit einer Ereignisbehandlungsroutine für OnDrawColumnCell können Sie eine benutzerdefinierte Anzeigeroutine für die Daten in den Gitterzellen bereitstellen. Die Darstellung in der Zelle erfolgt mit den Methoden der Eigenschaft Canvas. Der Parameter Rect gibt die Position der Zelle auf der Zeichenfläche an. Der Parameter DataCol enthält den Index der Spalte im Array Columns. Beim Parameter Column handelt es sich um das TColumn-Objekt, das die Anzeigeattribute und die Feldzuordnung für die Zelle beschreibt. Der Parameter State gibt an, ob die Zelle den Eingabefokus besitzt, markiert ist und sich in einem fixierten Teil des Gitters (keine Daten) wie z.B. einem Tabellenkopf befindet.

In einer Ereignisbehandlungsroutine für OnDrawColumnCell können Sie das datensensitive Gitter mit der Methode DefaultDrawColumnCell anweisen, den Datenwert in die Zelle zu schreiben. Die Ereignisbehandlungsroutine für OnDrawColumnCell kann die Methode DefaultDrawColumnCell erweitern, um die Markierung und den Fokus sichtbar zu machen. Falls die Ereignisbehandlungsroutine für OnDrawColumnCell den Text für die Zelle nicht mit DefaultDrawColumnCell zeichnet, können Sie mit der Methode GetFieldValue den Text ermitteln, der in der Zelle angezeigt werden soll.

Hat DefaultDrawing den Wert True, werden die Daten bereits vor dem Ereignis OnDrawColumnCell in die Zelle geschrieben, und das Fokusrechteck wird nach dem Ereignis OnDrawColumnCell für die markierten Zellen angezeigt.

Hinweis

Hat die Eigenschaft State der Eigenschaft Columns den Wert csDefault, wird das Ereignis OnDrawDataCell vor dem Ereignis OnDrawColumnCell ausgelöst. Das Ereignis OnDrawDataCell ist veraltet und dient nur der Abwärtskompatibilität. Geben Sie nicht gleichzeitig Ereignisbehandlungsroutinen für die Ereignisse OnDrawDataCell und OnDrawColumnCell an.


TCustomDBGrid::OnDrawDataCell

TCustomDBGrid	Siehe auch

Das Ereignis OnDrawDataCell wird ausgelöst, wenn im Gitter eine Zelle gezeichnet werden muß und die Eigenschaft State von Columns den Wert csDefault hat.

typedef Set<Grids_3, gdSelected, gdFixed> TGridDrawState;

typedef void __fastcall (__closure *TDrawDataCellEvent)(System::TObject* Sender, const Windows::TRect 	&Rect, Db::TField* Field,  Grids::TGridDrawState State);

__property TDrawDataCellEvent OnDrawDataCell;

Beschreibung

Schreiben Sie keine Ereignisbehandlungsroutine für OnDrawDataCell. OnDrawDataCell ist veraltet und dient nur der Abwärtskompatibilität. Schreiben Sie statt dessen eine Ereignisbehandlungsroutine für OnDrawColumnCell.


TCustomDBGrid::OnEditButtonClick

TCustomDBGrid	Siehe auch

Das Ereignis OnEditButtonClick wird ausgelöst, wenn der Benutzer in einer Gitterspalte auf die Schaltfläche mit den Punkten klickt.

typedef void __fastcall (__closure *TNotifyEvent)(System::TObject* Sender);

__property Classes::TNotifyEvent OnEditButtonClick;

Beschreibung

Mit einer Ereignisbehandlungsroutine für OnEditButtonClick können Sie eine Liste oder ein Dialogfeld anzeigen, wenn der Benutzer in einer Gitterzelle auf die Schaltfläche mit den Punkten klickt. Die Ereignisbehandlungsroutine für OnEditButtonClick kann den Wert des Feldes aufgrund der Benutzereingabe in der Liste oder dem Dialogfeld setzen. Mit der Eigenschaft SelectedField können Sie auf die TField-Komponente zugreifen, deren Wert gesetzt werden soll.


Methoden von TCustomDBGrid

TCustomDBGrid	Alphabetisch	Legende

In TCustomDBGrid

~TCustomDBGrid

AcquireLayoutLock

BeginLayout

BeginUpdate

CancelLayout

CanEditAcceptKey

CanEditModify

CanEditShow

ColEnter

ColExit

ColumnMoved

ColWidthsChanged

CreateColumns

CreateEditor

CreateWnd

DataToRawColumn

DefaultDrawColumnCell

DefaultDrawDataCell

DeferLayout

DefineFieldMap

DrawCell

DrawColumnCell

DrawDataCell

EditButtonClick

EndLayout

EndUpdate

GetColField

GetEditLimit

GetEditMask

GetEditText

GetFieldValue

HighlightCell

KeyDown

KeyPress

LayoutChanged

LinkActive

Loaded

MouseDown

Notification

RawToDataColumn

Scroll

SetColumnAttributes

SetEditText

StoreColumns

TCustomDBGrid

TimedScroll

ValidFieldIndex

Abgeleitet von TCustomGrid

MouseUp

Abgeleitet von TWinControl

Broadcast

CanFocus

ContainsControl

ControlAtPos

DisableAlign

EnableAlign

Focused

GetTabOrderList

HandleAllocated

HandleNeeded

InsertControl

Invalidate

PaintTo

Realign

RemoveControl

Repaint

ScaleBy

ScrollBy

SetBounds

SetFocus

Update

UpdateControlState

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

GetTextLen

Hide

Perform

Refresh

ScreenToClient

SendToBack

SetTextBuf

Show

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TCustomDBGrid

TCustomDBGrid	Nach Objekten	Legende

~TCustomDBGrid

AcquireLayoutLock

Assign

BeginDrag

BeginLayout

BeginUpdate

BringToFront

Broadcast

CancelLayout

CanEditAcceptKey

CanEditModify

CanEditShow

CanFocus

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

ClientToScreen

ColEnter

ColExit

ColumnMoved

ColWidthsChanged

ContainsControl

ControlAtPos

CreateColumns

CreateEditor

CreateWnd

DataToRawColumn

DefaultDrawColumnCell

DefaultDrawDataCell

DeferLayout

DefineFieldMap

DestroyComponents

Destroying

DisableAlign

Dispatch

DragDrop

Dragging

DrawCell

DrawColumnCell

DrawDataCell

EditButtonClick

EnableAlign

EndDrag

EndLayout

EndUpdate

FieldAddress

FindComponent

Focused

FreeInstance

FreeNotification

Free

GetColField

GetEditLimit

GetEditMask

GetEditText

GetFieldValue

GetParentComponent

GetTabOrderList

GetTextBuf

GetTextLen

HandleAllocated

HandleNeeded

HasParent

Hide

HighlightCell

InheritsFrom

InitInstance

InsertComponent

InsertControl

InstanceSize

Invalidate

KeyDown

KeyPress

LayoutChanged

LinkActive

Loaded

MethodAddress

MethodName

MouseDown

MouseUp

NewInstance

Notification

PaintTo

Perform

RawToDataColumn

Realign

Refresh

RemoveComponent

RemoveControl

Repaint

ScaleBy

ScreenToClient

ScrollBy

Scroll

SendToBack

SetBounds

SetColumnAttributes

SetEditText

SetFocus

SetTextBuf

Show

StoreColumns

TCustomDBGrid

TimedScroll

UpdateControlState

Update

ValidFieldIndex


TCustomDBGrid::~TCustomDBGrid

TCustomDBGrid	Siehe auch

Der Destruktor ~TCustomDBGrid gibt den Speicher frei, der für das TCustomDBGrid-Objekt reserviert war. Rufen Sie ~TCustomDBGrid nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TCustomDBGrid automatisch aufgerufen wird.

__fastcall virtual ~TCustomDBGrid(void);

Beschreibung

~TCustomDBGrid gibt alle Hilfsobjekte frei, die vom Gitter verwendet wurden.


TCustomDBGrid::AcquireLayoutLock

TCustomDBGrid	Siehe auch

Mit der Methode AcquireLayoutLock können Sie BeginLayout aufrufen, wenn die Tabelle nicht gerade neu formatiert wird.

bool __fastcall AcquireLayoutLock(void);

Beschreibung

In Anwendungen kann diese geschützte Methode nicht aufgerufen werden. AcquireLayoutLock wird vor der Neuberechnung von Columns aufgerufen, wenn die Felder der Datenmenge geändert werden oder die Eigenschaft Columns geändert wird. Der Rückgabewert ist True, wenn das Format der Tabelle noch nicht korrigiert wurde. Dadurch wird angezeigt, daß die Berechnung von Columns fortgesetzt werden sollte. Mit AcquireLayoutLock können Sie Endlosschleifen bei der Berechnung verhindern, die aufgrund der €nderungen auftreten, die von den Berechnungen ausgelöst werden.


TCustomDBGrid::BeginLayout

TCustomDBGrid	Siehe auch

Die Methode BeginLayout erhöht die Eigenschaft LayoutLock um Eins, wenn die Spaltenzuordnungen oder die Felder der Datenmenge geändert werden.

void __fastcall BeginLayout(void);

Beschreibung

In Anwendungen kann diese geschützte Methode nicht aufgerufen werden. In datensensitiven Gittern wird BeginLayout intern aufgerufen, bevor die Eigenschaft Columns oder die darin enthaltenen TColumn-Objekte geändert werden. Nachdem die €nderungen abgeschlossen wurden, wird EndLayout aufgerufen. Muß die Reaktion auf die €nderung verworfen oder verschoben werden, wird CancelLayout aufgerufen.

Durch jeden Aufruf von BeginLayout wird die Eigenschaft LayoutLock um Eins erhöht. Durch einen Aufruf von EndLayout oder CancelLayout wird die Eigenschaft LayoutLock um Eins verringert. Falls LayoutLock bei einem Aufruf von EndLayout den Wert 0 zurückgibt, wird die Eigenschaft Fields sowohl an die Zuordnungen in der Eigenschaft Columns als auch an die in der Datenmenge verfügbaren Felder angepaßt. Die Eigenschaft Columns wird wiederum an die Eigenschaft Fields angepaßt. Damit wird sichergestellt, daß die Eigenschaft Columns sowohl den angegebenen Spaltenzuordnungen als auch den in der Datenmenge verfügbaren Feldern entspricht.


TCustomDBGrid::BeginUpdate

TCustomDBGrid	Siehe auch

Die Methode BeginUpdate erhöht die Eigenschaft UpdateLock um Eins, wenn die Daten im Gitter geändert werden.

void __fastcall BeginUpdate(void);

Beschreibung

In Anwendungen kann diese geschützte Methode nicht aufgerufen werden. In den datensensitiven Gittern wird BeginUpdate intern aufgerufen, bevor die im Gitter angezeigten Daten geändert werden. Nachdem die €nderung abgeschlossen wurde, wird EndUpdate aufgerufen und die Eigenschaft UpdateLock um Eins verringert.

Solange UpdateLock größer als 0 ist, werden die Zellen im Gitter nicht neu gezeichnet. Mit BeginUpdate und EndUpdate können Sie verhindern, daß das Gitter flimmert, wenn es in der Größe verändert oder der Bildschirmausschnitt verschoben wird.


TCustomDBGrid::CancelLayout

TCustomDBGrid	Siehe auch

Die Methode CancelLayout verringert die Eigenschaft LayoutLock um Eins.

void __fastcall CancelLayout(void);

Beschreibung

In Anwendungen kann diese geschützte Methode nicht aufgerufen werden. In datensensitiven Gittern wird CancelLayout intern aufgerufen, wenn die Neuberechnung von Columns verschoben werden soll.

Durch jeden Aufruf von BeginLayout wird die Eigenschaft LayoutLock um Eins erhöht. Durch einen Aufruf von EndLayout oder CancelLayout wird die Eigenschaft LayoutLock um Eins verringert. Falls LayoutLock bei einem Aufruf von CancelLayout den Wert 0 zurückgibt, wird die Eigenschaft Columns nicht aktualisiert. CancelLayout wird von der Methode DeferLayout aufgerufen, um LayoutLock um Eins zu verringern und die Neuberechnung von Columns bis zu einem geeigneten Zeitpunkt zu verschieben.


TCustomDBGrid::CanEditAcceptKey

TCustomDBGrid	Siehe auch

Die Methode CanEditAcceptKey gibt an, ob der Parameter Key in die aktuelle Zelle eingegeben werden kann.

virtual bool __fastcall CanEditAcceptKey(char Key);

Beschreibung

In datensensitiven Gittern kann mit CanEditAcceptKey intern bestimmt werden, ob vom Benutzer gedrückte Tasten für das durch die aktuelle Zelle repräsentierte Feld gültig sind. CanEditAcceptKey ruft die Methode IsValidChar der Feldkomponente auf, die mit der Spalte verbunden ist, die den Eingabefokus besitzt.

Mit CanEditAcceptKey können Sie die Gültigkeit der Tastatureingabe grob überprüfen. Eine genauere Gültigkeitsprüfung ist möglich, wenn der Wert der Zelle in den Datensatz der Datenmenge geschrieben oder eine Eingabemaske angegeben wird.


TCustomDBGrid::CanEditModify

TCustomDBGrid	Siehe auch

Die Methode CanEditModify gibt an, ob die aktuelle Spalte des Gitters bearbeitet werden kann.

virtual bool __fastcall CanEditModify(void);

Beschreibung

Mit der Methode CanEditModify kann intern bestimmt werden, ob die aktuelle Zelle eines datensensitiven Gitters bearbeitet werden kann. CanEditModify gibt den Wert True zurück, falls das Feld in der aktuellen Spalte bearbeitet werden kann. Andernfalls wird False zurückgegeben. Die Methode versucht gegebenenfalls, die Datenmenge in den Bearbeitunsmodus zu versetzen.

Hinweis

CanEditModify gibt False zurück, falls es sich beim aktuellen Feld um ein BLOB-Feld (Binary Large Object) handelt. BLOB-Felder können nur über die Zwischenablage oder mit Hilfe von Streams bearbeitet werden.


TCustomDBGrid::CanEditShow

TCustomDBGrid	Siehe auch

Die Methode CanEditShow gibt an, ob Zellen mit dem Zelleditor bearbeitet werden können.

virtual bool __fastcall CanEditShow(void);

Beschreibung

Das TCustomDBGrid-Objekt überschreibt die geerbte Methode, um die Anzeige des Zelleditors zu verhindern, während das Layout des Gitters neu berechnet wird.

CanEditShow wird intern aufgerufen, bevor der Editor für eine Zelle erstellt wird. Nachdem das Gitter festgestellt hat, daß das Feld mit CanEditModify bearbeitet werden kann, wird CanEditShow aufgerufen.


TCustomDBGrid::ColEnter

TCustomDBGrid	Siehe auch

Die Methode ColEnter ruft die Ereignisbehandlungsroutine für OnColEnter auf.

virtual void __fastcall ColEnter(void);

Beschreibung

ColEnter kann von Anwendungen nicht direkt aufgerufen werden. Es handelt sich um eine geschützte Methode. Somit können die Nachkommen mit der Ereignisbehandlungsroutine für OnColEnter auf andere Ereignisse reagieren oder die Reaktion auf das Markieren einer Zelle im Gitter überschreiben.


TCustomDBGrid::ColExit

TCustomDBGrid	Siehe auch

Die Methode ColExit ruft die Ereignisbehandlungsroutine für OnColExit auf.

virtual void __fastcall ColExit(void);

Beschreibung

ColExit kann von Anwendungen nicht direkt aufgerufen werden. Bei ihr handelt es sich um eine geschützte Methode. Somit können die Nachkommen mit der Ereignisbehandlungsroutine für OnColExit auf andere Ereignisse reagieren oder die Reaktion auf das Verschieben des Fokus im Gitter überschreiben.


TCustomDBGrid::ColumnMoved

TCustomDBGrid	Siehe auch

Die Methode ColumnMoved ruft die Ereignisbehandlungsroutine für OnColumnMoved auf.

virtual void __fastcall ColumnMoved(long FromIndex, long ToIndex);

Beschreibung

ColumnMoved kann von Anwendungen nicht direkt aufgerufen werden. Bei ihr handelt es sich um eine geschützte Methode. Somit können die Nachkommen mit der Ereignisbehandlungsroutine für OnColumnMoved auf andere Ereignisse reagieren oder die Reaktion auf das Verschieben einer Spalte im Gitter überschreiben.


TCustomDBGrid::ColWidthsChanged

TCustomDBGrid	Siehe auch

Die Methode ColWidthsChanged aktualisiert die Spaltenbreiten in der Eigenschaft Columns, wenn der Benutzer die Größe der Spalten ändert.

virtual void __fastcall ColWidthsChanged(void);

Beschreibung

ColWidthsChanged kann von Anwendungen nicht direkt aufgerufen werden. Die Methode wird automatisch aufgerufen, wenn der Benutzer die Spaltenbreiten im Gitter ändert. ColWidthsChanged überschreibt die geerbte Methode, um die Spaltenbreiten in der Eigenschaft Columns zu aktualisieren.


TCustomDBGrid::CreateColumns

TCustomDBGrid	Siehe auch

Die Methode CreateColumns erstellt das TDBGridColumns-Objekt, in dem die Spaltendeskriptoren des Gitters gespeichert werden.

virtual TDBGridColumns* __fastcall CreateColumns(void);

Beschreibung

CreateColumns kann von Anwendungen nicht direkt aufgerufen werden. Bei ihr handelt es sich um eine geschützte Methode. Sie kann von Komponenteprogrammierern durch einen Nachkommen des TDBGridColumns-Objekts ersetzt werden, um die Spaltendeskriptoren eines datensensitiven Gitters zu verwalten. Die Hilfsobjekte der Unit DBGrids können eine Menge von Spaltendeskriptoren für ein Gitter erstellen.


TCustomDBGrid::CreateEditor

TCustomDBGrid	Siehe auch

Die Methode CreateEditor erstellt den Zelleditor, mit dem die Zellen des Gitters bearbeitet werden können.

virtual Grids::TInplaceEdit* __fastcall CreateEditor(void);

Beschreibung

CreateEditor überschreibt die geerbte Methode, um einen datensensitiven Nachkommen des TInplaceEdit-Objekts zu erstellen.


TCustomDBGrid::CreateWnd

TCustomDBGrid	Siehe auch

Die Methode CreateWnd erstellt das Fenster, in dem das datensensitive Gitter angezeigt wird.

virtual void __fastcall CreateWnd(void);

Beschreibung

CreateWnd überschreibt die geerbte Methode, um nach der Erstellung des Fensters die Beziehung zwischen der Anzeige und der Datenquelle einzurichten.


TCustomDBGrid::DataToRawColumn

TCustomDBGrid	Siehe auch

Die Methode DataToRawColumn wandelt einen Spaltenindex in der Eigenschaft Columns in den Index der entprechenden Spalte in der Anzeige um.

int __fastcall DataToRawColumn(int ACol);

Beschreibung

In Anwendungen kann diese geschützte Methode nicht aufgerufen werden. Sie wird intern verwendet, um die Anzeige anzupassen, wenn eine Spalte mit Datensatzmarkierung verwendet wird.


TCustomDBGrid::DefaultDrawColumnCell

TCustomDBGrid	Siehe auch

Mit der Methode DefaultDrawColumnCell können Sie den Text in eine Zelle einer Spalte schreiben.

void __fastcall DefaultDrawColumnCell(const Windows::TRect &Rect, int DataCol, TColumn* Column,  Grids::TGridDrawState  State);

Beschreibung

Mit DefaultDrawColumnCell können Sie in einer Ereignisbehandlungsroutine für OnDrawColumnCell den Text für ein Feld suchen und in die Zelle schreiben. DefaultDrawColumnCell entspricht der Aktion des Gitters, wenn die Eigenschaft DefaultDrawing den Wert True hat. Jedoch zeigt die Methode niemals das Fokusrechteck für die markierten Zellen an.

Der Parameter Rect gibt Position der Zelle auf der Zeichenfläche an. Der Parameter DataCol enthält den Index der Spalte im Array Columns. Der Parameter Column bezeichnet das TColumn-Objekt, das die Anzeigeattribute und die Feldzuordnung für die Zelle beschreibt. Der Parameter State gibt an, ob die Zelle den Eingabefokus besitzt, markiert ist und sich in einem fixierten Teil des Gitters (keine Daten) wie z.B. einem Tabellenkopf befindet.


TCustomDBGrid::DefaultDrawDataCell

TCustomDBGrid	Siehe auch

Mit der Methode DefaultDrawDataCell können Sie den Text in einer Zelle einer Spalte zeichnen.

void __fastcall DefaultDrawDataCell(const Windows::TRect &Rect, Db::TField* Field,  Grids::TGridDrawState  State);

Beschreibung

Mit DefaultDrawDataCell können Sie in einer Ereignisbehandlungsroutine für OnDrawDataCell den Text für ein Feld suchen und in die Zelle schreiben. Im Gegensatz zur Anzeige durch ein Gitter, dessen Eigenschaft DefaultDrawing den Wert True hat, ruft DefaultDrawDataCell die Ausrichtung für den Text aus der Feldkomponente und nicht aus dem Spaltendeskriptor ab. Außerdem zeigt die Methode niemals das Fokusrechteck für die markierten Zellen an.

Der Parameter Rect gibt die Position der Zelle auf der Zeichenfläche an. Der Parameter Field enthält die Feldkomponente, die die Daten und die Ausrichtung der Zelle angibt. Der Parameter State gibt an, ob die Zelle den Eingabefokus besitzt, markiert ist und sich in einem fixierten Teil des Gitters (keine Daten) wie z.B. einem Tabellenkopf befindet.


TCustomDBGrid::DeferLayout

TCustomDBGrid	Siehe auch

Die Methode DeferLayout verringert die Eigenschaft LayoutLock um Eins und sendet eine Botschaft an das Gitter, um die Neuberechnung des Layouts auf einen geeigneten Zeitpunkt zu verschieben.

void __fastcall DeferLayout(void);

Beschreibung

In Anwendungen kann diese geschützte Methode nicht aufgerufen werden. In datensensitiven Gittern wird DeferLayout intern aufgerufen, um die Neuberechnung der Eigenschaft Columns zu verschieben, wenn die Spalten nach einer €nderung der Datenmenge nicht sofort neu berechnet werden sollen.

DeferLayout ruft CancelLayout auf, um die Eigenschaft LayoutLock um Eins zu verringern. Diese wurde als Reaktion auf die €nderung der Datenmenge um Eins erhöht. Anschließend wird eine Botschaft an das Gitter gesendet. Dadurch wird die Neuberechnung des Layouts auf einen späteren Zeitpunkt verschoben. Sobald die Botschaft empfangen wird, ruft das Gitter BeginLayout und anschließend entweder EndLayout oder DeferLayout auf. Letzteres hängt davon ab, ob der Zeitpunkt zur Berechnung von Columns geeignet ist.


TCustomDBGrid::DefineFieldMap

TCustomDBGrid	Siehe auch

Die Methode DefineFieldMap erstellt das Array Fields aus der Eigenschaft Columns und der Datenquelle.

virtual void __fastcall DefineFieldMap(void);

Beschreibung

In Anwendungen kann diese geschützte Methode nicht aufgerufen werden. DefineFieldMap erstellt das Array Fields neu, um es an die Felder der Datenquelle anzupassen, die den Spalten der Eigenschaft Columns entsprechen. Nach dem Aufruf von DefineFieldMap sollte die Eigenschaft Columns mit den Feldkomponenten im Array Fields aktualisiert werden. So wird sichergestellt, daß in der Eigenschaft Columns alle €nderungen berücksichtigt werden, die in der Datenmenge vorgenommen wurden.


TCustomDBGrid::DrawCell

TCustomDBGrid	Siehe auch

Mit der Methode DrawCell können Sie die Zelle zeichnen, die mit den Parametern ACol und ARow angegeben wird.

virtual void __fastcall DrawCell(long ACol, long ARow, const Windows::TRect &ARect,  Grids::TGridDrawState  AState);

Beschreibung

DrawCell überschreibt die geerbte Methode, um beim Zeichnen der Zellen im Gitter die Eigenschaft Columns zu verwenden.

Mit der Methode können Sie die Schrift und den Pinsel einstellen und den Hintergrund der Zelle anzeigen. Hat DefaultDrawing den Wert True, liest DrawCell die Daten für die Zelle und schreibt sie an die Position, die durch den Parameter ARect festgelegt wird. Unabhängig von DefaultDrawing löst DrawCell die Ereignisse OnDrawDataCell und OnDrawColumnCell aus. Hat schließlich DefaultDrawing den Wert True, besitzt die Zelle den  Fokus oder ist sie markiert und enthält Options den Wert dgAlwaysShowSelection, wird das Fokusrechteck für die Zelle angezeigt.


TCustomDBGrid::DrawColumnCell

TCustomDBGrid	Siehe auch

Die Methode DrawColumnCell ruft die Ereignisbehandlungsroutine für OnDrawColumnCell auf.

virtual void __fastcall DrawColumnCell(const Windows::TRect &Rect, int DataCol, TColumn* Column,  Grids::TGridDrawState  State);

Beschreibung

In Anwendungen kann DrawColumCell nicht direkt aufgerufen werden. Bei ihr handelt es sich um eine geschützte Methode. Die Nachkommen können somit die Ereignisbehandlungsroutine für OnDrawColumnCell aufrufen oder die Methode überschreiben, um Reaktionen auf das Ereignis zu verhindern.


TCustomDBGrid::DrawDataCell

TCustomDBGrid	Siehe auch

Die Methode DrawDataCell ruft die Ereignisbehandlungsroutine für OnDrawDataCell auf.

virtual void __fastcall DrawDataCell(const Windows::TRect &Rect, Db::TField* Field,  Grids::TGridDrawState  State);

Beschreibung

In Anwendungen kann DrawDataCell nicht direkt aufgerufen werden. Bei ihr handelt es sich um eine geschützte Methode. Die Nachkommen können somit die Ereignisbehandlungsroutine für OnDrawDataCell aufrufen oder die Methode überschreiben, um die Reaktion auf das Ereignis zu verhindern.


TCustomDBGrid::EditButtonClick

TCustomDBGrid	Siehe auch

Die Methode EditButtonClick ruft die Ereignisbehandlungsroutine für OnEditButtonClick auf.

virtual void __fastcall EditButtonClick(void);

Beschreibung

In Anwendungen kann EditButtonClick nicht direkt aufgerufen werden. Bei ihr handelt es sich um eine geschützte Methode. Die Nachkommen können somit die Ereignisbehandlungsroutine für OnEditButtonClick aufrufen oder die Methode überschreiben, um die Reaktion auf das Ereignis zu verhindern.


TCustomDBGrid::EndLayout

TCustomDBGrid	Siehe auch

Die Methode EndLayout verringert die Eigenschaft LayoutLock um Eins und berechnet die Eigenschaft Columns neu, sobald LayoutLock den Wert 0 erreicht.

void __fastcall EndLayout(void);

Beschreibung

In Anwendungen kann diese geschützte Methode nicht aufgerufen werden. In datensensitiven Gittern wird EndLayout intern aufgerufen, nachdem die Eigenschaft Columns oder die Datenmenge geändert wurde. EndLayout verringert die Eigenschaft LayoutLock um Eins, die zuvor mit BeginLayout inkrementiert wurde, bevor die Eigenschaft Columns geändert wurde oder die Benachrichtigung über die €nderung der Datenmenge eintraf.

Falls LayoutLock den Wert 0 zurückgibt, paßt EndLayout die Eigenschaft Fields sowohl an die Zuordnungen der Eigenschaft Columns als auch an die in der Datenmenge verfügbaren Felder an. Die Eigenschaft Columns wird wiederum an die Eigenschaft Fields angepaßt. Damit wird sichergestellt, daß die Eigenschaft Columns sowohl den angegebenen Spaltenzuordnungen als auch den in der Datenmenge verfügbaren Feldern entspricht.


TCustomDBGrid::EndUpdate

TCustomDBGrid	Siehe auch

Die Methode EndUpdate verringert die Eigenschaft UpdateLock um Eins.

void __fastcall EndUpdate(void);

Beschreibung

In Anwendungen kann diese geschützte Methode nicht aufgerufen werden. In den datensensitiven Gittern wird EndUpdate intern aufgerufen, bevor die im Gitter angezeigten Daten geändert werden. EndUpdate setzt UpdateLock auf den Zustand zurück, in dem sich die Eigenschaft vor dem Aufruf der Methode BeginUpdate befand.

Solange UpdateLock größer als 0 ist, werden die Zellen im Gitter nicht neu gezeichnet. Wird UpdateLock auf 0 zurückgesetzt, wird das Zeichnen wieder aktiviert. Mit BeginUpdate und EndUpdate können Sie verhindern, daß das Gitter flimmert, während es in der Größe verändert oder der Bildschirmausschnitt verschoben wird.


TCustomDBGrid::GetColField

TCustomDBGrid	Siehe auch

Die Methode GetColField gibt die Feldkomponente zurück, die die Zuordnung einer bestimmten Spalte enthält.

Db::TField* __fastcall GetColField(int DataCol);

Beschreibung

Mit GetColField können Sie die Feldkomponente abrufen, die einer Spalte im datensensitiven Gitter entspricht. Der Parameter DataCol ist der Index der Spalte in der Eigenschaft Columns. Der Index 0 bezeichnet die erste Spalte, der Index 1 die zweite Spalte usw.

Im Gegensatz zur Eigenschaft Fields gibt GetColField die Feldkomponente der Spalten zurück, die keine Felder in der Datenmenge repräsentieren. Dazu gehören z.B. die berechneten Felder.


TCustomDBGrid::GetEditLimit

TCustomDBGrid	Siehe auch

Die Methode GetEditLimit begrenzt die Anzahl der Zeichen, die in Zellen für Stringfelder eingegeben werden können.

virtual int __fastcall GetEditLimit(void);

Beschreibung

GetEditLimit wird vom Zelleditor aufgerufen. Mit dieser Methode können Sie die Anzahl der Zeichen beschränken, die in eine Zelle eingegeben werden können. Mit GetEditLimit können Sie eine Obergrenze einstellen, wenn die markierte Zelle ein Stringfeld repräsentiert.


TCustomDBGrid::GetEditMask

TCustomDBGrid	Siehe auch

Die Methode GetEditMask gibt die Eingabemaske zurück, die mit dem Feld für die markierte Zelle verbunden ist.

virtual System::AnsiString __fastcall GetEditMask(long ACol, long ARow);

Beschreibung

Der Zelleditor kann mit GetEditMask eine Eingabemaske abrufen, die mit der Feldzuordnung der angegebenen Zelle verbunden ist. Die Methode gibt die Eigenschaft EditMask der Feldkomponente aus dem Array Columns zurück.

Die Parameter ACol und ARow bezeichnen den Spalten- bzw. den Zeilenindex der Gitterzelle. Enthält die Eigenschaft Options die Konstante dgIndicator, entspricht der Parameter ACol nicht dem Index der Spalte im Array Columns.


TCustomDBGrid::GetEditText

TCustomDBGrid	Siehe auch

Die Methode GetEditText gibt den formatierten Wert der angegebenen Zelle zur Bearbeitung zurück.

virtual System::AnsiString __fastcall GetEditText(long ACol, long ARow);

Beschreibung

Der Zelleditor ermittelt mit GetEditText den Text für die angegebene Zelle. GetEditText ermittelt die Position der Feldkomponente für die Zelle im Array Columns und gibt den zur Bearbeitung formatierten Wert zurück.

Die Parameter ACol und ARow bezeichnen den Spalten- bzw. den Zeilenindex der Gitterzelle. Der Parameter ACol ist der „reine“ Spaltenindex. Enthält die Eigenschaft Options die Konstante dgIndicator, entspricht ACol nicht dem Index der Spalte im Array Columns.

Hinweis

Der von GetEditText zurückgegebene String kann sich von dem von der Methode GetFieldValue zurückgegebenen String unterscheiden, falls der Wert des Feldes für die Bearbeitung und die Anzeige unterschiedlich formatiert wird.


TCustomDBGrid::GetFieldValue

TCustomDBGrid	Siehe auch

Die Methode GetFieldValue gibt den für die Anzeige formatierten Wert der angegebenen Zelle zurück.

System::AnsiString __fastcall GetFieldValue(int ACol);

Beschreibung

Mit GetFieldValue können Sie den Text abrufen, der in einer Zelle angezeigt werden soll. In einer Ereignisbehandlungsroutine für OnDrawColumnCell beispielsweise kann mit GetFieldValue der Text der Zelle abgerufen werden, um spezielle Formatierungen vorzunehmen. Dies ist mit DefaultDrawColumnCell nicht möglich.

Der Parameter ACol enthält den Index der Spalte im Array Columns. Enthält die Eigenschaft Options die Konstante dgIndicator, entspricht der Parameter ACol nicht der physischen Anzeige.


TCustomDBGrid::HighlightCell

TCustomDBGrid	Siehe auch

Die Methode HighlightCell gibt an, ob die von den Parametern DataCol und DataRow festgelegte Zelle beim Zeichnen hervorgehoben werden soll.

virtual bool __fastcall HighlightCell(int DataCol, int DataRow, const System::AnsiString Value,  Grids::TGridDrawState  AState);

Beschreibung

In Anwendungen kann diese geschützte Methode nicht aufgerufen werden. Sie wird intern von der Methode DrawCell aufgerufen, um zu bestimmen, ob die angegebene Zelle hervorgehoben werden soll. HighlightCell gibt den Wert True zurück, falls die Zelle den Fokus besitzt, markiert ist und Options den Wert dgAlwaysShowSelection enthält oder sich die Zelle in einer markierten Zeile befindet und Options den Wert dgRowSelect enthält.


TCustomDBGrid::KeyDown

TCustomDBGrid	Siehe auch

Mit der Methode KeyDown können Sie spezielle Aktionen durchführen, wenn der Benutzer eine Taste drückt.

virtual void __fastcall KeyDown(unsigned short &Key,  Classes::TShiftState Shift);

Beschreibung

In Anwendungen kann KeyDown nicht direkt aufgerufen werden. Die Methode wird automatisch vor der Methode KeyPress aufgerufen, wenn eine Taste gedrückt wird.

KeyDown löst das Ereignis OnKeyDown aus und reagiert anschließend auf die folgenden Tastenanschläge:

Taste	Reaktion

AUF	Der Cursor wird zur vorhergehenden Zeile verschoben. Falls Options den Wert dgRowSelect enthält, wird die Zeile ausgewählt.

STRG+AUF	Der Cursor wird zur ersten Zeile des Gitters verschoben. Die Auswahl aller Zeilen wird aufgehoben.

AB	Der Cursor wird zur nächsten Zeile verschoben. Falls Options den Wert dgRowSelect enthält, wird die Zeile ausgewählt.

STRG+AB	Der Cursor wird zur letzten Zeile des Gitters verschoben. Die Auswahl aller Zeilen wird aufgehoben.

BILD AUF	Der Cursor wird um die Anzahl der Datensätze nach oben verschoben, die im Gitter angezeigt werden. Die Auswahl aller Zeilen wird aufgehoben.

STRG+BILD AUF	Der Cursor wird zur ersten Zeile des Gitters verschoben. Die Auswahl aller Zeilen wird aufgehoben.

BILD AB	Der Cursor wird um die Anzahl der Datensätze nach unten verschoben, die im Gitter angezeigt werden. Die Auswahl aller Zeilen wird aufgehoben.

LINKS	Der Cursor wird um eine Spalte nach links verschoben. Falls Options die Konstante dgRowSelect enthält, wird der Cursor in die vorhergehende Zeile verschoben, ohne daß diese ausgewählt wird.

STRG+LINKS	Der Cursor wird zur ersten Spalte der aktuellen Zeile verschoben.

RECHTS	Der Cursor wird um eine Spalte nach rechts verschoben. Falls Options die Konstante dgRowSelect enthält, wird der Cursor in die nächste Zeile verschoben, ohne daß diese ausgewählt wird.

STRG+RECHTS	Der Cursor wird zur letzten Spalte der aktuellen Zeile verschoben.

POS1	Der Cursor wird zur ersten Spalte der aktuellen Zeile verschoben. Falls Options die Konstante dgRowSelect enthält oder das Gitter nur aus einer Spalte besteht, wird der Cursor zum ersten Datensatz der Datenmenge verschoben. Die Auswahl aller Zeilen wird aufgehoben.

STRG+POS1	Der Cursor wird zum ersten Datensatz der Datenmenge verschoben. Die Auswahl aller Zeilen wird aufgehoben.

ENDE	Der Cursor wird zur letzten Spalte der aktuellen Zeile verschoben. Falls Options die Konstante dgRowSelect enthält oder das Gitter nur aus einer Spalte besteht, wird der Cursor zum letzten Datensatz der Datenmenge verschoben. Die Auswahl aller Zeilen wird aufgehoben.

STRG+ENDE	Der Cursor wird zum letzten Datensatz der Datenmenge verschoben. Die Auswahl aller Zeilen wird aufgehoben.

TAB	Der Cursor wird zur nächsten Zelle des Gitters verschoben.

UMSCHALT+TAB	Der Cursor wird zur vorhergehenden Zelle des Gitters verschoben.

STRG+ENTF	Die aktuelle Auswahl wird gelöscht.

EINFG	Über der aktuellen Zeile wird eine neue Zeile eingefügt. Der Cursor wird dorthin verschoben. Die Auswahl aller Zeilen wird aufgehoben.

ESC	Alle nicht eingetragenen Bearbeitungen werden verworfen. Die Auswahl aller Zeilen wird aufgehoben.

F2	Das Gitter wird in den Bearbeitungsmodus versetzt.


TCustomDBGrid::KeyPress

TCustomDBGrid	Siehe auch

Die Methode KeyPress überschreibt die geerbte Methode, um die Bearbeitungen in die Datenbank einzutragen, wenn die Eingabetaste gedrückt wird.

virtual void __fastcall KeyPress(char &Key);

Beschreibung

Sobald eine Taste gedrückt wird, wird zuerst die Methode KeyDown und anschließend die Methode KeyPress aufgerufen. Schließlich wird die Methode KeyUp aufgerufen, wenn der Benutzer die Taste losläßt. Mit KeyPress können Sie alle Bearbeitungen in die Datenbank eintragen und die geerbte Methode KeyPress aufrufen.


TCustomDBGrid::LayoutChanged

TCustomDBGrid	Siehe auch

Mit der Methode LayoutChanged können Sie die Eigenschaft Columns neu berechnen.

virtual void __fastcall LayoutChanged(void);

Beschreibung

In Anwendungen kann diese geschützte Methode nicht aufgerufen werden. Sie wird automatisch als Reaktion auf €nderungen aufgerufen, die sich auf das Layout der Spalten auswirken. Dazu gehören folgende €nderungen:

•	€nderungen der Felder der Datenmenge.

•	€nderungen der Eigenschaft Options, die sich auf das Layout auswirken.

•	€nderungen der Eigenschaft TitleFont.

Die Methode AcquireLayoutLock wird aufgerufen, um die €nderungen von Columns einzuleiten. Gibt die Methode nicht an, daß der Aufruf von LayoutChanged rekursiv erfolgt, wird von LayoutChanged die Methode EndLayout aufgerufen, um die eigentliche Berechnung durchzuführen.


TCustomDBGrid::LinkActive

TCustomDBGrid	Siehe auch

Die Methode LinkActive berechnet die Eigenschaft Columns und die vertikale Bildlaufleiste des Gitters neu.

virtual void __fastcall LinkActive(bool Value);

Beschreibung

In Anwendungen kann diese geschützte Methode nicht aufgerufen werden. Sie wird automatisch aufgerufen, wenn die Datenmenge geöffnet wird. LinkActive ruft LayoutChanged auf, um die Eigenschaft Columns neu zu berechnen, und paßt die vertikale Bildlaufleiste an die Daten in der Datenmenge an.


TCustomDBGrid::Loaded

TCustomDBGrid	Siehe auch

Mit der Methode Loaded können Sie die Eigenschaft Columns setzen, nachdem das Datengitter und alle untergeordneten Komponente geladen wurden.

virtual void __fastcall Loaded(void);

Beschreibung

In Anwendungen kann diese geschützte Methode nicht aufgerufen werden. Loaded überschreibt die geerbte Methode, um das Gitter zu formatieren, nachdem alle Elemente geladen wurden.


TCustomDBGrid::MouseDown

TCustomDBGrid	Siehe auch

Mit der Methode MouseDown können Sie spezielle Aktionen durchführen, wenn der Benutzer eine Maustaste drückt.

virtual void __fastcall MouseDown(Controls::TMouseButton Button,  Classes::TShiftState Shift, int X, int Y);

Beschreibung

Die Methode MouseDown wird automatisch aufgerufen, wenn der Benutzer eine Maustaste drückt. Wird die Maus in einem Bereich des Gitters gedrückt, in dem Größenänderungen der Zeilen oder Spalten möglich sind, trägt MouseDown alle Bearbeitungen ein und ruft die geerbte Methode auf, um die Größenänderung zu verarbeiten. Enthält Options die Konstante dgRowSelect, wird die Zeile markiert, auf die geklickt wurde. Falls die Taste STRG gedrückt wurde, wird der Auswahlstatus umgeschaltet. Wird mit der Maus auf eine Datenzelle geklickt, wird das Gitter in den Bearbeitungsmodus versetzt.


TCustomDBGrid::Notification

TCustomDBGrid	Siehe auch

Mit der Methode Notification können Sie das Gitter korrigieren, wenn eine untergeordnete Komponente freigegeben wird.

virtual void __fastcall Notification(Classes::TComponent* AComponent, Classes::TOperation Operation );

Beschreibung

Nach dem Aufruf der geerbten Methode können Sie mit Notification folgende Aktionen durchführen:

•	Es wird geprüft, ob das Popup-Menü einer Spalte freigegeben wird. Ist dies der Fall, wird die Eigenschaft PopupMenu des Spaltenobjekts zurückgesetzt.

•	Es wird geprüft, ob die Datenquelle freigegeben wird. Ist dies der Fall, wird die Eigenschaft DataSource auf NULL gesetzt.

•	Es wird geprüft, ob eine mit einer Spalte verbundene Feldkomponente freigegeben wird. Ist dies der Fall, wird die Spalte aus dem Layout entfernt.


TCustomDBGrid::RawToDataColumn

TCustomDBGrid	Siehe auch

Die Methode RawToDataColumn konvertiert einen Spaltenindex der Anzeige in den entsprechenden Index der Eigenschaft Columns.

int __fastcall RawToDataColumn(int ACol);

Beschreibung

In Anwendungen kann diese geschützte Methode nicht aufgerufen werden. Sie wird intern verwendet, um das datensensitive Gitter anzupassen, wenn die Spalte mit der Datensatzmarkierung hinzugefügt oder entfernt wird.


TCustomDBGrid::Scroll

TCustomDBGrid	Siehe auch

Die Methode Scroll aktualisiert die Darstellung des Gitters nach einer Verschiebung des Datensatzzeigers.

virtual void __fastcall Scroll(int Distance);

Beschreibung

Scroll wird aufgerufen, wenn der aktuelle Datensatz in der Datenmenge wechselt. Mit Scroll können Sie die Darstellung des Gitters aktualisieren. Gegebenenfalls wird der Bildschirmausschnitt verschoben.


TCustomDBGrid::SetColumnAttributes

TCustomDBGrid	Siehe auch

Die Methode SetColumnAttributes stellt die Spaltenbreiten ein und verhindert, daß der Cursor mit der Taste TAB zu einer Zelle verschoben wird, die nicht bearbeitet werden kann.

virtual void __fastcall SetColumnAttributes(void);

Beschreibung

In Anwendungen kann diese geschützte Methode nicht aufgerufen werden. Sie wird automatisch aufgerufen, wenn die Eigenschaft Columns neu berechnet wird. Mit ihr können Sie die Spaltenbreiten anpassen und sicherstellen, daß der Cursor mit der Taste TAB nur zu den Feldern verschoben wird, die bearbeitet werden können.


TCustomDBGrid::SetEditText

TCustomDBGrid	Siehe auch

Die Methode SetEditText aktualisiert die bearbeitete Version der Daten in der aktuellen Zelle.

virtual void __fastcall SetEditText(long ACol, long ARow, const System::AnsiString Value);

Beschreibung

SetEditText wird vom Zelleditor aufgerufen, damit das Gitter den neuen Wert der aktuellen Zelle speichern kann. Das Gitter speichert diesen Wert, bis der Cursor zu einer anderen Zelle verschoben oder die Taste ESC gedrückt wird. Wird der Cursor zu einer anderen Zelle verschoben, wird dieser Wert in den Datensatz der Datenbank geschrieben. Drückt der Benutzer die Taste ESC, wird der Wert verworfen.


TCustomDBGrid::StoreColumns

TCustomDBGrid	Siehe auch

Die Methode StoreColumns gibt an, ob die Spalten des Gitters beim Sichern des Gitters gespeichert oder dynamisch erstellt werden.

bool __fastcall StoreColumns(void);

Beschreibung

Mit StoreColumns können Sie die Eigenschaft Columns nur speichern, wenn die Eigenschaft State in Columns den Wert csCustomized hat. Die Eigenschaft State gibt an, ob die Spalten automatisch aus den Feldern der Datenmenge erstellt oder im Programm bzw. mit dem Spalteneditor definiert werden.


TCustomDBGrid::TCustomDBGrid

TCustomDBGrid	Siehe auch

Der Konstruktor TCustomDBGrid erzeugt ein neues TCustomDBGrid-Objekt.

__fastcall virtual TCustomDBGrid(Classes::TComponent* AOwner);

Beschreibung

Mit der Methode TCustomDBGrid eines Nachkommens von TCustomDBGrid können Sie ein datensensitives Gitter zur Laufzeit erstellen. Die während des Entwurfs in ein Formular eingefügten Gitter werden automatisch erstellt.

Nach dem Aufruf des geerbten Konstruktors erstellt TCustomDBGrid die Hilfsobjekte, die vom datensensitiven Gitter verwendet werden, und initialisiert folgende Eigenschaften:

•	Color mit clWindow und ParentColor mit False

•	DefaultDrawing mit True

•	Options mit [dgEditing, dgTitles, dgIndicator, dgColumnResize, dgColLines, dgRowLines, dgTabs, dgConfirmDelete, dgCancelOnExit ]


TCustomDBGrid::TimedScroll

TCustomDBGrid	Siehe auch

Mit der Methode TimedScroll können Sie den aktuellen Datensatz verschieben, wenn die Maus in einen Bereich außerhalb der Datenzellen gezogen wird.

virtual void __fastcall TimedScroll( Grids::TGridScrollDirection Direction);

Beschreibung

Enthält der Parameter Direction den Wert sdUp, wird der Cursor der Datenmenge mit TimedScroll zum ersten sichtbaren Datensatz des Gitters verschoben. Enthält der Parameter Direction den Wert sdDown, wird der Cursor der Datenmenge mit TimedScroll zum letzten sichtbaren Datensatz des Gitters verschoben. Nach der Korrektur des aktuellen Datensatzes ruft TimedScroll die geerbte Methode auf, um die Darstellung zu aktualisieren.


TCustomDBGrid::ValidFieldIndex

TCustomDBGrid	Siehe auch

Die Methode ValidFieldIndex gibt an, ob sich ein Index auf das Spaltenarray auf ein gültiges  Feld der Datenmenge bezieht.

bool __fastcall ValidFieldIndex(int FieldIndex);

Beschreibung

Mit ValidFieldIndex können Sie bestimmen, ob in einer Spalte Daten aus einem Feld der Datenmenge angezeigt werden. Die Methode gibt den Wert True zurück, falls die Spalte mit einem Datenbankfeld verbunden ist. Handelt es sich bei der Spalte um ein berechnetes Feld, oder ist das Feld für die Spalte nicht definiert, wird False zurückgegeben.


Gültigkeitsbereich

Protected

Published

Zugriff

Read-only


Gültigkeitsbereich

Protected


Gültigkeitsbereich

Protected


Hierarchie

TObject

TPersistent

TComponent

TControl

TWinControl

TCustomControl

TCustomGrid


TCustomDBGrid Beispiel

TCustomDBGrid


TCustomEdit

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/stdctrls.hpp

Das Objekt TCustomEdit ist die abstrakte Klasse, von der alle Eingabefelder- und Memo-Steuerelemente abgeleitet werden.

Beschreibung

TCustomEdit kapselt das grundlegende Verhalten, das allen Komponenten für die Textbearbeitung gemeinsam ist. Zu diesem Zweck stehen Methoden und Eigenschaften zur Verfügung, die unterschiedliche Aufgaben erfüllen:

•	Grundlegende Bearbeitungsfunktionen: Markieren von Text, Bearbeitung von markiertem Text und Konvertierung der Groß-/Kleinschreibung.

•	Die Möglichkeit, auf Änderungen von Textinhalten zu reagieren.

•	Steuerung des Textzugriffs. Dies erfolgt entweder durch die Vergabe des Nur-Lesen-Attributs oder durch die Einführung eines Kennwortes, das den tatsächlichen Wert verbirgt.

Erstellen Sie keine Instanzen von TCustomEdit. Verwenden Sie TCustomEdit als Basisklasse, wenn Sie neue Steuerelementobjekte erzeugen, die dem Benutzer die Eingabe und Bearbeitung von Text ermöglichen. Die Eigenschaften und Methoden von TCustomEdit stellen sowohl grundlegende Verhaltensweisen zur Verfügung, die von den abgeleiteten Klassen geerbt werden, als auch Verhaltensweisen, die von Komponenten zur Anpassung des Verhaltens überschrieben werden können.


Eigenschaften von TCustomEdit

TCustomEdit	Alphabetisch	Legende

In TCustomEdit

AutoSelect

AutoSize

BorderStyle

CharCase

HideSelection

MaxLength

Modified

OEMConvert

PasswordChar

ReadOnly

SelLength

SelStart

SelText

Abgeleitet von TWinControl

Brush

ClientOrigin

ClientRect

ControlCount

Controls

Handle

HelpContext

Showing

TabOrder

TabStop

Abgeleitet von TControl

Align

BoundsRect

ClientHeight

ClientWidth

ControlState

ControlStyle

Cursor

Enabled

Height

Hint

Left

Name

Parent

ParentColor

ShowHint

Text

Top

Visible

Width

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TCustomEdit

TCustomEdit	Nach Objekten	Legende

Align

AutoSelect

AutoSize

BorderStyle

BoundsRect

Brush

CharCase

ClientHeight

ClientOrigin

ClientRect

ClientWidth

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlCount

ControlState

Controls

ControlStyle

Cursor

DesignInfo

Enabled

Handle

Height

HelpContext

HideSelection

Hint

Left

MaxLength

Modified

Name

OEMConvert

Owner

ParentColor

Parent

PasswordChar

ReadOnly

SelLength

SelStart

SelText

ShowHint

Showing

TabOrder

TabStop

Tag

Text

Top

Visible

Width


TCustomEdit::AutoSelect

TCustomEdit	Siehe auch	Beispiel

Die Eigenschaft AutoSelect bestimmt, ob der gesamte Text im Eingabefeld automatisch markiert wird, wenn das Steuerelement den Fokus erhält.

__property bool AutoSelect;

Beschreibung

Setzen Sie AutoSelect auf True, wenn der gesamte Text markiert werden soll, sobald das Eingabefeld den Fokus erhält. AutoSelect kann nur für einzeilige Eingabefelder verwendet werden.

Verwenden Sie AutoSelect, wenn der Benutzer den Text im Eingabefeld normalerweise ersetzt.


TCustomEdit::AutoSize

TCustomEdit	Siehe auch	Beispiel

Die Eigenschaft AutoSize legt fest, ob die Höhe des Eingabefeldes automatisch an den Text angepaßt wird.

__property bool AutoSize;

Beschreibung

Mit AutoSize kann die Größe des Client-Bereichs an die Höhe des Textes angepaßt werden. Wenn AutoSize den Wert False besitzt, hat das Eingabefeld eine feste Höhe. Ist AutoSize True, wird die Größe des Steuerelements angepaßt, sobald eine Änderung auftritt, die sich auf die Höhe des Eingabefeldes auswirkt. Dies ist beispielsweise beim Auswechseln der Schrift oder des Rahmenstils der Fall.

Hinweis

AutoSize paßt nur die Höhe des Eingabefeldes an. Auch wenn AutoSize auf True gesetzt ist, wird Text, der breiter als das Eingabefeld ist, abgeschnitten.


TCustomEdit::BorderStyle

TCustomEdit	Siehe auch	Beispiel

Die Eigenschaft BorderStyle legt fest, ob der Client-Bereich im Eingabefeld eine einzelne Linie als Rahmen verwendet.

__property Forms::TBorderStyle BorderStyle;

Beschreibung

Mit BorderStyle läßt sich die Art und Weise festlegen, in der der Client-Bereich des Eingabefeldes hervorgehoben wird. BorderStyle kann den Wert bsSingle oder bsNone haben. Wenn BorderStyle den Wert bsSingle hat, besitzt der Client-Bereich im Eingabefeld eine einzelne Linie als Rahmen. Hat BorderStyle den Wert bsNone, ist kein Rahmen vorhanden.

Hinweis

BorderStyle erstellt in Kombination mit der Eigenschaft Ctl3D verschiedene visuelle Effekte. Kombinieren Sie unterschiedliche Eigenschaften, um das gewünschte Aussehen zu erreichen.


TCustomEdit::CharCase

TCustomEdit	Siehe auch	Beispiel

Die Eigenschaft CharCase bestimmt die Schreibweise des Textes im Eingabefeld.

__property TEditCharCase CharCase;

Beschreibung

Mit CharCase kann für den Inhalt eines Eingabefeldes eine bestimmte Schreibweise erzwungen werden. Folgende Werte können für CharCase angegeben werden:

Wert	Bedeutung

ecLowerCase	Der Text wird in Kleinbuchstaben umgewandelt.

ecNormal	Der Text wird in normaler Groß-/Kleinschreibung angezeigt. Es wird keine besondere Schreibweise erzwungen.

ecUpperCase	Der Text wird in Großbuchstaben umgewandelt.

Wird CharCase auf ecLowerCase oder ecUpperCase gesetzt, werden die Zeichen bei der Eingabe entsprechend umgewandelt. Wenn die Eigenschaft CharCase zu ecLowerCase oder ecUpperCase geändert wird, ändert sich nicht nur die Darstellung, sondern auch die Attribute des Textes. Alle Informationen, die die Schreibweise betreffen, gehen verloren und können durch Ändern von CharCase auf ecNormal nicht wiederhergestellt werden.


TCustomEdit::HideSelection

TCustomEdit	Siehe auch	Beispiel

Die Eigenschaft HideSelection legt fest, ob die visuelle Kennzeichnung des markierten Textes erhalten bleibt, wenn der Fokus an ein anderes Steuerelement übergeht.

__property bool HideSelection;

Beschreibung

Setzen Sie HideSelection auf False, um die sichtbare Kennzeichnung des markierten Textbereichs zu erhalten, wenn das Eingabefeld den Fokus nicht besitzt.  Ist HideSelection auf True gesetzt, wird die Markierung nur angezeigt, wenn das Eingabefeld den Fokus besitzt. HideSelection hat keine Auswirkung auf den Wert der Markierung, sondern nur auf deren Sichtbarkeit. Wenn HideSelection immer auf False gesetzt wird, wirken Formulare mit vielen Eingabefeldern häufig unübersichtlich.


TCustomEdit::MaxLength

TCustomEdit	Siehe auch	Beispiel

Die Eigenschaft MaxLength legt die maximale Anzahl der Zeichen fest, die der Benutzer in das Eingabefeld eingeben kann.

__property int MaxLength;

Beschreibung

Mit MaxLength läßt sich die Anzahl der Zeichen einschränken, die in das Eingabefeld eingegeben werden können. Der Wert 0 gibt an, daß keine Längenbeschränkung besteht. MaxLength wird nur für einzeilige Eingabefelder verwendet.

Mit MaxLength wird die Länge des Textes in einem Eingabefeld eingeschränkt, wenn dieser Text in einen Puffer mit fester Länge kopiert werden soll.

Hinweis

Durch das Setzen von MaxLength wird der bestehende Text nicht abgeschnitten. Der Benutzer wird lediglich daran gehindert, weiterhin Text einzugeben, wenn die in MaxLength angegebene Beschränkung erreicht ist.


TCustomEdit::Modified

TCustomEdit	Siehe auch	Beispiel

Die Eigenschaft Modified gibt an, ob der Benutzer den Text im Eingabefeld bearbeitet hat.

__property bool Modified;

Beschreibung

Wenn Sie feststellen wollen, ob sich die Eigenschaft Text in einem Eingabefeld geändert hat, verwenden Sie Modified. Die Eigenschaft Modified sollte auf True gesetzt werden, falls eine Anwendung die Eigenschaft Text in einem Eingabefeld direkt ändert.


TCustomEdit::OEMConvert

TCustomEdit	Siehe auch

Die Eigenschaft OEMConvert legt fest, ob die in das Eingabefeld eingegebenen Zeichen von ANSI in OEM und wieder zurück in ANSI konvertiert werden sollen.

__property bool OEMConvert;

Beschreibung

Um sicherzustellen, daß die in das Eingabefeld eingegebenen Zeichen eindeutig in den OEM-Zeichensatz umgewandelt werden können, müssen Sie OEMConvert auf True setzen. In diesem Fall werden alle Zeichen bei ihrer Eingabe von ANSI in OEM und danach wieder in ANSI konvertiert. Wenn es nicht wichtig ist, daß der Text eindeutig in einen OEM-String konvertiert werden kann, können Sie OEMConvert auf False setzen, um den Rechenaufwand dieser Konvertierung zu vermeiden.

OEMConvert ist besonders bei Eingabefeldern für Dateinamen hilfreich, wenn die Anwendung keine Unicode-Dateinamen verwendet.


TCustomEdit::PasswordChar

TCustomEdit	Siehe auch	Beispiel

Die Eigenschaft PasswordChar gibt das Zeichen an (falls vorhanden), das anstelle des tatsächlich in das Steuerelement eingegebenen Zeichens angezeigt werden soll.

__property char PasswordChar;

Beschreibung

Mit Hilfe von PasswordChar läßt sich ein Eingabefeld erstellen, das anstatt des eingegebenen Textes ein spezielles Zeichen anzeigt. Wenn PasswordChar auf das Zeichen Null (ANSI-Zeichen Null) gesetzt wird, zeigt das Eingabefeld den Text normal an. Wird PasswordChar auf ein anderes Zeichen gesetzt, wird dieses im Eingabefeld anstelle des eingegebenen Zeichens angezeigt. PasswordChar wirkt sich nur auf das Aussehen des Eingabefeldes aus. Der Wert der Eigenschaft Text enthält die tatsächlich eingegebenen Zeichen.


TCustomEdit::ReadOnly

TCustomEdit	Siehe auch	Beispiel

Die Eigenschaft ReadOnly legt fest, ob der Benutzer den Text im Eingabefeld bearbeiten kann.

__property bool ReadOnly;

Beschreibung

Wenn das Eingabefeld nur angezeigt werden soll, setzen Sie die Eigenschaft ReadOnly auf True. Soll der Inhalt des Eingabefeldes auch geändert werden können, setzen Sie ReadOnly auf False.

Durch das Setzen von ReadOnly auf True stellen Sie sicher, daß der Text nicht geändert wird, ermöglichen dem Benutzer aber weiterhin die Textmarkierung. Der markierte Text kann dann von der Anwendung bearbeitet oder in die Zwischenablage kopiert werden.


TCustomEdit::SelLength

TCustomEdit	Siehe auch	Beispiel

Die Eigenschaft SelLength gibt die Anzahl der markierten Zeichen an.

__property int SelLength;

Beschreibung

Durch Lesen von SelLength wird die Länge des markierten Textes in Zeichen bestimmt. Durch Setzen von SelLength wird die Markierung so geändert, daß sie aus den ersten SelLength-Zeichen besteht und bei SelStart beginnt.

Hinweis

Wird SelLength auf einen Wert gesetzt, der größer als die Anzahl der Zeichen zwischen SelStart und den Textende ist, werden alle Zeichen von SelStart bis zum Textende markiert. Wenn Sie die Eigenschaft SelLength auf einen Wert setzen, der größer als die Anzahl der zur Verfügung stehenden Zeichen ist, wird nicht der gerade gesetzte Wert, sondern die Anzahl der tatsächlich markierten Zeichen zurückgegeben.


TCustomEdit::SelStart

TCustomEdit	Siehe auch

Die Eigenschaft SelStart gibt die Position des ersten markierten Zeichens im Text an.

__property int SelStart;

Beschreibung

Durch Lesen von SelStart wird die Position des ersten markierten Zeichens festgelegt, wobei 0 das erste Zeichen angibt. Ist kein markierter Text vorhanden, bezeichnet SelStart die Position des Cursors. Setzen Sie SelStart, um die aktuelle Markierung zu entfernen und den Cursor unmittelbar vor das angegebene Zeichen zu positionieren.

Wenn ein bestimmter Textbereich markiert werden soll, setzen Sie zuerst SelStart auf die Position des Cursors. Danach setzen Sie SelLength, um die Markierung zu erweitern.


TCustomEdit::SelText

TCustomEdit	Siehe auch	Beispiel

Die Eigenschaft SelText ist der markierte Textbereich des Eingabefeldes.

__property System::AnsiString SelText;

Beschreibung

Durch Lesen von SelText läßt sich der Wert des markierten Textes ermitteln. Setzen Sie SelText, wenn der markierte Text durch einen neuen String ersetzt werden soll. Wenn keine Markierung vorhanden ist, das Eingabefeld aber den Fokus besitzt, setzen Sie SelText, um einen neuen String an der Cursorposition in den Text einzufügen.


Ereignisse von TCustomEdit

TCustomEdit	Alphabetisch	Legende

In TCustomEdit

OnChange


Ereignisse von TCustomEdit

TCustomEdit	Nach Objekten	Legende

OnChange


TCustomEdit::OnChange

TCustomEdit	Siehe auch

Das Ereignis OnChange tritt ein, wenn die Möglichkeit besteht, daß der Text für das Eingabefeld geändert wurde.

__property Classes::TNotifyEvent OnChange;

Beschreibung

Durch Erstellung einer Ereignisbehandlungsroutine für OnChange können Sie für die Ausführung einer spezifischen Aktion sorgen, wenn die Möglichkeit besteht, daß sich der Text des Eingabefeldes geändert hat. Mit Hilfe der Eigenschaft Modified läßt sich überprüfen, ob tatsächlich eine Änderung stattgefunden hat. Die Eigenschaft Text des Eingabefeldes wird sofort entsprechend aktualisiert. Dieses Ereignis stellt die erste Möglichkeit zur Reaktion auf Änderungen dar, die der Benutzer im Eingabefeld vorgenommen hat.


Methoden von TCustomEdit

TCustomEdit	Alphabetisch	Legende

In TCustomEdit

~TCustomEdit

Change

Clear

ClearSelection

CopyToClipboard

CreateParams

CreateWnd

CutToClipboard

DestroyWnd

GetSelTextBuf

PasteFromClipboard

SelectAll

SetSelTextBuf

TCustomEdit

Abgeleitet von TWinControl

Broadcast

CanFocus

ContainsControl

ControlAtPos

DisableAlign

EnableAlign

Focused

GetTabOrderList

HandleAllocated

HandleNeeded

InsertControl

Invalidate

PaintTo

Realign

RemoveControl

Repaint

ScaleBy

ScrollBy

SetBounds

SetFocus

Update

UpdateControlState

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

GetTextLen

Hide

Perform

Refresh

ScreenToClient

SendToBack

SetTextBuf

Show

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TCustomEdit

TCustomEdit	Nach Objekten	Legende

~TCustomEdit

Assign

BeginDrag

BringToFront

Broadcast

CanFocus

Change

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

ClearSelection

Clear

ClientToScreen

ContainsControl

ControlAtPos

CopyToClipboard

CreateParams

CreateWnd

CutToClipboard

DefaultHandler

DestroyComponents

Destroying

DestroyWnd

DisableAlign

Dispatch

DragDrop

Dragging

EnableAlign

EndDrag

FieldAddress

FindComponent

Focused

FreeInstance

FreeNotification

Free

GetParentComponent

GetSelTextBuf

GetTabOrderList

GetTextBuf

GetTextLen

HandleAllocated

HandleNeeded

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InsertControl

InstanceSize

Invalidate

MethodAddress

MethodName

NewInstance

PaintTo

PasteFromClipboard

Perform

Realign

Refresh

RemoveComponent

RemoveControl

Repaint

ScaleBy

ScreenToClient

ScrollBy

SelectAll

SendToBack

SetBounds

SetFocus

SetSelTextBuf

SetTextBuf

Show

TCustomEdit

UpdateControlState

Update


TCustomEdit::~TCustomEdit

TCustomEdit

Der Destruktor ~TCustomEdit gibt den Speicher frei, der für das TCustomEdit-Objekt reserviert war. Rufen Sie ~TCustomEdit nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TCustomEdit automatisch aufgerufen wird.

__fastcall virtual ~TCustomEdit(void);


TCustomEdit::Change

TCustomEdit	Siehe auch

Die Methode Change reagiert auf Änderungen in der Eigenschaft Text durch einen Aufruf der Ereignisbehandlungsroutine für OnChange (falls dieser zugewiesen ist).

virtual void __fastcall Change(void);

Beschreibung

Anwendungen rufen die Methode Change nicht direkt auf. Sie wird automatisch von Windows-Ereignissen ausgelöst. Change ist als Methode vom Typ protected deklariert. Damit können abgeleitete Klassen zusätzliche Reaktionen auf Änderungen der Eigenschaft Text definieren, die über den Aufruf der Ereignisbehandlungsroutine für OnChange hinausgehen. Abgeleitete Klassen, die die Methode Change überschreiben, sollten die geerbte Methode aufrufen.


TCustomEdit::Clear

TCustomEdit	Siehe auch

Die Methode Clear löscht den gesamten Text im Eingabefeld.

void __fastcall Clear(void);

Beschreibung

Mit Clear wird die Eigenschaft Text durch einen leeren String ersetzt. Clear entfernt den gesamten Text, nicht nur die markierten Bereiche. Wenn nur der markierte Text gelöscht werden soll, verwenden Sie ClearSelection.


TCustomEdit::ClearSelection

TCustomEdit	Siehe auch	Beispiel

Die Methode ClearSelection entfernt den markierten Text aus dem Eingabefeld.

void __fastcall ClearSelection(void);

Beschreibung

ClearSelection entfernt den markierten Text aus dem Eingabefeld. Ist kein Text markiert, wird mit ClearSelection wie mit der Methode Clear der gesamte Text gelöscht. Wenn der gesamte Text markiert ist, hat ClearSelection die gleichen Auswirkungen wie die Methode Clear: der Text wird vollständig gelöscht.

Hinweis

Der Aufruf von ClearSelection entspricht dem Senden einer WM_CLEAR-Botschaft an das Eingabefeld.


TCustomEdit::CopyToClipboard

TCustomEdit	Siehe auch	Beispiel

Die Methode CopyToClipboard kopiert den markierten Text im Eingabefeld im Format CF_TEXT in die Zwischenablage.

void __fastcall CopyToClipboard(void);

Beschreibung

Mit CopyToClipboard wird der Inhalt der Zwischenablage durch den markierten Text ersetzt. Ist kein Text markiert, wird die Zwischenablage von dieser Methode nicht gelöscht. CopyToClipboard führt in diesem Fall keine Aktionen aus.

Hinweis

Der Aufruf von CopyToClipboard entspricht dem Senden einer WM_COPY-Botschaft an das Eingabefeld.


TCustomEdit::CreateParams

TCustomEdit	Siehe auch

Die Methode CreateParams initialisiert einen Datensatz mit Parametern zur Fenstererstellung, der im Parameter Params übergeben wird.

virtual void __fastcall CreateParams(Controls::TCreateParams &Params);

Beschreibung

Die Methode CreateWnd ruft CreateParams zur Initialisierung der Parameter auf, die von ihr an CreateWindowHandle übergeben werden. TCustomEdit überschreibt die geerbte Methode, um ein einzeiliges, bildlauffähiges Eingabefeld zu definieren, das die aktuellen Werte für die Eigenschaften BorderStyle, HideSelections, PasswordChar und ReadOnly verwendet.


TCustomEdit::CreateWnd

TCustomEdit	Siehe auch

Die Methode CreateWnd erstellt ein dem Eingabefeld entsprechendes Windows-Steuerelement.

virtual void __fastcall CreateWnd(void);

Beschreibung

CreateWnd wird einerseits bei der Erzeugung des Eingabefeldes aufgerufen und andererseits, wenn das Fenster wegen Änderungen am Eingabefeld erneut aufgebaut werden muß. Nach dem Aufruf der geerbten Methode sendet CreateWnd Botschaften, um die Eigenschaften MaxLength und PasswordChar geeignet zu belegen.


TCustomEdit::CutToClipboard

TCustomEdit	Siehe auch	Beispiel

Die Methode CutToClipboard kopiert den markierten Text im Eingabefeld im Format CF_TEXT in die Zwischenablage und löscht ihn aus dem Eingabefeld.

void __fastcall CutToClipboard(void);

Beschreibung

Mit CutToClipboard wird der Inhalt der Zwischenablage durch den markierten Text ersetzt, wobei dieser gelöscht wird. Ist kein Text markiert, führt CutToClipboard keine Aktionen aus.


TCustomEdit::DestroyWnd

TCustomEdit	Siehe auch

Die Methode DestroyWnd gibt das Windows-Steuerelement frei, das dem Eingabefeld entspricht.

virtual void __fastcall DestroyWnd(void);

Beschreibung

Vor der Freigabe des Fensters speichert DestroyWnd eine Kopie aller Fenstereigenschaften, die für die Neuerstellung des Fensters nach seiner Freigabe erforderlich sind.


TCustomEdit::GetSelTextBuf

TCustomEdit	Siehe auch	Beispiel

Die Methode GetSelTextBuf kopiert den markierten Text in einen Puffer und liefert die Anzahl der kopierten Zeichen zurück.

int __fastcall GetSelTextBuf(char * Buffer, int BufSize);

Beschreibung

Mit GetSelTextBuf wird der markierte Text in einen Zeichenpuffer kopiert. Wenn kein markierter Text vorhanden ist, empfängt der Puffer einen leeren String. Umfaßt die Markierung mehr als (BufSize - 1)Zeichen, werden nur die ersten (BufSize - 1)Zeichen kopiert. GetSelTextBuf liefert die Anzahl der Zeichen, die in den Puffer kopiert wurden.


TCustomEdit::PasteFromClipboard

TCustomEdit	Siehe auch	Beispiel

Die Methode PasteFromClipboard kopiert den Inhalt der Zwischenablage in ein Eingabefeld und ersetzt den aktuell markierten Text.

void __fastcall PasteFromClipboard(void);

Beschreibung

Mit PasteFromClipboard wird der markierte Text durch den Inhalt der Zwischenablage ersetzt. Wenn kein Text markiert ist, wird der Inhalt der Zwischenablage an der Cursorposition eingefügt. Falls die Zwischenablage leer ist oder keinen Text im Format CF_TEXT enthält, führt PasteFromClipbard keine Aktionen aus.

Hinweis

Der Aufruf von PasteFromClipboard entspricht dem Senden einer WM_PASTE-Botschaft an das Eingabefeld.


TCustomEdit::SelectAll

TCustomEdit	Siehe auch	Beispiel

Die Methode SelectAll markiert den gesamten Text im Eingabefeld.

void __fastcall SelectAll(void);

Beschreibung

Mit SelectAll wird der gesamte Text im Eingabefeld markiert. Für die Markierung von Textteilen stehen die Eigenschaften SelStart und SelLength zur Verfügung.


TCustomEdit::SetSelTextBuf

TCustomEdit	Siehe auch	Beispiel

Die Methode SetSelTextBuf ersetzt den markierten Text durch einen nullterminierten String.

void __fastcall SetSelTextBuf(char * Buffer);

Beschreibung

Mit SetSelTextBuf wird der aktuell markierte Text durch den Inhalt des nullterminierten Strings ersetzt, auf den Buffer zeigt. Ist kein Text markiert, wird der Inhalt von Buffer an der Cursorposition eingefügt. SetSelTextBuf entspricht dem Setzen der Eigenschaft SelText. Anstelle eines Strings wird jedoch ein PChar-Wert verwendet.


TCustomEdit::TCustomEdit

TCustomEdit	Siehe auch

Der Konstruktor TCustomEdit erzeugt ein neues TCustomEdit-Objekt.

__fastcall virtual TCustomEdit(Classes::TComponent* AOwner);

Beschreibung

Mit TCustomEdit wird eine Instanz von TCustomEdit erzeugt und initialisiert.

Nach dem Aufruf des geerbten Konstruktors initialisiert TCustomEdit die nachstehenden Eigenschaften wie folgt:

•	AutoSelect mit True.

•	AutoSize mit True.

•	BorderStyle mit bsSingle.

•	ControlStyle mit [csClickEvents, csDoubleClicks, csFixedHeight, csSetCaption].

•	Height und Width mit 25 und 121.

•	HideSelection mit True.

•	ParentColor mit False.

•	TabStop mit True.


Gültigkeitsbereich

Protected

Published

Zugriff

Read-only


Gültigkeitsbereich

Protected


Gültigkeitsbereich

Protected


Hierarchie

TObject

TPersistent

TComponent

TControl

TWinControl


TCustomEdit Beispiel

TCustomEdit


TCustomGroupBox

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/stdctrls.hpp

TCustomGroupBox ist die abstrakte Basisklasse für alle Gruppenfeldkomponenten.

Beschreibung

Gruppenfelder sind visuelle Komponenten, die als Container für zusammengehörige verwandte Steuerelemente (z.B. Optionsfelder) dienen. Gruppenfelder können weitere Gruppenfelder enthalten. TCustomGroupBox ist die abstrakte Klasse, von der alle Gruppenfeldkomponenten - einschließlich TGroupBox, TRadioGroup und TDBRadioGroup - abgeleitet sind.

Neben den von TCustomControl geerbten Methoden überschreibt TCustomGroupBox die Methode AlignControls (geerbt von TWinControl), mit der die Position der Komponenten innerhalb des Gruppenfeldes gesteuert werden kann.


Eigenschaften von TCustomGroupBox

TCustomGroupBox	Alphabetisch	Legende

Abgeleitet von TWinControl

Brush

ClientOrigin

ClientRect

ControlCount

Controls

Handle

HelpContext

Showing

TabOrder

TabStop

Abgeleitet von TControl

Align

BoundsRect

ClientHeight

ClientWidth

ControlState

ControlStyle

Cursor

Enabled

Height

Hint

Left

Name

Parent

ShowHint

Top

Visible

Width

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TCustomGroupBox

TCustomGroupBox	Nach Objekten	Legende

Align

BoundsRect

Brush

ClientHeight

ClientOrigin

ClientRect

ClientWidth

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlCount

ControlState

Controls

ControlStyle

Cursor

DesignInfo

Enabled

Handle

Height

HelpContext

Hint

Left

Name

Owner

Parent

ShowHint

Showing

TabOrder

TabStop

Tag

Top

Visible

Width


Methoden von TCustomGroupBox

TCustomGroupBox	Alphabetisch	Legende

In TCustomGroupBox

~TCustomGroupBox

Paint

TCustomGroupBox

Abgeleitet von TWinControl

Broadcast

CanFocus

ContainsControl

ControlAtPos

DisableAlign

EnableAlign

Focused

GetTabOrderList

HandleAllocated

HandleNeeded

InsertControl

Invalidate

PaintTo

Realign

RemoveControl

Repaint

ScaleBy

ScrollBy

SetBounds

SetFocus

Update

UpdateControlState

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

GetTextLen

Hide

Perform

Refresh

ScreenToClient

SendToBack

SetTextBuf

Show

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TCustomGroupBox

TCustomGroupBox	Nach Objekten	Legende

~TCustomGroupBox

Assign

BeginDrag

BringToFront

Broadcast

CanFocus

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

ClientToScreen

ContainsControl

ControlAtPos

DefaultHandler

DestroyComponents

Destroying

DisableAlign

Dispatch

DragDrop

Dragging

EnableAlign

EndDrag

FieldAddress

FindComponent

Focused

FreeInstance

FreeNotification

Free

GetParentComponent

GetTabOrderList

GetTextBuf

GetTextLen

HandleAllocated

HandleNeeded

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InsertControl

InstanceSize

Invalidate

MethodAddress

MethodName

NewInstance

Paint

PaintTo

Perform

Realign

Refresh

RemoveComponent

RemoveControl

Repaint

ScaleBy

ScreenToClient

ScrollBy

SendToBack

SetBounds

SetFocus

SetTextBuf

Show

TCustomGroupBox

UpdateControlState

Update


TCustomGroupBox::~TCustomGroupBox

TCustomGroupBox

Der Destruktor ~TCustomGroupBox gibt den Speicher frei, der für das TCustomGroupBox-Objekt reserviert war. Rufen Sie ~TCustomGroupBox nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TCustomGroupBox automatisch aufgerufen wird.

__fastcall virtual ~TCustomGroupBox(void);


TCustomGroupBox::Paint

TCustomGroupBox	Siehe auch

Die Methode Paint erstellt das Bild, das auf dem Bildschirm für das Gruppenfeld angezeigt wird.

virtual void __fastcall Paint(void);

Beschreibung

Paint erzeugt eine Windows-RECT-Struktur, umgibt sie mit einem Rahmen und fügt durch einen Aufruf der DrawText-Funktion von Windows den Titel ein. Wird Ctl3D (eine von TWinControl geerbte Protected-Eigenschaft) auf True gesetzt, zeichnet Paint den Rahmen mit dreidimensionalem Aussehen.


TCustomGroupBox::TCustomGroupBox

TCustomGroupBox	Siehe auch

Der Konstruktor TCustomGroupBox erzeugt ein neues TCustomGroupBox-Objekt.

__fastcall virtual TCustomGroupBox(Classes::TComponent* AOwner);

Beschreibung

Nach dem Aufruf des Konstruktors des übergeordneten Objekts initialisiert TCustomGroupBox die Eigenschaft ControlStyle mit folgenden Flags: csAcceptsControls, csCaptureMouse, csClickEvents, csSetCaption, csDoubleClicks und csReplicatable. Außerdem werden Width und Height mit 185 bzw. 105 Pixel initialisiert.


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Protected


Hierarchie

TObject

TPersistent

TComponent

TControl

TWinControl

TCustomControl


TCustomGroupBox Beispiel

TCustomGroupBox


TCustomGrid

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/grids.hpp

TCustomGrid ist der abstrakte Basistyp für alle Komponenten, die Informationen in einem zweidimensionalen Gitter darstellen.

Beschreibung

Mit TCustomGrid als Basisklasse können Sie Komponenten definieren, die Informationen tabellarisch darstellen. Das TCustomGrid-Objekt besitzt Eigenschaften und Methoden, mit denen das Aussehen und die Funktion des Gitters gesteuert werden kann, sowie vordefinierte Reaktionen auf Mausaktionen und Benutzereingaben.

Erstellen Sie keine Instanzen von TCustomGrid. Fügen Sie statt dessen ein Gitter in ein Formular ein, indem Sie einen Nachkommen von TCustomGrid erstellen. Verwenden Sie in einem tabellarischen Gitter für Elemente, die keinen Text repräsentieren, die Klasse TDrawGrid. Verwenden Sie für Text ein TStringGrid-Objekt. Falls der Text Feldwerte einer Datenmenge repräsentiert, verwenden Sie TDBGrid.

TCustomGrid kann auch als Basisklasse für Objekte verwendet werden, die Daten in einem zweidimensionalen Layout darstellen, das nicht tabellarisch ist. Beispielsweise ist TOutline ein Nachkomme von TCustomGrid.


Eigenschaften von TCustomGrid

TCustomGrid	Alphabetisch	Legende

In TCustomGrid

BorderStyle

Col

ColCount

ColWidths

DefaultColWidth

DefaultDrawing

DefaultRowHeight

EditorMode

FixedColor

FixedCols

FixedRows

GridHeight

GridLineWidth

GridWidth

InplaceEditor

LeftCol

Options

Row

RowCount

RowHeights

ScrollBars

Selection

TabStops

TopRow

VisibleColCount

VisibleRowCount

Abgeleitet von TWinControl

Brush

ClientOrigin

ClientRect

ControlCount

Controls

Handle

HelpContext

Showing

TabOrder

TabStop

Abgeleitet von TControl

Align

BoundsRect

ClientHeight

ClientWidth

Color

ControlState

ControlStyle

Cursor

Enabled

Height

Hint

Left

Name

Parent

ParentColor

ShowHint

Top

Visible

Width

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TCustomGrid

TCustomGrid	Nach Objekten	Legende

Align

BorderStyle

BoundsRect

Brush

ClientHeight

ClientOrigin

ClientRect

ClientWidth

ColCount

Color

Col

ColWidths

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlCount

ControlState

Controls

ControlStyle

Cursor

DefaultColWidth

DefaultDrawing

DefaultRowHeight

DesignInfo

EditorMode

Enabled

FixedColor

FixedCols

FixedRows

GridHeight

GridLineWidth

GridWidth

Handle

Height

HelpContext

Hint

InplaceEditor

LeftCol

Left

Name

Options

Owner

ParentColor

Parent

RowCount

RowHeights

Row

ScrollBars

Selection

ShowHint

Showing

TabOrder

TabStops

TabStop

Tag

TopRow

Top

VisibleColCount

VisibleRowCount

Visible

Width


TCustomGrid::BorderStyle

TCustomGrid	Siehe auch	Beispiel

Die Eigenschaft BorderStyle bestimmt, ob ein einfacher Rahmen um das Gitter gezeichnet wird.

__property Forms::TBorderStyle BorderStyle;

Beschreibung

Um einen einfachen Rahmen um das Gitter zu zeichnen, setzen Sie BorderStyle auf bsSingle. Um den Rahmen nicht darzustellen, verwenden Sie für BorderStyle den Wert bsNone.

Der visuelle Effekt von BorderStyle wird von der Eigenschaft Ctrl3D beeinflußt. Um den gewünschten Rahmen zu erhalten, können Sie verschiedene Werte in BorderStyle und Ctrl3D verwenden.


TCustomGrid::Col

TCustomGrid	Siehe auch	Beispiel

Die Eigenschaft Col bezeichnet den Index der Spalte, die die ausgewählte Zelle enthält.

__property long Col;

Beschreibung

Mit Col können Sie zur Laufzeit die aktuelle Spalte des Gitters bestimmen. Durch das Einstellen von Col wird der Fokus zu der Zelle der aktuellen Zeile verschoben, die sich in der neuen Spalte befindet. Die erste Spalte hat den Index 0, die zweite den Index 1 usw.

Die ausgewählte Zelle des Gitters kann mit der Eigenschaft Col und der Eigenschaft Row ermittelt werden. Mit diesen Eigenschaften werden die Indizes der Spalte und der Zeile abgerufen. Sobald der Fokus zum Gitter verschoben wird, erhält die ausgewählte Zelle den Eingabefokus.


TCustomGrid::ColCount

TCustomGrid	Siehe auch	Beispiel

Die Eigenschaft ColCount enthält die Anzahl der Spalten im Gitter.

__property long ColCount;

Beschreibung

Mit ColCount können Sie die Anzahl der Einträge im Array ColWidths bestimmen. Stellen Sie ColCount ein, um Spalten auf der rechten Seite des Gitters einzufügen oder zu löschen. Der Wert von ColCount enthält alle nicht verschiebbaren Spalten auf der linken Seite des Gitters sowie die Spalten im Gitter, die verschoben werden können.


Color

Die Eigenschaft Color enthält die Hintergrundfarbe des Gitters.

__property Color;

Beschreibung

Mit Color können Sie die Hintergrundfarbe des Gitters ermitteln und ändern. Die Hintergrundfarbe wird nicht für die fixierten Zeilen und Spalten des Gitters verwendet. Die Farbe der nicht verschiebbaren Zeilen und Spalten kann mit der Eigenschaft FixedColor geändert werden.

Die folgende Tabelle enthält die möglichen Werte von Color:

Wert	Bedeutung

clBlack	Schwarz

clMaroon	Rotbraun

clGreen	Grün

clOlive	Olivgrün

clNavy	Marineblau

clPurple	Violett

clTeal	Blaugrün

clGray	Grau

clSilver	Silbergrau

clRed	Rot

clLime	Limonengrün

clBlue	Blau

clFuchsia	Pink

clAqua	Türkis

clWhite	Weiß

clBackground	Aktuelle Hintergrundfarbe des Windows-Desktop

clActiveCaption	Aktuelle Farbe der Titelleiste des aktiven Fensters

clInactiveCaption	Aktuelle Farbe der Titelleiste inaktiver Fenster

clMenu	Aktuelle Hintergrundfarbe der Menüs

clWindow	Aktuelle Hintergrundfarbe der Fenster

clWindowFrame	Aktuelle Farbe der Fensterrahmen

clMenuText	Aktuelle Farbe von Menütext

clWindowText	Aktuelle Farbe von Fenstertext

clCaptionText	Aktuelle Farbe des Textes in der Titelleiste des aktiven Fensters

clActiveBorder	Aktuelle Rahmenfarbe des aktiven Fensters

clInactiveBorder	Aktuelle Rahmenfarbe inaktiver Fenster

clAppWorkSpace	Aktuelle Farbe des Arbeitsbereichs der Anwendung

clHighlight	Aktuelle Hintergrundfarbe von markiertem Text

clHightlightText	Aktuelle Farbe von markiertem Text

clBtnFace	Aktuelle Farbe einer Schaltfläche

clBtnShadow	Aktuelle Farbe des Schattens einer Schaltfläche

clGrayText	Aktuelle Farbe von grau dargestelltem Text

clBtnText	Aktuelle Farbe von Text auf einer Schaltfläche

clInactiveCaptionText	Aktuelle Farbe des Textes in der Titelleiste eines inaktiven Fensters

clBtnHighlight	Aktuelle Farbe der Hervorhebung einer Schaltfläche

cl3DDkShadow 	Nur Windows 95 oder NT 4.0: Dunkler Schatten für dreidimensionale Anzeigeelemente

cl3DLight 	Nur Windows 95 oder NT 4.0: Helle Farbe für dreidimensionale Anzeigeelemente (für Kanten, die dem Licht zugewandt sind)

clInfoText 	Nur Windows 95 oder NT 4.0: Textfarbe für Tool-Tip-Steuerelemente

clInfoBk 	Nur Windows 95 oder NT 4.0: Hintergrundfarbe für Tool-Tip-Steuerelemente

Hinweis

Hat die Eigenschaft ParentColor des Gitters den Wert True, wird die Eigenschaft Color des Gitters automatisch mit der Eigenschaft Color seines übergeordneten Objekts geändert. Durch das Einstellen der Eigenschaft Color erhält die Eigenschaft ParentColor automatisch den Wert False.


TCustomGrid::ColWidths

TCustomGrid	Siehe auch	Beispiel

Die Eigenschaft ColWidths enthält ein indiziertes Array mit der Breite der einzelnen Spalten des Gitters in Pixel.

__property int ColWidths[long Index];

Beschreibung

Mit ColWidths können Sie die Breite der Spalten bestimmen, die im Parameter Index angegeben sind. Der Index 0 bezieht sich auf die erste Spalte. Mit ColWidths können Sie die Breite jeder Spalte zur Laufzeit ändern.

Wurde die Breite einer Spalte nicht explizit mit der Maus oder mit der Eigenschaft ColWidths geändert, ist der Standard-Wert DefaultColWidth.

Mit der Eigenschaft ColCount können Sie die Anzahl der Einträge im Array ColWidths bestimmen.


TCustomGrid::DefaultColWidth

TCustomGrid	Siehe auch	Beispiel

Die Eigenschaft DefaultColWidth enthält die Breite aller Spalten des Gitters, die nicht explizit geändert wurde, in Pixel.

__property int DefaultColWidth;

Beschreibung

Mit DefaultColWidth können Sie die Breite aller Spalten des Gitters ändern. Beim Einstellen von DefaultColWidth erhalten auch die Spalten die Standardbreite, deren Breite mit der Maus oder mit der Eigenschaft ColWidth geändert wurden.

Werden mit der Eigenschaft ColCount neue Spalten in das Gitter eingefügt, wird ihre Breite auf DefaultColWidth eingestellt.


TCustomGrid::DefaultDrawing

TCustomGrid	Siehe auch	Beispiel

Die Eigenschaft DefaultDrawing bestimmt, ob die Zellen mit dem Gitter gezeichnet werden.

__property bool DefaultDrawing;

Beschreibung

Hat DefaultDrawing den Wert True, werden die Zellen des Gitters automatisch angezeigt. Dazu wird die Hintergrundfarbe eingefügt, in die fixierten Zellen werden die 3D-Effekte eingefügt und das Fokusrechteck umgibt die ausgewählte Zelle. Wenn Sie DefaultDrawing auf False setzen, werden die Zellen nicht mit dem Gitter gezeichnet.

Hat DefaultDrawing den Wert False, sollten die Zellen mit der Methode DrawCell gezeichnet werden. Für ein TCustomGrid-Objekt ist DrawCell eine abstrakte Methode. Die Nachkommen des TCustomGrid-Objekts verfügen mit DrawCell über eine eigene Zeichenmethode oder lösen das Ereignis OnDrawCell aus.


TCustomGrid::DefaultRowHeight

TCustomGrid	Siehe auch	Beispiel

Die Eigenschaft DefaultRowHeight enthält die Höhe aller Zeilen des Gitters, die nicht explizit geändert wurde, in Pixel.

__property int DefaultRowHeight;

Beschreibung

Mit DefaultRowHeight können Sie die Höhe aller Zeilen des Gitters ändern. Beim Einstellen von DefaultRowHeight erhalten auch die Zeilen die Standardhöhe, deren Höhe mit der Maus oder mit der Eigenschaft RowHeights geändert wurde.

Werden mit der Eigenschaft RowCount neue Zeilen in das Gitter eingefügt, wird ihre Höhe auf DefaultRowHeight eingestellt.


TCustomGrid::EditorMode

TCustomGrid	Siehe auch

Mit der Eigenschaft EditorMode können Sie bestimmen, ob die aktuelle Zelle bearbeitet werden kann.

__property bool EditorMode;

Beschreibung

Setzen Sie EditorMode zur Laufzeit auf True, um das Gitter in den Bearbeitungsmodus zu versetzen. In diesem Fall können die Zellen des Gitters bearbeitet werden. Mit F2 kann EditorMode auf True gesetzt werden. Mit der Eingabetaste kann der Wert von EditorMode umgeschaltet werden.

Hinweis

EditorMode hat keine Auswirkungen, wenn die Eigenschaft Options den Wert goAlwaysShowEditor und nicht den Wert goEditing enthält.


TCustomGrid::FixedColor

TCustomGrid	Siehe auch	Beispiel

Die Eigenschaft FixedColor enthält die Hintergrundfarbe der fixierten Zeilen und Spalten des Gitters.

__property Graphics::TColor FixedColor;

Beschreibung

Mit FixedColor können Sie die Farbe der Gitterzellen festlegen, die nicht verschoben werden können. Der bildlauffähige Bereich des Gitters wird in der Farbe der Eigenschaft Color angezeigt.

Die möglichen Werte für FixedColor finden Sie in der Beschreibung der Eigenschaft Color.


TCustomGrid::FixedCols

TCustomGrid	Siehe auch	Beispiel

Die Eigenschaft FixedCols enthält die Anzahl der Spalten auf der linken Seite des Gitters, die nicht verschoben werden können.

__property int FixedCols;

Beschreibung

Mit FixedCols können Sie nicht verschiebbare Spalten erstellen oder lösen. Diese Spalten erscheinen auf der linken Seite des Gitters und sind immer sichtbar, auch wenn der Bildschirmausschnitt zu anderen Spalten im Gitter verschoben wird. In den fixierten Spalten können Zeilentitel oder Zeilennummern angezeigt werden. Außerdem kann eine Funktion implementiert werden, mit der der Benutzer die Anzahl der fixierten Spalten einstellen kann.

Die fixierten Spalten unterscheiden sich visuell von den restlichen Spalten des Gitters. Sie werden mit einer eigenen Hintergrundfarbe angezeigt. Hat die Eigenschaft Ctrl3D den Wert True, erhalten die Zellen ein dreidimensionales Erscheinungsbild.

Hinweis

Ein Gitter muß mindestens eine Spalte enthalten, die verschoben werden kann. Stellen Sie FixedCols nicht auf einen größeren Wert als ColCount - 1 ein.


TCustomGrid::FixedRows

TCustomGrid	Siehe auch	Beispiel

Die Eigenschaft FixedRows enthält die Anzahl der Zeilen auf der linken Seite des Gitters, die nicht verschoben werden können.

__property int FixedRows;

Beschreibung

Mit FixedRows können Sie nicht verschiebbare Zeilen erstellen oder lösen. Diese Zeilen erscheinen am oberen Rand des Gitters und sind immer sichtbar, auch wenn der Bildschirmausschnitt zu anderen Zeilen im Gitter verschoben wird. In den fixierten Zeilen können Spaltentitel oder Spaltennummern angezeigt werden.

Die fixierten Zeilen unterscheiden sich visuell von den restlichen Zeilen des Gitters. Sie werden mit einer eigenen Hintergrundfarbe angezeigt. Hat die Eigenschaft Ctrl3D den Wert True, erhalten die Zellen ein dreidimensionales Erscheinungsbild.

Hinweis

Ein Gitter muß mindestens eine Zeile enthalten, die verschoben werden kann. Stellen Sie FixedRows nicht auf einen größeren Wert als RowCount - 1 ein.


TCustomGrid::GridHeight

TCustomGrid	Siehe auch	Beispiel

Die Eigenschaft GridHeight bezeichnet die Höhe des Gitters in Pixel.

__property int GridHeight;

Beschreibung

Mit GridHeight können Sie die Höhe des Gitters bestimmen. Ist GridHeight kleiner als der Wert von ClientHeight, wird im Steuerelement unter den einzelnen Zeilen ein leerer Bereich angezeigt. Ist das Gitter größer als das Steuerelement, hat GridHeight denselben Wert wie ClientHeight. Um den vollständigen Inhalt des Gitters anzuzeigen, muß der Bildschirmausschnitt verschoben werden.


TCustomGrid::GridLineWidth

TCustomGrid	Siehe auch	Beispiel

Die Eigenschaft GridLineWidth enthält die Breite der Linien, die die Zellen des Gitters trennen, in Pixel.

__property int GridLineWidth;

Beschreibung

Mit GridLineWidth können Sie die Breite der Linien einstellen, durch die die Zellen im Gitter voneinander getrennt werden. Hat GridLineWidth den Wert Null, werden zwischen den Zellen keine Trennlinien angezeigt.

Enthält die Eigenschaft Options nicht den Wert goFixedHorzLine, goFixedVertLine, goHorzLine oder goVertLine, wirkt sich die Eigenschaft GridLineWidth nicht aus.

Hinweis

Auch wenn GridLineWidth den Wert Null hat, werden die Zellen der fixierten Zeilen und Spalten im Gitter unterschiedlich angezeigt, wenn die Eigenschaft Ctrl3D den Wert True hat. Durch Setzen von Ctrl3D auf False können Sie den 3D-Effekt entfernen, der die Zellen des fixierten Bereichs im Gitter von den anderen Zellen unterscheidet.


TCustomGrid::GridWidth

TCustomGrid	Siehe auch	Beispiel

Die Eigenschaft GridWidth enthält die Breite des Gitters in Pixel.

__property int GridWidth;

Beschreibung

Mit GridWidth können Sie die Breite des Gitters bestimmen. Ist GridWidth kleiner als der Wert von ClientWidth, wird im Steuerelement rechts von den Spalten ein leerer Bereich angezeigt. Ist das Gitter breiter als das Steuerelement, hat GridWidth denselben Wert wie ClientWidth. Um den vollständigen Inhalt des Gitters anzuzeigen, muß der Bildschirmausschnitt verschoben werden.


TCustomGrid::InplaceEditor

TCustomGrid	Siehe auch

Die Eigenschaft InplaceEditor bezeichnet das Steuerelement, mit dem der Inhalt der ausgewählten Zelle bearbeitet werden kann.

__property TInplaceEdit* InplaceEditor;

Beschreibung

Mit InplaceEditor können Sie direkt auf das Steuerelement zugreifen, das sich über der ausgewählten Zelle befindet, wenn das Gitter in den Bearbeitungsmodus versetzt wurde. Dieser Editor wird erstellt, wenn das Gitter erstmals in den Bearbeitungsmodus versetzt wird. Er wird erst freigegeben, wenn das Gitter freigegeben wird. Sobald eine andere Zelle ausgewählt wird, wird der Editor im Gitter verschoben. Wird der Bearbeitungsmodus beendet, wird das Fenster des Editors verborgen.


TCustomGrid::LeftCol

TCustomGrid	Siehe auch	Beispiel

Die Eigenschaft LeftCol bezeichnet die Nummer der ersten sichtbaren Spalte des Gitters, die verschoben werden kann.

__property long LeftCol;

Beschreibung

Mit LeftCol können Sie die Nummer der ersten sichtbaren Spalte im Bereich bestimmen, die verschoben werden kann. Mit LeftCol können Sie den Bildschirmausschnitt verschieben, damit die Spalte mit dem Index LeftCol als erste Spalte neben den fixierten Spalten angezeigt wird.


TCustomGrid::Options

TCustomGrid	Siehe auch

Mit der Eigenschaft Options können Sie die verschiedenen Eigenschaften zur Anzeige und zum Verhalten des Gitters festlegen.

__property TGridOptions Options;

Beschreibung

Fügen Sie in Options die gewünschten Eigenschaftswerte für das Gitter ein. Options ist eine Menge, deren Werte folgender Tabelle entnommen werden können:

Wert	Bedeutung

goFixedVertLine	Die fixierten Spalten des Gitters werden durch vertikale Linien getrennt.

goFixedHorzLine	Die fixierten Zeilen des Gitters werden durch horizontale Linien getrennt.

goVertLine	Die verschiebbaren Spalten des Gitters werden durch vertikale Linien getrennt.

goHorzLine	Die verschiebbaren Zeilen des Gitters werden durch horizontale Linien getrennt.

goRangeSelect	Der Benutzer kann Zellbereiche auswählen. Falls Options den Wert goEditing enthält, wird goRangeSelect ignoriert.

goDrawFocusSelected	Die Zellen mit dem Eingabefokus werden ebenso wie die ausgewählten Zellen ohne Eingabefokus in einer bestimmten Farbe angezeigt. Ist der Wert goDrawFocusSelected nicht enthalten, wird die Zelle mit dem Eingabefokus durch ein Fokusrechteck und nicht durch eine spezielle Hintergrundfarbe gekennzeichnet. Dies gilt nicht, wenn goRowSelect in Options enthalten ist.

goRowSizing	Die verschiebbaren Zeilen können einzeln vergrößert bzw. verkleinert werden.

goColSizing	Die verschiebbaren Zeilen Spalten einzeln vergrößert bzw. verkleinert werden.

goRowMoving	Die verschiebbaren Zeilen können mit der Maus verschoben werden.

goColMoving	Die verschiebbaren Spalten können mit der Maus verschoben werden.

goEditing	Der Inhalt der Zellen kann bearbeitet werden. Ist goEditing in Options enthalten, hat goRangeSelect keine Auswirkung.

goTabs	Der Benutzer kann die Zellen des Gitters mit TAB und UMSCHALT+TAB aufrufen.

goRowSelect	Es werden gesamte Zeilen ausgewählt und keine einzelnen Zellen. Ist goRowSelect in Options enthalten, hat goAlwaysShowEditor keine Auswirkung.

goAlwaysShowEditor	Der Bearbeitungsmodus kann nicht beendet werden. EditorMode muß nicht mit der Eingabetaste oder F2 aktiviert werden. Ist goEditing in Options nicht enthalten, hat goAlwaysShowEditor keine Auswirkung. Ist goRowSelect in Options enthalten, hat goAlwaysShowEditor ebenfalls keine Auswirkung.

goThumbTracking	Das Bild des Gitters wird aktualisiert, sobald die Positionsmarke in der Bildlaufleiste verschoben wird. Ist goThumbTracking nicht in Options enthalten, wird das Bild erst aktualisiert, nachdem die Maustaste an der neuen Position losgelassen wurde.


TCustomGrid::Row

TCustomGrid	Siehe auch	Beispiel

Die Eigenschaft Row bezeichnet den Index der Zeile, die die ausgewählte Zelle enthält.

__property long Row;

Beschreibung

Mit Row können Sie zur Laufzeit die aktuelle Zeile des Gitters bestimmen. Durch das Setzen von Row wird der Fokus zu der Zelle der aktuellen Spalte verschoben, die sich in der neuen Zeile befindet. Die erste Zeile hat den Index 0, die zweite den Index 1 usw.

Die ausgewählte Zelle des Gitters kann mit den Eigenschaften Row und Col ermittelt werden. Diese Eigenschaften enthalten die Indizes der Zeile und der Spalte. Sobald der Fokus zum Gitter verschoben wird, erhält die ausgewählte Zelle den Eingabefokus.


TCustomGrid::RowCount

TCustomGrid	Siehe auch	Beispiel

Die Eigenschaft RowCount enthält die Anzahl der Zeilen im Gitter.

__property long RowCount;

Beschreibung

Mit RowCount können Sie die Anzahl der Einträge im Array RowHeights bestimmen. Stellen Sie RowCount ein, um Zeilen am unteren Rand des Gitters einzufügen oder zu löschen. Der Wert von RowCount enthält alle fixierten Zeilen am oberen Rand des Gitters sowie die verschiebbaren Spalten.


TCustomGrid::RowHeights

TCustomGrid	Siehe auch	Beispiel

Die Eigenschaft RowHeights enthält ein indiziertes Array mit der Höhe der einzelnen Zeilen des Gitters in Pixeln.

__property int RowHeights[long Index];

Beschreibung

Mit RowHeights können Sie die Höhe der Zellen in der Zeile bestimmen, die im Parameter Index angegeben ist. Der Index 0 bezeichnet die erste Zeile. Mit RowHeights können Sie die Höhe einer Zeile zur Laufzeit ändern.

Wurde die Höhe einer Zeile nicht explizit mit der Maus oder mit der Eigenschaft RowHeights geändert, hat die Höhe den Wert DefaultRowHeight.

Mit der Eigenschaft RowCount können Sie die Anzahl der Einträge im Array RowHeights bestimmen.


TCustomGrid::ScrollBars

TCustomGrid	Siehe auch	Beispiel

Mit der Eigenschaft ScrollBars können Sie festlegen, ob das Gitter eine horizonale oder eine vertikale Bildlaufleiste enthält.

__property Stdctrls::TScrollStyle ScrollBars;

Beschreibung

Mit der Eigenschaft ScrollBars können Sie dem Gitter eine horizonale und eine vertikale Bildlaufleiste zuweisen. Die Eigenschaft kann einen der folgenden Werte annehmen:

Wert	Bedeutung

ssNone	Das Gitter besitzt keine Bildlaufleiste.

ssHorizontal	Auf der Unterseite des Gitters wird eine Bildlaufleiste angezeigt.

ssVertical	Auf der rechten Seite des Gitters wird eine Bildlaufleiste angezeigt.

ssBoth	Auf der unteren und der rechten Seite des Gitters werden Bildlaufleisten angezeigt.

Hinweis

Falls alle Zellen in dem mit ClientWidth angegebenen Raum angezeigt werden können, wird keine horizontale Bildlaufleiste angezeigt, auch wenn ScrollBars auf ssHorizontal oder ssBoth gesetzt wurde. Können alle Zellen in den mit ClientHeight angegebenen Raum angezeigt werden, wird keine vertikale Bildlaufleiste angezeigt, auch wenn ScrollBars auf ssVertical oder ssBoth gesetzt wurde.


TCustomGrid::Selection

TCustomGrid	Siehe auch	Beispiel

Die Eigenschaft Selection gibt die Größe der aktuellen Auswahl an.

__property TGridRect Selection;

Beschreibung

Mit Selection können Sie einen Zellbereich auswählen. Selection enthält entweder für erste Spalte, die erste Zeile, die letzte Spalte und die letzte Zeile im Gitter oder die Zeilen- und Spaltenkoordinaten der linken oberen und der rechten unteren Zelle der ausgewählten Bereichs.

Selection kann nur mehrere Zellen repräsentieren, wenn Options den Wert goRangeSelect enthält.


TCustomGrid::TabStops

TCustomGrid	Siehe auch

Die Eigenschaft TabStops enthält ein indiziertes Array mit booleschen Werten. Diese geben an, ob der Benutzer den Fokus mit der Taste TAB zu bestimmten Spalten des Gitters verschieben kann.

__property bool TabStops[long Index];

Beschreibung

Um die durch Index bezeichnete Spalte aus der Tabulatorreihenfolge zu entfernen, setzen Sie TabStops auf False. Die erste Spalte des Gitters hat den Index 0.

Hinweis

Ist der Wert goTabs nicht in Options enthalten, können die Spalten nicht mit der Taste TAB durchlaufen werden, auch wenn TabStops den Wert True hat.


TCustomGrid::TopRow

TCustomGrid	Siehe auch	Beispiel

Die Eigenschaft TopRow bezeichnet den Index der ersten sichtbaren Zeile des Gitters, die verschoben werden kann.

__property long TopRow;

Beschreibung

Mit TopRow können Sie den Index der ersten sichtbaren Zeile im Bereich bestimmen, die verschoben werden kann. Durch das Einstellen von TopRow können Sie den Bildschirmausschnitt nach oben oder unten verschieben, so daß die Zeile mit dem Index TopRow die erste Zeile unter den fixierten Zeilen wird.


TCustomGrid::VisibleColCount

TCustomGrid	Siehe auch	Beispiel

Die Eigenschaft VisibleColCount enthält die Anzahl der Spalten, die im Gitter sichtbar sind.

__property int VisibleColCount;

Beschreibung

Mit VisibleColCount können Sie die Anzahl der verschiebbaren Spalten ermitteln, die vollständig im Gitter sichtbar sind. Der Wert von VisibleColCount enthält die fixierten Spalten nicht. Diese werden von der Eigenschaft FixedCols gezählt. Die eventuell nur teilweise sichtbaren Spalten auf der rechten Seite des Gitters sind ebenfalls nicht enthalten.


TCustomGrid::VisibleRowCount

TCustomGrid	Siehe auch	Beispiel

Die Eigenschaft VisibleRowCount enthält die Anzahl der Zeilen, die im Gitter sichtbar sind.

__property int VisibleRowCount;

Beschreibung

Mit VisibleRowCount können Sie die Anzahl der verschiebbaren Zeilen ermitteln, die im Gitter vollständig sichtbar sind. Der Wert von VisibleRowCount enthält die fixierten Zeilen nicht. Diese werden von der Eigenschaft FixedRows gezählt. Die eventuell nur teilweise sichtbaren Zeilen am unteren Rand des Gitters sind ebenfalls nicht enthalten.


Methoden von TCustomGrid

TCustomGrid	Alphabetisch	Legende

In TCustomGrid

~TCustomGrid

AdjustSize

BoxRect

CanEditAcceptKey

CanEditModify

CanEditShow

CanGridAcceptKey

CellRect

ColumnMoved

ColWidthsChanged

CreateEditor

CreateParams

DefineProperties

DeleteColumn

DeleteRow

DoExit

DrawCell

GetEditLimit

GetEditMask

GetEditText

GetGridHeight

GetGridWidth

HideEditor

InvalidateCell

InvalidateCol

InvalidateEditor

InvalidateRow

KeyDown

KeyPress

MouseCoord

MouseDown

MouseMove

MouseUp

MoveColRow

MoveColumn

MoveRow

Paint

RowHeightsChanged

RowMoved

ScrollData

SelectCell

SetEditText

ShowEditor

ShowEditorChar

SizeChanged

Sizing

TCustomGrid

TimedScroll

TopLeftChanged

UpdateDesigner

Abgeleitet von TWinControl

Broadcast

CanFocus

ContainsControl

ControlAtPos

DisableAlign

EnableAlign

Focused

GetTabOrderList

HandleAllocated

HandleNeeded

InsertControl

Invalidate

PaintTo

Realign

RemoveControl

Repaint

ScaleBy

ScrollBy

SetBounds

SetFocus

Update

UpdateControlState

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

GetTextLen

Hide

Perform

Refresh

ScreenToClient

SendToBack

SetTextBuf

Show

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TCustomGrid

TCustomGrid	Nach Objekten	Legende

~TCustomGrid

AdjustSize

Assign

BeginDrag

BoxRect

BringToFront

Broadcast

CanEditAcceptKey

CanEditModify

CanEditShow

CanFocus

CanGridAcceptKey

CellRect

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

ClientToScreen

ColumnMoved

ColWidthsChanged

ContainsControl

ControlAtPos

CreateEditor

CreateParams

DefaultHandler

DefineProperties

DeleteColumn

DeleteRow

DestroyComponents

Destroying

DisableAlign

Dispatch

DoExit

DragDrop

Dragging

DrawCell

EnableAlign

EndDrag

FieldAddress

FindComponent

Focused

FreeInstance

FreeNotification

Free

GetEditLimit

GetEditMask

GetEditText

GetGridHeight

GetGridWidth

GetParentComponent

GetTabOrderList

GetTextBuf

GetTextLen

HandleAllocated

HandleNeeded

HasParent

HideEditor

Hide

InheritsFrom

InitInstance

InsertComponent

InsertControl

InstanceSize

InvalidateCell

InvalidateCol

InvalidateEditor

InvalidateRow

Invalidate

KeyDown

KeyPress

MethodAddress

MethodName

MouseCoord

MouseDown

MouseMove

MouseUp

MoveColRow

MoveColumn

MoveRow

NewInstance

Paint

PaintTo

Perform

Realign

Refresh

RemoveComponent

RemoveControl

Repaint

RowHeightsChanged

RowMoved

ScaleBy

ScreenToClient

ScrollBy

ScrollData

SelectCell

SendToBack

SetBounds

SetEditText

SetFocus

SetTextBuf

ShowEditorChar

ShowEditor

Show

SizeChanged

Sizing

TCustomGrid

TimedScroll

TopLeftChanged

UpdateControlState

UpdateDesigner

Update


TCustomGrid::~TCustomGrid

TCustomGrid	Siehe auch

Der Destruktor ~TCustomGrid gibt den Speicher frei, der für das TCustomGrid-Objekt reserviert war. Rufen Sie ~TCustomGrid nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TCustomGrid automatisch aufgerufen wird.

__fastcall virtual ~TCustomGrid(void);


TCustomGrid::AdjustSize

TCustomGrid	Siehe auch

Mit der Methode AdjustSize können Sie die Größe aller Zeilen und Spalten auf eine Standardgröße einstellen, die um einen angegebenen Wert korrigiert wird.

virtual void __fastcall AdjustSize(long Index, long Amount, bool Rows);

Beschreibung

Die Gitterkomponenten rufen AdjustSize intern auf, um die Zeilen oder Spalten zu korrigieren, wenn diese mit der Maus vergrößert bzw. verkleinert werden. Index ist der Index der ersten anzupassenden Zeile oder Spalte. Amount ist die Anzahl der Pixel, um die die Standardgröße geändert wird. Bei Rows handelt es sich um einen booleschen Wert. Dieser gibt an, ob Zeilen oder Spalten geändert werden.


TCustomGrid::BoxRect

TCustomGrid	Siehe auch

Mit der Methode BoxRect können Sie die Bildschirmkoordinaten der angegebenen Gruppe von Zellen ermitteln.

Windows::TRect __fastcall BoxRect(long ALeft, long ATop, long ARight, long ABottom);

Beschreibung

Mit BoxRect können Sie die Bildschirmkoordinaten der Zellen von der Spalte mit dem Index ALeft bis zur Spalte mit dem Index ARight und von der Zeile mit dem Index ATop bis zur Zeile mit dem Index ABottom in Pixel ermitteln. Die Koordinaten der Zellen, die nicht auf dem Bildschirm sichtbar sind, sind im zurückgegebenen Rechteck nicht enthalten.


TCustomGrid::CanEditAcceptKey

TCustomGrid	Siehe auch

Die Methode CanEditAcceptKey gibt an, ob der Inhalt des Parameters Key in die aktuelle Zelle eingegeben werden kann.

virtual bool __fastcall CanEditAcceptKey(char Key);

Beschreibung

Mit der Methode CanEditAcceptKey können Sie die Tastatureingaben verarbeiten, während der Benutzer den Inhalt einer Zelle bearbeitet. CanEditAcceptKey gibt für TCustomGrid immer den Wert True zurück. Die Nachkommen des TCustomGrid-Objekts überschreiben diese Methode, um unzulässige Zeichen auszublenden.

Mit Hilfe einer Eingabemaske können Sie die Gültigkeit von Zeichen genauer prüfen.


TCustomGrid::CanEditModify

TCustomGrid	Siehe auch

Die Methode CanEditModify zeigt an, ob die aktuelle Zelle des Gitters bearbeitet werden kann.

virtual bool __fastcall CanEditModify(void);

Beschreibung

Mit der Methode CanEditModify kann intern bestimmt werden, ob die aktuelle Zelle bearbeitet werden kann. CanEditModify gibt den Wert False zurück, wenn der Zelleditor die Bearbeitung der Zelle nicht zuläßt.


TCustomGrid::CanEditShow

TCustomGrid	Siehe auch

Die Methode CanEditShow gibt an, ob Zellen mit dem Zelleditor bearbeitet werden können.

virtual bool __fastcall CanEditShow(void);

Beschreibung

CanEditShow wird intern aufgerufen, bevor der Editor für eine Zelle erstellt wird. Nachdem das Gitter festgestellt hat, daß das Feld mit CanEditModify bearbeitet werden kann, wird CanEditShow aufgerufen.

CanEditShow gibt den Wert False zurück, falls das Gitter aufgrund des Inhalts der Eigenschaft Options nicht bearbeitet werden kann oder vollständige Zeilen des Gitters ausgewählt werden können. Falls der Bearbeitungsmodus aufgrund des Inhalts der Eigenschaft Options nicht beendet werden kann oder das Gitter den Eingabefokus besitzt, wird True zurückgegeben. Kann der Bearbeitungsmodus beendet werden und besitzt das Gitter den Eingabefokus nicht, gibt CanEditShow den Wert False zurück.


TCustomGrid::CanGridAcceptKey

TCustomGrid	Siehe auch

Die Methode CanGridAcceptKey gibt an, ob das Gitter auf eine bestimmte Tastenkombination reagieren soll.

virtual bool __fastcall CanGridAcceptKey(unsigned short Key,  Classes::TShiftState Shift);

Beschreibung

Die Methode CanGridAcceptKey wird intern aufgerufen. Mit ihr können Sie Tastenkombinationen überprüfen, sobald der Benutzer eine Taste drückt. Für ein TCustomGrid-Objekt gibt CanGridAcceptKey immer den Wert True zurück. Die Nachkommen des TCustomGrid-Objekts überschreiben diese Methode, um irrelevante Tastenkombinationen oder Tastenkombinationen auszublenden, deren zugewiesene Aktionen die Eigenschaft Options oder den Modus des Gitters verletzen würden.


TCustomGrid::CellRect

TCustomGrid	Siehe auch	Beispiel

Mit der Methode CellRect können Sie die Bildschirmkoordinaten einer Zelle im Gitter ermitteln.

Windows::TRect __fastcall CellRect(long ACol, long ARow);

Beschreibung

Mit CellRect können Sie die Begrenzungen der Zelle in Pixel ermitteln, die durch die Parameter ACol (Spalte) und ARow (Zeile) gegeben ist. Enthalten ACol und ARow Null, ist die linke obere Zelle ausgewählt.

Ist die angegebene Zelle nicht sichtbar, gibt CellRect ein leeres Rechteck zurück.


TCustomGrid::ColumnMoved

TCustomGrid	Siehe auch

Die Methode ColumnMoved stellt eine Schnittstelle für eine Methode bereit, die auf Positionsänderungen einer Spalte reagiert.

virtual void __fastcall ColumnMoved(long FromIndex, long ToIndex);

Beschreibung

ColumnMoved wird aufgerufen, nachdem eine Spalte im Gitter verschoben wurde. Der Parameter FromIndex enthält den bisherigen Index der Spalte und der Parameter ToIndex den neuen Index. Die Methode ColumnMoved eines TCustomGrid-Objekts hat keine Funktion. Die Nachkommen des TCustomGrid-Objekts überschreiben diese Methode, um interne Anpassungen vorzunehmen oder das Ereignis OnColumnMoved auszulösen.


TCustomGrid::ColWidthsChanged

TCustomGrid	Siehe auch

Mit der Methode ColWidthsChanged können Sie auf Änderungen der Spaltenbreite reagieren.

virtual void __fastcall ColWidthsChanged(void);

Beschreibung

ColWidthsChanged wird aufgerufen, nachdem die Spaltenbreite geändert wurde. Die Änderung kann sich aus der Einstellung der Eigenschaft ColWidths, aus der Einstellung der Eigenschaft DefaultColWidth, aus einer Verschiebung der Spalte oder aus einer Bearbeitung der Spalte mit der Maus ergeben.

Mit ColWidthsChanged können Sie die Bildlaufleiste und die Position des Zelleditors anpassen, um die neue Spaltenbreite und die neuen Positionen der Spalten zu berücksichtigen.


TCustomGrid::CreateEditor

TCustomGrid	Siehe auch

Mit der Methode CreateEditor können Sie den Zelleditor erstellen.

virtual TInplaceEdit* __fastcall CreateEditor(void);

Beschreibung

Das Gitter ruft die Methode CreateEditor intern auf, wenn es zum erstenmal in den Bearbeitungsmodus versetzt wird. CreateEditor ist eine geschützte Methode. Somit können die Nachkommen des TCustomGrid-Objekts einen spezialisierten Nachkommen von TInplaceEdit für die Zellbearbeitung verwenden.


TCustomGrid::CreateParams

TCustomGrid	Siehe auch

Die Methode CreateParams initialisiert den Parameterdatensatz zur Erstellung des Fensters, der im Parameter Params übergeben wird.

virtual void __fastcall CreateParams(Controls::TCreateParams &Params);

Beschreibung

Die Methode CreateParams wird intern aufgerufen, um die Eigenschaften des Fensters für dieses Steuerelement festzulegen. Der TCreateParams-Typ ist eine Datenstruktur mit Informationen. Diese müssen Windows übergeben werden, um ein Fenster-Handle zu erstellen. Aus den Feldern des TCreateParams-Datensatzes werden die Parameter für die API-Funktion CreateWindowEx gebildet.

Nach dem Aufruf der geerbten Methode paßt CreateParams den Wert von Params an, damit das Gitter Doppelklick-Botschaften empfängt und die Werte der Eigenschaften Ctrl3D, ScrollBars und BorderStyle implementiert werden.


TCustomGrid::DefineProperties

TCustomGrid	Siehe auch

Mit der Methode DefineProperties können Sie die Eigenschaften ColWidths und RowHeight den Werten hinzufügen, die zusammen mit dem Gitter gespeichert werden.

virtual void __fastcall DefineProperties(Classes::TFiler* Filer);

Beschreibung

Die Methode DefineProperties überschreibt die geerbte Methode, um die Eigenschaften ColWidths und RowHeights zusammen mit dem Gitter zu speichern. Dies gilt nur, wenn die Eigenschaften nicht die Standardbreiten und -höhen enthalten.


TCustomGrid::DeleteColumn

TCustomGrid	Siehe auch

Die Methode DeleteColumn löscht die Spalte mit dem Index ACol aus dem Gitter.

void __fastcall DeleteColumn(long ACol);

Beschreibung

Mit DeleteColumns können Sie eine Spalte aus der Mitte aus dem Gitter entfernen. Mit der Eigenschaft ColCount können Sie die letzte Spalte aus dem Gitter entfernen.


TCustomGrid::DeleteRow

TCustomGrid	Siehe auch

Die Methode DeleteRow löscht die Zeile mit dem Index ARow aus dem Gitter.

void __fastcall DeleteRow(long ARow);

Beschreibung

Mit DeleteRow können Sie eine Zeile aus der Mitte des Gitters entfernen. Mit der Eigenschaft RowCount können Sie die letzte Zeile aus dem Gitter entfernen.


TCustomGrid::DoExit

TCustomGrid	Siehe auch

Die Methode DoExit verbirgt den Zelleditor, wenn ein anderes Steuerelement im Formular ausgewählt wird.

virtual void __fastcall DoExit(void);

Beschreibung

Nach dem Aufruf der geerbten Methode, die das Ereignis OnExit auslöst, schließt DoExit den Zelleditor, sofern die Eigenschaft Options nicht den Wert goAlwaysShowEditor enthält.


TCustomGrid::DrawCell

TCustomGrid	Siehe auch

Die Methode DrawCell ist der abstrakte Prototyp für eine Methode, die den Inhalt einer Zelle in das Gitter zeichnet.

virtual void __fastcall DrawCell(long ACol, long ARow, const Windows::TRect &ARect,  TGridDrawState AState);

Beschreibung

In den Nachkommen von TCustomGrid wird die Methode DrawCell implementiert, um den Inhalt der Zelle zu zeichnen oder das Ereignis OnDrawCell auszulösen. Hat DefaultDrawing den Wert True, wird der Hintergrund der Zelle vor dem Aufruf von DrawCell angezeigt. Die 3D-Effekte der fixierten Zellen und das Fokusrechteck werden nach dem Aufruf von DrawCell gezeichnet.

Spalten- und Zeilenindex der anzuzeigenden Zelle werden in den Parametern ACol und ARow angegeben. Der Parameter ARect bezeichnet die Begrenzungen der Zelle in den Koordinaten der Zeichenfläche. Der Parameter AState gibt an, ob die Zelle markiert ist, den Eingabefokus besitzt und sich in einem fixierten Teil des Gitters befindet.


TCustomGrid::GetEditLimit

TCustomGrid	Siehe auch

Die Methode GetEditLimit stellt eine Schnittstelle für eine Methode bereit, mit der Sie die Anzahl der Zeichen beschränken können, die in die Zellen eingegeben werden können.

virtual int __fastcall GetEditLimit(void);

Beschreibung

GetEditLimit wird vom Zelleditor aufgerufen. Mit dieser Methode können Sie bestimmen, ob die Anzahl der Zeichen beschränkt werden soll, die in eine Zelle eingegeben werden können. Mit GetEditLimit können keine Beschränkungen gesetzt werden. Die Nachkommen von TCustomGrid überschreiben diese Methode, um die Textlänge für bestimmte Zellen zu beschränken.


TCustomGrid::GetEditMask

TCustomGrid	Siehe auch

Die Methode GetEditMask stellt eine Schnittstelle für eine Methode bereit, die eine Eingabemaske für die angegebene Zelle zurückgibt.

virtual System::AnsiString __fastcall GetEditMask(long ACol, long ARow);

Beschreibung

Der Zelleditor kann mit GetEditMask eine Eingabemaske abrufen, die mit der in ACol und ARow angegebenen Zelle verbunden ist. GetEditMask gibt einen leeren String zurück. Dies bedeutet, daß die Zelle keine Eingabemaske besitzt. Die Nachkommen von TCustomGrid überschreiben diese Methode, um eine Eingabemaske zur Verfügung zu stellen oder das Ereignis OnEditMask auszulösen.


TCustomGrid::GetEditText

TCustomGrid	Siehe auch

Die Methode GetEditText gibt den für die Bearbeitung formatierten Wert der angegebenen Zelle zurück.

virtual System::AnsiString __fastcall GetEditText(long ACol, long ARow);

Beschreibung

Der Zelleditor ermittelt mit GetEditText den Text für die angegebene Zelle. GetEditText gibt einen leeren String zurück. Die Nachkommen von TCustomGrid überschreiben die Methode GetEditText, um einen String zurückzugeben, der den Inhalt der durch die Parameter ACol und ARow gegebenen Zelle repräsentiert.


TCustomGrid::GetGridHeight

TCustomGrid	Siehe auch

GetGridHeight ist eine geschützte Methode für den Zugriff auf die Eigenschaft GridHeight.

int __fastcall GetGridHeight(void);

Beschreibung

Mit GetGridHeight können Sie den Wert der Eigenschaft GridHeight basierend auf der Zeilenhöhe, der Breite der Trennlinien und der Höhe des Steuerelements berechnen.


TCustomGrid::GetGridWidth

TCustomGrid	Siehe auch

GetGridWidth ist eine geschützte Methode für den Zugriff auf die Eigenschaft GridWidth.

int __fastcall GetGridWidth(void);

Beschreibung

Mit der Methode GetGridWidth können Sie den Wert der Eigenschaft GridWidth basierend auf der Spaltenbreite, der Breite der Trennlinien und der Breite des Steuerelements berechnen.


TCustomGrid::HideEditor

TCustomGrid	Siehe auch

Die Methode HideEditor verbirgt den Zelleditor, wenn dieser nicht verwendet wird.

void __fastcall HideEditor(void);

Beschreibung

Wird der Bearbeitungsmodus beendet, wird HideEditor aufgerufen. Mit HideEditor können Sie das Fenster des Zelleditors verbergen.


TCustomGrid::InvalidateCell

TCustomGrid	Siehe auch

Die Methode InvalidateCell erklärt den Bereich für ungültig, der von einer Zelle eingenommen wird, damit diese beim Empfang der nächsten entsprechenden Windows-Botschaft neu gezeichnet wird.

void __fastcall InvalidateCell(long ACol, long ARow);

Beschreibung

Die Methode InvalidateCell wird benötigt, wenn der Inhalt einer Zelle geändert wurde und diese neu gezeichnet werden muß. Der Parameter ACol enthält den Index der Spalte und der Parameter ARow den Index der Zeile.


TCustomGrid::InvalidateCol

TCustomGrid	Siehe auch

Die Methode InvalidateCol erklärt den Bereich für ungültig, der von einer Spalte eingenommen wird, damit diese beim Empfang der nächsten entsprechenden Windows-Botschaft neu gezeichnet wird.

void __fastcall InvalidateCol(long ACol);

Beschreibung

Die Methode InvalidateCol wird benötigt, wenn eine Spalte geändert wurde und der von ihr eingenommene Bereich neu gezeichnet werden muß. Der Parameter ACol enthält den Spaltenindex.


TCustomGrid::InvalidateEditor

TCustomGrid	Siehe auch

Mit der Methode InvalidateEditor können Sie den Zelleditor neu zeichnen. Gegebenenfalls wird er an eine neue Position verschoben.

void __fastcall InvalidateEditor(void);

Beschreibung

Die Methode InvalidateEditor wird benötigt, wenn eine andere Zelle ausgewählt wird, während sich das Gitter im Bearbeitungsmodus befindet.


TCustomGrid::InvalidateRow

TCustomGrid	Siehe auch

Die Methode InvalidateRow erklärt den Bereich für ungültig, der von einer Zeile eingenommen wird, damit diese beim Empfang der nächsten entsprechenden Windows-Botschaft neu gezeichnet wird.

void __fastcall InvalidateRow(long ARow);

Beschreibung

Die Methode InvalidateRow wird benötigt, wenn eine Zeile geändert wurde und der von ihr eingenommene Bereich neu gezeichnet werden muß. Der Parameter ARow enthält den Zeilenindex.


TCustomGrid::KeyDown

TCustomGrid	Siehe auch

Mit der Methode KeyDown können Sie spezielle Aktionen durchführen, wenn der Benutzer eine Taste drückt.

virtual void __fastcall KeyDown(unsigned short &Key,  Classes::TShiftState Shift);

Beschreibung

Nachdem das Ereignis OnKeyDown ausgelöst wurde, blendet KeyDown mit der Methode CanGridAcceptKey problematische Tastenkombinationen aus. Mit KeyDown können Sie die entsprechende Zelle als Reaktion auf Tastenkombinationen aktivieren oder die Eigenschaft EditorMode auf True setzen, sobald F2 gedrückt wird.


TCustomGrid::KeyPress

TCustomGrid	Siehe auch

Mit der Methode KeyPress können Sie spezielle Aktionen durchführen, wenn der Benutzer eine Taste drückt.

virtual void __fastcall KeyPress(char &Key);

Beschreibung

Nachdem das Ereignis OnKeyPress ausgelöst wurde, können Sie mit KeyPress die Eigenschaft EditorMode umschalten, sobald die Eingabetaste gedrückt wird. KeyPress wird nach der Methode KeyDown aufgerufen, aber bevor die Taste losgelassen wird.


TCustomGrid::MouseCoord

TCustomGrid	Siehe auch

Die Methode MouseCoord gibt den Zeilen- und den Spaltenindex der Zelle zurück, die einen in Bildschirmkoordinaten angegebenen Punkt enthält.

TGridCoord __fastcall MouseCoord(int X, int Y);

Beschreibung

Mit MouseCoord können Sie die Spalte und die Zeile der Zelle ermitteln, die eine angegebene Bildschirmkoordinate enthält. Normalerweise wird mit MouseCoord die Zelle ermittelt, auf der sich der Mauscursor befindet.


TCustomGrid::MouseDown

TCustomGrid	Siehe auch

Mit der Methode MouseDown können Sie spezielle Aktionen durchführen, wenn der Benutzer eine Maustaste drückt.

virtual void __fastcall MouseDown(Controls::TMouseButton Button,  Classes::TShiftState Shift, int X, int Y);

Beschreibung

Mit MouseDown wird das Eingabefenster verborgen und zu der Zelle verschoben, die den Mausklick empfängt. Wird der Mauscursor in den entsprechenden Bereich verschoben, indem eine Zeile oder eine Spalte verschoben oder ihre Größe geändert werden kann, können Sie den jeweiligen Vorgang mit MouseDown starten. Um den Vorgang sichtbar zu machen, wird der Cursor verändert. Wurde der Zelleditor verborgen, wird er an seiner neuen Position wieder sichtbar. Schließlich löst MouseDown das Ereignis OnMouseDown aus.


TCustomGrid::MouseMove

TCustomGrid	Siehe auch

Mit der Methode MouseMove können Sie spezielle Aktionen durchführen, wenn der Benutzer den Mauscursor bewegt.

virtual void __fastcall MouseMove( Classes::TShiftState Shift, int X, int Y);

Beschreibung

Während der Verschiebung oder Größenänderung einer Zeile oder einer Spalte oder während der Auswahl eines Zellbereichs mit der Maus berechnet MouseMove die von der Verschiebung der Maus bewirkten Änderungen und zeigt sie an. Schließlich löst MouseMove das Ereignis OnMouseMove aus.


TCustomGrid::MouseUp

TCustomGrid	Siehe auch

Mit der Methode MouseUp können Sie spezielle Aktionen durchführen, wenn der Benutzer die Maustaste losläßt.

virtual void __fastcall MouseUp(Controls::TMouseButton Button,  Classes::TShiftState Shift, int X,  int Y);

Beschreibung

Mit der Methode MouseUp können Sie eine Verschiebung oder Größenänderung einer Zeile oder einer Spalte oder die Auswahl eines Zellbereichs mit der Maus beenden. Schließlich löst MouseUp das Ereignis OnMouseUp aus.


TCustomGrid::MoveColRow

TCustomGrid	Siehe auch

Mit der Methode MoveColRow können Sie die Zelle auswählen, die mit den Parametern ACol und ARow angegeben wird.

void __fastcall MoveColRow(long ACol, long ARow, bool MoveAnchor, bool Show);

Beschreibung

MoveColRow wird intern aufgerufen, wenn eine andere Zelle ausgewählt wird. MoveColRow wählt die angegebene Zelle aus ohne die bisherige Auswahl aufzuheben.

Die Parameter ACol und ARow bezeichnen den Spalten- bzw. den Zeilenindex der zu markierenden Zelle. Der Parameter MoveAnchor gibt an, ob die neue Zelle zur linken oberen Ecke eines ausgewählten Bereichs wird. MoveAnchor hat den Wert False, wenn MoveColRow bei der Erweiterung eines ausgewählten Zellenbereichs aufgerufen wird. Mit dem Parameter Show können Sie sicherstellen, daß die neu ausgewählte Zelle sichtbar ist.


TCustomGrid::MoveColumn

TCustomGrid	Siehe auch

Mit der Methode MoveColumn können Sie eine Spalte an eine andere Position verschieben.

void __fastcall MoveColumn(long FromIndex, long ToIndex);

Beschreibung

Mit MoveColumnn können Sie die im Parameter FromIndex angegebene Spalte an die Position verschieben, die im Parameter ToIndex angegeben ist.


TCustomGrid::MoveRow

TCustomGrid	Siehe auch

Mit der Methode MoveRow können Sie eine Zeile an eine andere Position verschieben.

void __fastcall MoveRow(long FromIndex, long ToIndex);

Beschreibung

Mit MoveRow können Sie die im Parameter FromIndex angegebene Zeile an die Position verschieben, die im Parameter ToIndex angegeben ist.


TCustomGrid::Paint

TCustomGrid	Siehe auch

Mit der Methode Paint können Sie das Bild des Gitters auf dem Bildschirm zeichnen.

virtual void __fastcall Paint(void);

Beschreibung

Die Methode Paint wird aufgerufen, sobald das Gitter Die Windows-Botschaft Paint empfängt. Mit Paint wird das Gitter gezeichnet. Zur Anzeige der Zellinhalte wird die Methode DrawCell aufgerufen. Hat DefaultDrawing den Wert False, werden der Hintergrund der Zellen, die 3D-Effekte der fixierten Zellen und das Fokusrechteck nicht angezeigt.


TCustomGrid::RowHeightsChanged

TCustomGrid	Siehe auch

Die Methode RowHeightsChanged reagiert auf Änderungen der Zeilenhöhen.

virtual void __fastcall RowHeightsChanged(void);

Beschreibung

RowHeightsChanged wird aufgerufen, nachdem die Zeilenhöhen geändert wurden. Die Änderung kann sich aus der Einstellung der Eigenschaft RowHeights, aus der Einstellung der Eigenschaft DefaultRowHeight, aus der Verschiebung der Zeilen oder aus der Veränderung der Zeilen mit der Maus ergeben.

Mit RowHeightsChanged können Sie die Bildlaufleiste und die Position des Zelleditors an die neue Zeilenhöhe und die neuen Positionen der Zeilen anpassen.


TCustomGrid::RowMoved

TCustomGrid	Siehe auch

Die Methode RowMoved stellt eine Schnittstelle für eine Methode bereit, die auf Positionsänderungen einer Zeile reagiert.

virtual void __fastcall RowMoved(long FromIndex, long ToIndex);

Beschreibung

RowMoved wird aufgerufen, nachdem eine Zeile im Gitter verschoben wurde. Der Parameter FromIndex enthält den bisherigen Index der Zeile und der Parameter ToIndex den neuen Index. Die Methode RowMoved von TCustomGrid hat keine Funktion. Die Nachkommen von TCustomGrid überschreiben diese Methode, um interne Anpassungen vorzunehmen oder das Ereignis OnRowMoved auszulösen.


TCustomGrid::ScrollData

TCustomGrid	Siehe auch

Mit der Methode ScrollData können Sie den sichtbaren Ausschnitt im Gitter verschieben.

void __fastcall ScrollData(int DX, int DY);

Beschreibung

Das Gitter ruft ScrollData intern auf, wenn Zeilen oder Spalten verschoben werden. Mit ScrollData können Sie das Bild des Gitters aktualisieren.


TCustomGrid::SelectCell

TCustomGrid	Siehe auch

Die Methode SelectCell bestimmt, ob eine bestimmte Zelle im Gitter ausgewählt werden kann.

virtual bool __fastcall SelectCell(long ACol, long ARow);

Beschreibung

Ein Gitter ruft SelectCell intern auf, bevor die im Parameter ACol und ARow angegebene Zelle ausgewählt wird. Bei ACol und ARow handelt es sich um den Spalten- bzw. den Zeilenindex der Zelle. Die erste Spalte und die oberste Zeile haben jeweils den Index 0.

Für TCustomGrid gibt die Methode SelectCell immer den Wert True zurück. Die Zelle kann also markiert werden. Die Nachkommen von TCustomGrid überschreiben diese Methode, um die Eigenschaften der in der Zelle angezeigten Daten zu prüfen oder das Ereignis OnSelectCell auszulösen.


TCustomGrid::SetEditText

TCustomGrid	Siehe auch

Die Methode SetEditText stellt eine Schnittstelle für eine Methode bereit, die den mit einer Zelle verbundenen Text aktualisiert.

virtual void __fastcall SetEditText(long ACol, long ARow, const System::AnsiString Value);

Beschreibung

SetEditText wird vom Zelleditor aufgerufen, damit das Gitter den neuen Wert der aktuellen Zelle speichern kann. Die Methode SetEditText von TCustomGrid hat keine Funktion. Die Nachkommen von TCustomGrid überschreiben diese Methode, um die interne Repräsentation des Zellwertes zu aktualisieren oder das Ereignis OnSetEditText auszulösen.


TCustomGrid::ShowEditor

TCustomGrid	Siehe auch

Die Methode ShowEditor zeigt den Zelleditor an, sobald das Gitter in den Bearbeitungsmodus versetzt wird.

void __fastcall ShowEditor(void);

Beschreibung

Sobald das Gitter in den Bearbeitungsmodus versetzt wird, wird ShowEditor aufgerufen. Mit ShowEditor können Sie das Fenster des Zelleditors über der aktuell ausgewählten Zelle anzeigen. Falls der Zelleditor noch nicht existiert, wird er mit ShowEditor erstellt.


TCustomGrid::ShowEditorChar

TCustomGrid	Siehe auch

Die Methode ShowEditorChar zeigt den Zelleditor an. Dabei wird der Eigenschaft Text das angegebene Zeichen zugewiesen.

void __fastcall ShowEditorChar(char Ch);

Beschreibung

Die Methode ShowEditorChar wird aufgerufen, wenn ein Zeichen in eine Zelle eingegeben und der Editor noch nicht angezeigt wird. Mit der Methode ShowEditorChar können Sie das Fenster des Zelleditors über der aktuell ausgewählten Zelle anzeigen und seiner Eigenschaft Text das Zeichen im Parameter Ch zuweisen. Falls der Zelleditor noch nicht existiert, wird er von ShowEditorChar erstellt.


TCustomGrid::SizeChanged

TCustomGrid	Siehe auch

Die Methode SizeChanged reagiert auf Änderungen der Größe des Gitters.

virtual void __fastcall SizeChanged(long OldColCount, long OldRowCount);

Beschreibung

Die Methode SizeChanged stellt eine Schnittstelle für eine Methode bereit, die auf Änderungen der Zeilen- oder Spaltenzahl des Gitters reagiert. Die Methode SizeChanged von TCustomGrid hat keine Funktion. Die Nachkommen von TCustomGrid überschreiben diese Methode, um interne Anpassungen vorzunehmen oder Ereignisse auszulösen.


TCustomGrid::Sizing

TCustomGrid	Siehe auch

Die Methode Sizing gibt an, ob sich die angegebenen Koordinaten in einem Bereich des Gitters befinden, der zur Größenänderung verwendet werden kann.

bool __fastcall Sizing(int X, int Y);

Beschreibung

Ein Gitter ruft Sizing intern auf und übergibt der Methode die Koordinaten eines Mausklicks. Dadurch wird bestimmt, ob der Benutzer die Größe einer Zeile oder einer Spalte ändern will.


TCustomGrid::TCustomGrid

TCustomGrid	Siehe auch

Der Konstruktor TCustomGrid erzeugt ein neues TCustomGrid-Objekt.

__fastcall virtual TCustomGrid(Classes::TComponent* AOwner);

Beschreibung

Erstellen Sie Instanzen von TCustomGrid nicht direkt. Bei TCustomGrid handelt es sich um eine abstrakte Basisklasse für Gitter. Um ein Gitter zur Laufzeit zu erstellen, rufen Sie statt dessen den Konstruktor eines Nachkommens von TCustomGrid auf. Die während des Entwurfs in ein Formular eingefügten Gitter werden automatisch erstellt.

Nach dem Aufruf des geerbten Konstruktors führt TCustomGrid folgende Aktionen durch:

•	Die Eigenschaft BorderStyle wird mit bsSingle initialisiert.

•	Die Eigenschaften ColCount und RowCount werden mit 5 initialisiert.

•	Die Eigenschaft Color wird auf clWindow und die Eigenschaft FixedColor auf clBtnFace gesetzt.

•	Die Eigenschaft ControlStyle wird mit [csCaptureMouse, csOpaque, csDoubleClicks, csFramed ] initialisiert.

•	Die Eigenschaft DefaultColWidth wird mit 64 und die Eigenschaft DefaultRowHeight mit 24 initialisiert.

•	Die Eigenschaft DefaultDrawing wird auf True gesetzt.

•	Die Eigenschaft EditorMode wird auf False gesetzt.

•	Die Eigenschaften FixedCols und FixedRows werden mit 1 initialisiert.

•	Die Eigenschaft GridLineWidth wird mit 1 initialisiert.

•	Die Eigenschaft Options wird mit [goFixedVertLine, goFixedHorzLine, goVertLine, goHorzLine, goRangeSelect] initialisiert.

•	Die Eigenschaft ParentColor wird auf False gesetzt.

•	Die Eigenschaft ScrollBars wird mit ssBoth initialisiert.

•	Die Eigenschaft TabStop wird auf True gesetzt.


TCustomGrid::TimedScroll

TCustomGrid	Siehe auch

Die Methode TimedScroll erweitert die Verschiebung, die Größenänderung oder die Auswahl eines verschiebbaren Bereichs, sobald die Maus über den bildlauffähigen Bereich des Gitters hinaus verschoben wird.

virtual void __fastcall TimedScroll( TGridScrollDirection Direction);

Beschreibung

TimedScroll wird aufgerufen, wenn die Maus aus dem verschiebbaren Bereich des Gitters gezogen wird. TimedScroll hat nur eine Funktion, wenn eine Zeile oder eine Spalte verschoben oder in der Größe verändert wird oder ein Zellbereich mit der Maus ausgewählt wird. TimedScroll verschiebt den Bildschirmausschnitt des Gitters, damit die Operation in dem Teil des Gitters fortgesetzt werden kann, der zuvor verborgen war.


TCustomGrid::TopLeftChanged

TCustomGrid	Siehe auch

Die Methode TopLeftChanged aktualisiert die Position des Zelleditors, wenn der Bildschirmausschnitt im Gitter verschoben wird.

virtual void __fastcall TopLeftChanged(void);

Beschreibung

Ein Gitter ruft TopLeftChanged intern auf, wenn die Eigenschaft LeftCol oder die Eigenschaft TopRow geändert wird.

Die Nachkommen von TCustomGrid überschreiben diese Methode, um interne Anpassungen vorzunehmen oder das Ereignis OnTopLeftChanged auszulösen.


TCustomGrid::UpdateDesigner

TCustomGrid	Siehe auch

Die Methode UpdateDesigner benachrichtigt den Designer, wenn die Zeilen und die Spalten des Gitters verschoben oder in der Größe verändert werden.

void __fastcall UpdateDesigner(void);

Beschreibung

Während des Entwurfs überwacht der Designer die Änderungen der Eigenschaften automatisch. Er kann somit den Benutzer auffordern, die Änderungen zu speichern. Durch eine Verschiebung oder Größenänderung der Zeilen und Spalten des Gitters mit der Maus wird dieses System übergangen. Die Methode UpdateDesigner löst dieses Problem. Sie benachrichtigt den Designer, daß die Eigenschaften des Gitters geändert wurden und die Änderungen gespeichert werden sollen.


Gültigkeitsbereich

Protected

Published

Zugriff

Read-only


Gültigkeitsbereich

Protected


Hierarchie

TObject

TPersistent

TComponent

TControl

TWinControl

TCustomControl


TCustomGrid Beispiel

TCustomGrid


TCustomImageList

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/controls.hpp

TCustomImageList ist eine abstrakte Klasse, deren Ableitungen Sammlungen mit Bildern in gleicher Größe zur Verfügung stellen. Auf diese Bilder kann mit Hilfe eines Index zugegriffen werden.

Beschreibung

Mit Bilderlisten lassen sich große Mengen von Symbolen oder Bitmaps effizient verwalten. Alle Bilder einer Bilderliste befinden sich in einem einzigen, großen Bitmap im Bildschirmgeräteformat. Eine Bilderliste kann außerdem ein monochromes Bitmap enthalten, in dem sich Masken für das transparente Zeichnen von Bildern (Symbolstil) befinden.


Eigenschaften von TCustomImageList

TCustomImageList	Alphabetisch	Legende

In TCustomImageList

AllocBy

BkColor

BlendColor

Count

DragCursor

Dragging

DrawingStyle

Handle

Height

ImageType

Masked

ShareImages

Width

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Name

Owner

Tag


Eigenschaften von TCustomImageList

TCustomImageList	Nach Objekten	Legende

AllocBy

BkColor

BlendColor

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

Count

DesignInfo

DragCursor

Dragging

DrawingStyle

Handle

Height

ImageType

Masked

Name

Owner

ShareImages

Tag

Width


TCustomImageList::AllocBy

TCustomImageList	Siehe auch

Mit der Eigenschaft AllocBy wird die Anzahl der Bilder bestimmt, um die die Bilderliste vergrößert wird, wenn ihre Größe zur Aufnahme neuer Bilder geändert werden muß.

__property int AllocBy;

Beschreibung

Mit der Methode AllocBy läßt sich die Anzahl der neuen Bilder festlegen, die in die Bilderliste mit der neuen Größe eingefügt werden können.


TCustomImageList::BkColor

TCustomImageList	Siehe auch

Die Eigenschaft BkColor legt fest, welche Hintergrundfarbe für das Zeichnen eines Bildes verwendet werden soll.

__property Graphics::TColor BkColor;

Beschreibung

Wenn Sie BkColor auf clNone setzen, wird keine Hintergrundfarbe angegeben. Dies hat zur Folge, daß das Bild transparent gezeichnet wird. Wird BkColor auf clDefault gesetzt, wird die Hintergrundfarbe der Bilderliste für das Zeichnen verwendet.


TCustomImageList::BlendColor

TCustomImageList	Siehe auch

Die Eigenschaft BlendColor legt fest, welche Vordergrundfarbe für das Zeichnen eines Bildes verwendet werden soll.

__property Graphics::TColor BlendColor;

Beschreibung

clNone gibt an, daß keine vermischte Farbe für den Vordergrund verwendet wird, während clDefault festlegt, daß die Hervorhebungsfarbe des Systems als Farbe für den Vordergrund dient.


TCustomImageList::Count

TCustomImageList	Siehe auch

Die Eigenschaft Count liefert die Anzahl der Bilder in der Bilderliste zurück.

__property int Count;

Beschreibung

Count kann von Nutzen sein, wenn die Bilderliste in Schleifen verarbeitet wird.


TCustomImageList::DragCursor

TCustomImageList	Siehe auch	Beispiel

Die Eigenschaft DragCursor bestimmt den aktuellen Drag-Cursor für die Bilderliste.

__property TCursor DragCursor;

Beschreibung

Mit der Eigenschaft DragCursor wird festgelegt, welcher Drag-Cursor angezeigt wird, wenn ein Bild in der Bilderliste gezogen wird. Wird ein Bild gezogen, erfolgt die Erzeugung eines neuen Drag-Bildes durch die Kombination des gegebenen Bildes (normalerweise ein Mauscursor-Bild) mit dem aktuellen Drag-Cursor.


TCustomImageList::Dragging

TCustomImageList	Siehe auch

Die Eigenschaft Dragging gibt an, ob das Bild in der Bilderliste gerade gezogen wird.

__property bool Dragging;

Beschreibung

Wenn Dragging True zurückgibt, wird ein Bild in der Bilderliste gezogen. Liefert Dragging False zurück, wird kein Bild gezogen.


TCustomImageList::DrawingStyle

TCustomImageList	Siehe auch

Die Eigenschaft DrawingStyle legt den Stil fest, der verwendet wird, wenn die Bilderliste ein Bild zeichnet.

__property TDrawingStyle DrawingStyle;

Beschreibung

Mit der Eigenschaft DrawingStyle wird die Art und Weise gesteuert, in der das Bild angezeigt werden soll. Folgende Werte stehen für die Eigenschaft DrawingStyle zur Verfügung:

Wert	Bedeutung

dsFocused	Zeichnet das Bild, indem mit 25 % der Hervorhebungsfarbe des Systems überblendet wird. Dies betrifft nur Bilderlisten, die Masken enthalten.

dsSelected	Zeichnet das Bild, indem mit 50 % der Hervorhebungsfarbe des Systems überblendet wird. Dies betrifft nur Bilderlisten, die Masken enthalten.

dsNormal	Zeichnet das Bild mit der in der Eigenschaft BkColor angegebenen Farbe. Wenn BkColor den Wert clNone hat, wird das Bild unter Verwendung der Maske transparent gezeichnet.

dsTransparent	Zeichnet mit Hilfe der Maske, unabhängig von der BkColor-Einstellung.


TCustomImageList::Handle

TCustomImageList	Siehe auch	Beispiel

Die Eigenschaft Handle legt das Handle für die Bilderliste fest.

__property int Handle;

Beschreibung

Die Eigenschaft Handle ermöglicht den Zugriff auf das Handle des Windows-Bildlistenobjekts, wenn API-Funktionen aufgerufen werden, die das Handle benötigen.


TCustomImageList::Height

TCustomImageList	Siehe auch	Beispiel

Die Eigenschaft Height legt die Höhe der Bilder in der Bilderliste fest.

__property int Height;

Beschreibung

Mit der Eigenschaft Height wird die Höhe die Bilder festgelegt, bevor diese in die Bilderliste eingefügt werden. Die Bilderliste wird geleert, wenn sich dieser Wert ändert.


TCustomImageList::ImageType

TCustomImageList	Siehe auch

Die Eigenschaft ImageType legt fest, ob die Bilderliste zum Zeichnen das Bild oder die verbundene Maske verwendet.

__property TImageType ImageType;

Beschreibung

Mit der Eigenschaft ImageType wird die Art und Weise gesteuert, in der das Bild angezeigt werden soll. Folgende Werte können für die Eigenschaft ImageType angegeben werden:

Wert	Bedeutung

itImage	Zeichnet das Bild.

itMask	Zeichnet die Maske.


TCustomImageList::Masked

TCustomImageList	Siehe auch

Die Eigenschaft Masked legt fest, ob die Bilderliste transparente oder nichttransparente Bilder enthält.

__property bool Masked;

Beschreibung

Durch Setzen der Eigenschaft Masked auf True legen Sie fest, daß die Bilder transparent sind.


TCustomImageList::ShareImages

TCustomImageList	Siehe auch

Die Eigenschaft ShareImages legt fest, ob die Bilderliste ihr Handle freigibt, wenn sie selbst freigegeben wird.

__property bool ShareImages;

Beschreibung

Setzen Sie die Eigenschaft ShareImages auf False, um sicherzustellen, daß bei Freigabe der Bilderliste auch das Handle freigegeben wird.


TCustomImageList::Width

TCustomImageList	Siehe auch	Beispiel

Die Eigenschaft Width legt die Breite der Bilder in der Bilderliste fest.

__property int Width;

Beschreibung

Mit der Eigenschaft Width wird die Breite der Bilder festgelegt, bevor diese in die Bilderliste eingefügt werden. Die Bilderliste wird geleert, wenn sich dieser Wert ändert.


Ereignisse von TCustomImageList

TCustomImageList	Alphabetisch	Legende

In TCustomImageList

OnChange


Ereignisse von TCustomImageList

TCustomImageList	Nach Objekten	Legende

OnChange


TCustomImageList::OnChange

TCustomImageList	Siehe auch

Das Ereignis OnChange wird aufgerufen, wenn sich die Bilderliste ändert.

Beschreibung

Mit Hilfe des Ereignisses OnChange läßt sich Code ausführen, wenn sich die Bilderliste ändert. Außerdem werden alle mit der Methode RegisterChanges registrierten Objekte benachrichtigt.


Methoden von TCustomImageList

TCustomImageList	Alphabetisch	Legende

In TCustomImageList

~TCustomImageList

Add

AddIcon

AddImages

AddMasked

Assign

BeginDrag

Change

Clear

DefineProperties

Delete

DragLock

DragMove

DragUnlock

Draw

DrawOverlay

EndDrag

FileLoad

GetBitmap

GetHotSpot

GetIcon

GetImageBitmap

GetImages

GetMaskBitmap

GetResource

HandleAllocated

HandleNeeded

HideDragImage

Initialize

Insert

InsertIcon

InsertMasked

Move

Overlay

RegisterChanges

Replace

ReplaceIcon

ReplaceMasked

ResourceLoad

SetDragImage

ShowDragImage

TCustomImageList

UnRegisterChanges

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TCustomImageList

TCustomImageList	Nach Objekten	Legende

~TCustomImageList

AddIcon

AddImages

AddMasked

Add

Assign

BeginDrag

Change

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

Clear

DefaultHandler

DefineProperties

Delete

DestroyComponents

Destroying

Dispatch

DragLock

DragMove

DragUnlock

DrawOverlay

Draw

EndDrag

FieldAddress

FileLoad

FindComponent

FreeInstance

FreeNotification

Free

GetBitmap

GetHotSpot

GetIcon

GetImageBitmap

GetImages

GetMaskBitmap

GetParentComponent

GetResource

HandleAllocated

HandleNeeded

HasParent

HideDragImage

InheritsFrom

Initialize

InitInstance

InsertComponent

InsertIcon

InsertMasked

Insert

InstanceSize

MethodAddress

MethodName

Move

NewInstance

Overlay

RegisterChanges

RemoveComponent

ReplaceIcon

ReplaceMasked

Replace

ResourceLoad

SetDragImage

ShowDragImage

TCustomImageList

UnRegisterChanges


TCustomImageList::~TCustomImageList

TCustomImageList	Siehe auch

Der Destruktor ~TCustomImageList gibt den Speicher frei, der für das TCustomImageList-Objekt reserviert war. Rufen Sie ~TCustomImageList nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TCustomImageList automatisch aufgerufen wird.

__fastcall virtual ~TCustomImageList(void);


TCustomImageList::Add

TCustomImageList	Siehe auch

Die Methode Add fügt ein Bild und dessen Maske dem Bildlistenobjekt hinzu. Add liefert den Index des hinzugefügten Bildes zurück.

int __fastcall Add(Graphics::TBitmap* Image, Graphics::TBitmap* Mask);

Beschreibung

Mit der Methode Add können Sie Bilder zusammen mit ihren Masken einer Bilderliste hinzufügen. Wenn die Eigenschaft Masked der Bilderliste den Wert False hat, wird das zweite Bitmap-Handle ignoriert. Es kann auf NULL gesetzt werden. Add liefert bei Erfolg 0, ansonsten -1.


TCustomImageList::AddIcon

TCustomImageList	Siehe auch

Die Methode AddIcon fügt ein mit Image angegebenes Symbol dem Bildlistenobjekt hinzu. AddIcon liefert den Index des hinzugefügten Bildes zurück.

int __fastcall AddIcon(Graphics::TIcon* Image);

Beschreibung

Mit der Methode AddIcon können Sie ein Symbol einer Bilderliste hinzufügen. AddIcon liefert bei Erfolg 0, ansonsten -1.


TCustomImageList::AddImages

TCustomImageList	Siehe auch

Mit der Methode AddImages können Bilder aus der mit Value angegebenen Bilderliste dem Bildlistenobjekt hinzugefügt werden.

void __fastcall AddImages(TCustomImageList* Value);

Beschreibung

Mit der Methode AddImages können Sie Bilder aus einer anderen Bilderliste hinzufügen. AddImages liefert bei Erfolg 0, ansonsten -1.


TCustomImageList::AddMasked

TCustomImageList	Siehe auch

Mit der Methode AddMasked wird ein Bild zusammen mit einer Farbe in die Bilderliste eingefügt. Diese Farbe dient ausgehend von dem Bild zur Erzeugung einer transparenten Maske.

int __fastcall AddMasked(Graphics::TBitmap* Image, Graphics::TColor MaskColor);

Beschreibung

AddMasked ähnelt Add, jedoch mit dem Unterschied, daß kein Masken-Bitmap angegeben wird. Statt dessen wird eine Farbe festgelegt, die das System zur automatischen Erzeugung der Masken mit dem Bild-Bitmap kombiniert. Jedes Pixel der angegebenen Farbe im Bild-Bitmap erhält die Farbe Schwarz, und das entsprechende Bit in der Maske wird auf 1 gesetzt. Dadurch werden beim Zeichnen des Bildes alle Pixel im Bild mit der angegebenen Farbe transparent. AddMasked liefert bei Erfolg 0, ansonsten -1.


TCustomImageList::Assign

TCustomImageList	Siehe auch

Mit der Methode Assign werden die Daten aus einer Bilderliste in eine andere kopiert.

virtual void __fastcall Assign(Classes::TPersistent* Source);

Beschreibung

Wenn es sich bei Source um ein anderes TImageList-Objekt handelt, verwirft Assign alle aktuellen Bildinformationen und ersetzt sie durch die Informationen aus Source. Ist Source ein anderer Objekttyp, ruft Assign dessen geerbte Methode auf. Mit Hilfe dieser Methode können Sie Informationen aus einem Objekt in ein anderes kopieren.


TCustomImageList::BeginDrag

TCustomImageList	Siehe auch

Die Methode BeginDrag startet das Ziehen eines Bildes.

bool __fastcall BeginDrag(HWND Window, int X, int Y);

Beschreibung

Mit der Methode BeginDrag starten Sie das Ziehen eines Bildes, das mit SetDragImage angegeben wurde, auf die X- und Y-Koordinaten der Zugposition relativ zu der oberen linken Ecke des Bildes. Window ist das Handle der Bilderliste. BeginDrag liefert True zurück, wenn mit dem Ziehen des Bildes begonnen werden konnte.


TCustomImageList::Change

TCustomImageList	Siehe auch

Die Methode Change benachrichtigt die Bilderliste und alle mit RegisterChanges registrierten Objekte davon, daß in der Bilderliste eine Änderung aufgetreten ist.

virtual void __fastcall Change(void);

Beschreibung

Mit dieser Methode wird das Ereignis OnChange der Bilderliste und aller für die Liste registrierten Objekte ausgelöst, um diese von der Änderung zu benachrichtigen.


TCustomImageList::Clear

TCustomImageList	Siehe auch

Mit der Methode Clear werden alle Bilder aus der Bilderliste gelöscht.

void __fastcall Clear(void);

Beschreibung

Mit der Methode Clear können Sie alle Bilder aus der Bilderliste löschen. Wenn Sie nur ein Bild aus der Liste entfernen wollen, verwenden Sie die Methode Delete.


TCustomImageList::DefineProperties

TCustomImageList	Siehe auch

Die Methode DefineProperties ruft die geerbte Methode DefineProperties auf und definiert außerdem die Bitmap-Daten für die Speicherung durch den Filer.

virtual void __fastcall DefineProperties(Classes::TFiler* Filer);

Beschreibung

Die Methode DefineProperties ruft sowohl die geerbte Methode DefineProperties als auch die Methode TFiler::DefineBinaryProperty auf. Letztere definiert binäre Daten, die das Filer-Objekt wie eine Eigenschaft speichert.


TCustomImageList::Delete

TCustomImageList	Siehe auch

Mit der Methode Delete wird ein bestimmtes Bild aus der Bilderliste gelöscht.

void __fastcall Delete(int Index);

Beschreibung

Verwenden Sie die Methode Delete, wenn Sie das in Index angegebene Bild aus der Liste löschen wollen. Mit der Methode Clear können Sie alle Bilder aus der Bilderliste löschen.


TCustomImageList::DragLock

TCustomImageList	Siehe auch

Die Methode DragLock verbindet das Drag-Bild mit dem gegebenen Fenster-Handle und zeichnet es an der mit den Parametern XPos und YPos festgelegten Position, während sich das Fenster im Drag-Modus befindet. Bei Erfolg liefert die Methode True zurück.

bool __fastcall DragLock(HWND Window, int XPos, int YPos);

Beschreibung

Rufen Sie DragLock auf, wenn Sie ein Bild der Bilderliste beim Ziehen eines bestimmten Fensters als Drag-Bild verwenden wollen.


TCustomImageList::DragMove

TCustomImageList	Siehe auch

Mit der Methode DragMove wird das mit SetDragImage angegebene Drag-Bild im aktuell mit ihm verbundenen Fenster an die neue, durch X und Y angegebene Position verschoben. Das Fenster befindet sich dabei im Drag-Modus. Bei Erfolg liefert die Methode True zurück.

bool __fastcall DragMove(int X, int Y);

Beschreibung

Setzen Sie die Methode DragMove ein, um das Bild zu verschieben, das bei einer Drag-and-Drop-Operation gezogen wird,.


TCustomImageList::DragUnlock

TCustomImageList	Siehe auch

Mit der Methode DragUnlock läßt sich die Verbindung zwischen dem Drag-Bild und einem Fenster entfernen.

void __fastcall DragUnlock(void);

Beschreibung

Verwenden Sie die Methode DragUnlock, wenn ein Bild nicht mehr als Drag-Bild für ein bestimmtes Fenster benötigt wird.


TCustomImageList::Draw

TCustomImageList	Siehe auch

Die Methode Draw zeichnet das mit dem Parameter Index angegebene Bild an der Position X, Y auf der bereitgestellten Zeichenfläche. Zum Zeichnen des Bildes wird der Stil verwendet, der in der Eigenschaft DrawingStyle festgelegt ist.

void __fastcall Draw(Graphics::TCanvas* Canvas, int X, int Y, int Index);

Beschreibung

Verwenden Sie die Methode Draw zum Zeichnen eines Bildes.

Beispiel

Der folgende Code zeichnet alle Tabellenkopfbereiche und fügt Text für einen Titel und in ImageList1 gespeicherte Symbole hinzu. Die Bilderliste enthält so viele Symbole, wie Kopfbereiche vorhanden sind.

void TForm1::HeaderControl1DrawSection(THeaderControl *HeaderControl1, THeaderSection *Section, const TRect& Rect, bool Pressed)

{

   HeaderControl->Canvas->Brush->Color = clRed;

   HeaderControl->Canvas->FillRect(Rect);

   HeaderControl->Canvas->Font->Color = clYellow;

   HeaderControl->Canvas->TextOut(Rect.left + 30, Rect.top + 2, "Header Control");

   ImageList1->Draw(HeaderControl1->Canvas,Rect.Left,Rect.Top,Section->Index);

}


TCustomImageList::DrawOverlay

TCustomImageList	Siehe auch

Mit der Methode DrawOverlay werden ein Bild und ein Overlay auf die bereitgestellte Zeichenfläche gezeichnet.

void __fastcall DrawOverlay(Graphics::TCanvas* Canvas, int X, int Y, int ImageIndex, TOverlay Overlay);

Beschreibung

Eine Overlay-Maske ist ein Bild, das transparent über ein anderes Bild gezeichnet wird. Alle Bilder können als Overlay-Masken verwendet werden. Für das Zeichnen einer Overlay-Maske über ein Bild steht die Methode DrawOverlay mit dem Index der Overlay-Maske zur Verfügung. Zuvor muß die Methode Overlay aufgerufen werden, damit ein Bild als Overlay verwendet werden kann.


TCustomImageList::EndDrag

TCustomImageList	Siehe auch	Beispiel

Die Methode EndDrag beendet die Drag-Operation. Bei Erfolg liefert die Methode True zurück.

bool __fastcall EndDrag(void);

Beschreibung

Rufen Sie nach BeginDrag die Methode EndDrag auf, um die Drag-Operation zu beenden.


TCustomImageList::FileLoad

TCustomImageList	Siehe auch

Mit der Methode FileLoad wird eine Datei vom Typ TResType in die Bilderliste geladen. Mit MaskColor wird die transparente Farbe für die Bilder in der Datei festgelegt. Der Parameter Name gibt die Datei an, die geladen werden soll.

bool __fastcall FileLoad(TResType ResType,  System::AnsiString Name, Graphics::TColor MaskColor);

Beschreibung

Mit der Methode FileLoad können Sie eine Bitmap-, eine Cursor- oder eine Symboldatei in eine Bilderliste laden. Bei Erfolg liefert die Methode True zurück.


TCustomImageList::GetBitmap

TCustomImageList	Siehe auch

Die Methode GetBitmap liefert das mit dem Parameter Index angegebene Bild als Bitmap im Parameter Image zurück.

void __fastcall GetBitmap(int Index, Graphics::TBitmap* Image);

Beschreibung

Verwenden Sie die Methode GetBitmap, wenn Sie ein bestimmtes Bild der Bilderliste als Bitmap-Objekt abrufen wollen.


TCustomImageList::GetHotSpot

TCustomImageList	Siehe auch

Die Methode GetHotSpot liefert die Hotspot-Position, die mit dem aktuellen Drag-Bild verbunden ist.

POINT __fastcall GetHotSpot(void);

Beschreibung

Mit der Methode GetHotSpot erhalten Sie die Position des Hotspot für das aktuelle Drag-Bild.


TCustomImageList::GetIcon

TCustomImageList	Siehe auch

Die Methode GetIcon liefert das mit dem Parameter Index angegebene Bild als Symbol im Parameter Image zurück.

void __fastcall GetIcon(int Index, Graphics::TIcon* Image);

Beschreibung

Verwenden Sie die Methode GetIcon, wenn Sie ein bestimmtes Bild der Bilderliste als Symbol abrufen wollen.


TCustomImageList::GetImageBitmap

TCustomImageList	Siehe auch

Die Methode GetImageBitmap liefert ein Handle eines Bitmaps, das alle Bilder der Bilderliste enthält.

HBITMAP __fastcall GetImageBitmap(void);

Beschreibung

Verwenden Sie die Methode GetImageBitmap, wenn Sie ein Bitmap abrufen wollen, das alle Bilder der Bilderliste enthält. Die Methode liefert 0, wenn sie fehlschlägt.


TCustomImageList::GetImages

TCustomImageList	Siehe auch

Die Methode GetImages liefert das mit dem Parameter Index angegebene Bild und seine Maske als Bitmap in den Parametern Image bzw. Mask zurück.

void __fastcall GetImages(int Index, Graphics::TBitmap* Image, Graphics::TBitmap* Mask);

Beschreibung

Mit der Methode GetImages können Sie ein Bild und seine Maske als Bitmaps abrufen.


TCustomImageList::GetMaskBitmap

TCustomImageList	Siehe auch

Die Methode GetMaskBitmap liefert ein Handle eines Bitmaps, das alle Masken für die Bilder der Bilderliste enthält.

HBITMAP __fastcall GetMaskBitmap(void);

Beschreibung

Verwenden Sie die Methode GetMaskBitmap, wenn Sie ein Bitmap abrufen wollen, das alle Masken der Bilderliste enthält. Die Methode liefert 0, wenn sie fehlschlägt.


TCustomImageList::GetResource

TCustomImageList	Siehe auch

Mit der Methode GetResource wird die angegebene Bitmap-, Cursor- oder Symbolressource in die Bilderliste geladen.

bool __fastcall GetResource(TResType ResType,  System::AnsiString Name, int Width,  TLoadResources  LoadFlags, Graphics::TColor MaskColor);

Beschreibung

Mit der Methode GetResource können Sie die mit dem Parameter Name angegebene Bitmap-, Cursor- oder Symbolressource in eine Bilderliste laden.

ResType bestimmt den Typ der grafischen Ressource, die in die Bilderliste geladen werden soll. Der Typ kann den Wert rtBitmap, rtCursor oder rtIcon haben. Mit MaskColor wird die transparente Farbe für die Bilder in der Datei bestimmt. LoadFlags legt fest, wie das Bild geladen werden soll. Sie können eine Kombination aus den folgenden Werten angeben:

Wert	Bedeutung

lrNone	Keine spezifischen Ressourcen-Flags.

lrDefaultColor	Verwendet das Farbformat der Anzeige.

lrDefaultSize	Verwendet die Systemmaßeinheit für Height und Width, wenn der Parameter Width für GetResource 0 ist. Wenn der Parameter Width 0 und diese Option für Cursor und Symbole nicht angegeben ist, werden die Höhe und Breite der Ressourcen verwendet.

lrFromFile	Lädt die Ressource aus der angegebenen Datei.

lrMap3DColors	Ersetzt die Grauabstufungen der Bilder durch die 3D-Fensterfarben.

lrTransparent	Ersetzt den Farbtabelleneintrag für das erste Pixel der Ressource durch die Standardfensterfarbe (COLOR_WINDOW). Dies gilt nur für Bilder mit Farbtabellen.

lrMonoChrome	Lädt die Ressource in Schwarzweiß.


TCustomImageList::HandleAllocated

TCustomImageList	Siehe auch	Beispiel

Die Methode HandleAllocated liefert True zurück, wenn ein Fenster-Handle für das Steuerelement existiert. Ansonsten wird False zurückgegeben.

bool __fastcall HandleAllocated(void);

Beschreibung

Mit Hilfe der Methode HandleAllocated können Sie feststellen, ob für das Steuerelement ein Handle existiert. HandleAllocated erstellt kein Handle, wenn noch keines vorhanden ist. Existiert kein Handle, wird durch den direkten Aufruf der Eigenschaft Handle eines Steuerelements automatisch ein Handle erstellt.


TCustomImageList::HandleNeeded

TCustomImageList	Siehe auch	Beispiel

Mit der Methode HandleNeeded wird ein Handle für eine Bilderliste erstellt, wenn noch keines existiert.

void __fastcall HandleNeeded(void);

Beschreibung

Mit der Methode HandleNeeded können Sie ein Handle für eine Bilderliste erstellen, wenn noch keines existiert. Diese Methode wird automatisch aufgerufen, wenn ein Zugriff auf die Eigenschaft Handle einer Bilderliste erfolgt.


TCustomImageList::HideDragImage

TCustomImageList	Siehe auch

Mit der Methode HideDragImage wird das aktuelle Drag-Bild verborgen, wenn es vorher sichtbar war.

void __fastcall HideDragImage(void);

Beschreibung

Verwenden Sie die Methode HideDragImage, wenn das aktuelle Drag-Bild verborgen werden soll.


TCustomImageList::Initialize

TCustomImageList	Siehe auch

Mit der Methode Initialize werden zahlreiche Bildlisteneigenschaften auf ihre Standardwerte gesetzt und Instanzen von Objekten erzeugt, die intern für die Bilderliste verwendet werden.

void __fastcall Initialize(void);

Beschreibung

Initialize wird vom Create- und CreateSize-Konstruktor der Bilderliste aufgerufen.


TCustomImageList::Insert

TCustomImageList	Siehe auch

Mit der Methode Insert wird nach dem mit Index angegebenen Bild ein Bitmap und seine Maske in die Bilderliste eingefügt.

void __fastcall Insert(int Index, Graphics::TBitmap* Image, Graphics::TBitmap* Mask);

Beschreibung

Verwenden Sie die Methode Insert, wenn Sie ein Bitmap und seine Maske in die Bilderliste einfügen wollen.


TCustomImageList::InsertIcon

TCustomImageList	Siehe auch

Mit der Methode InsertIcon wird ein Symbol an der Position Index + 1 in die Bilderliste eingefügt.

void __fastcall InsertIcon(int Index, Graphics::TIcon* Image);

Beschreibung

Mit der Methode InsertIcon können Sie ein Symbol in die Bilderliste einfügen.


TCustomImageList::InsertMasked

TCustomImageList	Siehe auch

Mit der Methode InsertMasked wird ein Bitmap an der Position Index + 1 eingefügt, wobei die Maske aus der transparenten Farbe erstellt wird, die mit dem Parameter MaskColor angegeben wird.

void __fastcall InsertMasked(int Index, Graphics::TBitmap* Image, Graphics::TColor MaskColor);

Beschreibung

Mit der Methode InsertMasked können Sie ein Bild mit Maske in die Bilderliste einfügen.


TCustomImageList::Move

TCustomImageList	Siehe auch

Mit der Methode Move wird ein mit CurIndex angegebenes Bild in der Bilderliste an die mit NewIndex angegebene Position verschoben.

void __fastcall Move(int CurIndex, int NewIndex);

Beschreibung

Verwenden Sie die Methode Move, wenn Sie ein Bild an eine andere Position in der Bilderliste verschieben wollen.


TCustomImageList::Overlay

TCustomImageList	Siehe auch

Mit der Methode Overlay wird der Index eines Bildes in die Liste der Bilder eingefügt, die als Overlay-Masken verwendet werden. Es können bis zu vier Indizes in die Liste eingefügt werden.

typedef signed char TOverlay;

bool __fastcall Overlay(int ImageIndex, TOverlay Overlay);

Beschreibung

Eine Overlay-Maske ist ein Bild, das transparent über ein anderes Bild gezeichnet wird. Alle Bilder können als Overlay-Masken verwendet werden. Für das Zeichnen einer Overlay-Maske über ein Bild wird die Methode DrawOverlay mit dem Index der Overlay-Maske verwendet. Die Methode liefert bei Erfolg True zurück.


TCustomImageList::RegisterChanges

TCustomImageList	Siehe auch

Mit der Methode RegisterChanges wird ein Objekt registriert, so daß es bei auftretenden Änderungen in der Bilderliste benachrichtigt wird.

void __fastcall RegisterChanges(TChangeLink* Value);

Beschreibung

Verwenden Sie die Methode RegisterChanges, damit ein Objekt von Änderungen in der Bilderliste benachrichtigt wird. Die Ereignisbehandlungsroutine für OnChange für TChangeLink wird jedesmal aufgerufen, wenn eine Änderung in der Bilderliste auftritt.

Erstellen Sie ein ChangeLink-Objekt für alle Objekte, die von Änderungen benachrichtigt werden sollen. Zum Registrieren eines Objekts rufen Sie RegisterChanges auf und übergeben sein ChangeLink-Objekt im Parameter Value. Danach wird das Ereignis OnChange aller registrierten ChangeLink-Objekte ausgelöst, sobald eine Änderung in der Bilderliste auftritt. Es wird der Quelltext ausgeführt, der der Ereignisbehandlungsroutine für OnChange zugewiesen ist.


TCustomImageList::Replace

TCustomImageList	Siehe auch

Mit der Methode Replace wird ein Bild in der Bilderliste durch ein neues Bild und eine neue Maske ersetzt.

void __fastcall Replace(int Index, Graphics::TBitmap* Image, Graphics::TBitmap* Mask);

Beschreibung

Mit der Methode Replace können Sie das Bild an der Position Index in der Bilderliste durch ein neues Bild und eine Overlay-Maske ersetzen.


TCustomImageList::ReplaceIcon

TCustomImageList	Siehe auch

Mit der Methode ReplaceIcon wird ein Bild in der Bilderliste durch ein Symbol ersetzt.

void __fastcall ReplaceIcon(int Index, Graphics::TIcon* Image);

Beschreibung

Mit der Methode ReplaceIcon können Sie das Bild an der Position Index in der Bilderliste durch ein neues Symbol ersetzen.


TCustomImageList::ReplaceMasked

TCustomImageList	Siehe auch

Mit der Methode ReplaceMasked wird ein Bild in der Bilderliste durch ein neues Bild und eine neue Maske ersetzt.

void __fastcall ReplaceMasked(int Index, Graphics::TBitmap* NewImage, Graphics::TColor MaskColor);

Beschreibung

Mit der Methode ReplaceMasked können Sie das Bild an der Position Index in der Bilderliste durch ein neues Bild und eine neue Maske ersetzen, die mit MaskColor für Transparenz erstellt wurde.

Siehe auch

Methode Replace, Methode InsertMasked


TCustomImageList::ResourceLoad

TCustomImageList	Siehe auch

Mit der Methode ResourceLoad wird eine Ressource in die Bilderliste geladen.

bool __fastcall ResourceLoad(TResType ResType,  System::AnsiString Name, Graphics::TColor MaskColor );

Beschreibung

Mit der Methode ResourceLoad können Sie eine Ressource vom Typ TResType in die Bilderliste laden. Mit Hilfe von MaskColor wird die Maske für das resultierende Bild erstellt.

Siehe auch

Methode GetResource


TCustomImageList::SetDragImage

TCustomImageList	Siehe auch

Mit der Methode SetDragImage wird ein Bild in der Bilderliste angegeben, das während einer Drag-and-Drop-Operation angezeigt werden soll.

bool __fastcall SetDragImage(int Index, int HotSpotX, int HotSpotY);

Beschreibung

Mit der Methode SetDragImage bestimmen Sie das durch Index angegebene Bild in der Bilderliste als dasjenige, das bei einer Drag-and-Drop-Operation der Bilderliste angezeigt werden soll. Der Hotspot des Bildes wird mit HotSpotX und HotSpotY festgelegt.

Siehe auch

Methode DragMove, Methode BeginDrag, Methode DragLock, Methode DragUnlock, Methode EndDrag, Methode ShowDragImages


TCustomImageList::ShowDragImage

TCustomImageList	Siehe auch

Mit der Methode ShowDragImage wird das aktuelle Drag-Bild angezeigt, wenn es zuvor verborgen war.

void __fastcall ShowDragImage(void);

Beschreibung

Mit der Methode ShowDragImage wird das aktuelle Drag-Bild angezeigt, wenn es zuvor verborgen war.


TCustomImageList::TCustomImageList

TCustomImageList	Siehe auch

Der Konstruktor TCustomImageList erzeugt ein neues TCustomImageList-Objekt.

__fastcall virtual TCustomImageList(Classes::TComponent* AOwner);

-oder-

__fastcall TCustomImageList(int AWidth, int AHeight);

Beschreibung

Mit dem Konstruktor Create erstellen Sie eine Bilderliste als untergeordnetes Objekt der mit AOwner angegebenen Komponente. Es wird die Standardbildgröße von 16 x 16 Pixel verwendet.

Es können aber auch Bilderlisten mit einer anderen Bildgröße erzeugt werden. Die anfängliche Größe wird in den Parametern AHeight und AWidth festgelegt. Nach der Erzeugung können Höhe und Breite mit den Eigenschaften Width und Height verändert werden.


TCustomImageList::UnRegisterChanges

TCustomImageList	Siehe auch

Mit der Methode UnRegisterChanges kann ein Objekt aus der Liste der Objekte entfernt werden, die bei Änderungen in der Bilderliste benachrichtigt werden sollen.

void __fastcall UnRegisterChanges(TChangeLink* Value);

Beschreibung

Mit der Methode UnRegisterChanges können Sie die Registrierung eines TChangeLink-Objekts aufheben. Das betreffende Objekt wird dann nicht mehr von Änderungen in der Bilderliste benachrichtigt.


Gültigkeitsbereich

Protected

Published

Zugriff

Read-only


Gültigkeitsbereich

Protected


Gültigkeitsbereich

Protected


Hierarchie

TObject

TPersistent

TComponent


TCustomImageList Beispiel

TCustomImageList


TCustomLabel

Hierarchie	Eigenschaften	Methoden	Siehe auch

TCustomLabel ist die Basisklasse für nicht fensterorientierte Steuerelemente, mit denen Text in einem Formular dargestellt werden kann.

Header

vcl/stdctrls.hpp

Beschreibung

Verwenden Sie TCustomLabel als Basisklasse, wenn Sie selbst Objekte definieren, mit denen Text angezeigt werden soll, den der Benutzer nicht bearbeiten kann. TCustomLabel führt mehrere neue Eigenschaften und Methoden ein, die das Aussehen und die Anordnung des Textes betreffen. TCustomLabel ist kein Nachkomme von TWinControl, besitzt deshalb kein eigenes Fenster und kann auch keine Tastatureingaben verarbeiten.

Erzeugen Sie keine Instanzen von TCustomLabel. Wenn Sie eine Beschriftung in einem Formular plazieren wollen, verwenden Sie ein TLabel-Objekt.


Eigenschaften von TCustomLabel

TCustomLabel	Alphabetisch	Legende

In TCustomLabel

Alignment

AutoSize

FocusControl

ShowAccelChar

Transparent

WordWrap

Abgeleitet von TGraphicControl

Canvas

Abgeleitet von TControl

Align

BoundsRect

ClientHeight

ClientOrigin

ClientRect

ClientWidth

ControlState

ControlStyle

Cursor

Enabled

Height

Hint

Left

Name

Parent

ShowHint

Top

Visible

Width

WindowProc

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TCustomLabel

TCustomLabel	Nach Objekten	Legend

Alignment

Align

AutoSize

BoundsRect

Canvas

ClientHeight

ClientOrigin

ClientRect

ClientWidth

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlState

ControlStyle

Cursor

DesignInfo

Enabled

FocusControl

Height

Hint

Left

Name

Owner

Parent

ShowAccelChar

ShowHint

Tag

Top

Transparent

Visible

Width

WindowProc

WordWrap


TCustomLabel::Alignment

TCustomLabel	Siehe auch	Beispiel

Die Eigenschaft Alignment steuert die Anordnung des Textes innerhalb der Beschriftungskomponente.

__property Classes::TAlignment Alignment;

Beschreibung

Mit Alignment legen Sie fest, wie der Text innerhalb des Begrenzungsrechtecks der Komponente ausgerichtet wird. Folgende Werte sind möglich:

Wert	Bedeutung

taLeftJustify	Der Text wird am linken Rand ausgerichtet.

taRightJustify	Der Text wird am rechten Rand ausgerichtet.

taCenter	Der Text wird zentriert.

Der Effekt der Eigenschaft Alignment wird deutlicher, wenn die Eigenschaft WordWrap den Wert True hat und der Beschriftungstext mehrere Textzeilen enthält.


TCustomLabel::AutoSize

TCustomLabel	Siehe auch	Beispiel

Die Eigenschaft AutoSize legt fest, ob die Größe des Steuerelements automatisch an die Größe des enthaltenen Textes angepaßt wird.

__property bool AutoSize;

Beschreibung

Wenn AutoSize den Wert True hat, wird der Client-Bereich des Steuerelements automatisch an Höhe und Breite des enthaltenen Textes angepaßt, auch wenn der Text oder die Schriftart geändert wird. Der Wert False bewirkt eine feste Größe.

Wenn WordWrap den Wert True hat, ist die Breite des Steuerelements fest. Ist AutoSize ebenfalls True, bewirken Änderungen am Text, daß das Steuerelement in der Höhe angepaßt wird. Wenn AutoSize True ist und WordWrap False, wird die Höhe des Steuerelements von der Schriftart vorgegeben, und Änderungen am Text bewirken eine Breitenänderung.


TCustomLabel::FocusControl

TCustomLabel	Siehe auch

Die Eigenschaft FocusControl bezeichnet ein fensterorientiertes Steuerelement, dem eine Beschriftung zugeordnet ist.

__property Controls::TWinControl* FocusControl;

Beschreibung

Über FocusControl erfolgt die Verknüpfung zu einem fensterorientierten Steuerelement, das den Fokus erhalten soll, wenn der Benutzer das Tastenkürzel eingibt, das in der Beschriftungskomponente definiert ist. Die Tastenkürzeldefinition erfolgt dadurch, daß einem Zeichen im Beschriftungstext ein kaufmännisches Und (&) vorangestellt und gleichzeitig die Eigenschaft ShowAccelChar auf True gesetzt wird.


TCustomLabel::ShowAccelChar

TCustomLabel	Siehe auch	Beispiel

Die Eigenschaft ShowAccelChar steuert, in welcher Form ein kaufmännisches Und (&) im Beschriftungstext dargestellt wird.

__property bool ShowAccelChar;

Beschreibung

Wenn ShowAccelChar den Wert True hat, wird das Zeichen, das unmittelbar auf ein & folgt, als Tastenkürzel interpretiert und mit einer Unterstreichung versehen. Ist gleichzeitig die Eigenschaft FocusControl definiert und wird das Tastenkürzel vom Benutzer eingegeben, dann erhält das von FocusControl bezeichnete Steuerelement den Eingabefokus. Wenn es notwendig sein sollte, ein kaufmännisches Und als solches auszugeben, während ShowAccelChar den Wert True hat, müssen Sie dieses Zeichen verdoppeln (&&). Eines davon wird dann als & angezeigt.

Setzen Sie ShowAccelChar auf False, wenn alle im Beschriftungstext enthaltenen &-Zeichen auch als solche angezeigt werden sollen. Wenn ShowAccelChar den Wert False hat, wird der Wert von FocusControl ignoriert.


TCustomLabel::Transparent

TCustomLabel	Siehe auch	Beispiel

Die Eigenschaft Transparent legt fest, ob eine Beschriftungskomponente ein darunterliegendes Steuerelement verdeckt oder nicht.

__property bool Transparent;

Beschreibung

Setzen Sie Transparent auf True, wenn die Beschriftung andere Steuerelemente nicht abdecken soll. Auf diese Weise läßt sich zum Beispiel Text in eine Grafik integrieren.


TCustomLabel::WordWrap

TCustomLabel	Siehe auch	Beispiel

Die Eigenschaft WordWrap steuert, ob der Beschriftungstext bei Bedarf umbrochen wird.

__property bool WordWrap;

Beschreibung

Der Wert True bewirkt, daß mehrere Textzeilen in der Komponente Platz finden. Bei Bedarf wird ein Zeilenumbruch vorgenommen.

Wenn WordWrap den Wert False hat und der Text nicht in eine einzige Zeile paßt, wird er in der Bildschirmdarstellung abgeschnitten.


Methoden von TCustomLabel

TCustomLabel	Alphabetisch	Legende

In TCustomLabel

~TCustomLabel

GetLabelText

Notification

Paint

SetAutoSize

TCustomLabel

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

GetTextLen

Hide

Invalidate

Perform

Refresh

Repaint

ScreenToClient

SendToBack

SetBounds

SetTextBuf

Show

Update

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TCustomLabel

TCustomLabel	Nach Objekten	Legende

~TCustomLabel

Assign

BeginDrag

BringToFront

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

ClientToScreen

DefaultHandler

DestroyComponents

Destroying

Dispatch

DragDrop

Dragging

EndDrag

FieldAddress

FindComponent

FreeInstance

FreeNotification

Free

GetLabelText

GetParentComponent

GetTextBuf

GetTextLen

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InstanceSize

Invalidate

MethodAddress

MethodName

NewInstance

Notification

Paint

Perform

Refresh

RemoveComponent

Repaint

ScreenToClient

SendToBack

SetAutoSize

SetBounds

SetTextBuf

Show

TCustomLabel

Update


TCustomLabel::~TCustomLabel

TCustomLabel

Der Destruktor ~TCustomLabel gibt den Speicher frei, der für das TCustomLabel-Objekt reserviert war. Rufen Sie ~TCustomLabel nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TCustomLabel automatisch aufgerufen wird.

__fastcall virtual ~TCustomLabel(void);


TCustomLabel::GetLabelText

TCustomLabel	Siehe auch

Die Methode GetLabelText gibt den Wert der Eigenschaft Caption zurück.

virtual System::AnsiString __fastcall GetLabelText(void);

Beschreibung

Mit GetLabelText kann der String ermittelt werden, der als Beschriftungstext angezeigt wird. GetLabelText ist als protected deklariert, so daß die Methode in abgeleiteten Objekten so überschrieben werden kann, daß ein anderer Text als der in Caption enthaltene angezeigt wird.


TCustomLabel::Notification

TCustomLabel	Siehe auch

Die Methode Notification aktualisiert die Eigenschaft FocusControl, sobald das fensterorientierte Steuerelement, das von dieser Eigenschaft referenziert wird, freigegeben wird.

virtual void __fastcall Notification(Classes::TComponent* AComponent, Classes::TOperation Operation );

Beschreibung

Notification wird immer automatisch aufgerufen, sobald Komponenten erzeugt oder freigegeben werden. Nach dem Aufruf der geerbten Version von Notification überprüft die Methode, ob das fensterorientierte Steuerelement, daß von der Eigenschaft FocusControl referenziert wird, kurz vor der Freigabe steht. In diesem Fall setzt Notification die Eigenschaft FocusControl auf den Wert NULL.


TCustomLabel::Paint

TCustomLabel	Siehe auch

Die Methode Paint übernimmt die Anzeige der Beschriftung.

virtual void __fastcall Paint(void);

Beschreibung

Paint wird automatisch aufgerufen, sobald die Beschriftungskomponente eine Botschaft WM_PAINT vom übergeordneten Objekt erhält. Auf dem Bildschirm wird der Text dargestellt, der von der Methode GetLabelText zurückgegeben wird.


TCustomLabel::SetAutoSize

TCustomLabel	Siehe auch

Die Methode SetAutoSize weist der Eigenschaft AutoSize einen Wert zu.

virtual void __fastcall SetAutoSize(bool Value);

Beschreibung

SetAutoSize ist eine als protected deklarierte Methode für den Zugriff auf die Eigenschaft AutoSize. In abgeleiteten Objekten kann sie deshalb nach Bedarf überschrieben werden.


TCustomLabel::TCustomLabel

TCustomLabel	Siehe auch

Die Methode TCustomLabel erzeugt und initialisiert eine Instanz von TCustomLabel.

__fastcall virtual TCustomLabel(Classes::TComponent* AOwner);

Beschreibung

Mit TCustomLabel wird zur Laufzeit eine Instanz von TCustomLabel erzeugt. Alle Beschriftungen, die während des Entwurfs im Formular plaziert wurden, werden automatisch erzeugt.

Nach dem Aufruf des Konstruktors des übergeordneten Objekts werden folgende Initialisierungen vorgenommen:

•	AutoSize wird auf True gesetzt.

•	ShowAccelChar wird auf True gesetzt.

•	ControlStyle wird mit [csOpaque, csReplicatable] initialisiert.

•	Width wird auf 65 gesetzt, Height auf 17.


Gültigkeitsbereich

Protected

Published

Zugriff

Nur Lesen


Gültigkeitsbereich

Protected


Hierarchie

TObject

TPersistent

TComponent

TControl

TGraphicControl


Beispiel für TCustomLabel

TCustomLabel


TCustomListBox

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/stdctrls.hpp

TCustomListBox ist die abstrakte Basisklasse für Objekte, die die in Windows üblichen Listenfelder kapseln.

Beschreibung

TCustomListBox ist eine abstrakte Basisklasse. Sie kapselt das Verhalten, das alle Listenfelder in C++Builder gemeinsam haben. Ein Listenfeld zeigt eine bildlauffähige Liste an, aus der der Benutzer einen oder mehrere Einträge auswählen kann. Die Auswahl des Benutzers ist auf die Einträge beschränkt, die Sie zur Entwurfszeit festgelegt haben. Einträge können aber auch zur Laufzeit eingefügt oder gelöscht werden.

Mit den von TCustomListBox eingeführten Methoden können Sie:

•	die Einträge der Liste anzeigen, sortieren, auswählen, bearbeiten und abfragen.

•	Owner-Draw-Listenfelder erzeugen, in denen Grafiken wie z.B. Symbole und Bitmaps angezeigt werden.

•	Listen erzeugen, die aus mehreren Spalten bestehen, und Listen, aus denen der Benutzer mehrere Einträge auswählen kann.

Standardmäßig werden die Einträge eines TCustomListBox-Objekts als Strings angezeigt. Sie sind in einem TStrings-Objekt gespeichert und können mit dessen Methoden angehängt, eingefügt oder gelöscht werden.

Listenfelder, die Nachkommen von TCustomListBox sind, erben die grundlegende Funktionalität dieser Klasse. Einige Nachkommen verfügen auch über spezielle Merkmale und können mit Datei-, Verzeichnis-, Laufwerks- oder Datenbankinformationen verknüpft werden. Mit Hilfe dieser Listenfelder können Sie die betreffenden Informationen auf einfache Weise abrufen und auflisten.

Ein Kombinationsfeld ist ein Listenfeld, das mit einem Eingabefeld verknüpft ist. Das Listenfeld kann auf unterschiedliche Art angezeigt werden. In einem Kombinationsfeld kann der Benutzer eigene Eingaben vornehmen oder die aufklappbare Liste verwenden, durch die im Formular Platz gespart wird.

Wenn eine Matrix oder eine baumähnliche Struktur dargestellt werden soll, bietet sich die Verwendung eines Gliederungsdiagramms, einer Listenansicht oder eines Baumdiagramms an. Mit diesen Steuerelementen können Sie Einträge unter verschiedenen Spaltenüberschriften oder in expandierbaren Zeilen gruppieren.

Hinweis für Komponentenentwickler

Komponentenentwickler, die benutzerdefinierte Listenfeld entwickeln wollen, sollten TCustomListBox als Basisklasse verwenden.


Eigenschaften von TCustomListBox

TCustomListBox	Alphabetisch	Legende

In TCustomListBox

BorderStyle

Canvas

Columns

ExtendedSelect

IntegralHeight

ItemHeight

ItemIndex

Items

MultiSelect

SelCount

Selected

Sorted

Style

TabWidth

TopIndex

Abgeleitet von TWinControl

Brush

ClientOrigin

ClientRect

ControlCount

Controls

Handle

HelpContext

Showing

TabOrder

TabStop

Abgeleitet von TControl

Align

BoundsRect

ClientHeight

ClientWidth

ControlState

ControlStyle

Cursor

Enabled

Height

Hint

Left

Name

Parent

ParentColor

ShowHint

Top

Visible

Width

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TCustomListBox

TCustomListBox	Nach Objekten	Legende

Align

BorderStyle

BoundsRect

Brush

Canvas

ClientHeight

ClientOrigin

ClientRect

ClientWidth

Columns

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlCount

ControlState

Controls

ControlStyle

Cursor

DesignInfo

Enabled

ExtendedSelect

Handle

Height

HelpContext

Hint

IntegralHeight

ItemHeight

ItemIndex

Items

Left

MultiSelect

Name

Owner

ParentColor

Parent

SelCount

Selected

ShowHint

Showing

Sorted

Style

TabOrder

TabStop

TabWidth

Tag

TopIndex

Top

Visible

Width


TCustomListBox::BorderStyle

TCustomListBox	Siehe auch	Beispiel

Die Eigenschaft BorderStyle legt fest, ob das Listenfeld über einen Rahmen verfügt.

__property Forms::TBorderStyle BorderStyle;

Beschreibung

Mit BorderStyle können Sie das Aussehen der Umrißlinie eines Listenfeldes ändern. Ein Listenfeld kann entweder keinen oder einen einfachen Rahmen haben. Die folgende Tabelle enthält die möglichen Werte für TBorderStyle, den Typ der Eigenschaft BorderStyle:

Wert	Bedeutung

bsNone	Kein sichtbarer Rahmen

bsSingle	Einfacher Rahmen


TCustomListBox::Canvas

TCustomListBox	Siehe auch

Die Eigenschaft Canvas ermöglicht den Zugriff auf die Zeichenoberfläche, die Sie benötigen, um eine Ereignisbehandlungsroutine für das Ereignis OnDrawItem eines Owner-Draw-Listenfeldes zu implementieren.

__property Graphics::TCanvas* Canvas;

Beschreibung

Canvas ist nur für Anwendungen von Bedeutung, die die Einträge eines Listenfeldes selbst zeichnen (also nur bei Owner-Draw-Listenfeldern). Mit Canvas können Sie Grafiken erzeugen, die als Einträge eines Listenfeldes verwendet werden.

Im Konstruktor des Listenfeldes wird für die Eigenschaft Canvas standardmäßig ein TControlCanvas-Objekt erzeugt. Indem Sie der Eigenschaft Style den entsprechenden Wert zuweisen, können Sie ein Owner-Draw-Listenfeld erzeugen, das eine Zeichenfläche verwendet.

Beispiel

Der folgende Code zeichnet eine Grafik, die in der Eigenschaft Objects der Liste Items von ListBox1 gespeichert ist. Dieser Code könnte als Behandlungsroutine für das Ereignis OnDrawItem von ListBox1 verwendet werden.

void __fastcall TForm1::ListBox1DrawItem(TWinControl *Control, int Index,

TRect Rect, TOwnerDrawState State)

{

TBitmap *bmp = static_cast<TBitmap*>(ListBox1->Items->Objects[Index]);

TRect SourceRect = { 0, 0, bmp->Height, bmp->Width };

ListBox1->Canvas->CopyRect(Rect, bmp->Canvas, SourceRect);

}


TCustomListBox::Columns

TCustomListBox	Siehe auch

Die Eigenschaft Columns bezeichnet die Anzahl der ohne Verschiebung des Bildschirmausschnitts sichtbaren Spalten eines mehrspaltigen Listenfeldes.

__property int Columns;

Beschreibung

Mit Columns können Sie festlegen, wieviele Spalten eines mehrspaltigen Listenfeldes ohne Verwendung der horizontalen Bildlaufleiste sichtbar sind.

Mehrspaltige Listenfelder verfügen über eine horizontale Bildlaufleiste, mit deren Hilfe Spalten angezeigt werden können, die nicht mehr in den Bildschirmausschnitt passen. Der Standardwert 0 für Columns bedeutet, daß das Listenfeld nicht mehrspaltig ist. Der Bildschirmausschnitt kann in diesem Fall nur vertikal verschoben werden. Die Liste der Einträge wird nicht umbrochen.

Bei Werten größer als 0 werden Einträge, die über den unteren Rand des Listenfeldes hinausgehen, in mehreren Spalten angezeigt. Die Eigenschaft Columns legt fest, wieviele Spalten ohne Verwendung der Bildlaufleiste sichtbar sind.

Die Breite der Spalten hängt sowohl von der Eigenschaft Width als auch von der Eigenschaft Columns ab.


TCustomListBox::ExtendedSelect

TCustomListBox	Siehe auch

Die Eigenschaft ExtendedSelect legt fest, ob der Benutzer im Listenfeld mehrere aufeinanderfolgende Einträge auswählen kann.

__property bool ExtendedSelect;

Beschreibung

ExtendedSelect und MultiSelect gehören zusammen. Sind beide Eigenschaften True, kann der Benutzer einen Eintrag auswählen, die UMSCHALT-Taste gedrückt halten und einen weiteren Eintrag auswählen. Alle Einträge zwischen den beiden Einträgen werden dann ebenfalls ausgewählt. Wenn der Benutzer keine der Tasten UMSCHALT oder STRG gedrückt hält, während er auf den zweiten Eintrag klickt, wird die Auswahl des ersten Eintrags aufgehoben. Mit STRG können also mehrere nicht aufeinanderfolgende Einträge ausgewählt werden, mit UMSCHALT ein Bereich von Einträgen.

Wenn ExtendedSelect False und MultiSelect True ist, können auch ohne die Tasten UMSCHALT und STRG mehrere Einträge ausgewählt werden. Es ist jedoch nicht möglich, einen Bereich von Einträgen in einem Schritt auszuwählen.

Wenn MultiSelect False ist, wirkt sich ExtendedSelect nicht aus, da der Benutzer ohnehin nur einen Eintrag zur selben Zeit auswählen kann.


TCustomListBox::IntegralHeight

TCustomListBox	Siehe auch	Beispiel

Die Eigenschaft IntegralHeight legt fest, ob Einträge im Listenfeld teilweise angezeigt werden.

__property bool IntegralHeight;

Beschreibung

Wenn IntegralHeight True ist, werden im Listenfeld nur die Einträge angezeigt, die in ihrer Höhe den zur Verfügung stehenden Platz nicht überschreiten. Der untere Rand des Listenfeldes schließt in diesem Fall mit dem letzten vollständig angezeigten Eintrag ab.

Ist IntegralHeight False, legt die Eigenschaft ItemHeight den unteren Rand des Listenfeldes fest. Der letzte Eintrag der Liste ist unter Umständen nur teilweise sichtbar.

Hat die Eigenschaft Style des Listenfeldes den Wert lbOwnerDrawFixed, ist die Höhe des Listenfeldes zur Entwurfszeit immer ein Vielfaches von ItemHeight.

Hat die Eigenschaft Style des Listenfeldes den Wert lbOwnerDrawVariable, spielt der Wert von IntegralHeight keine Rolle.


TCustomListBox::ItemHeight

TCustomListBox	Siehe auch

Die Eigenschaft ItemHeight bezeichnet in Pixel die Höhe eines Eintrags in einem Owner-Draw-Listenfeld.

__property int ItemHeight;

Beschreibung

Mit ItemHeight können Sie die Höhe eines Eintrags in einem Listenfeld festlegen, dessen Eigenschaft Style den Wert lsOwnerDrawFixed hat. Die Eigenschaft ItemHeight kann sich auch auf die Höhe des Listenfeldes selbst auswirken. Wenn ItegralHeight True ist, ist die Höhe des Listenfeldes immer ein Vielfaches von ItemHeight.

Hat die Eigenschaft Style den Wert lsStandard oder lsOwnerDrawVariable, wird ItemHeight ignoriert.


TCustomListBox::ItemIndex

TCustomListBox	Siehe auch	Beispiel

Die Eigenschaft ItemIndex gibt den Index des im Listenfeld ausgewählten Eintrags an.

__property int ItemIndex;

Beschreibung

Mit ItemIndex können Sie zur Laufzeit einen Eintrag auswählen. Weisen Sie der Eigenschaft den Index des Eintrags zu, der ausgewählt werden soll. Der Index des ersten Eintrags ist 0. Wenn kein Eintrag ausgewählt ist, hat ItemIndex den Wert -1 (dies ist zugleich der Vorgabewert, wenn MultiSelect False ist).

Hat die Eigenschaft MultiSelect den Wert True, können mehrere Einträge des Listenfeldes ausgewählt werden. In diesem Fall ist ItemIndex der Index des Eintrags, der den Fokus hat. Wenn MultiSelect True ist, ist der Vorgabewert für ItemIndex 0.


TCustomListBox::Items

TCustomListBox	Siehe auch

Die Eigenschaft Items enthält die Strings, die im Listenfeld angezeigt werden.

__property Classes::TStrings* Items;

Beschreibung

Mit Items können Sie Einträge anhängen, einfügen, löschen und verschieben. Standardmäßig sind alle Einträge eines Listenfeldes TStrings-Objekte. Mit den Methoden und Eigenschaften dieser Klasse können Sie die Einträge der Liste bearbeiten. Der folgende Code hängt beispielsweise den Text eines Eingabefeldes als Eintrag an das Listenfeld an:

ListBox1->Items->Add(Edit1->Text);

Um Einträge hinzuzufügen, die keine Strings sind (z.B. Grafiken oder Kombinationen aus Strings und anderen Elementen), weisen Sie der Eigenschaft Style eine der Owner-Draw-Konstanten zu.

Auch andere Eigenschaften und Methoden von Listenfeldern können die Einträge der Liste beeinflussen, indem sie

•	das Erscheinungsbild der Einträge festlegen.

•	festlegen, wie die Einträge ausgewählt werden können.

•	Informationen über die Einträge liefern.


TCustomListBox::MultiSelect

TCustomListBox	Siehe auch	Beispiel

Die Eigenschaft MultiSelect legt fest, ob im Listenfeld mehrere Elemente gleichzeitig ausgewählt werden können.

__property bool MultiSelect;

Beschreibung

Wenn Sie MultiSelect auf True setzen, kann der Benutzer mehrere Einträge auswählen. Andernfalls kann immer nur ein Eintrag ausgewählt werden.

MultiSelect erlaubt dem Benutzer, mehrere nicht aufeinanderfolgende Einträge auszuwählen. Es ist jedoch nicht möglich, einen Bereich von Einträgen in einer einzigen Operation auszuwählen, wie dies bei ExtendedSelect der Fall ist.

Wenn MultiSelect True ist und mehrere Einträge markiert sind , enthält die Eigenschaft ItemIndex den Index des Eintrags, der den Fokus hat.


TCustomListBox::SelCount

TCustomListBox	Siehe auch

Die Eigenschaft SelCount enthält die Anzahl der in einem Listenfeld markierten Einträge, sofern mehrere Einträge markiert werden dürfen.

__property int SelCount;

Beschreibung

SelCount ist eine Nur-Lesen-Eigenschaft, mit der Sie die Anzahl der im Listenfeld markierten Einträge ermitteln können, wenn die Eigenschaft MultiSelect True ist.

Hat MultiSelected den Wert False, kann nur ein Eintrag ausgewählt werden. Wenn kein Eintrag markiert ist, hat SelCount den Wert 0.


TCustomListBox::Selected

TCustomListBox	Siehe auch	Beispiel

Die Eigenschaft Selected gibt an, ob ein bestimmter Eintrag im Listenfeld markiert ist.

__property bool Selected[int Index];

Beschreibung

Mit Selected können Sie den Status eines bestimmten Eintrags im Listenfeld abfragen. Wenn der im Parameter Index angegebene Eintrag im Listenfeld markiert ist, hat Selected den Wert True,  andernfalls False.

Der Parameter Index bezeichnet den Eintrag über seine Position im Listenfeld. Der erste Eintrag hat den Index 0.

Ein Eintrag gilt als ausgewählt, wenn der Benutzer ihn markiert. Wenn Sie die Eigenschaft MultiSelect auf True setzen, können mehrere Einträge des Listenfeldes ausgewählt werden. In diesem Fall bezieht sich Selected auf den Eintrag, der den Fokus hat.


TCustomListBox::Sorted

TCustomListBox	Siehe auch	Beispiel

Die Eigenschaft Sorted gibt an, ob die Einträge eines Listenfeldes alphabetisch geordnet sind.

__property bool Sorted;

Beschreibung

Indem Sie Sorted auf True setzen, können Sie die Einträge der Liste alphabetisch ordnen. Wenn Sorted False ist, sind die Einträge nicht geordnet. Hat Sorted den Wert True, werden neue Einträge automatisch an der richtigen Position in das Listenfeld eingefügt.


TCustomListBox::Style

TCustomListBox	Siehe auch	Beispiel

Die Eigenschaft Style legt fest, ob es sich um ein Standardlistenfeld oder um ein Owner-Draw-Listenfeld handelt.

__property TListBoxStyle Style;

Beschreibung

Mit Style können Sie festlegen, ob es sich bei dem Listenfeld um ein Standardlistenfeld handelt, das Strings anzeigt, oder um ein Owner-Draw-Listenfeld, das auch Grafiken anzeigen kann. Standardmäßig hat Style den Wert lbStandard, was bedeutet, daß alle Einträge als Strings angezeigt werden.

Owner-Draw-Listenfelder können Grafiken zusammen mit oder anstelle von Strings anzeigen. Außerdem können die Einträge eine feste Höhe haben oder in ihrer Höhe variieren. Um ein Owner-Draw-Listenfeld zu erzeugen, weisen Sie Style den Wert lbOwnerDrawFixed oder lbOwnerDrawVariable zu. Die folgende Tabelle enthält die Werte für TListBoxStyle, den Typ der Eigenschaft Style:

Wert	Bedeutung

lbStandard	Alle Einträge sind Strings mit derselben Höhe.

lbOwnerDrawFixed	Alle Einträge haben die Höhe, die in der Eigenschaft ItemHeight festgelegt ist.

lbOwnerDrawVariable	Die Einträge können unterschiedlich hoch sein.

OwnerDraw-Listenfelder erfordern einen höheren Programmieraufwand, da die Anwendung Informationen darüber benötigt, wie die Bilder für die einzelnen Einträge gezeichnet werden müssen.

Wenn in einem Listenfeld mit dem Stil lbOwnerDrawFixed ein Eintrag angezeigt wird, tritt das Ereignis OnDrawItem ein. Die Ereignisbehandlungsroutine für OnDrawItem zeichnet den Eintrag. Die Eigenschaft ItemHeight legt die Höhe aller Einträge fest.

Wenn in einem Listenfeld mit dem Stil lbOwnerDrawVariable ein Eintrag angezeigt wird, treten zwei Ereignisse ein. Das erste Ereignis ist OnMeasureItem. Im Code seiner Ereignisbehandlungsroutine kann die Höhe der einzelnen Einträge festgelegt werden. Anschließend tritt das Ereignis OnDrawItem ein. Die Ereignisbehandlungsroutine für OnDrawItem zeichnet die einzelnen Einträge des Listenfeldes mit der Höhe, die in der Ereignisbehandlungsroutine für OnMeasureItem festgelegt wurde.


TCustomListBox::TabWidth

TCustomListBox

TabWidth ist die Breite der Tabulatoren im Listenfeld.

__property int TabWidth;

Beschreibung

Verwenden Sie TabWidth, um die breite der Tabulatoren für Einträge des Listenfeldes zu bestimmen


TCustomListBox::TopIndex

TCustomListBox	Siehe auch

Die Eigenschaft TopIndex gibt den Index des Eintrags an, der an der Spitze des Listenfeldes angezeigt wird.

__property int TopIndex;

Beschreibung

Mit TopIndex können Sie ermitteln oder festlegen, welcher Eintrag am oberen Rand des Listenfeldes angezeigt wird. Auf diese Weise können Sie beispielsweise einen anderen Eintrag als obersten Eintrag anzeigen lassen.

Beispiel

Im folgenden Beispiel gibt es in einem Formular ein Listenfeld mit einer String-Liste, einen Schalter und ein Eingabefeld. Wenn der Benutzer auf den Schalter klickt, wird der dritte Eintrag der Liste zum ersten Eintrag, und sein Index erscheint im Eingabefeld. Das Eingabefeld zeigt den Index 2 an, der den dritten Eintrag der Liste bezeichnet (der erste Eintrag hat den Index 0):

__fastcall TForm1::TForm1(TComponent *Owner) : TForm(Owner)

{

for (int i = 0; i < 20; ++i)

ListBox1->Items->Add("Eintrag " + AnsiString(i));

}

void __fastcall TForm1::Button1Click(TObject *Sender)

{

ListBox1->TopIndex = 2;

Edit1.Text = AnsiString(ListBox1->TopIndex);

}


Ereignisse von TCustomListBox

TCustomListBox	Alphabetisch	Legende

In TCustomListBox

OnDrawItem

OnMeasureItem


Ereignisse von TCustomListBox

TCustomListBox	Nach Objekten	Legende

OnDrawItem

OnMeasureItem


TCustomListBox::OnDrawItem

TCustomListBox	Siehe auch

Das Ereignis OnDrawItem tritt ein, wenn ein Eintrag in einem Owner-Draw-Listenfeld neu angezeigt werden muß.

__property TDrawItemEvent OnDrawItem;

Beschreibung

Mit einer Ereignisbehandlungsroutine für OnDrawItem können Sie die Einträge von Listenfeldern zeichnen, deren Eigenschaft Style den Wert lbOwnerDrawFixed oder lbOwnerDrawVariable hat. OnDrawItem tritt ein, wenn ein Eintrag ausgewählt oder der Bildschirmausschnitt eines OwnerDraw-Listenfeldes verschoben wird und der Eintrag neu gezeichnet werden muß. Dieses Ereignis gibt es nur bei Owner-Draw-Listenfeldern.

OnDrawItem ist vom Typ TDrawItemEvent und übergibt seiner Ereignisbehandlungsroutine vier Parameter, die den anzuzeigenden Eintrag beschreiben:

•	ListBox gibt an, in welchem Listenfeld der Eintrag enthalten ist.

•	Index gibt den Index des Eintrags in diesem Listenfeld an.

•	Rect legt das Rechteck fest, in dem der Eintrag gezeichnet wird.

•	State legt den Status des Eintrags fest (markiert, fokussiert oder deaktiviert).

Die Größe des Rechtecks, das den Eintrag enthält, wird bei Owner-Draw-Listenfeldern mit fester Höhe von der Eigenschaft ItemHeight und bei Owner-Draw-Listenfeldern mit variabler Höhe von der Reaktion auf das Ereignis OnMeasureItem bestimmt.

Der Parameter Index bezeichnet die Position des Eintrags im Listenfeld.

Rect ist der Bereich des Listenfeldes, in dem der Eintrag gezeichnet werden soll. Der Parameter dient zur automatischen Positionierung des Eintrags auf der Zeichenfläche des Steuerelements.

State ist der aktuelle Status des Eintrags. Der Typ TOwnerDrawState definiert die folgenden Werte für den Parameter State:

Wert	Bedeutung

odSelected	Der Eintrag ist markiert.

odDisabled	Das gesamte Listenfeld ist deaktiviert.

odFocused	Der Eintrag ist fokussiert.

Beispiel

Das folgende Beispiel zeigt eine typische Ereignisbehandlungsroutine für OnDrawItem. In einem Listenfeld mit dem Stil lbOwnerDrawFixed wird links der Strings jeweils ein Bitmap angezeigt.

void __fastcall TForm1::ListBox1DrawItem(TWinControl *Control, int Index,

TRect &Rect, TOwnerDrawState State)

{

int Offset = 2;                               // Standard-Offset

TListBox *ListBox = dynamic_cast<TListBox*>(Control);

TCanvas *Canvas = ListBox->Canvas;

Canvas->FillRect(Rect);                       // Rechteck leeren

// Bitmap laden und zeichnen, falls es existiert

Graphics::TBitmap *Bitmap = static_cast<Graphics::TBitmap*>(ListBox->Items->Objects[Index]);

if (Bitmap) {

Canvas->BrushCopy(Bounds(Rect.Left + 2, Rect.Top,

Bitmap->Width, Bitmap->Height), Bitmap,

Bounds(0, 0, Bitmap->Width, Bitmap->Height), clRed);

Offset = Bitmap->Width + 6;               // 6 Pixel zwischen Bitmap und Text

}

// Text anzeigen

Canvas->TextOut(Rect.Left + Offset, Rect.Top, ListBox->Items->Names[Index]);

}


TCustomListBox::OnMeasureItem

TCustomListBox	Siehe auch

Das Ereignis OnMeasureItem tritt ein, wenn ein Eintrag in einem Owner-Draw-Listenfeld mit variabler Höhe neu gezeichnet werden muß.

__property TMeasureItemEvent OnMeasureItem;

Beschreibung

Mit einer Ereignisbehandlungsroutine für OnMeasureItem können Sie die Höhe der Einträge eines Listenfeldes festlegen, dessen Eigenschaft Style den Wert lbOwnerDrawVariable hat.

OnMeasureItem ist vom Typ TMeasureItemEvent. Dieser Typ enthält drei Parameter, die den Eintrag beschreiben:

•	Control gibt an, in welchem Listenfeld der Eintrag enthalten ist.

•	Index gibt den Index des Eintrags in diesem Listenfeld an.

•	Height gibt die Höhe des Eintrags an.

Der Parameter Index bezeichnet die Position des Eintrags im Listenfeld.

Der Parameter Height gibt die Höhe in Pixel an, die der Eintrag im Steuerelement belegt. Der Parameter Height ist ein var-Parameter. Er enthält zunächst die Standardhöhe des Eintrags oder die Höhe des Textes in der Schrift des Steuerelements. Die Ereignisbehandlungsroutine kann Height einen geeigneten Wert zuweisen, z.B. die Höhe einer Grafik, die im Eintrag angezeigt werden soll.

Nach OnMeasureItem tritt das Ereignis OnDrawItem ein, dessen Behandlungsroutine den Eintrag mit der angegebenen Höhe zeichnet.

Beispiel

Das folgende Beispiel zeigt eine typische Ereignisbehandlungsroutine für OnMeasureItem. Es geht davon aus, daß allen Strings eines Owner-Draw-Listenfeldes mit variabler Höhe jeweils ein Bitmap zugeordnet ist. Wenn die Höhe des Bitmaps die Standardhöhe überschreitet, wird sie dem Eintrag als neue Höhe zugewiesen.

void __fastcall TForm1::ListBox1MeasureItem(TWinControl *Control, int Index,

int &Height)

{

TListBox *ListBox = dynamic_cast<TListBox*>(Control);

if (ListBox) {

Graphics::TBitmap *Bitmap;

    Bitmap = static_cast<Graphics::TBitmap*>(ListBox->Items->Objects[Index]);

if (Bitmap && Bitmap->Height > Height)

Height = Bitmap->Height;

}

}


Methoden von TCustomListBox

TCustomListBox	Alphabetisch	Legende

In TCustomListBox

~TCustomListBox

Clear

CreateParams

CreateWnd

DestroyWnd

DragCanceled

DrawItem

ItemAtPos

ItemRect

MeasureItem

TCustomListBox

WndProc

Abgeleitet von TWinControl

Broadcast

CanFocus

ContainsControl

ControlAtPos

DisableAlign

EnableAlign

Focused

GetTabOrderList

HandleAllocated

HandleNeeded

InsertControl

Invalidate

PaintTo

Realign

RemoveControl

Repaint

ScaleBy

ScrollBy

SetBounds

SetFocus

Update

UpdateControlState

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

GetTextLen

Hide

Perform

Refresh

ScreenToClient

SendToBack

SetTextBuf

Show

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TCustomListBox

TCustomListBox	Nach Objekten	Legende

~TCustomListBox

Assign

BeginDrag

BringToFront

Broadcast

CanFocus

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

Clear

ClientToScreen

ContainsControl

ControlAtPos

CreateParams

CreateWnd

DefaultHandler

DestroyComponents

Destroying

DestroyWnd

DisableAlign

Dispatch

DragCanceled

DragDrop

Dragging

DrawItem

EnableAlign

EndDrag

FieldAddress

FindComponent

Focused

FreeInstance

FreeNotification

Free

GetParentComponent

GetTabOrderList

GetTextBuf

GetTextLen

HandleAllocated

HandleNeeded

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InsertControl

InstanceSize

Invalidate

ItemAtPos

ItemRect

MeasureItem

MethodAddress

MethodName

NewInstance

PaintTo

Perform

Realign

Refresh

RemoveComponent

RemoveControl

Repaint

ScaleBy

ScreenToClient

ScrollBy

SendToBack

SetBounds

SetFocus

SetTextBuf

Show

TCustomListBox

UpdateControlState

Update

WndProc


TCustomListBox::Clear

TCustomListBox	Siehe auch

Die Methode Clear löscht alle Enträge aus dem Listenfeld.

void __fastcall Clear(void);

Beschreibung

Mit Clear können Sie alle Einträge des Listenfeldes in einem Schritt löschen.

Obwohl die Einträge eines Listenfeldes standardmäßig vom Typ TStrings sind, können sie mit Clear ohne Angabe des Typs gelöscht werden. Das folgende Beispiel zeigt die einfache Verwendung der Methode Clear eines Listenfeldes:

  ListBox1->Clear;

Die Anweisung

  ListBox1->Items->Clear;

ruft statt dessen die Methode Clear der einzelnen Einträge auf, die dadurch ebenfalls gelöscht werden.


TCustomListBox::CreateParams

TCustomListBox	Siehe auch

Die Methode CreateParams initialisiert den im Parameter Params übergebenen Parameterdatensatz, der zur Erzeugung des Fensters benötigt wird.

virtual void __fastcall CreateParams(Controls::TCreateParams &Params);

Beschreibung

CreateParams übergibt im Parameter Params Informationen an die Methode CreateWindowHandle, wenn das Listenfeld erzeugt wird. Die Methode CreateWnd des Listenfeldes ruft die geerbte Methode CreateWnd auf. Diese gibt die Informationen an CreateWindowHandle weiter (eine als protected deklarierte, von TWinControl geerbte Methode).

TCustomListBox überschreibt CreateParams, um die Darstellung des Fensters anhand der Eigenschaften Columns, ExtendedSelect, IntegralHeight, MultiSelect, Sorted und Style des Listenfeldes neu festzulegen. Das Listenfeld wird mit den Windows-Konstanten WS_HSCROLL, WS_VSCROLL, LBS_HASSTRINGS und LBS_NOTIFY erzeugt.

Wenn Sie CreateParams überschreiben, sollten Sie immer zuerst die geerbte Methode aufrufen, damit die Standardwerte gesetzt werden. Anschließend können Sie die gewünschten Anpassungen vornehmen.

Der an CreateParams übergebene Parameter Params ist vom Typ TCreateParams. Diese Struktur enthält Daten, die benötigt werden, um ein Fenster-Handle zu erzeugen. CreateWindowHandle bearbeitet die Felder dieses Datensatzes, um daraus die Parameter für den Aufruf der API-Funktion CreateWindowEx abzuleiten.


TCustomListBox::CreateWnd

TCustomListBox	Siehe auch

Die Methode CreateWnd erzeugt ein Windows-Steuerelement, das dem Listenfeld entspricht.

virtual void __fastcall CreateWnd(void);

Beschreibung

CreateWnd wird automatisch von CreateHandle (einer von TWinControl geerbten, als protected deklarierten Methode) aufgerufen. CreateWnd ruft die geerbte Methode CreateWnd auf, die ihrerseits folgende Methoden aufruft:

•	CreateParams initialisiert die für die Erzeugung des Fensters benötigten Parameter.

•	CreateWindowHandle erzeugt das Fenster-Handle für das Steuerelement.

Außerdem setzt TCustomListBox::CreateWnd die Position, die Tab-Reihenfolge, die Einträge und die Anzahl der Spalten des Listenfeldes.


TCustomListBox::~TCustomListBox

TCustomListBox	Siehe auch

Der Destruktor ~TCustomListBox gibt den Speicher frei, der für das TCustomListBox-Objekt reserviert war. Rufen Sie ~TCustomListBox nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TCustomListBox automatisch aufgerufen wird.

__fastcall virtual ~TCustomListBox(void);


TCustomListBox::DestroyWnd

TCustomListBox	Siehe auch

Die Methode DestroyWnd speichert die Einträge eines Listenfeldes in einer String-Liste, bevor die geerbte Methode DestroyWnd aufgerufen wird.

virtual void __fastcall DestroyWnd(void);

Beschreibung

DestroyWnd speichert die Strings der Eigenschaft Items intern in einem TStringList-Objekt, das von der Methode selbst erzeugt wird. Anschließend wird die geerbte Methode DestroyWnd aufgerufen, die das Fenster-Handle des fensterorientierten Steuerelements und jeden zugewiesenen Gerätekontext freigibt.


TCustomListBox::DragCanceled

TCustomListBox	Siehe auch

Die Methode DragCanceled sendet eine Maus-Botschaft, die eine Drag-and-Drop-Operation abbricht.

virtual void __fastcall DragCanceled(void);

Beschreibung

DragCanceled wird als Reaktion auf den Abbruch einer zuvor begonnenen Drag-and-Drop-Operation aufgerufen. Der Benutzer kann einen solchen Abbruch hervorrufen, indem er ein Objekt auf eine Komponente zieht, die die Operation nicht unterstützt, oder indem er während des Ziehens die Taste ESC drückt.

C++Builder ruft DragCanceled auf, bevor das Ereignis OnEndDrag ausgelöst wird.


TCustomListBox::DrawItem

TCustomListBox	Siehe auch

Die Methode DrawItem implementiert eine Reaktion auf das Ereignis OnDrawItem eines Owner-Draw-Listenfeldes.

virtual void __fastcall DrawItem(int Index, const Windows::TRect &Rect,  TOwnerDrawState State);

Beschreibung

DrawItem wird immer dann aufgerufen, wenn sich die visuelle Darstellung eines Owner-Draw-Listenfeldes ändert. Das Listenfeld ruft die Methode für jeden sichtbaren Eintrag auf und übergibt ihr dessen Index im Parameter Index.

Bei Listenfeldern ruft DrawItem standardmäßig alle Ereignisbehandlungsroutinen auf, die mit dem Ereignis OnDrawItem der Komponente verknüpft sind. Wenn dem Ereignis keine Behandlungsroutine zugewiesen ist, füllt DrawItem das in Rect übergebene Rechteck und zeigt den Text an, der zu dem indizierten Eintrag gehört. Die standardmäßige Zeichenoperation ignoriert den Parameter State, obwohl er an die Ereignisbehandlungsroutine übergeben wird.


TCustomListBox::ItemAtPos

TCustomListBox	Siehe auch

Die Methode ItemAtPos gibt den Index des Eintrags zurück, der durch die Koordinaten eines Punktes auf dem Steuerelement bezeichnet wird.

int __fastcall ItemAtPos(const POINT &Pos, bool Existing);

Beschreibung

Mit ItemAtPos können Sie feststellen, ob an einer bestimmten Stelle des Steuerelements ein Eintrag vorhanden ist.

Der Parameter Pos gibt in Koordinaten relativ zum Fenster den Punkt innerhalb des Steuerelements an. Wenn Pos unterhalb des letzten Eintrags liegt, bestimmt der Parameter Existing den Rückgabewert. Wenn Existing True ist, gibt ItemAtPos -1 zurück, was bedeutet, daß an diesem Punkt kein Eintrag vorhanden ist. Ist Existing False, gibt ItemAtPos den um 1 erhöhten Index des letzten Eintrags zurück.


TCustomListBox::ItemRect

TCustomListBox	Siehe auch

Die Methode ItemRect gibt das Rechteck zurück, das den im Parameter Item übergebenen Eintrag umgibt.

Windows::TRect __fastcall ItemRect(int Index);

Beschreibung

Mit ItemRect können Sie die Koordinaten eines bestimmten Eintrags im Listenfeld abfragen. ItemRect wird unter anderem intern von der Methode ItemAtPos verwendet.

Der Parameter Item ist der Index des Eintrags, dessen Position abgefragt wird.


TCustomListBox::MeasureItem

TCustomListBox	Siehe auch

Die Methode MeasureItem implementiert eine Reaktion auf das Ereignis OnMeasureItem eines Owner-Draw-Listenfeldes.

virtual void __fastcall MeasureItem(int Index, int &Height);

Beschreibung

Die Methode MeasureItem wird immer dann aufgerufen, wenn sich die visuelle Darstellung eines Owner-Draw-Listenfeldes ändert, dessen Eigenschaft Style den Wert csOwnerDrawVariable hat.

Bevor es seine Einträge zeichnet, ruft ein Owner-Draw-Listenfeld mit variabler Höhe für jeden sichtbaren Eintrag einmal die Methode MeasureItem auf und übergibt ihr den Index des Eintrags und den Vorgabewert für seine Höhe. Da Height ein var-Parameter ist, kann MeasureItem die Höhe für jeden einzelnen Eintrag individuell festlegen.

Standardmäßig ruft MeasureItem lediglich alle Behandlungsroutinen auf, die mit dem Ereignis OnMeasureItem verknüpft sind. Überschreiben Sie MeasureItem, wenn Sie dieses Standardverhalten ändern oder erweitern wollen.


TCustomListBox::TCustomListBox

TCustomListBox	Siehe auch

Die Methode TCustomListBox instantiiert ein Listenfeld.

__fastcall virtual TCustomListBox(Classes::TComponent* AOwner);

Beschreibung

Mit TCustomListBox können Sie zur Laufzeit ein Listenfeld instantiieren. Für Listenfelder, die zur Entwurfszeit erzeugt werden, wird TCustomListBox automatisch aufgerufen.

TCustomListBox reserviert Speicher für das Listenfeld und ruft die geerbte Methode TCustomListBox auf. Anschließend führt die Methode folgende Schritte durch:

•	Sie initialisiert die Eigenschaften Width, Height und ItemHeight.

•	Sie setzt ParentColor auf False und TabStop und ExtendedSelect auf True.

•	Sie setzt die Eigenschaft ControlStyle des Listenfeldes.

•	Sie setzt die Eigenschaft BorderStyle auf bsSingle.

•	Sie erzeugt ein TControlCanvas-Objekt für die Eigenschaft Canvas.

•	Sie erzeugt ein TStrings-Objekt für die Eigenschaft Items.


TCustomListBox::WndProc

TCustomListBox	Siehe auch

Die Methode WndProc führt einige zusätzliche Funktionen für Auto-Drag-Operationen ein, bevor sie die geerbte Methode aufruft.

virtual void __fastcall WndProc(Messages::TMessage &Message);

Beschreibung

WndProc überschreibt die geerbte Methode WndProc und führt spezielle Reaktionen auf Botschaften ein, die dem Listenfeld erlauben, Auto-Drag-Operationen selbst zu überwachen. Anschließend wird die geerbte Methode WndProc aufgerufen, die alle anderen Botschaften bearbeitet.

Wenn Sie WndProc überschreiben, müssen Sie am Ende die geerbte Methode WndProc aufrufen, damit die anderen Meldungen weitergegeben werden.


Gültigkeitsbereich

Protected

Published

Zugriff

Read-only


Gültigkeitsbereich

Protected


Gültigkeitsbereich

Protected


Hierarchie

TObject

TPersistent

TComponent

TControl

TWinControl


TCustomListBox Beispiel

TCustomListBox


TCustomListView

Hierarchie	Eigenschaften	Methoden	Ereignisse

Header

vcl/comctrls.hpp

Die TCustomListView-Komponente ist das abstrakte Basisobjekt für alle Listenkomponenten einschließlich der TListView-Komponente.

Beschreibung

Die meisten Eigenschaften, Methoden und Ereignisse der Klasse TCustomListView sind geschützt. Sie können sie gegebenenfalls in ihren eigenen Listenansichten veröffentlichen. In TListView werden fast alle Eigenschaften, Methoden und Ereignisse als public deklariert. Deren Erläuterung finden Sie also in der VCL-Referenz unter TListView.


Eigenschaften von TCustomListView

TCustomListView	Alphabetisch	Legende

In TCustomListView

AllocBy

BorderStyle

BoundingRect

Column

ColumnClick

Columns

DropTarget

HideSelection

IconOptions

ItemFocused

Items

LargeImages

MultiSelect

ReadOnly

SelCount

Selected

ShowColumnHeaders

SmallImages

SortType

StateImages

TopItem

ViewOrigin

ViewStyle

VisibleRowCount

Abgeleitet von TWinControl

Brush

ClientOrigin

ClientRect

ControlCount

Controls

Handle

HelpContext

Showing

TabOrder

TabStop

Abgeleitet von TControl

Align

BoundsRect

ClientHeight

ClientWidth

ControlState

ControlStyle

Cursor

Enabled

Height

Hint

Left

Name

Parent

ShowHint

Top

Visible

Width

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TCustomListView

TCustomListView	Nach Objekten	Legende

Align

AllocBy

BorderStyle

BoundingRect

BoundsRect

Brush

ClientHeight

ClientOrigin

ClientRect

ClientWidth

ColumnClick

Columns

Column

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlCount

ControlState

Controls

ControlStyle

Cursor

DesignInfo

DropTarget

Enabled

Handle

Height

HelpContext

HideSelection

Hint

IconOptions

ItemFocused

Items

LargeImages

Left

MultiSelect

Name

Owner

Parent

ReadOnly

SelCount

Selected

ShowColumnHeaders

ShowHint

Showing

SmallImages

SortType

StateImages

TabOrder

TabStop

Tag

TopItem

Top

ViewOrigin

ViewStyle

VisibleRowCount

Visible

Width


TCustomListView::AllocBy

TCustomListView

Die Eigenschaft AllocBy liefert eine Listenansicht, in die eine große Anzahl von Einträgen eingefügt werden kann.

__property int AllocBy;

Beschreibung

Die Eigenschaft AllocBy liefert eine Listenansicht, in die eine große Anzahl von Einträgen eingefügt werden kann. Verwenden Sie AllocBy, bevor Sie eine große Anzahl von Einträgen einfügen. Mit AllocBy werden die internen Datenstrukturen einer Listenansicht nur einmal und nicht für jeden eingefügten Eintrag neu zugewiesen.


TCustomListView::BorderStyle

TCustomListView	Beispiel

Mit der Eigenschaft BorderStyle können Sie den Rahmen festlegen, der die Komponente umgibt.

__property Forms::TBorderStyle BorderStyle;

Beschreibung

Mit der Eigenschaft BorderStyle von Listenfeldern können Sie bestimmen, ob ein Rahmen angezeigt wird. Die möglichen Werte sind bsNone für einen nicht sichtbaren Rahmen und bsSingle für einen einfachen Rahmen.


TCustomListView::BoundingRect

TCustomListView	Siehe auch

Mit der Eigenschaft BoundingRect können Sie das umgebene Rechteck für alle Einträge der Listenansicht abrufen.

__property Windows::TRect BoundingRect;

Beschreibung

Mit der Eigenschaft BoundingRect können Sie das umgebene Rechteck für alle Einträge der Listenansicht abrufen. Die Eigenschaft ViewStyle der Listenansicht muß entweder vsIcon oder vsSmallIcon enthalten. Auf diese Eigenschaft kann nur zur Laufzeit zugegriffen werden, und sie kann nur gelesen werden.


TCustomListView::Column

TCustomListView

Mit der Eigenschaft Column können Sie die Spalte mit dem angegebenen Index ermitteln.

virtual void __fastcall ColClick(TListColumn* Column);

Beschreibung

Mit der Eigenschaft Column können Sie die Spalte mit dem angegebenen Index ermitteln. Auf diese Eigenschaft kann nur zur Laufzeit zugegriffen werden, und sie kann nur gelesen werden.


TCustomListView::ColumnClick

TCustomListView	Siehe auch

Mit der Eigenschaft ColumnClick können Sie bestimmen, ob sich der Kopf einer Spalte wie eine Schaltfläche verhält.

__property bool ColumnClick;

Beschreibung

Mit der Eigenschaft ColumnClick können Sie bestimmen, ob sich der Kopf einer Spalte wie eine Schaltfläche verhält. Ein Spaltenkopf ist eine Leiste mit einem Titel, der die Kategorie der Listeneinträge bezeichnet. Um die Spaltenköpfe anzuzeigen, muß die Eigenschaft ShowColumnHeaders True und die Eigenschaft ViewStyle vsReport enthalten.


TCustomListView::Columns

TCustomListView

Mit der Eigenschaft Columns können Sie Spalten in eine Listenansicht einfügen oder aus einer Listenansicht löschen und die Anzeigeeigenschaften bearbeiten.

__property TListColumns* Columns;

Beschreibung

Die Eigenschaft Columns enthält die optionalen Tabellenköpfe für ein TListView-Objekt. Um die Spalten anzuzeigen, muß die Eigenschaft ViewStyle der Listenansicht auf vsReport gesetzt werden (vsIcon ist der Standardwert).

Bei der Einstellung von Columns während des Entwurfs wird der Spalteneditor für Listenansichten eingeblendet. In diesem Dialogfeld wird eine indizierte Liste der Spalten angezeigt, die vom TListColumns-Objekt verwaltet werden. Bei den einzelnen Spalten handelt es sich um TListColumn-Objekte. Mit diesem Dialogfeld können Sie Spalten (TListColumn) einfügen oder löschen und deren Anzeigeeigenschaften bearbeiten. Zur Laufzeit können Sie mit den Eigenschaften Caption, Alignment und Width das Erscheinungsbild der Tabellenköpfe ändern.


TCustomListView::DropTarget

TCustomListView

Mit der Eigenschaft DropTarget können Sie ermitteln, ob es sich bei einem Eintrag der Listenansicht um das Ziel einer Drag&Drop-Operation handelt.

__property TListItem* DropTarget;

Beschreibung

Mit der Eigenschaft DropTarget können Sie ermitteln, ob es sich bei einem Eintrag der Listenansicht um das Ziel einer Drag&Drop-Operation handelt.


TCustomListView::HideSelection

TCustomListView	Beispiel

Mit der Eigenschaft HideSelection können Sie bestimmen, ob der in einer Liste markierte Text markiert bleibt, wenn der Fokus zu einem anderen Steuerelement verschoben wird.

__property bool HideSelection;

Beschreibung

Mit der Eigenschaft HideSelection können Sie bestimmen, ob der in einer Liste markierte Text markiert bleibt, wenn der Fokus zu einem anderen Steuerelement verschoben wird. Bei True wird die Markierung aufgehoben, bis der Fokus zum Steuerelement zurückkehrt. Andernfalls bleibt der Text markiert. Der Standardwert ist True.


TCustomListView::IconOptions

TCustomListView

Die Eigenschaft IconOptions enthält die Optionen für die in einer Listenansicht angezeigten Symbole.

__property TIconOptions* IconOptions;

Beschreibung

Die Eigenschaft IconOptions enthält die Optionen für die in einer Listenansicht angezeigten Symbole. Damit sich diese Optionen auf das Steuerelement auswirken, muß die Eigenschaft ViewStyle der Listenansicht entweder auf vsIcon oder vsSmallIcons gesetzt werden. Mit der Eigenschaft Arrangement können Sie die Symbole am oberen oder linken Rand der Listenansicht ausrichten. Ist AutoArrange True, werden die Symbole automatisch angeordnet, sobald Symbole eingefügt, verschoben, gelöscht oder anderweitig neu angezeigt werden. Setzen Sie WrapText auf True, damit der Titel eines Eintrags umbrochen und nicht in einer Zeile angezeigt wird, sobald die Breite des Symbols überschritten wird.


TCustomListView::ItemFocused

TCustomListView

Mit der Eigenschaft ItemFocused können Sie bestimmen, ob und welcher Eintrag einer Listenansicht den Fokus besitzt, und Sie können den Fokus einem Eintrag zuweisen.

__property TListItem* ItemFocused;

Beschreibung

Diese Eigenschaft kann nur zur Laufzeit verwendet werden. Mit der Eigenschaft ItemFocused von Listenansichten können Sie bestimmen, ob und welcher Eintrag einer Listenansicht den Fokus besitzt, und Sie können den Fokus einem Eintrag zuweisen. Sobald ein Eintrag den Fokus besitzt, wird er von einem Standard-Fokusrechteck umgeben. Besitzt kein Eintrag den Fokus, gibt ItemsFocused den Wert NULL zurück. Nur ein Eintrag kann den Fokus besitzen.


TCustomListView::Items

TCustomListView 	Beispiel

Die Eigenschaft Items enthält die Liste der Einträge in einem TListView-Objekt.

__property TListItems* Items;

Beschreibung

Die Eigenschaft Items enthält die Liste der Einträge in einem TListView-Objekt. Bei der Einstellung dieser Eigenschaft während des Entwurfs wird ein Editor für die Einträge von Listenansichten eingeblendet. In diesem Dialogfeld wird eine indizierte Liste der Einträge angezeigt, die vom TListItems-Objekt verwaltet werden. Bei den einzelnen Einträgen einer Listenansicht handelt es sich um TListItem-Objekte.

Mit diesem Dialogfeld können Sie Einträge oder SubItem-Objekte einfügen oder löschen und deren Anzeigeeigenschaften bearbeiten. Zur Laufzeit können Sie mit den Eigenschaften Caption, ImageIndex und StateIndex das Erscheinungsbild der Listeneinträge ändern.


TCustomListView::LargeImages

TCustomListView	Beispiel

Mit der Eigenschaft LargeImages können Sie bestimmen, welche Bilderliste (TImageList) verwendet wird, wenn die Eigenschaft ViewStyle der Listenansicht auf vsIcon gesetzt wurde.

__property Controls::TImageList* LargeImages;

Beschreibung

Mit der Eigenschaft LargeImages einer Listenansicht können Sie bestimmen, welche Bilderliste (TImageList) von der Listenansicht verwendet wird, wenn die Eigenschaft ViewStyle der Listenansicht auf vsIcon gesetzt wurde. Eine Bilderliste enthält eine Liste mit Bitmaps, die neben der Beschriftung der Einträge angezeigt werden können.


TCustomListView::MultiSelect

TCustomListView	Beispiel

Mit der Eigenschaft MultiSelect können Sie bestimmen, ob mehrere Elemente gleichzeitig aus der Liste ausgewählt werden können.

__property bool MultiSelect;

Beschreibung

Mit der Eigenschaft MultiSelect können Sie bestimmen, ob mehrere Elemente gleichzeitig aus der Liste ausgewählt werden können. Hat MultiSelect den Wert True, können mehrere Einträge ausgewählt werden. Andernfalls kann im Listenfeld nur ein Eintrag ausgewählt werden. Die Voreinstellung ist False.


TCustomListView::ReadOnly

TCustomListView

Mit der Eigenschaft ReadOnly können Sie bestimmen, ob der Inhalt des Steuerelements geändert werden kann.

__property bool ReadOnly;

Beschreibung

Mit der Eigenschaft ReadOnly können Sie bestimmen, ob der Inhalt des Steuerelements geändert werden kann. Wenn ReadOnly den Wert True hat, kann der Benutzer den Inhalt nicht ändern. Wenn ReadOnly den Wert False hat, kann der Benutzer den Inhalt ändern. Die Voreinstellung ist False.

Bei datensensitiven Steuerelementen können Sie mit der Eigenschaft ReadOnly bestimmen, ob der Wert eines Feldes des aktuellen Datensatzes geändert werden kann. Wenn ReadOnly False ist, kann der Benutzer den Wert des Feldes ändern, solange sich die Datenmenge im Bearbeitungsmodus befindet.

Hat die Eigenschaft ReadOnly eines Datengitters den Wert True, können Sie weder mit der Taste Einfg eine neue Zeile in das Gitter einfügen noch mit der Taste Pfeil nach unten eine neue Zeile am Ende des Datengitters anfügen.


TCustomListView::SelCount

TCustomListView

Mit der Eigenschaft SelCount können Sie die Anzahl der ausgewählten Einträge einer Listenansicht ermitteln.

__property int SelCount;

Beschreibung

Auf diese Eigenschaft kann nur zur Laufzeit zugegriffen werden, und sie kann nur gelesen werden. Mit der Eigenschaft SelCount können Sie die Anzahl der ausgewählten Einträge einer Listenansicht ermitteln.


TCustomListView::Selected

TCustomListView	Beispiel

Mit der Eigenschaft Selected können Sie den ersten ausgewählten Eintrag in einer Listenansicht ermitteln.

__property TListItem* Selected;

Beschreibung

Diese Eigenschaft kann nur zur Laufzeit verwendet werden. Mit der Eigenschaft Selected können Sie den ersten ausgewählten Eintrag einer Listenansicht ermitteln. Sobald ein Eintrag ausgewählt wird, werden die Ereignisse OnChanging und OnChange der Listenansicht ausgelöst.


TCustomListView::ShowColumnHeaders

TCustomListView	Beispiel

Mit der Eigenschaft ShowColumnHeaders können Sie bestimmen, ob die Tabellenköpfe einer Listenansicht angezeigt werden.

__property bool ShowColumnHeaders;

Beschreibung

Mit der Eigenschaft ShowColumnHeaders können Sie bestimmen, ob die Tabellenköpfe einer Listenansicht angezeigt werden. Ein Tabellenkopf ist eine Tafel mit einem Titel, der die Kategorie der Listeneinträge bezeichnet. Sie dienen beispielsweise zur Beschriftung der Spalten von untergeordneten Einträgen, die in einer Listenansicht zusätzliche Informationen zur Verfügung stellen.

Mit der Eigenschaft Columns können Sie Tabellenköpfe erstellen oder einfügen. Um die Tabellenköpfe anzuzeigen, muß die Eigenschaft ShowColumnHeaders auf True und die Eigenschaft ViewStyle auf vsReport gesetzt werden.


TCustomListView::SmallImages

TCustomListView	Beispiel

Mit der Eigenschaft SmallImages können Sie bestimmen, welche Bilderliste (TImageList) von der Listenansicht verwendet wird, wenn die Eigenschaft ViewStyle der Listenansicht auf vsSmallIcon gesetzt wurde.

__property Controls::TImageList* SmallImages;

Beschreibung

Mit der Eigenschaft SmallImages können Sie bestimmen, welche Bilderliste (TImageList) von der Listenansicht verwendet wird, wenn die Eigenschaft ViewStyle der Listenansicht auf vsSmallIcon gesetzt wurde. Eine Bilderliste enthält eine Liste mit Bitmaps, die neben der Beschriftung des Eintrags angezeigt werden können.


TCustomListView::SortType

TCustomListView

Mit der Eigenschaft SortType können Sie bestimmen, ob und wie die Einträge eines Baumdiagramms oder einer Listenansicht sortiert werden sollen.

__property TSortType SortType;

Beschreibung

Mit der Eigenschaft SortType können Sie bestimmen, ob und wie die Einträge eines Baumdiagramms oder einer Listenansicht automatisch sortiert werden. Der Standardwert ist stNone.

Beim Sortieren einer Listenansicht oder eines Baumdiagramms geht die ursprüngliche Hierarchie verloren. Durch das Zurücksetzen von SortType auf stNone wird also die ursprüngliche Reihenfolge der Einträge nicht wiederhergestellt. Im folgenden sind die möglichen Werte aufgeführt:

Wert	Bedeutung

stNone	Die Einträge werden nicht sortiert.

stData	Die Einträge werden sortiert, sobald das Datenobjekt oder SortType geändert wird.

stText	Die Einträge werden sortiert, sobald Caption oder SortType geändert wird.

stBoth	Die Einträge werden sortiert, sobald das Datenobjekt, Caption oder SortType geändert wird.


TCustomListView::StateImages

TCustomListView 	Beispiel

Mit der Eigenschaft StateImages können Sie bestimmen, welche Bilderliste (TImageList-Komponente) für die Statusbilder verwendet wird.

__property Controls::TImageList* StateImages;

Beschreibung

Diese Eigenschaft kann nur zur Laufzeit verwendet werden. Mit der Eigenschaft StateImages können Sie bestimmen, welche Bilderliste (TImageList-Komponente) für die Statusbilder verwendet wird. Ein Statusbild kann zusätzlich links vom Symbol eines Eintrags angezeigt werden.


TCustomListView::TopItem

TCustomListView	Beispiel

Mit der Eigenschaft Selected können Sie den obersten sichtbaren Eintrag einer Listenansicht ermitteln.

__property TListItem* TopItem;

Beschreibung

Auf diese Eigenschaft kann nur zur Laufzeit zugegriffen werden, und sie kann nur gelesen werden. Mit der Eigenschaft Selected können Sie den obersten sichtbaren Eintrag einer Listenansicht ermitteln. Diese Information ist nützlich, wenn der Bildschirmausschnitt zur Anzeige von Einträgen verschoben wurde, die sonst nicht im Client-Bereich des Steuerelements sichtbar sind. TopItem sollte nur verwendet werden, wenn ViewStyle auf vsReport oder vsList gesetzt wurde. Enthält ViewStyle vsIcon oder vsSmallIcon, können Sie mit der Eigenschaft ViewOrigin die Position des Bildschirmausschnitts in einer Listenansicht bestimmen. Wurde ViewStyle auf vsIcon oder vsSmallIcon gesetzt, wird beim Abrufen von TopItem eine Exception aufgrund einer Zugriffsverletzung ausgegeben.


TCustomListView::ViewOrigin

TCustomListView

Die Eigenschaft ViewOrigin gibt die Koordinaten bezogen auf den sichtbaren Bereich der Listenansicht zurück, die den Koordinaten (0, 0) der Anzeige entsprechen.

__property POINT ViewOrigin;

Beschreibung

Auf diese Eigenschaft kann nur zur Laufzeit zugegriffen werden, und sie kann nur gelesen werden. Die Eigenschaft ViewOrigin gibt die Koordinaten bezogen auf den sichtbaren Bereich der Listenansicht zurück, die den Koordinaten (0, 0) der Anzeige entsprechen. Diese Information kann nützlich sein, wenn der Bildschirmausschnitt zu Einträgen verschoben wurde, die sonst nicht im Client-Bereich sichtbar sind. ViewOrigin sollte nur verwendet werden, wenn ViewStyle auf vsIcon oder vsSmallIcon gesetzt wurde. Bei vsReport oder vsList werden keine aussagefähigen Daten zurückgegeben. Für Listen- oder Reportansichten wird die aktuelle Position des Bildschirmausschnitts von der Eigenschaft TopItem bestimmt.


TCustomListView::ViewStyle

TCustomListView

Mit der Eigenschaft ViewStyle können Sie die Anzeige der Einträge in einer Listenansicht steuern.

__property TViewStyle ViewStyle;

Beschreibung

Mit der Eigenschaft ViewStyle können Sie die Anzeige der Einträge in einer Listenansicht steuern. Die Eigenschaft ViewStyle kann die Werte vsList, vsIcon, vsReport oder vsSmallIcon annehmen. Mit vsIcon werden alle Einträge als Symbol voller Größe angezeigt. Mit vsList werden die Einträge in Spalten und als kleines Symbol mit einer Beschriftung auf der rechten Seite angezeigt. Mit vsSmallIcon werden alle Einträge als ein kleines Symbol mit einer Beschriftung auf der rechten Seite angezeigt. Bei vsReport werden die einzelnen Einträge in einer eigenen Zeile zusammen mit Informationen angezeigt, die in Spalten angeordnet sind. Die äußerste linke Spalte enthält das kleine Symbol und die Beschriftung, und die nachfolgenden Spalten enthalten die untergeordneten Einträge. Im folgenden sind die möglichen Werte aufgeführt:

Wert	Bedeutung

vsIcon	Die einzelnen Einträge erscheinen als Symbol voller Größe und mit einer darunterliegenden Beschriftung. Die Einträge können in der Listenansicht beliebig verschoben werden.

vsSmallIcon	Die einzelnen Einträge werden als ein kleines Symbol mit einer Beschriftung auf der rechten Seite angezeigt. Die Einträge können beliebig verschoben werden.

vsList	Die einzelnen Einträge werden als ein kleines Symbol mit einer Beschriftung auf der rechten Seite angezeigt. Sie werden in Spalten angeordnet und können vom Benutzer nicht an jede beliebige Position verschoben werden.

vsReport	Die einzelnen Einträge erscheinen in einer eigenen Zeile zusammen mit Informationen, die in Spalten angeordnet sind. Die äußerste linke Spalte enthält das kleine Symbol und die Beschriftung. Die nachfolgenden Spalten enthalten die untergeordneten Einträge, die von der Anwendung festgelegt wurden. Wenn ShowColumnHeaders nicht den Wert False hat, besitzt jede Spalte einen Tabellenkopf.


TCustomListView::VisibleRowCount

TCustomListView	Beispiel

Die Eigenschaft VisibleRowCount gibt die Anzahl der Einträge zurück, die vertikal im sichtbaren Bereich einer Listenansicht angezeigt werden können, wenn ViewStyle auf vsList oder vsReport gesetzt wurde.

__property int VisibleRowCount;

Beschreibung

Auf diese Eigenschaft kann nur zur Laufzeit zugegriffen werden, und sie kann nur gelesen werden. Die Eigenschaft VisibleRowCount gibt die Anzahl der Einträge zurück, die vertikal im sichtbaren Bereich einer Listenansicht angezeigt werden können, wenn ViewStyle auf vsList oder vsReport gesetzt wurde. Nur die vollständig sichtbaren Einträge werden gezählt.


Ereignisse von TCustomListView

TCustomListView	Alphabetisch	Legende

In TCustomListView

OnChange

OnChanging

OnColumnClick

OnCompare

OnDeletion

OnEdited

OnEditing

OnInsert


Ereignisse von TCustomListView

TCustomListView	Nach Objekten	Legende

OnChange

OnChanging

OnColumnClick

OnCompare

OnDeletion

OnEdited

OnEditing

OnInsert


TCustomListView::OnChange

TCustomListView

Das Ereignis OnChange wird ausgelöst, wenn die Auswahl von einem Eintrag zu einem anderen verschoben wird oder der Status, der Text oder das Bild geändert wird.

enum TItemChange { ctText, ctImage, ctState };

typedef void __fastcall (__closure *TLVChangeEvent)(System::TObject* Sender, TListItem* Item, TItemChange Change);

__property TLVChangeEvent OnChange;

Beschreibung

Mit einer Ereignisbehandlungsroutine für OnChange können Sie auf €nderungen in der Liste reagieren. OnChange stellt eine Reaktion bereit, nachdem die Liste erfolgreich geändert wurde.


TCustomListView::OnChanging

TCustomListView

Das Ereignis OnChanging wird ausgelöst, bevor ein anderer Eintrag ausgewählt oder der Status, der Text oder das Bild geändert wird.

enum TItemChange { ctText, ctImage, ctState };

typedef void __fastcall (__closure *TLVChangingEvent)(System::TObject* Sender, TListItem* Item, TItemChange Change, bool &AllowChange);

__property TLVChangingEvent OnChanging;

Beschreibung

Mit einer Ereignisbehandlungsroutine für OnChanging können Sie Aktionen durchführen, bevor die Liste geändert wird. OnChanging stellt eine Reaktion bereit, bevor die Liste geändert wird.


TCustomListView::OnColumnClick

TCustomListView

Das Ereignis OnColumnClick wird ausgelöst, wenn der Benutzer auf einen Tabellenkopf der Listenansicht klickt.

typedef void __fastcall (__closure *TLVColumnClickEvent)(System::TObject* Sender, TListColumn* Column);

__property TLVColumnClickEvent OnColumnClick;

Beschreibung

Das Ereignis OnColumnClick wird ausgelöst, wenn der Benutzer auf einen Tabellenkopf der Listenansicht klickt. ViewStyle muß auf vsReport und ColumnClick auf True gesetzt sein.


TCustomListView::OnCompare

TCustomListView

Das Ereignis OnCompare wird ausgelöst, wenn vom übergeordneten Fenster einer Listenansicht die Sortierung eines Eintrags angefordert wird.

typedef void __fastcall (__closure *TLVCompareEvent)(System::TObject* Sender, TListItem* Item1, TListItem* Item2, int Data, int &Compare);

__property TLVCompareEvent OnCompare;

Beschreibung

Das Ereignis OnCompare wird ausgelöst, wenn vom übergeordneten Fenster einer Listenansicht die Sortierung eines Eintrags angefordert wird.


TCustomListView::OnDeletion

TCustomListView

Das Ereignis OnDeletion wird ausgelöst, wenn ein Eintrag aus einer Listenansicht gelöscht wird.

typedef void __fastcall (__closure *TLVDeletedEvent)(System::TObject* Sender, TListItem* Item);

__property TLVDeletedEvent OnDeletion;

Beschreibung

Das Ereignis OnDeletion wird ausgelöst, wenn ein Eintrag aus einer Listenansicht gelöscht wird. Mit einer Ereignisbehandlungsroutine für OnDeletion können Sie Aktionen durchführen, wenn ein Eintrag der Liste gelöscht wird.


TCustomListView::OnEdited

TCustomListView

Das Ereignis OnEdited wird ausgelöst, wenn die Bearbeitung der Beschriftung in der Eigenschaft Caption eines Eintrags beendet wird.

typedef void __fastcall (__closure *TLVEditedEvent)(System::TObject* Sender, TListItem* Item,  System::AnsiString &S);

__property TLVEditedEvent OnEdited;

Beschreibung

Das Ereignis OnEdited wird ausgelöst, wenn die Bearbeitung der Beschriftung in der Eigenschaft Caption eines Eintrags beendet wird. Das Ereignis kann nur ausgelöst werden, wenn ReadOnly auf False gesetzt wurde.


TCustomListView::OnEditing

TCustomListView

Das Ereignis OnEditing wird ausgelöst, wenn die Bearbeitung der Beschriftung in der Eigenschaft Caption eines Eintrags der TListView-Komponente begonnen wird.

typedef void __fastcall (__closure *TLVEditingEvent)(System::TObject* Sender, TListItem* Item, bool &AllowEdit);

__property TLVEditingEvent OnEditing;

Beschreibung

Das Ereignis OnEditing wird ausgelöst, wenn die Bearbeitung der Beschriftung in der Eigenschaft Caption eines Eintrags der TListView-Komponente begonnen wird. Dieses Ereignis kann nur ausgelöst werden, wenn die Eigenschaft ReadOnly auf False gesetzt wurde.

Der Typ TLVEditingEvent zeigt auf eine Methode, die bei Beginn der Bearbeitung einer Beschriftung eines Eintrags (Ereignis OnEditing) der Komponente aufgerufen wird. Der Parameter AllowEdit bestimmt, ob die Komponente bearbeitet werden darf. Hat AllowEdit den Wert False, kann die Beschriftung des Eintrags im Baumdiagramm nicht geändert werden.


TCustomListView::OnInsert

TCustomListView

Das Ereignis OnInsert wird ausgelöst, wenn ein neuer Listeneintrag eingefügt wird.

typedef void __fastcall (__closure *TLVDeletedEvent)(System::TObject* Sender, TListItem* Item);

__property TLVDeletedEvent OnInsert;

Beschreibung

Das Ereignis OnInsert wird ausgelöst, wenn ein neuer Listeneintrag eingefügt wird.


Methoden von TCustomListView

TCustomListView	Alphabetisch	Legende

In TCustomListView

~TCustomListView

AlphaSort

Arrange

CreateParams

CustomSort

FindCaption

FindData

GetDragImages

GetItemAt

GetNearestItem

GetNextItem

GetSearchString

IsEditing

Notification

Scroll

StringWidth

TCustomListView

UpdateColumn

UpdateColumns

UpdateItems

WndProc

Abgeleitet von TWinControl

Broadcast

CanFocus

ContainsControl

ControlAtPos

DisableAlign

EnableAlign

Focused

GetTabOrderList

HandleAllocated

HandleNeeded

InsertControl

Invalidate

PaintTo

Realign

RemoveControl

Repaint

ScaleBy

ScrollBy

SetBounds

SetFocus

Update

UpdateControlState

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

GetTextLen

Hide

Perform

Refresh

ScreenToClient

SendToBack

SetTextBuf

Show

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TCustomListView

TCustomListView	Nach Objekten	Legende

~TCustomListView

AlphaSort

Arrange

Assign

BeginDrag

BringToFront

Broadcast

CanFocus

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

ClientToScreen

ContainsControl

ControlAtPos

CreateParams

CustomSort

DefaultHandler

DestroyComponents

Destroying

DisableAlign

Dispatch

DragDrop

Dragging

EnableAlign

EndDrag

FieldAddress

FindCaption

FindComponent

FindData

Focused

FreeInstance

FreeNotification

Free

GetDragImages

GetItemAt

GetNearestItem

GetNextItem

GetParentComponent

GetSearchString

GetTabOrderList

GetTextBuf

GetTextLen

HandleAllocated

HandleNeeded

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InsertControl

InstanceSize

Invalidate

IsEditing

MethodAddress

MethodName

NewInstance

Notification

PaintTo

Perform

Realign

Refresh

RemoveComponent

RemoveControl

Repaint

ScaleBy

ScreenToClient

ScrollBy

Scroll

SendToBack

SetBounds

SetFocus

SetTextBuf

Show

StringWidth

TCustomListView

UpdateColumns

UpdateColumn

UpdateControlState

UpdateItems

Update

WndProc


TCustomListView::~TCustomListView

TCustomListView

Der Destruktor ~TCustomListView gibt den Speicher frei, der für das TCustomListView-Objekt reserviert war. Rufen Sie ~TCustomListView nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TCustomListView automatisch aufgerufen wird.

__fastcall virtual ~TCustomListView(void);

Beschreibung

Rufen Sie ~TCustomListView nicht direkt auf. Verwenden Sie statt dessen Free. Free überprüft, ob die TListItem-Komponente nicht bereits freigegeben wurde, und ruft nur dann ~TCustomListView auf.

~TCustomListView setzt vor dem Aufruf des geerbten Destruktors die Eigenschaft OnStateChange auf NULL und gibt die Liste frei.


TCustomListView::AlphaSort

TCustomListView

Mit der Methode AlphaSort können Sie alle Listeneinträge einer Listenansicht alphabetisch sortieren. Wird die Methode erfolgreich ausgeführt, gibt sie den Wert True zurück.

bool __fastcall AlphaSort(void);

Beschreibung

Mit der Methode AlphaSort können Sie alle Listeneinträge einer Listenansicht alphabetisch sortieren. Wird die Methode erfolgreich ausgeführt, gibt sie den Wert True zurück.


TCustomListView::Arrange

TCustomListView

Die Methode Arrange ordnet die Symbole in einer Listenansicht an, deren Eigenschaft ViewStyle auf vsIcon oder vsSmallIcon gesetzt wurde.

void __fastcall Arrange(TListArrangement Code);

Beschreibung

Diese Methode kann nur zur Laufzeit verwendet werden. Die Methode Arrange ordnet die Symbole in einer Listenansicht an, deren Eigenschaft ViewStyle auf vsIcon oder vsSmallIcon gesetzt wurde. Der Parameter Code gibt an, wie die Symbole angeordnet werden. Im folgenden finden Sie die möglichen Werte für Code:

Wert	Bedeutung

arAlignBottom:	Die Einträge werden an der Unterseite des Fensters angeordnet.

arAlignLeft:	Die Einträge werden an der linken Seite des Fensters angeordnet.

arAlignRight:	Die Einträge werden an der rechten Seite des Fensters angeordnet.

arAlignTop:	Die Einträge werden an der Oberseite des Fensters angeordnet.

arDefault:	Die Einträge werden entsprechend der aktuellen Ausrichtung der Listenansicht (Standardwert) ausgerichtet.

arSnapToGrid:	Alle Symbole werden an der nächsten Gitterposition ausgerichtet.


TCustomListView::CreateParams

TCustomListView

Die Methode CreateParams initialisiert den Parameterdatensatz zur Erstellung des Fensters, der im Parameter Params übergeben wird.

virtual void __fastcall CreateParams(Controls::TCreateParams &Params);

Beschreibung

Die Methode CreateParams initialisiert den Parameterdatensatz zur Erstellung des Fensters, der im Parameter Params übergeben wird. Im TWinControl-Objekt wird CreateParams implementiert, indem allen Feldern von Params generische Basiswerte zugewiesen werden. CreateParams wird von verschiedenen Standardsteuerelementen überschrieben, um einen oder mehrere Standardwerte von Params zu ändern.

Mit CreateWnd können Sie CreateParams aufrufen und die Parameter initialisieren, die der Methode CreateWindowHandle übergeben werden. Durch Überschreiben von CreateParams können Sie das Fenster einer Komponente anpassen. Beim Überschreiben von CreateParams sollten Sie zuerst die geerbte Methode aufrufen, um die Standardwerte einzustellen. Anschließend können Sie die gewünschten Anpassungen vornehmen.


TCustomListView::CustomSort

TCustomListView

Mit der Methode CustomSort können Sie die Listeneinträge aufgrund von Kriterien sortieren, die Sie festlegen.

bool __fastcall CustomSort(Commctrl::TLVCompare SortProc, long lParam);

Beschreibung

Mit der Methode CustomSort können Sie die Listeneinträge aufgrund von Kriterien sortieren, die Sie festlegen. Geben Sie bei Verwendung dieser Methode eine anwendungsdefinierte Callback-Funktion an, die die relative Reihenfolge zweier Listeneinträge festlegen kann. Der Parameter SortProc ist ein Zeiger auf die anwendungsdefinierte Callback-Funktion. Der Parameter IParam ist optional. Mit ihm kann der Funktion ein Wert übergeben werden.

Der Callback-Funktion werden die beiden zu vergleichenden Einträge und ein 32-Bit-Wert übergeben, den Sie festlegen.

Soll der erste Eintrag dem zweiten vorangestellt werden, muß die Callback-Funktion einen negativen Wert zurückgeben. Soll der erste Eintrag dem zweiten folgen, muß ein positiver Wert zurückgegeben werden. Sind die beiden Einträge gleichwertig, muß der Rückgabewert Null sein. Die Parameter Item1 und Item2 enthalten die beiden zu vergleichenden Einträge.

Hat der Parameter SortProc den Wert NULL, wird die Standardmethode AlphaSort aufgerufen. Dies kann nützlich sein, da CustomSort den Parameter IParam besitzt, über den AlphaSort nicht verfügt.


TCustomListView::FindCaption

TCustomListView

Die Methode FindCaption sucht nach einem Listeneintrag mit den angegebenen Merkmalen und gibt ihn zurück.

TListItem* __fastcall FindCaption(int StartIndex,  System::AnsiString Value, bool Partial, bool Inclusive, bool Wrap);

Beschreibung

Die Methode FindCaption sucht nach einem Listeneintrag mit den angegebenen Merkmalen und gibt ihn zurück. Die Suche beginnt bei dem Listeneintrag, der in StartIndex angegeben wird. Es wird der in Value festgelegte Titel gesucht. Kann kein entsprechender Eintrag gefunden werden, wird der Wert NULL zurückgegeben.


TCustomListView::FindData

TCustomListView

Die Methode FindData sucht in einer Listenansicht nach einem Eintrag mit den angegebenen Merkmalen und gibt ihn zurück.

TListItem* __fastcall FindData(int StartIndex, void * Value, bool Inclusive, bool Wrap);

Beschreibung

Diese Eigenschaft kann nur zur Laufzeit verwendet werden. Die Methode FindData sucht in einer Listenansicht nach einem Eintrag mit den angegebenen Merkmalen und gibt ihn zurück. Die Suche beginnt bei dem Listeneintrag, der in StartIndex angegeben wird. Es wird der in Value festgelegte Dateneintrag gesucht. Kann kein entsprechender Eintrag gefunden werden, wird der Wert NULL zurückgegeben.


TCustomListView::GetDragImages

TCustomListView

Mit der Methode GetDragImages können Sie die Bilderliste des Steuerelements mit dem Bild abrufen, das beim Ziehen angezeigt wird.

virtual Controls::TCustomImageList* __fastcall GetDragImages(void);

Beschreibung

Mit der Methode GetDragImages können Sie die Bilderliste des Steuerelements mit dem Bild abrufen, das beim Ziehen angezeigt werden soll. Die Bilderliste enthält normalerweise nur ein Bild. Sie wird von der VCL automatisch erstellt und verwaltet.


TCustomListView::GetItemAt

TCustomListView

Die Methode GetItemAt gibt den Listeneintrag an der Position zurück, die durch die Parameter X und Y in Pixel relativ zur linken oberen Ecke der Listenansicht gegeben ist.

TListItem* __fastcall GetItemAt(int X, int Y);

Beschreibung

Diese Eigenschaft kann nur zur Laufzeit verwendet werden. Die Methode GetItemAt gibt den Listeneintrag an der Position zurück, die durch die Parameter X und Y in Pixel relativ zur linken oberen Ecke der Listenansicht gegeben ist. Befindet sich an dieser Position kein Eintrag, wird der Wert NULL zurückgegeben.


TCustomListView::GetNearestItem

TCustomListView

Die Methode GetNearestItem sucht nach dem Listeneintrag in der Listenansicht, der der in Point angegebenen Position am nächsten liegt, und gibt ihn zurück. Die Suche erfolgt in der Richtung, die im Parameter Direction angegeben ist.

TListItem* __fastcall GetNearestItem(const POINT &Point, TSearchDirection Direction);

Beschreibung

Diese Eigenschaft kann nur zur Laufzeit verwendet werden. Die Methode GetNearestItem sucht nach dem Listeneintrag in der Listenansicht, der der in Point angegebenen Position am nächsten liegt, und gibt ihn zurück. Die Suche erfolgt in der Richtung, die im Parameter Direction angegeben ist. Direction kann die Werte sdLeft, sdRight, sdAbove, sdBelow und sdAll annehmen. Kann kein entsprechender Eintrag gefunden werden, wird der Wert NULL zurückgegeben.


TCustomListView::GetNextItem

TCustomListView

Die Methode GetNextItem gibt den nächsten Listeneintrag nach StartItem zurück, der sich in der in Direction festgelegten Richtung befindet und in dem im Parameter States angegebenen Status besitzt.

TListItem* __fastcall GetNextItem(TListItem* StartItem, TSearchDirection Direction,  TItemStates States );

Beschreibung

Diese Eigenschaft kann nur zur Laufzeit verwendet werden. Die Methode GetNextItem gibt den nächsten Listeneintrag nach StartItem zurück, der sich in der in Direction festgelegten Richtung befindet und in dem im Parameter States angegebenen Status besitzt. Direction kann die Werte sdLeft, sdRight, sdAbove, sdBelow und sdAll annehmen. Im folgenden finden Sie die möglichen Werte für den Parameter States:

Wert	Bedeutung

isNone	Der Eintrag besitzt den Standardstatus.

isCut	Der Eintrag ist markiert und kann ausgeschnitten und eingefügt werden.

isDropHilited	Der Eintrag ist als Ziel einer Drag&Drop-Operation hervorgehoben.

isFocused	Der Eintrag besitzt den Fokus. Er wird deshalb von einem standardmäßigen Fokusrechteck umgeben. Obwohl mehrere Einträge ausgewählt werden können, kann nur ein Eintrag den Fokus besitzen.

isSelected	Der Eintrag ist ausgewählt. Das Aussehen des ausgewählten Eintrags hängt vom Fokus und den Systemfarben ab, die für ausgewählte Elemente verwendet werden.


TCustomListView::GetSearchString

TCustomListView

Mit der Methode GetSearchString können Sie den inkrementellen Suchstring einer Listenansicht abrufen.

System::AnsiString __fastcall GetSearchString(void);

Beschreibung

Diese Eigenschaft kann nur zur Laufzeit verwendet werden. Mit der Methode GetSearchString können Sie den inkrementellen Suchstring einer Listenansicht abrufen. Beim zurückgegebenen String handelt es sich um die Zeichenfolge, die vom Benutzer eingegeben wurde, während die Listenansicht den Fokus besaß. Bei der Eingabe eines Zeichens wird dieses an den Suchstring angehängt. Anschließend wird nach einem übereinstimmenden Eintrag gesucht. Jedem eingegebenen Zeichen wird ein Timeout-Wert von weniger als einer Sekunde zugewiesen. Ist der Timeout-Wert abgelaufen, ohne daß ein weiteres Zeichen eingetippt wurde, wird der inkrementelle Suchstring zurückgesetzt. Bei einer Übereinstimmung wird der entsprechende Eintrag ausgewählt. Gegebenenfalls wird der Bildschirmausschnitt verschoben, um ihn anzuzeigen.


TCustomListView::IsEditing

TCustomListView

Die Methode IsEditing gibt True zurück, falls ein Listeneintrag der Listenansicht bearbeitet wird.

bool __fastcall IsEditing(void);

Beschreibung

Diese Eigenschaft kann nur zur Laufzeit verwendet werden. Die Methode IsEditing gibt True zurück, falls ein Listeneintrag der Listenansicht bearbeitet wird.


TCustomListView::Notification

TCustomListView

Die Methode Notification teilt der Komponente mit, daß die im Parameter AComponent übergebene Komponente in Abhängigkeit vom Wert des Parameters Operation entweder eingefügt oder entfernt wird.

virtual void __fastcall Notification(Classes::TComponent* AComponent, Classes::TOperation Operation );

Beschreibung

Notification teilt der Komponente mit, daß die im Parameter AComponent übergebene Komponente in Abhängigkeit vom Wert des Parameters Operation entweder eingefügt oder entfernt wird. Standardmäßig leiten Komponenten Benachrichtigungen an die ihnen untergeordneten Komponenten weiter.

Eine Komponente kann, falls erforderlich, auf die Benachrichtigung reagieren, daß eine Komponente entweder eingefügt oder entfernt wird. Wenn eine Komponente Objektfelder oder Eigenschaften enthält, die auf andere Komponenten verweisen, kann sie anhand der Benachrichtigungen prüfen, ob solche Komponenten entfernt wurden, und die entsprechenden Referenzen für ungültig erklären.


TCustomListView::Scroll

TCustomListView

In der Methode Scroll geben Sie den Bildschirmausschnitt einer Listenansicht verschieben.

void __fastcall Scroll(int DX, int DY);

Beschreibung

Mit der Methode Scroll können Sie den Bildschirmausschnitt einer Listenansicht verschieben. In DX und DY geben Sie die horizontale bzw. die vertikale Verschiebung an.


TCustomListView::StringWidth

TCustomListView

Die Methode StringWidth gibt die Breite eines angegebenen Strings zurück. Dabei wird die aktuelle Schriftart der Listenansicht verwendet.

int __fastcall StringWidth( System::AnsiString S);

Beschreibung

Diese Eigenschaft kann nur zur Laufzeit verwendet werden. Die Methode StringWidth gibt die Breite eines angegebenen Strings zurück. Dabei wird die aktuelle Schriftart der Listenansicht verwendet.


TCustomListView::TCustomListView

TCustomListView

Der Konstruktor TCustomListView erzeugt ein neues TCustomListView-Objekt.

__fastcall virtual TCustomListView(Classes::TComponent* AOwner);

Beschreibung

Die Methode TCustomListView weist der Komponente Speicher zu und nimmt die erforderlichen Initialisierungen vor.


TCustomListView::UpdateColumn

TCustomListView

Mit der Methode UpdateColumn können Sie die in Index angegebene Spalte der Listenansicht aktualisieren.

void __fastcall UpdateColumn(int Index);

Beschreibung

Mit der Methode UpdateColumn können Sie die in Index angegebene Spalte der Listenansicht aktualisieren.


TCustomListView::UpdateColumns

TCustomListView

Mit der Methode UpdateColumns können Sie alle Spalten der Listenansicht aktualisieren.

void __fastcall UpdateColumns(void);

Beschreibung

Mit der Methode UpdateColumns können Sie alle Spalten der Listenansicht aktualisieren.


TCustomListView::UpdateItems

TCustomListView

Mit der Methode UpdateItems können Sie einen Bereich von Einträgen in der Listenansicht neu anzeigen. Der Bereich beginnt bei FirstIndex und endet bei LastIndex.

void __fastcall UpdateItems(int FirstIndex, int LastIndex);

Beschreibung

Mit der Methode UpdateItems können Sie einen Bereich von Einträgen in der Listenansicht neu anzeigen. Der Bereich beginnt bei FirstIndex und endet bei LastIndex.


TCustomListView::WndProc

TCustomListView

Die Methode WndProc ermöglicht dem Steuerelement spezifische Reaktionen auf Botschaften.

virtual void __fastcall WndProc(Messages::TMessage &Message);

Beschreibung

Die Methode WndProc ermöglicht dem Steuerelement spezifische Reaktionen auf Botschaften. WndProc ist die erste Methode, der Botschaften für ein Borland C++Builder-Steuerelement übergeben werden.

Die Methode WndProc der Klasse TControl definiert Reaktionen auf Mausbotschaften (Klicken und Ziehen) und gibt alle anderen Botschaften an die Methode Dispatch weiter. Das TWinControl-Objekt überschreibt WndProc, um Reaktionen auf Botschaften bezüglich des Fokus, der Maus und der Tastatur zu definieren. Alle anderen Botschaften werden an die geerbte Methode WndProc weitergeleitet.

Wenn Sie WndProc in eigenen Komponenten überschreiben, um spezifische Reaktionen auf Botschaften zu ermöglichen, sollten Sie abschließend die geerbte Methode WndProc aufrufen, damit alle anderen Botschaften verteilt werden.


Gültigkeitsbereich

Protected

Published

Zugriff

Read-only


Gültigkeitsbereich

Protected


Gültigkeitsbereich

Protected


Hierarchie

TObject

TPersistent

TComponent

TControl

TWinControl


TCustomListView Beispiel

TCustomListView


TCustomMaskEdit

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/mask.hpp

TCustomMaskEdit ist der abstrakte Basistyp für Eingabefelder, bei denen der eingegebene Text mit Hilfe einer Maske auf seine Gültigkeit geprüft werden kann.

Beschreibung

TCustomMaskEdit erweitert den Funktionsumfang der Klasse TCustomEdit um neue Eigenschaften und Methoden, mit denen die eingegebenen Informationen mit Hilfe einer Eingabemaske auf ihre Gültigkeit geprüft werden können. Um ein maskiertes Eingabefeld zu erstellen, verwenden Sie ein TMaskEdit-Objekt. Soll ein Eingabefeld ohne Gültigkeitsprüfung erstellt werden, verwenden Sie statt dessen ein TEdit-Objekt.

Erstellen Sie auf keinen Fall direkte Instanzen von TCustomMaskEdit. Verwenden Sie TCustomMaskEdit als Basisklasse für das Deklarieren von Steuerobjekten, die ein maskiertes Eingabefeld implementieren. Die Eigenschaften und Methoden von TCustomMaskEdit stellen grundlegendes Verhalten bereit, das von abgeleiteten Klassen geerbt wird, sowie Funktionsweisen, die von den Komponenten überschrieben werden können, um deren eigenes Verhalten anzupassen.


Eigenschaften von TCustomMaskEdit

TCustomMaskEdit	Alphabetisch	Legende

In TCustomMaskEdit

EditMask

EditText

IsMasked

MaskState

MaxLength

Text

Abgeleitet von TCustomEdit

Modified

SelLength

SelStart

SelText

Abgeleitet von TWinControl

Brush

ClientOrigin

ClientRect

ControlCount

Controls

Handle

HelpContext

Showing

TabOrder

TabStop

Abgeleitet von TControl

Align

BoundsRect

ClientHeight

ClientWidth

ControlState

ControlStyle

Cursor

Enabled

Height

Hint

Left

Name

Parent

ShowHint

Top

Visible

Width

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TCustomMaskEdit

TCustomMaskEdit	Nach Objekten	Legende

Align

BoundsRect

Brush

ClientHeight

ClientOrigin

ClientRect

ClientWidth

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlCount

ControlState

Controls

ControlStyle

Cursor

DesignInfo

EditMask

EditText

Enabled

Handle

Height

HelpContext

Hint

IsMasked

Left

MaskState

MaxLength

Modified

Name

Owner

Parent

SelLength

SelStart

SelText

ShowHint

Showing

TabOrder

TabStop

Tag

Text

Top

Visible

Width


TCustomMaskEdit::EditMask

TCustomMaskEdit	Siehe auch	Beispiel

Die Eigenschaft EditMask definiert die Maske, mit der festgelegt wird, welche Eingaben im maskierten Steuerelement gültig sind.

__property System::AnsiString EditMask;

Beschreibung

Mit Hilfe der Eigenschaft EditMask können Sie festlegen, welche Zeichen und Formate im maskierten Steuerelement gültig sind. Versucht der Benutzer, ein ungültiges Zeichen einzugeben, wird dieses nicht angenommen. Die Überprüfung wird von der Methode ValidateEdit zeichenweise durchgeführt.

Eine Maske besteht aus drei Feldern, die durch Semikolons voneinander getrennt sind. Das erste Feld ist die Maske selbst. Das zweite Feld besteht aus einem Zeichen und bestimmt, ob die literalen Zeichen der Maske mit den Daten gespeichert werden. Das dritte Feld legt das Zeichen fest, das für noch nicht eingegebene Zeichen angezeigt wird.

Die folgenden speziellen Zeichen werden im ersten Feld der Maske verwendet:

Zeichen	Bedeutung in der Maske

      !	Das Zeichen ! gibt in einer Maske an, daß optionale Zeichen als führende Leerzeichen dargestellt werden. Ist kein !-Zeichen vorhanden, werden optionale Zeichen im EditText-Objekt als abschließende Leerzeichen dargestellt.

     >	Wird das Zeichen > in einer Maske angegeben, werden alle nachfolgenden Zeichen in Großbuchstaben umgewandelt, bis das Ende der Maske erreicht ist oder das Zeichen < angetroffen wird.

     <	Wird das Zeichen < in einer Maske angegeben, werden alle nachfolgenden Zeichen in Kleinbuchstaben umgewandelt, bis das Ende der Maske erreicht ist oder das Zeichen > angetroffen wird.

     <>	Werden diese beiden Zeichen zusammen verwendet, findet keine Überprüfung der Groß-/Kleinschreibung statt. Die Daten werden in der Schreibweise formatiert, in der sie vom Benutzer eingegeben werden.

     \	Nach dem Zeichen \ folgt ein literales Zeichen. Mit seiner Hilfe können die speziellen Maskenzeichen als Literale in den Daten angegeben werden.

     L	An dieser Stelle muß ein Buchstabe (A-Z, a-z) eingegeben werden.

     l	An dieser Stelle ist ausschließlich ein Buchstabe erlaubt. Eine Eingabe ist jedoch nicht erforderlich.

     A	An dieser Stelle muß ein alphanumerisches Zeichen (A-Z, a-z, 0-9) eingegeben werden.

     a	An dieser Stelle ist ausschließlich ein alphanumerisches Zeichen erlaubt. Eine Eingabe ist jedoch nicht erforderlich.

     C	Andieser Stelle muß ein beliebiges Zeichen eingegeben werden.

     c	An dieser Stelle kann ein beliebiges Zeichen eingegeben werden. Eine Eingabe ist jedoch nicht erforderlich.

     0	An dieser Stelle muß ein numerisches Zeichen eingegeben werden.

     9	An dieser Stelle darf ausschließlich ein numerisches Zeichen angegeben werden. Eine Eingabe ist jedoch nicht erforderlich.

     #	An dieser Stelle darf ausschließlich ein numerisches Zeichen oder ein Plus- bzw. Minuszeichen eingegeben werden. Eine Eingabe ist jedoch nicht erforderlich.

     :	Das Zeichen : wird verwendet, um in Zeitangaben Stunden, Minuten und Sekunden zu trennen. Ist unter Ländereinstellungen in der Systemsteuerung ein anderes Trennzeichen eingestellt, wird dieses statt dessen verwendet.

     /	Mit dem Zeichen / werden in einer Datumsangabe der Monat, der Tag und das Jahr voneinander getrennt. Ist unter Ländereinstellungen in der Systemsteuerung ein anderes Trennzeichen eingestellt, wird dieses statt dessen verwendet..

     ;	Das Zeichen ; wird verwendet, um die drei Felder der Maske voneinander zu trennen.

     _	Das Zeichen _ fügt automatisch Leerzeichen in den Text ein. Bei der Eingabe in das Feld werden diese Zeichen vom Cursor übersprungen.

Alle nicht in der Tabelle aufgeführten Zeichen können im ersten Feld der Maske als literale Zeichen angegeben werden. Literale Zeichen werden automatisch eingefügt und vom Cursor beim Bearbeiten übersprungen. Die speziellen Maskenzeichen können auch als Literale angegeben werden, sofern ihnen das Zeichen \ vorangestellt wird.

Das Zeichen im zweiten Feld der Maske gibt an, ob die in der Maske enthaltenen literalen Zeichen zusammen mit dem Text des Eingabefeldes gespeichert werden. So kann beispielsweise die Maske für eine Telefonnummer mit Vorwahl folgendermaßen angegeben werden:

(00000)_0000000;0;*

Der Wert 0 im zweiten Feld gibt an, daß die Eigenschaft Text des Steuerelements aus den 10 einzugebenden Ziffern besteht und nicht aus den 14 Zeichen, aus denen sich die Nummer im Eingabefeld zusammensetzt.

Eine 0 im zweiten Feld legt fest, daß Literale nicht gespeichert werden. Bei jedem anderen Zeichen werden sie als Teil des Textes behandelt. Dieser Wert kann mit der Eigenschaft EditMask im Objektinspektor oder im Programm durch Ändern der typisierten Konstante MaskNoSave eingestellt werden.

Das dritte Feld der Maske enthält das Zeichen, das im Eingabefeld für Leerstellen (nicht eingegebene Zeichen) angezeigt wird. In der Voreinstellung entspricht es dem für literale Leerzeichen verwendeten Zeichen. Beide Zeichen werden im Eingabefenster identisch angezeigt. Gibt der Benutzer jedoch Informationen in das Feld ein, werden die Leerstellen der Reihe nach ausgewählt, während die Leerzeichen übersprungen werden.

Bei Angabe eines leeren Strings für EditMask wird die Maske entfernt.


TCustomMaskEdit::EditText

TCustomMaskEdit	Siehe auch

Die Eigenschaft EditText gibt den im Fenster des maskierten Steuerelements angezeigten Text an.

__property System::AnsiString EditText;

Beschreibung

Mit EditText wird der im Eingabefeld enthaltene Text nach der Formatierung durch EditMask angegeben. Solange der Text nicht vollständig in das maskierte Steuerelement eingegeben ist, enthält EditText für jedes noch nicht eingegebene Zeichen ein Leerzeichen. Bei der Eingabe werden die Leerzeichen dann durch die vom Benutzer eingegebenen Zeichen ersetzt.

Befinden sich literale Maskenzeichen im Text und wird kein Zeichen für die Leerstellen eingesetzt, sind die Werte von EditText und Text identisch.

Hinweis

Die Eigenschaft EditText wirkt sich nur zur Laufzeit aus.


TCustomMaskEdit::IsMasked

TCustomMaskEdit	Siehe auch	Beispiel

Die Eigenschaft IsMasked gibt an, ob für das Eingabefeld eine Maske vorhanden ist.

__property bool IsMasked;

Beschreibung

Mit Hilfe von IsMasked kann ermittelt werden, ob die Eigenschaft EditMask gesetzt ist. Hat IsMasked den Wert True, ist eine Maske vorhanden, und die Eingabe wird zur Laufzeit überprüft. Bei False wird die Eingabe nicht überprüft.


TCustomMaskEdit::MaskState

TCustomMaskEdit	Siehe auch

Die Eigenschaft MaskState liefert Statusinformationen über die Verwendung der Maske.

__property TMaskedState MaskState;

Beschreibung

MaskState wird intern verwendet, um entsprechend der aktuellen Verwendung der Maske bestimmte Aktionen einzuleiten. MaskState ist eine Menge und besteht aus folgenden Werten:

Wert	Bedeutung

msMasked	Eine Maske ist zugewiesen worden. MaskState enthält msMasked, wenn IsMasked den Wert True hat.

msReEnter	Ein ungültiges Zeichen ist zurückgewiesen worden, und die nächste Eingabe sollte ein gültiges Ersetzungszeichen sein.

msDBSetText	Der Text stammt aus einem Datenbankfeld und braucht nicht überprüft zu werden.

MaskState ist als protected deklariert, so daß abgeleitete Klassen diese Statusinformationen in der Implementierung von Eigenschaften und Methoden verwalten und verwenden können.


TCustomMaskEdit::MaxLength

TCustomMaskEdit	Siehe auch	Beispiel

MaxLength gibt an, wieviele Zeichen maximal in das Eingabefeld eingegeben werden können.

__property int MaxLength;

Beschreibung

Die Eigenschaft MaxLength gibt die Länge von EditText an. Mit ihr kann die Anzahl der Zeichen eingeschränkt werden, die in das Steuerelement eingegeben werden können, wenn keine Maske vorhanden ist. Wird mit EditMask eine Maske angegeben, gilt MaxLength für die Maske selbst und kann nicht geändert werden. EditText enthält für alle noch nicht eingegebenen Zeichen Leerzeichen. Diese füllen das Ende oder den Anfang jedes optionalen Abschnitts, so daß die Länge immer konstant bleibt.


TCustomMaskEdit::Text

TCustomMaskEdit	Siehe auch	Beispiel

Die Eigenschaft Text gibt den Text an, der vor Anwendung der Maske im maskierten Steuerelement enthalten ist.

__property System::AnsiString Text;

Beschreibung

Mit Hilfe der Eigenschaft Text kann der im Steuerelement enthaltene Text vor der Formatierung durch die Maske bestimmt werden. Der Wert der Eigenschaften Text und EditText ist unterschiedlich, wenn die Maske angibt, daß literale Zeichen entfernt werden sollen oder wenn die Maske Leerzeichen bzw. noch nicht vom Benutzer eingegebene Zeichen enthält. Text enthält dann keine Leerzeichen, die Leerstellen werden nicht durch das Zeichen _ ersetzt, und literale Zeichen in der Maske werden entfernt, wenn die Maske dies vorgibt.

Beim Festlegen der Eigenschaft Text wird der Textwert durch die Maske formatiert. Der daraus entstehende EditText-Wert wird dann verwendet, um das Fenster zu aktualisieren.

Ist keine Maske definiert, wird der Wert der Eigenschaft Text im Steuerelement angezeigt.


Methoden von TCustomMaskEdit

TCustomMaskEdit	Alphabetisch	Legende

In TCustomMaskEdit

~TCustomMaskEdit

CheckCursor

Clear

EditCanModify

GetFirstEditChar

GetLastEditChar

GetMaxChars

GetNextEditChar

GetPriorEditChar

GetSel

GetTextLen

KeyDown

KeyPress

KeyUp

ReformatText

Reset

SetCursor

SetSel

TCustomMaskEdit

ValidateEdit

ValidateError

Abgeleitet von TCustomEdit

ClearSelection

CopyToClipboard

CutToClipboard

GetSelTextBuf

PasteFromClipboard

SelectAll

SetSelTextBuf

Abgeleitet von TWinControl

Broadcast

CanFocus

ContainsControl

ControlAtPos

DisableAlign

EnableAlign

Focused

GetTabOrderList

HandleAllocated

HandleNeeded

InsertControl

Invalidate

PaintTo

Realign

RemoveControl

Repaint

ScaleBy

ScrollBy

SetBounds

SetFocus

Update

UpdateControlState

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

Hide

Perform

Refresh

ScreenToClient

SendToBack

SetTextBuf

Show

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TCustomMaskEdit

TCustomMaskEdit	Nach Objekten	Legende

~TCustomMaskEdit

Assign

BeginDrag

BringToFront

Broadcast

CanFocus

CheckCursor

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

ClearSelection

Clear

ClientToScreen

ContainsControl

ControlAtPos

CopyToClipboard

CutToClipboard

DefaultHandler

DestroyComponents

Destroying

DisableAlign

Dispatch

DragDrop

Dragging

EditCanModify

EnableAlign

EndDrag

FieldAddress

FindComponent

Focused

FreeInstance

FreeNotification

Free

GetFirstEditChar

GetLastEditChar

GetMaxChars

GetNextEditChar

GetParentComponent

GetPriorEditChar

GetSel

GetSelTextBuf

GetTabOrderList

GetTextBuf

GetTextLen

HandleAllocated

HandleNeeded

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InsertControl

InstanceSize

Invalidate

KeyDown

KeyPress

KeyUp

MethodAddress

MethodName

NewInstance

PaintTo

PasteFromClipboard

Perform

Realign

ReformatText

Refresh

RemoveComponent

RemoveControl

Repaint

Reset

ScaleBy

ScreenToClient

ScrollBy

SelectAll

SendToBack

SetBounds

SetCursor

SetFocus

SetSel

SetSelTextBuf

SetTextBuf

Show

TCustomMaskEdit

UpdateControlState

Update

ValidateEdit

ValidateError


TCustomMaskEdit::~TCustomMaskEdit

TCustomMaskEdit

Der Destruktor ~TCustomMaskEdit gibt den Speicher frei, der für das TCustomMaskEdit-Objekt reserviert war. Rufen Sie ~TCustomMaskEdit nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TCustomMaskEdit automatisch aufgerufen wird.

__fastcall virtual ~TCustomMaskEdit(void);


TCustomMaskEdit::CheckCursor

TCustomMaskEdit	Siehe auch

CheckCursor setzt den Cursor auf das nächste Zeichen, das bearbeitet werden kann, und wählt es aus, wenn ansonsten keine aktuelle Auswahl vorhanden ist.

void __fastcall CheckCursor(void);

Beschreibung

CheckCursor wird immer dann aufgerufen, wenn sich die Position des Cursors geändert haben könnte. Mit Hilfe dieser Methode kann sichergestellt werden, daß immer mindestens ein Zeichen ausgewählt ist. Das Bearbeiten eines maskierten Eingabefeldes besteht aus dem Ersetzen der Leerzeichen in der Maske. Daher muß immer eine Markierung vorhanden sein, die ersetzt werden kann. Die Auswahl entspricht einem oder mehreren nicht literalen Zeichen in der Maske. Dies sind entweder Leerzeichen oder Zeichen, die der Benutzer erneut eingeben muß.


TCustomMaskEdit::Clear

TCustomMaskEdit	Siehe auch

Die Methode Clear weist der Eigenschaft Text einen leeren String zu.

void __fastcall Clear(void);

Beschreibung

Mit der Methode Clear kann der gesamte in das maskierte Eingabefeld eingegebene Text entfernt werden. Dabei wird der Wert der Eigenschaft Text auf einen leeren String gesetzt. Der Inhalt von EditMask wird jedoch nicht gelöscht. Wurde für das Steuerelement eine Maske definiert, wird EditText nicht geleert, jedoch werden alle nicht literalen Zeichen durch Leerzeichen ersetzt.


TCustomMaskEdit::EditCanModify

TCustomMaskEdit	Siehe auch

Die Methode EditCanModify ermöglicht es dem Benutzer, den Text zu bearbeiten.

virtual bool __fastcall EditCanModify(void);

Beschreibung

Die von TCustomMaskEdit definierte Methode EditCanModify liefert immer den Wert True zurück und erlaubt dadurch dem Benutzer, den Text zu bearbeiten. EditCanModify dient hauptsächlich als Schnittstelle für eine Methode, die durch den Rückgabewert False in bestimmten Situationen eine Textänderung unterbinden kann.


TCustomMaskEdit::GetFirstEditChar

TCustomMaskEdit	Siehe auch

GetFirstEditChar gibt den Index des ersten nicht literalen Zeichens in EditMask zurück. Das erste Zeichen hat den Index Null.

int __fastcall GetFirstEditChar(void);

Beschreibung

Mit GetFirstEditChar kann die erste Position von EditMask gefunden werden, an der der Benutzer den String EditText bearbeiten kann. Ist keine Maske vorhanden, gibt GetFirstEditChar den Wert Null zurück.

GetFirstEditChar kann in einem Programm als Ausgangspunkt dienen, um alle nicht literalen Zeichen in EditText zu verarbeiten. Mit GetNextEditChar können Sie dann die Schleife durch die editierbaren Zeichen in EditText fortsetzen und mit GetLastEditChar feststellen, wann alle Zeichen bearbeitet worden sind.


TCustomMaskEdit::GetLastEditChar

TCustomMaskEdit	Siehe auch

GetLastEditChar gibt den Index des letzten nicht literalen Zeichens in EditMask zurück. Das erste Zeichen hat den Index Null.

int __fastcall GetLastEditChar(void);

Beschreibung

Mit Hilfe von GetLastEditChar kann die letzte Position in EditMask ermittelt werden, an der der Benutzer den String EditText bearbeiten kann. Ist keine Maske vorhanden, gibt GetLastEditChar die Länge des Textes zurück.


TCustomMaskEdit::GetMaxChars

TCustomMaskEdit	Siehe auch

Die Methode GetMaxChars gibt die Länge von EditText zurück.

int __fastcall GetMaxChars(void);

Beschreibung

Ist eine Maske vorhanden, liefert GetMaxChars die Länge von EditText einschließlich aller Leerzeichen. Dieser Wert ist mit MaxLength identisch, da das Bearbeiten eines maskierten Eingabefeldes aus dem Ersetzen der nicht literalen Zeichen besteht. Ist keine Maske vorhanden, gibt GetMaxChars die Länge des Textes im Fenster zurück. In diesem Fall kann der von GetMaxChars gelieferte Wert kleiner als MaxLength sein. Diese Eigenschaft gibt an, wieviele Zeichen maximal in das Steuerelement eingegeben werden können.


TCustomMaskEdit::GetNextEditChar

TCustomMaskEdit	Siehe auch

GetNextEditChar liefert den ersten Index eines nicht literalen Zeichens größer oder gleich dem Wert von Offset. Das erste Zeichen hat den Index Null.

int __fastcall GetNextEditChar(int Offset);

Beschreibung

Mit Hilfe von GetNextEditChar kann die erste Position von EditMask an oder nach der Position Offset gefunden werden, wo der Benutzer den String EditText bearbeiten kann. Sind an oder nach der Position Offset keine literalen Zeichen vorhanden, liefert GetNextEditChar den Wert von MaxLength zurück.

GetNextEditChar kann verwendet werden, um die editierbaren Zeichen von EditText in einer Schleife zu bearbeiten. Als Startpunkt wird dabei der von GetFirstEditChar gelieferte Wert verwendet. Durch einen Aufruf der Methode GetLastEditChar kann bestimmt werden, ob bereits alle nicht literalen Zeichen verarbeitet worden sind.


TCustomMaskEdit::GetPriorEditChar

TCustomMaskEdit	Siehe auch

GetPriorEditChar liefert den ersten Index eines nicht literalen Zeichens kleiner oder gleich dem Wert von Offset. Das erste Zeichen hat den Index Null.

int __fastcall GetPriorEditChar(int Offset);

Beschreibung

Mit Hilfe von GetPriorEditChar kann die erste Position von EditMask an oder vor der Position Offset gefunden werden, wo der Benutzer den String EditText ändern kann. Ist an dieser Position kein nicht literales Zeichen vorhanden, liefert GetPriorEditChar den Index des ersten editierbaren Zeichens nach Offset.


TCustomMaskEdit::GetSel

TCustomMaskEdit	Siehe auch

GetSel gibt den Index des ersten und letzten Zeichens der aktuellen Auswahl in EditText zurück.

void __fastcall GetSel(int &SelStart, int &SelStop);

Beschreibung

Mit Hilfe von GetSel kann der Index des ersten und letzten ausgewählten Zeichens in EditText bestimmt werden. Das erste Zeichen hat den Index 0. Enthält die Maske literale Zeichen, können nicht zwangsläufig alle Zeichen in der Auswahl bearbeitet werden. Verwenden Sie auf keinen Fall die zurückgegebenen Indizes für die Eigenschaft Text, wenn eine Maske vorhanden ist. EditText könnte Leerzeichen oder nicht literale Zeichen enthalten, die in Text nicht vorhanden sind.

Soll der ausgewählte Text in einem Programm geändert werden, verwenden Sie GetNextEditChar, um die editierbaren Zeichen der Auswahl SelStart bis SelStop in einer Schleife zu verarbeiten.


TCustomMaskEdit::GetTextLen

TCustomMaskEdit	Siehe auch	Beispiel

GetTextLen gibt die Länge des unformatierten Textes zurück.

int __fastcall GetTextLen(void);

Beschreibung

Mit GetTextLen kann die Länge des Textes vor der Formatierung durch die Maske ermittelt werden. Der unformatierte Text kann sich vom String EditText unterscheiden, der im Fenster des Steuerelements angezeigt wird.


TCustomMaskEdit::KeyDown

TCustomMaskEdit	Siehe auch

KeyDown ergänzt die geerbte Methode KeyDown um das Verarbeiten der Steuertasten und der Taste ENTF.

virtual void __fastcall KeyDown(unsigned short &Key,  Classes::TShiftState Shift);

Beschreibung

Nach dem Aufrufen der geerbten Methode stellt KeyDown sicher, daß nach jeder Bewegung des Cursors im maskierten Eingabefeld der Cursor immer auf ein editierbares Zeichen gesetzt und daß nach dem Löschen der aktuellen Auswahl nicht literale Zeichen durch Leerzeichen ersetzt werden. Abgeleitete Objekte können diese Methode überschreiben, um die Verarbeitung weitergehend zu ergänzen, die beim Drücken einer Taste durch den Benutzer stattfindet.


TCustomMaskEdit::KeyPress

TCustomMaskEdit	Siehe auch

KeyPress ergänzt die geerbte Methode um die Verarbeitung der Tasten ESC und EINGABE.

virtual void __fastcall KeyPress(char &Key);

Beschreibung

Nach dem Aufrufen der geerbten Methode ruft KeyPress die Methode Reset als Reaktion auf das Drücken der Taste ESC oder die Methode ValidateEdit als Reaktion auf die Taste EINGABE auf. Abgeleitete Klassen können diese Methode überschreiben, um die Verarbeitung in bezug auf diese Tasten zu erweitern.


TCustomMaskEdit::KeyUp

TCustomMaskEdit	Siehe auch

KeyUp ergänzt die geerbte Methode um die Verarbeitung der Tastenkombinationen STRG+LINKS und STRG+RECHTS.

virtual void __fastcall KeyUp(unsigned short &Key,  Classes::TShiftState Shift);

Beschreibung

Nach dem Aufrufen der geerbten Methode stellt KeyUp sicher, daß die Tastenkombinationen STRG+LINKS und STRG+RECHTS immer zu einer editierbaren Auswahl im Bearbeitungsfenster führen. Abgeleitete Klassen können diese Methode überschreiben, um die Verarbeitung zu erweitern, die beim Loslassen einer Taste durch den Benutzer stattfindet.


TCustomMaskEdit::ReformatText

TCustomMaskEdit	Siehe auch

ReformatText wendet die Maske NewMask auf den unformatierten Text an und aktualisiert die interne Darstellung der Maske.

void __fastcall ReformatText(const System::AnsiString NewMask);

Beschreibung

ReformatText führt den Großteil der Vorgänge durch, die für das Festlegen der Eigenschaft EditMask zur Laufzeit nötig sind. Diese Methode sollte jedoch nicht anstelle von EditMask verwendet werden, da sie nicht den Wert der Eigenschaft MaskState abfragen oder den Cursor positionieren kann.


TCustomMaskEdit::Reset

TCustomMaskEdit	Siehe auch

Reset setzt EditText auf den Wert zurück, der aktuell war, als das Eingabefeld zuletzt den Fokus verloren hat.

virtual void __fastcall Reset(void);

Beschreibung

Reset verwirft die letzten Änderungen des maskierten Eingabefeldes. EditText erhält wieder den Wert, der aktuell war, als das Steuerelement das letzte Mal den Fokus verloren hat. Daher gehen auch alle Änderungen verloren, die im Programm durchgeführt wurden, während das Steuerelement nicht den Fokus hatte.


TCustomMaskEdit::SetCursor

TCustomMaskEdit	Siehe auch

SetCursor setzt den Cursor auf das erste Zeichen vor oder an der Position Pos, das bearbeitet werden kann, und wählt es aus.

void __fastcall SetCursor(int Pos);

Beschreibung

SetCursor positioniert den Cursor innerhalb von EditText so, daß er sich immer auf einem Zeichen befindet, das geändert werden kann. Diese Methode stellt auch sicher, daß jeweils mindestens ein Zeichen ausgewählt ist. Es muß immer eine aktuelle Auswahl vorhanden sein, da in einem maskierten Eingabefeld die Leerzeichen in der Maske beim Bearbeiten ersetzt werden. Die Auswahl entspricht einem oder mehreren nicht literalen Zeichen in der Maske. Diese sind entweder Leerzeichen oder Zeichen, die der Benutzer erneut eingeben muß.


TCustomMaskEdit::SetSel

TCustomMaskEdit	Siehe auch

SetSel wählt die Zeichen in EditText von Position SelStart bis Position SelStop aus.

void __fastcall SetSel(int SelStart, int SelStop);

Beschreibung

SetSel wählt die Zeichen im angegebenen Bereich in EditText aus. Dies geschieht unabhängig davon, ob sie bearbeitet werden können oder nicht. Ist SelStart mit SelStop identisch, positioniert SetSel den Cursor auf dem Zeichen an der Position SelStart. Wird SetSel verwendet, muß der Cursor an einer editierbaren Position gelassen werden, wenn eine vom Benutzer zu ersetzende Auswahl gebildet werden soll.

SetSel ermöglicht das Auswählen von Zeichen, die nicht bearbeitet werden können. Diese können dann mit Hilfe der Eigenschaft SelText abgefragt oder in die Zwischenablage kopiert werden. Nach dieser Operation muß der Cursor durch den Aufruf von CheckCursor zurück auf eine editierbare Position gesetzt werden.


TCustomMaskEdit::TCustomMaskEdit

TCustomMaskEdit	Siehe auch

Der Konstruktor TCustomMaskEdit erzeugt ein neues TCustomMaskEdit-Objekt.

__fastcall virtual TCustomMaskEdit(Classes::TComponent* AOwner);

Beschreibung

Mit TCustomEdit wird ein TCustomMaskEdit-Objekt instantiiert. TCustomMaskEdit initialisiert die Eigenschaft MaskState.


TCustomMaskEdit::ValidateEdit

TCustomMaskEdit	Siehe auch

ValidateEdit versucht, den String EditText mit Hilfe der aktuellen Maske zu validieren.

void __fastcall ValidateEdit(void);

Beschreibung

ValidateEdit validiert EditText nach jedem Tastendruck bzw. nach jedem Versuch, das maskierte Eingabefeld zu verlassen. Stimmt EditText nicht mit der Maske überein, ruft ValidateEdit die Methode ValidateError auf, um eine Exception auszulösen, und setzt den Cursor an die erste Position, die sich nicht mit der Maske deckt.


TCustomMaskEdit::ValidateError

TCustomMaskEdit	Siehe auch

ValidateError gibt ein akustisches Warnsignal aus und löst eine EDBEditError-Exception aus.

void __fastcall ValidateError(void);

Beschreibung

ValidateEdit ruft ValidateError auf, wenn EditText nicht mit EditMask übereinstimmt.


Gültigkeitsbereich

Protected

Published

Zugriff

Read-only


Gültigkeitsbereich

Protected


Hierarchie

TObject

TPersistent

TComponent

TControl

TWinControl

TCustomEdit


TCustomMaskEdit Beispiel

TCustomMaskEdit


TCustomMemo

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/stdctrls.hpp

TCustomMemo ist der abstrakte Basistyp für Memokomponenten. Dies sind mehrzeilige Eingabefelder, zu denen auch TMemo und TDBMemo gehören.

Beschreibung

TCustomMemo erweitert den Funktionsumfang der Klasse TCustomEdit um neue Eigenschaften und Methoden, um mehrzeilige Eingabefelder zu unterstützen.

Erstellen Sie keine direkten Instanzen von TCustomMemo. Verwenden Sie TCustomMemo als Basisklasse für das Erzeugen von Steuerobjekten, die ein mehrzeiliges Eingabefeld implementieren. Die Eigenschaften und Methoden von TCustomMemo stellen grundlegende Funktionen bereit, die von den abgeleiteten Klassen geerbt werden sowie Funktionsweisen, die von den Komponenten überschrieben werden können, um ihr Verhalten anzupassen.


Eigenschaften von TCustomMemo

TCustomMemo	Alphabetisch	Legende

In TCustomMemo

Alignment

Lines

ScrollBars

WantReturns

WantTabs

WordWrap

Abgeleitet von TCustomEdit

Modified

SelLength

SelStart

SelText

Abgeleitet von TWinControl

Brush

ClientOrigin

ClientRect

ControlCount

Controls

Handle

HelpContext

Showing

TabOrder

TabStop

Abgeleitet von TControl

Align

BoundsRect

ClientHeight

ClientWidth

ControlState

ControlStyle

Cursor

Enabled

Height

Hint

Left

Name

Parent

ShowHint

Text

Top

Visible

Width

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TCustomMemo

TCustomMemo	Nach Objekten	Legende

Alignment

Align

BoundsRect

Brush

ClientHeight

ClientOrigin

ClientRect

ClientWidth

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlCount

ControlState

Controls

ControlStyle

Cursor

DesignInfo

Enabled

Handle

Height

HelpContext

Hint

Left

Lines

Modified

Name

Owner

Parent

ScrollBars

SelLength

SelStart

SelText

ShowHint

Showing

TabOrder

TabStop

Tag

Text

Top

Visible

WantReturns

WantTabs

Width

WordWrap


TCustomMemo::Alignment

TCustomMemo	Siehe auch

Die Eigenschaft Alignment bestimmt, wie der Text im Eingabefeld ausgerichtet wird.

__property Classes::TAlignment Alignment;

Beschreibung

Mit Hilfe der Eigenschaft Alignment kann festgelegt werden, wie der Text im Eingabefeld formatiert wird. Dazu werden folgende Konstanten verwendet:

Wert	Bedeutung

taLeftJustify	Der Text im Steuerelement wird linksbündig angeordnet.

taCenter	Der Text im Steuerelement wird zentriert angeordnet.

taRightJustify	Der Text im Steuerelement wird rechtsbündig angeordnet.


TCustomMemo::Lines

TCustomMemo	Siehe auch

Die Eigenschaft Lines enthält die einzelnen Textzeilen des Eingabefelds.

__property Classes::TStrings* Lines;

Beschreibung

Mit Hilfe der Eigenschaft Lines kann der Text in einem Eingabefeld zeilenweise bearbeitet werden. Lines ist ein TStrings-Objekt, so daß die TStrings-Methoden für Lines verwendet werden können, um Bearbeitungen wie Zählen der Textzeilen sowie Hinzufügen, Löschen und Ersetzen von Zeilen durchführen zu können.

Um den gesamten Text zu bearbeiten, verwenden Sie die Eigenschaft Text. Lines ist jedoch für die Verarbeitung einzelner Zeilen besser geeignet.


TCustomMemo::ScrollBars

TCustomMemo	Siehe auch	Beispiel

Die Eigenschaft ScrollBars bestimmt, ob das Steuerelement mit Bildlaufleisten versehen wird.

__property TScrollStyle ScrollBars;

Beschreibung

Mit ScrollBars können zu mehrzeiligen Eingabefeldern horizontale oder vertikale Bildlaufleisten hinzugefügt werden. Folgende Konstanten können angegeben werden:

Wert	Bedeutung

ssNone	Keine Bildlaufleiste

ssHorizontal	Horizontale Bildlaufleiste

ssVertical	Vertikale Bildlaufleiste

ssBoth	Horizontale und vertikale Bildlaufleiste


TCustomMemo::WantReturns

TCustomMemo	Siehe auch	Beispiel

WantReturns bestimmt, ob der Benutzer mit der Taste EINGABE einen Zeilenumbruch in den Text einfügen kann.

__property bool WantReturns;

Beschreibung

Hat WantReturns den Wert True, kann der Benutzer mit der Taste EINGABE einen Zeilenumbruch in den Text eingeben. Wird WantReturns auf False gesetzt, wirkt sich die Taste statt dessen auf das Formular aus.

Hat beispielsweise WantReturns in einem Formular mit einem Standardschalter (z. B. OK) und einem Memofeld den Wert False, wird durch Drücken der Taste EINGABE der Schalter „betätigt“. Ist WantReturns auf True gesetzt, wird statt dessen ein Zeilenumbruch in den Text eingefügt.

Hinweis

Auch wenn WantReturns auf False gesetzt ist, kann der Benutzer immer noch mit STRG+EINGABE einen Zeilenumbruch in den Text einfügen.


TCustomMemo::WantTabs

TCustomMemo	Siehe auch	Beispiel

Die Eigenschaft WantTabs bestimmt, ob der Benutzer Tabulatorzeichen in den Text einfügen kann.

__property bool WantTabs;

Beschreibung

Ist WantTabs auf True gesetzt, kann der Benutzer Tabulatorzeichen in den Text einfügen. Hat WantTabs den Wert False, wird durch Drücken der Tabulatortaste statt dessen das nächste Steuerelement im Formular ausgewählt.

Hinweis

Hat WantTabs den Wert True, können Benutzer mit Hilfe der Tabulatortaste in das Eingabefeld gelangen, es jedoch nicht auf diese Weise verlassen.


TCustomMemo::WordWrap

TCustomMemo	Siehe auch	Beispiel

Die Eigenschaft WordWrap bestimmt, ob der Text im Eingabefeld am rechten Rand umbrochen wird.

__property bool WordWrap;

Beschreibung

Ist WordWrap auf True gesetzt, wird der Text im Eingabefeld entsprechend der Breite des Client-Bereichs am rechten Rand umbrochen. Der Umbruch wird lediglich auf dem Bildschirm angezeigt, der Text enthält keinerlei Zeilenumbrüche, die nicht explizit eingegeben wurden. Hat WordWrap den Wert False, wird eine separate Zeile nur dort angezeigt, wo explizit ein Zeilenumbruch in den Text eingefügt wurde.

Hinweis

Hat WordWrap den Wert True, wird keine horizontale Bildlaufleiste für das Eingabefeld benötigt.


Methoden von TCustomMemo

TCustomMemo	Alphabetisch	Legende

In TCustomMemo

~TCustomMemo

CreateParams

CreateWindowHandle

KeyPress

Loaded

SetAlignment

SetLines

SetScrollBars

SetWordWrap

TCustomMemo

Abgeleitet von TCustomEdit

Clear

ClearSelection

CopyToClipboard

CutToClipboard

GetSelTextBuf

PasteFromClipboard

SelectAll

SetSelTextBuf

Abgeleitet von TWinControl

Broadcast

CanFocus

ContainsControl

ControlAtPos

DisableAlign

EnableAlign

Focused

GetTabOrderList

HandleAllocated

HandleNeeded

InsertControl

Invalidate

PaintTo

Realign

RemoveControl

Repaint

ScaleBy

ScrollBy

SetBounds

SetFocus

Update

UpdateControlState

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

GetTextLen

Hide

Perform

Refresh

ScreenToClient

SendToBack

SetTextBuf

Show

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TCustomMemo

TCustomMemo	Nach Objekten	Legende

~TCustomMemo

Assign

BeginDrag

BringToFront

Broadcast

CanFocus

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

ClearSelection

Clear

ClientToScreen

ContainsControl

ControlAtPos

CopyToClipboard

CreateParams

CreateWindowHandle

CutToClipboard

DefaultHandler

DestroyComponents

Destroying

DisableAlign

Dispatch

DragDrop

Dragging

EnableAlign

EndDrag

FieldAddress

FindComponent

Focused

FreeInstance

FreeNotification

Free

GetParentComponent

GetSelTextBuf

GetTabOrderList

GetTextBuf

GetTextLen

HandleAllocated

HandleNeeded

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InsertControl

InstanceSize

Invalidate

KeyPress

Loaded

MethodAddress

MethodName

NewInstance

PaintTo

PasteFromClipboard

Perform

Realign

Refresh

RemoveComponent

RemoveControl

Repaint

ScaleBy

ScreenToClient

ScrollBy

SelectAll

SendToBack

SetAlignment

SetBounds

SetFocus

SetLines

SetScrollBars

SetSelTextBuf

SetTextBuf

SetWordWrap

Show

TCustomMemo

UpdateControlState

Update


TCustomMemo::~TCustomMemo

TCustomMemo	Siehe auch

Der Destruktor ~TCustomMemo gibt den Speicher frei, der für das TCustomMemo-Objekt reserviert war. Rufen Sie ~TCustomMemo nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TCustomMemo automatisch aufgerufen wird.

__fastcall virtual ~TCustomMemo(void);

Beschreibung

Der Destruktor ~TCustomMemo gibt das TStrings-Objekt frei, das die Eigenschaft Lines implementiert, und ruft dann den Destruktor seines übergeordneten Objekts auf.


TCustomMemo::CreateParams

TCustomMemo	Siehe auch

Die Methode CreateParams initialisiert den folgenden Datensatz, der im Parameter Params übergeben wird, mit den benötigten Parametern.

virtual void __fastcall CreateParams(Controls::TCreateParams &Params);

Beschreibung

Die Methode CreateWnd ruft CreateParams auf, um die Parameter zu initialisieren, die an CreateWindowHandle übergeben werden. TCustomEdit überschreibt die geerbte Methode, um ein bildlauffähiges mehrzeiliges Eingabefeld zu erzeugen. Der Parameter Params wird mit den aktuellen Werten der Eigenschaften Alignment, ScrollBars und WordWrap sowie den von der geerbten Methode angegebenen Eigenschaften BorderStyle, HideSelections, PasswordChar und ReadOnly aktualisiert.


TCustomMemo::CreateWindowHandle

TCustomMemo	Siehe auch

Die Methode CreateWindowHandle liefert ein Fenster-Handle für das Eingabefeld.

virtual void __fastcall CreateWindowHandle(const Controls::TCreateParams &Params);

Beschreibung

CreateWindowHandle überschreibt die geerbte Methode, damit die Eigenschaft Caption in Params als Anfangstext und nicht als Fenstertitel interpretiert wird.


TCustomMemo::KeyPress

TCustomMemo	Siehe auch

KeyPress überschreibt die Standardmethode, um sicherzustellen, daß Return-Zeichen nicht in den Text eingefügt werden, wenn WantReturns den Wert False hat.

virtual void __fastcall KeyPress(char &Key);

Beschreibung

Nach dem Aufruf der geerbten Methode KeyPress, welche die Ereignisbehandlungsroutine für OnKeyPress aufruft, verwirft KeyPress alle Return-Zeichen, wenn WantReturns den Wert False hat.


TCustomMemo::Loaded

TCustomMemo	Siehe auch

Die Methode Loaded initialisiert die Eigenschaft Modified mit dem Wert False.

virtual void __fastcall Loaded(void);

Beschreibung

Loaded überschreibt den Vorgabewert, so daß die Eigenschaft Modified nach dem Laden des Steuerelements aus einem Stream auf False gesetzt ist. Abgeleitete Klassen können die Methode Loaded überschreiben, um nach dem Laden des Steuerelements weitere Initialisierungen durchzuführen.


TCustomMemo::SetAlignment

TCustomMemo	Siehe auch

Die Methode SetAlignment legt den Wert der Eigenschaft Alignment fest.

void __fastcall SetAlignment(Classes::TAlignment Value);

Beschreibung

SetAlignment ist eine geschützte Methode, so daß abgeleitete Klassen ihre Implementierung der Eigenschaft Alignment anpassen können.


TCustomMemo::SetLines

TCustomMemo	Siehe auch

SetLines legt den Wert der Eigenschaft Lines fest.

void __fastcall SetLines(Classes::TStrings* Value);

Beschreibung

SetLines ist eine geschützte Methode, so daß abgeleitete Klassen ihre Implementierung der Eigenschaft Lines anpassen können.


TCustomMemo::SetScrollBars

TCustomMemo	Siehe auch

Die Methode SetScrollBars legt den Wert der Eigenschaft ScrollBars fest.

void __fastcall SetScrollBars(TScrollStyle Value);

Beschreibung

SetScrollBars ist eine geschützte Methode, so daß abgeleitete Klassen ihre Implementierung der Eigenschaft ScrollBars anpassen können.


TCustomMemo::SetWordWrap

TCustomMemo	Siehe auch

SetWordWrap legt den Wert der Eigenschaft WordWrap fest.

void __fastcall SetWordWrap(bool Value);

Beschreibung

SetWordWrap ist eine geschützte Methode, so daß abgeleitete Klassen ihre Implementierung der Eigenschaft WordWrap anpassen können.


TCustomMemo::TCustomMemo

TCustomMemo	Siehe auch

Der Konstruktor TCustomMemo erzeugt ein neues TCustomMemo-Objekt.

__fastcall virtual TCustomMemo(Classes::TComponent* AOwner);

Beschreibung

Mit TCustomMemo wird ein TCustomMemo-Objekt instantiiert. Nach dem Aufruf des geerbten Konstruktors setzt TCustomMemo einige Eigenschaften neu. Das Steuerelement wird mit folgenden Werten initialisiert:

•	AutoSelect ist True.

•	AutoSize ist False.

•	BorderStyle ist bsSingle.

•	ControlStyle ist [csClickEvents, csDoubleClicks, csFixedHeight, csSetCaption]

•	Height und Width sind 89 bzw. 188.

•	HideSelection ist True.

•	ParentColor ist False.

•	TabStop ist True.

•	WantReturns ist True.

•	WordWrap ist True.


Gültigkeitsbereich

Protected

Published

Zugriff

Read-only


Gültigkeitsbereich

Protected


Hierarchie

TObject

TPersistent

TComponent

TControl

TWinControl

TCustomEdit


TCustomMemo Beispiel

TCustomMemo


TCustomMemoryStream

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/classes.hpp

TCustomMemoryStream ist eine abstrakte Basisklasse, die als gemeinsamer Vorfahr für Speicher-Streams dient.

Beschreibung

Verwenden Sie TCustomMemoryStream als Basisklasse, wenn Sie ein Stream-Objekt definieren, mit dem gespeicherte Daten übertragen werden können. Mit Hilfe von Speicher-Streams läßt sich der Ein- und Ausgabezugriff auf Daten implementieren, die sich auf einem schlecht zugänglichen Speichermedium befinden. Bei der Erstellung des Speicher-Streams können die Daten in einem internen Speicherpuffer abgelegt werden. Nachdem die Daten in einem Speicher-Stream bearbeitet wurden, können sie bei der Freigabe des Speicher-Streams auf das ursprüngliche Speichermedium zurückgeschrieben werden.

Die Instantiierung einer Instanz von TCustomMemoryStream ist nicht zulässig. Es handelt sich bei TCustomMemoryStream um eine abstrakte Klasse, die das allgemeine Verhalten aller Speicher-Streams implementiert. Wenn Sie mit der Instanz eines Speicher-Streams arbeiten wollen, verwenden Sie einen Nachkommen von TCustomMemoryStream, zum Beispiel TMemoryStream oder TResourceStream.


Eigenschaften von TCustomMemoryStream

TCustomMemoryStream	Alphabetisch	Legende

In TCustomMemoryStream

Memory

Abgeleitet von TStream

Position

Size


Eigenschaften von TCustomMemoryStream

TCustomMemoryStream	Nach Objekten	Legende

Memory

Position

Size


TCustomMemoryStream::Memory

TCustomMemoryStream	Siehe auch

Die Eigenschaft Memory ermöglicht den direkten Zugriff auf den Speicher-Pool, der dem Speicher-Stream zugewiesen ist.

__property void * Memory;

Beschreibung

Mit Memory erhalten Sie Zugriff auf den Speicher, der dem Stream zugewiesen ist. Der Speicher für den Stream enthält die Daten, die mit Hilfe des Speicher-Streams übertragen werden. Size gibt die Größe des zugewiesenen Speichers in Byte an, und Position bestimmt die aktuelle Position im Speicher.

Hinweis

Memory ist eine Eigenschaft mit dem Attribut Nur Lesen. Mit der Eigenschaft Memory kann der Inhalt des Speichers geändert werden. Um den Speicherbereich festzulegen, mit dem der Stream arbeitet, müssen Nachkommen von TCustomMemoryStream durch einen Aufruf der Methode SetPointer einen Zeiger auf den betreffenden Speicherpuffer zuweisen.


Methoden von TCustomMemoryStream

TCustomMemoryStream	Alphabetisch	Legende

In TCustomMemoryStream

~TCustomMemoryStream

Read

SaveToFile

SaveToStream

Seek

SetPointer

TCustomMemoryStream

Abgeleitet von TStream

CopyFrom

ReadBuffer

ReadComponent

ReadComponentRes

ReadResHeader

Write

WriteBuffer

WriteComponent

WriteComponentRes

WriteDescendent

WriteDescendentRes

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TCustomMemoryStream

TCustomMemoryStream	Nach Objekten	Legende

~TCustomMemoryStream

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

CopyFrom

DefaultHandler

Dispatch

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance

ReadBuffer

ReadComponentRes

ReadComponent

ReadResHeader

Read

SaveToFile

SaveToStream

Seek

SetPointer

TCustomMemoryStream

WriteBuffer

WriteComponentRes

WriteComponent

WriteDescendentRes

WriteDescendent

Write


TCustomMemoryStream::~TCustomMemoryStream

TCustomMemoryStream	Siehe auch

Der Destruktor ~TCustomMemoryStream gibt den Speicher frei, der für das TCustomMemoryStream-Objekt reserviert war.

__fastcall virtual ~TCustomMemoryStream(void);

Beschreibung

Rufen Sie ~TCustomMemoryStream nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TCustomMemoryStream automatisch aufgerufen wird.


TCustomMemoryStream::Read

TCustomMemoryStream	Siehe auch

Die Methode Read liest bis zu Count Byte aus dem Speicher-Stream in Buffer ein und verschiebt die aktuelle Position im Stream um die Anzahl der eingelesenen Bytes nach vorne.

virtual long __fastcall Read(void *Buffer, long Count);

Beschreibung

Verwenden Sie Read, um den Inhalt des Speicher-Streams beginnend ab der aktuellen Position in einen Puffer einzulesen. Read liest maximal Count Byte ab der aktuellen Position im Speicher. Wenn die mit Count angegebene Anzahl Bytes größer als der Umfang des Speicherpuffers ist, überträgt Read nur die Daten bis zum Ende des Puffers. Read liefert die Anzahl der Bytes zurück, die tatsächlich in den Puffer (Buffer) übertragen wurden, und verschiebt die aktuelle Position um den entsprechenden Betrag nach vorne. Ist der Rückgabewert kleiner als Count, wurde beim Lesen das Ende der Stream-Daten erreicht.

Alle anderen Methoden des Speicher-Streams, die das Lesen von Daten ermöglichen (ReadBuffer, ReadComponent), rufen zum Lesen Read auf.

Hinweis

Read verwendet Count als Obergrenze. Dagegen löst die Methode ReadBuffer eine Exception aus, wenn nicht die mit Count angegebene Anzahl Bytes gelesen werden kann.


TCustomMemoryStream::SaveToFile

TCustomMemoryStream	Siehe auch

SaveToFile schreibt den gesamten Inhalt des Speicher-Streams in die Datei mit dem angegebenen Namen.

void __fastcall SaveToFile(const System::AnsiString FileName);

Beschreibung

Verwenden Sie SaveToFile, um den Inhalt von Memory in eine Datei zu schreiben. SaveToFile ermöglicht es einer Anwendung, den Inhalt des Speicher-Streams zu schreiben, ohne explizit ein Datei-Stream-Objekt zu erstellen und freizugeben. Wenn die angegebene Datei nicht erstellt oder geöffnet werden kann, verursacht SaveToFile eine EFCreateError-Exception


TCustomMemoryStream::SaveToStream

TCustomMemoryStream	Siehe auch

SaveToStream schreibt den gesamten Inhalt des Speicher-Streams in das über Stream angegebene Stream-Objekt.

void __fastcall SaveToStream(TStream* Stream);

Beschreibung

Mit SaveToStream können gespeicherte Daten in ein anderes Speichermedium kopiert werden. SaveToStream schreibt den gesamten Inhalt von Memory in das angegebene Stream-Objekt. Der Kopiervorgang beginnt an der aktuellen Position in dem Stream, der als Parameter übergeben wurde.

Handelt es sich bei dem Stream-Parameter um ein TFileStream-Objekt, führt SaveToStream eine ähnliche Aktion aus wie die Methode SaveToFile. Allerdings beginnt SaveToStream den Schreibvorgang an der aktuellen Position im Ziel-Stream. Sie können SaveToStream beispielsweise einsetzen, um den Inhalt von Memory an einen Datei-Stream anzuhängen (SaveToFile würde den Inhalt der Datei ersetzen).

Wenn der Inhalt des Speicher-Streams nicht vollständig in den Ziel-Stream geschrieben werden kann, verursacht SaveToStream eine EWriteError-Exception.


TCustomMemoryStream::Seek

TCustomMemoryStream	Siehe auch

Die Methode Seek verschiebt die aktuelle Position des Streams um Offset Bytes. Die Verschiebung erfolgt relativ zu dem mit Origin angegebenen Ursprung.

virtual long __fastcall Seek(long Offset, unsigned short Origin);

Beschreibung

Mit Seek kann die aktuelle Position innerhalb des Speicher-Streams um den angegebenen Offset verschoben werden. Seek ermöglicht es der Anwendung, ab einer bestimmten Position in dem mit dem Speicher-Stream verbundenen Speicher zu lesen oder zu schreiben.

Wenn für Offset eine negative Zahl angegeben wird, erfolgt die Suche rückwärts ab dem angegebenen Ursprung. Die folgende Tabelle enthält verschiedene Wert für Origin und deren Bedeutung für die Suche.

Wert	Bedeutung

soFromBeginning	Der Offset bezieht sich auf den Anfang von Memory. Seek positioniert auf die in Offset angegebene Position. Offset muß >= 0 sein.

soFromCurrent	Offset beginnt an der aktuellen Position. Seek positioniert auf Position + Offset.

soFromEnd	Offset beginnt am Ende von Memory. Offset muß <= 0 sein und die gewünschte Anzahl Bytes vor dem Ende des Speicherpuffers angeben.

Seek gibt den neuen Wert der Eigenschaft Position zurück.

Hinweis

Seek führt keine Fehlerprüfung hinsichtlich des für Offset angegebenen Wertes durch. Seek darf weder mit einem Wert aufgerufen werden, der die aktuelle Position vor den Anfang des Streams verschiebt, noch mit einem Wert, der größer als Size ist, also hinter das Ende des Speicherpuffers.


TCustomMemoryStream::SetPointer

TCustomMemoryStream	Siehe auch

SetPointer ersetzt den Speicherpuffer, der mit dem Speicher-Stream verbunden ist.

void __fastcall SetPointer(void * Ptr, long Size);

Beschreibung

Mit SetPointer kann der interne Speicherpuffer (Memory) auf den in Ptr übergebenen Wert gesetzt werden. Size ist die Anzahl Bytes, auf die Ptr zeigt.

Nachkommen von TCustomMemoryStream müssen SetPointer verwenden, um den Speicher-Stream mit dem Speicherpuffer zu verbinden, der die Daten für den Speicher-Stream enthält.

Hinweis

SetPointer gibt den existierenden Wert von Memory (falls vorhanden) nicht frei, wenn der Speicherpuffer ersetzt wird. Nachkommen von TCustomMemoryStream, die mit Hilfe von SetPointer den Speicher-Pool des Streams ersetzen, müssen vor dem entsprechenden Aufruf von SetPointer den Speicher freigeben, auf den die Eigenschaft Memory zeigt.


TCustomMemoryStream::TCustomMemoryStream

TCustomMemoryStream	Siehe auch

Der Konstruktor TCustomMemoryStream erzeugt ein neues TCustomMemoryStream-Objekt.

__fastcall TCustomMemoryStream(void);


Zugriff

Read-only


Gültigkeitsbereich

Protected


Hierarchie

TObject

TStream


TCustomMemoryStream Beispiel

TCustomMemoryStream


TCustomOutline

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/outline.hpp

TCustomOutline ist eine abstrakte Containerklasse für Gliederungsknoten (Objekte der Klasse TOutlineNode). TCustomOutline ist die Basis für Gitterkomponenten wie TOutline.

Beschreibung

Die meisten Eigenschaften und Methoden der Klasse TCustomOutline sind geschützt. Sie können sie somit in ihren eigenen Gliederungskomponenten veröffentlichen. Deren Erläuterung finden Sie somit unter TOutline.

Zusätzlich zu den in TOutline veröffentlichten Elementen wird in TCustomOutline eine Reihe von geschützten Implementierungsmethoden deklariert. Diese können in ihren Gliederungsdiagramme überschrieben werden.


Eigenschaften von TCustomOutline

TCustomOutline	Alphabetisch	Legende

In TCustomOutline

ItemCount

ItemHeight

Items

ItemSeparator

Lines

Options

OutlineStyle

PictureClosed

PictureLeaf

PictureMinus

PictureOpen

PicturePlus

SelectedItem

Style

Abgeleitet von TCustomGrid

Row

Abgeleitet von TCustomControl

Canvas

Abgeleitet von TWinControl

Brush

ClientOrigin

ClientRect

ControlCount

Controls

Handle

HelpContext

ParentWindow

Showing

TabOrder

TabStop

Abgeleitet von TControl

Align

BoundsRect

ClientHeight

ClientWidth

ControlState

ControlStyle

Cursor

Enabled

Height

Hint

Left

Name

Parent

ShowHint

Top

Visible

Width

WindowProc

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TCustomOutline

TCustomOutline	Nach Objekten	Legende

Align

BoundsRect

Brush

Canvas

ClientHeight

ClientOrigin

ClientRect

ClientWidth

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlCount

ControlState

Controls

ControlStyle

Cursor

DesignInfo

Enabled

Handle

Height

HelpContext

Hint

ItemCount

ItemHeight

ItemSeparator

Items

Left

Lines

Name

Options

OutlineStyle

Owner

Parent

ParentWindow

PictureClosed

PictureLeaf

PictureMinus

PictureOpen

PicturePlus

Row

SelectedItem

ShowHint

Showing

Style

TabOrder

TabStop

Tag

Top

Visible

Width

WindowProc


TCustomOutline::ItemCount

TCustomOutline	Siehe auch

Mit der Eigenschaft ItemCount können Sie die Anzahl der Knoten im Gliederungsindex ermitteln.

__property long ItemCount;

Beschreibung

ItemCount kann sehr rechenintensiv sein, da alle Indizes aktualisiert werden.


TCustomOutline::ItemHeight

TCustomOutline	Siehe auch

Mit der Eigenschaft ItemHeight können Sie die Höhe der Knoten im Gliederungsindex ermitteln.

__property int ItemHeight;


TCustomOutline::Items

TCustomOutline	Siehe auch

Mit der Eigenschaft Items können Sie einen Knoten (ein Objekt der Klasse TOutlineNode) im Gliederungsindex ermitteln.

__property TOutlineNode* Items[long Index];

Beschreibung

Mit Items können Sie auf einen Knoten des Gliederungsindex zugreifen.

Index ist eine Zahl, die den zu ermittelnden Knoten angibt. Items[1] bezeichnet den ersten (obersten) Eintrag.

Da es sich bei Items um die Standard-Array-Eigenschaft von TOutline handelt, kann auch auf einen Eintrag zugegriffen werden, der dem Namen des Gliederungsindex unmittelbar folgt. Beispielsweise beziehen sich Outline1.Items[1] und Outline1[1] auf den ersten Knoten im Gliederungsindex.


TCustomOutline::ItemSeparator

TCustomOutline	Siehe auch

Mit der Eigenschaft ItemSeparator können Sie ein Trennzeichen für die Knoten eines Gliederungsindex einstellen.

__property System::AnsiString ItemSeparator;

Beschreibung

ItemSeparator wird von der Methode TOutlineNode::GetFullPath aufgerufen. Bei der Erstellung des Objekts der Klasse TCustomOutline wird ItemSeparator mit dem Zeichen \ initialisiert.


TCustomOutline::Lines

TCustomOutline	Siehe auch

Die Eigenschaft Lines enthält die Werte der Eigenschaft Text der einzelnen Elemente eines Gliederungsindex.

__property Classes::TStrings* Lines;

Beschreibung

Jede Zeile wird in einem Objekt der Klasse TOutlineNode in ein Element eines Gliederungsindex umgewandelt. Entsprechend den vorangestellten Tabulator- und Leerzeichen werden die Zeilen den Stufen im Gliederungsindex zugeordnet. Text ohne vorangestellte Tabulator- und Leerzeichen wird zu einem Element der Ebene 1. Um beispielsweise ein Element der Ebene 2 zu erstellen, stellen Sie dem Text dieses Elements ein Tabulator- oder ein Leerzeichen voran.

Mit der Eigenschaft Lines von Gliederungsindizes können Sie einem Gliederungsindex während des Entwurfs Elemente zuweisen. Obwohl Sie während der Laufzeit mit der Eigenschaft Lines auf die einzelnen Elemente zugreifen können, erfolgt der Zugriff mit der Eigenschaft Items wesentlich schneller.


TCustomOutline::Options

TCustomOutline	Siehe auch

Mit der Eigenschaft Options können Sie bestimmen, wie die Einträge des Gliederungsindex angezeigt werden.

__property TOutlineOptions Options;

Beschreibung

Options kann eine beliebige Kombination der folgenden Werte zugewiesen werden:

Wert	Bedeutung

ooDrawTreeRoot	Das erste Element (Index 1) wird vom Indexbaum mit dem Hauptelement verbunden. Der Baum wird also vom oberen Rand des Gliederungsindex zu den Elementen der ersten Ebene ausgedehnt. Ohne ooDrawTreeRoot werden alle Elemente der ersten Ebene am linken Rand des Gliederungsindex angezeigt, ohne Verbindung durch den Baum.

ooDrawFocusRect	Das ausgewählte Element wird von einem Fokusrechteck umgeben.

ooStretchBitmaps	Die Standard-Bitmaps des Gliederungsindex (PictureLeaf, PictureOpen, PictureClosed, PicturePlus, PictureMinus) werden an die Größe des Elements angepaßt. Diese wird durch die Schriftgröße des Textes bestimmt. Ohne ooStretchBitmap werden die Bitmaps nicht angepaßt. Sind die Bitmaps höher als der Text des Eintrags, werden sie abgeschnitten. Sind sie kleiner als der Text, wird der Platz für den Eintrag nur teilweise ausgefüllt.


TCustomOutline::OutlineStyle

TCustomOutline	Siehe auch

Mit der Eigenschaft OutlineStyle können Sie festlegen, wie die Struktur im Gliederungsindex angezeigt wird.

__property TOutlineStyle OutlineStyle;

Beschreibung

OutlineStyle kann eine beliebige Kombination der folgenden Werte zugewiesen werden:

Wert	Bedeutung

osPlusMinusText	Zeigt das Plus-Bitmap (PicturePlus), das Minus-Bitmap (PictureMinus), das Bild für den Zustand Geöffnet, das Bild für den Zustand Geschlossen, das Blatt und den Text des Elements an.

osPictureText	Zeigt das Bild für den Zustand Geöffnet (PictureOpen), das Bild für den Zustand Geschlossen (PictureClosed), das Blatt (PictureLeaf) und den Text des Elements (Text) an.

osPlusMinusPictureText	Zeigt das Plus-Bitmap, das Minus-Bitmap und den Text des Elements an.

osText	Zeigt den Text des Elements an.

osTreePictureText	Zeigt den Indexbaum, das Bild für den Zustand Geöffnet, das Bild für den Zustand Geschlossen, das Blatt und den Text des Elements an.

osTreeText	Zeigt den Indexbaum und den Text des Elements an.


TCustomOutline::PictureClosed

TCustomOutline	Siehe auch

Mit der Eigenschaft PictureClosed können Sie das Bitmap für einen geschlossenen Knoten festlegen, das Elemente enthält.

__property Graphics::TBitmap* PictureClosed;

Beschreibung

Standardmäßig enthält die Eigenschaft PictureClosed ein Bitmap mit einem geschlossenen Dateiordner.

Das Bitmap wird im Gliederungsindex nur angezeigt, wenn die Eigenschaft OutlineStyle osPictureText, osPlusMinusPictureText oder osTreePictureText enthält.


TCustomOutline::PictureLeaf

TCustomOutline	Siehe auch

Mit der Eigenschaft PictureLeaf können Sie das Bitmap für ein Element festlegen, das keine untergeordneten Elemente enthält.

__property Graphics::TBitmap* PictureLeaf;

Beschreibung

Standardmäßig enthält die Eigenschaft PictureLeaf ein Dokument-Bitmap.

Das Bitmap wird im Gliederungsindex nur angezeigt, wenn die Eigenschaft OutlineStyle osPictureText, osPlusMinusPictureText oder osTreePictureText enthält.


TCustomOutline::PictureMinus

TCustomOutline	Siehe auch

Mit der Eigenschaft PictureMinus können Sie das Bitmap für ein geöffnetes Element festlegen, das untergeordnete Elemente enthält.

__property Graphics::TBitmap* PictureMinus;

Beschreibung

Standardmäßig enthält die Eigenschaft PictureMinus ein Bitmap mit einem Minuszeichen.

Das Bitmap wird im Gliederungsindex nur angezeigt, wenn die Eigenschaft OutlineStyle osPlusMinusPictureText oder osPlusMinusText enthält.


TCustomOutline::PictureOpen

TCustomOutline	Siehe auch

Mit der Eigenschaft PictureOpen können Sie das Bitmap für ein geöffnetes Element festlegen, das untergeordnete Elemente enthält.

__property Graphics::TBitmap* PictureOpen;

Beschreibung

Standardmäßig enthält die Eigenschaft PictureOpen ein Bitmap mit einem geöffneten Dateiordner.

Das Bitmap wird im Gliederungsindex nur angezeigt, wenn die Eigenschaft OutlineStyle osPictureText, osPlusMinusPictureText oder osTreePictureText enthält.


TCustomOutline::PicturePlus

TCustomOutline	Siehe auch

Mit der Eigenschaft PicturePlus können Sie das Bitmap für ein geschlossenes Element festlegen, das untergeordnete Elemente enthält.

__property Graphics::TBitmap* PicturePlus;

Beschreibung

Standardmäßig enthält die Eigenschaft PicturePlus ein Bitmap mit einem Pluszeichen.

Das Bitmap wird im Gliederungsindex nur angezeigt, wenn die Eigenschaft OutlineStyle osPlusMinusPictureText oder osPlusMinusText enthält.


TCustomOutline::SelectedItem

TCustomOutline	Siehe auch

Mit der Eigenschaft SelectedItem können Sie den Index des ausgewählten Elements ermitteln.

__property long SelectedItem;

Beschreibung

Diese Eigenschaft kann nur zur Laufzeit verwendet werden. SelectedItem enthält den Index des ausgewählten Elements. Wurde kein Element ausgewählt, hat SelectedItem den Wert 0.


TCustomOutline::Style

TCustomOutline	Siehe auch

Mit der Eigenschaft Style können Sie bestimmen, wie die Elemente des Gliederungsindex angezeigt werden.

__property TOutlineType Style;

Beschreibung

Standardmäßig hat Style den Wert osStandard. Dies bedeutet, daß die Einträge des Gliederungsindex in dem Stil angezeigt werden, der durch die Eigenschaft OutlineStyle bestimmt wird. Indem Sie den Wert von Style auf otOwnerDraw setzen, können Sie Gliederungsindizes erstellen, deren Element auf der Zeichenfläche der TOutline-Komponente mit Hilfe von Quelltext angezeigt werden, den Sie programmieren. Im folgenden finden Sie die möglichen Werte für Style:

Wert	Bedeutung

otStandardItems	Die Elemente werden nach Maßgabe von OutlineStyle angezeigt.

otOwnerDraw	Die Elemente werden von ihrem Quelltext auf der Zeichenfläche angezeigt.

In diesen Gliederungsindizes können außer dem Text eines Elements und den Standard-Bitmaps der Eigenschaften PictureClosed, PictureOpen, PictureMinus, PicturePlus und PictureLeaf weitere Elemente angezeigt werden. Für eigentümergezeichnete Gliederungsindizes ist jedoch ein höherer Programmieraufwand erforderlich, da in der Anwendung Informationen über die Darstellung der Bilder für die einzelnen Elemente der Liste benötigt werden.

Wird ein Element in einem Gliederungsindex des Stils otOwnerDraw angezeigt, wird das Ereignis OnDrawItem ausgelöst. Das angegebene Element wird von der Ereignisbehandlungsroutine für OnDrawItem angezeigt. Die Eigenschaft ItemHeight bestimmt die Höhe aller Elemente.


Ereignisse von TCustomOutline

TCustomOutline	Alphabetisch	Legende

In TCustomOutline

OnCollapse

OnDrawItem

OnExpand


Ereignisse von TCustomOutline

TCustomOutline	Nach Objekten	Legende

OnCollapse

OnDrawItem

OnExpand


TCustomOutline::OnCollapse

TCustomOutline	Siehe auch

Das Ereignis OnCollapse wird ausgelöst, wenn ein Element des Gliederungsindex geschlossen wird.

__property EOutlineChange OnCollapse;

Beschreibung

Mit OnCollapse können Sie spezielle Aktionen durchführen, wenn ein Element des Gliederungsindex geschlossen wird.


TCustomOutline::OnDrawItem

TCustomOutline	Siehe auch

Das Ereignis OnDrawItem wird ausgelöst, wenn ein Element im Gliederungsindex gezeichnet werden muß.

__property Stdctrls::TDrawItemEvent OnDrawItem;

Beschreibung

Mit OnDrawItem können Sie das Aussehen von Elementen im Gliederungsindex festlegen.

OnDrawItem wird nur ausgelöst, wenn die Eigenschaft Style auf otOwnerDraw gesetzt wurde.


TCustomOutline::OnExpand

TCustomOutline	Siehe auch

Das Ereignis OnExpand wird ausgelöst, wenn ein Element im Gliederungsindex erweitert wird.

__property EOutlineChange OnExpand;

Beschreibung

Mit OnExpand können Sie spezielle Aktionen durchführen, wenn ein Element im Gliederungsindex erweitert wird.


Methoden von TCustomOutline

TCustomOutline	Alphabetisch	Legende

In TCustomOutline

~TCustomOutline

Add

AddChild

AddChildObject

AddObject

BadIndex

BeginUpdate

Clear

Click

Collapse

DblClick

DefineProperties

Delete

DeleteNode

DrawCell

EndUpdate

Expand

FullCollapse

FullExpand

GetDataItem

GetItem

GetNodeDisplayWidth

GetTextItem

GetVisibleNode

Insert

InsertObject

KeyDown

KeyPress

Loaded

LoadFromFile

LoadFromStream

MouseDown

Move

SaveToFile

SaveToStream

SetDisplayWidth

SetGoodIndex

SetLevel

SetUpdateState

TCustomOutline

Abgeleitet von TWinControl

Broadcast

CanFocus

ContainsControl

ControlAtPos

DisableAlign

EnableAlign

Focused

GetTabOrderList

HandleAllocated

HandleNeeded

InsertControl

Invalidate

PaintTo

Realign

RemoveControl

Repaint

ScaleBy

ScrollBy

SetBounds

SetFocus

Update

UpdateControlState

Abgeleitet von TCustomGrid

MouseCoord

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

GetTextLen

Hide

Perform

Refresh

ScreenToClient

SendToBack

SetTextBuf

Show

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TCustomOutline

TCustomOutline	Nach Objekten	Legende

~TCustomOutline

AddChildObject

AddChild

AddObject

Add

Assign

BadIndex

BeginDrag

BeginUpdate

BringToFront

Broadcast

CanFocus

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

Clear

Click

ClientToScreen

Collapse

ContainsControl

ControlAtPos

DblClick

DefaultHandler

DefineProperties

DeleteNode

Delete

DestroyComponents

Destroying

DisableAlign

Dispatch

DragDrop

Dragging

DrawCell

EnableAlign

EndDrag

EndUpdate

Expand

FieldAddress

FindComponent

Focused

FreeInstance

FreeNotification

Free

FullCollapse

FullExpand

GetDataItem

GetItem

GetNodeDisplayWidth

GetParentComponent

GetTabOrderList

GetTextBuf

GetTextItem

GetTextLen

GetVisibleNode

HandleAllocated

HandleNeeded

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InsertControl

InsertObject

Insert

InstanceSize

Invalidate

KeyDown

KeyPress

Loaded

LoadFromFile

LoadFromStream

MethodAddress

MethodName

MouseCoord

MouseDown

Move

NewInstance

PaintTo

Perform

Realign

Refresh

RemoveComponent

RemoveControl

Repaint

SaveToFile

SaveToStream

ScaleBy

ScreenToClient

ScrollBy

SendToBack

SetBounds

SetDisplayWidth

SetFocus

SetGoodIndex

SetLevel

SetTextBuf

SetUpdateState

Show

TCustomOutline

UpdateControlState

Update


TCustomOutline::~TCustomOutline

TCustomOutline	Siehe auch

Der Destruktor ~TCustomOutline gibt den Speicher frei, der für das TCustomOutline-Objekt reserviert war. Rufen Sie ~TCustomOutline nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TCustomOutline automatisch aufgerufen wird.

__fastcall virtual ~TCustomOutline(void);


TCustomOutline::Add

TCustomOutline	Siehe auch

Mit der Methode Add können Sie ein Element (ein Objekt der Klasse TOutlineNode) in den Gliederungsindex einfügen.

long __fastcall Add(long Index, const System::AnsiString Text);

Beschreibung

Mit Add können Sie ein Element in den Gliederungsindex einfügen.

Index gibt an, an welcher Stelle das neue Element eingefügt werden soll. Das eingefügte Element wird im angegebenen Gliederungsindex als letzter Abkömmling positioniert. Die dem eingefügten Element folgenden Elemente werden um eine Zeile nach unten verschoben und neu indiziert. Dies wird automatisch durchgeführt, sofern nicht BeginUpdate aufgerufen wurde. Um Elemente in einen leeren Gliederungsindex einzufügen, geben Sie für den Parameter Index den Wert 0 an.

Text gibt den Wert der Eigenschaft Text des neuen Elements an.

Mit Add können Sie den Wert der Eigenschaft Index des eingefügten Elements zurückgeben.


TCustomOutline::AddChild

TCustomOutline	Siehe auch

Mit der Methode AddChild können Sie ein untergeordnetes Element (ein Objekt der Klasse TOutlineNode) in den Gliederungsindex einfügen.

long __fastcall AddChild(long Index, const System::AnsiString Text);

Beschreibung

Mit AddChild können Sie ein untergeordnetes Element in den Gliederungsindex einfügen.

Index gibt an, an welcher Stelle das neue Element eingefügt werden soll. Das eingefügte Element wird als untergeordnetes Objekt des angegebenen Elements in den Gliederungsindex positioniert. Die dem eingefügten Element folgenden Elemente werden um eine Zeile nach unten verschoben und neu indiziert. Dies wird automatisch durchgeführt, sofern nicht BeginUpdate aufgerufen wurde. Um Elemente in einen leeren Gliederungsindex einzufügen, geben Sie für den Parameter Index den Wert 0 an.

Text gibt den Wert der Eigenschaft Text des neuen Elements an.

Mit Add können Sie den Wert der Eigenschaft Index des eingefügten Elements zurückgeben.


TCustomOutline::AddChildObject

TCustomOutline	Siehe auch

Mit der Methode AddChildObject können Sie ein untergeordnetes Element (ein Objekt der Klasse TOutlineNode), der Daten enthält, in den Gliederungsindex einfügen.

long __fastcall AddChildObject(long Index, const System::AnsiString Text, void * const Data);

Beschreibung

Mit AddChildObject können Sie ein untergeordnetes Element, der Daten enthält, in den Gliederungsindex einfügen.

Index gibt an, an welcher Stelle das neue Element eingefügt werden soll. Das eingefügte Element wird als untergeordnetes Objekt des angegebenen Elements in den Gliederungsindex positioniert. Die dem eingefügten Element folgenden Elemente werden um eine Zeile nach unten verschoben und neu indiziert. Dies wird automatisch durchgeführt, sofern nicht BeginUpdate aufgerufen wurde. Um Elemente in einen leeren Gliederungsindex einzufügen, geben Sie für den Parameter Index den Wert 0 an.

Text gibt den Wert der Eigenschaft Text des neuen Elements an.

Data zeigt auf die Daten, die mit dem neuen Knoten verbunden sind.

Mit Add können Sie den Wert der Eigenschaft Index des eingefügten Elements zurückgeben.


TCustomOutline::AddObject

TCustomOutline	Siehe auch

Mit der Methode AddObject können Sie ein Element (ein Objekt der Klasse TOutlineNode), das Daten enthält, in den Gliederungsindex einfügen.

long __fastcall AddObject(long Index, const System::AnsiString Text, void * const Data);

Beschreibung

Mit AddObject können Sie ein Element, das Daten enthält, in den Gliederungsindex einfügen.

Index gibt an, an welcher Stelle das neue Element eingefügt werden soll. Das eingefügte Element wird im angegebenen Gliederungsindex als letzter Abkömmling positioniert. Die dem eingefügten Element folgenden Elemente werden um eine Zeile nach unten verschoben und neu indiziert. Dies wird automatisch durchgeführt, sofern nicht BeginUpdate aufgerufen wurde. Um Elemente in einen leeren Gliederungsindex einzufügen, geben Sie für den Parameter Index den Wert 0 an.

Text gibt den Wert der Eigenschaft Text des neuen Elements an.

Data zeigt auf die Daten, die mit dem neuen Gliederungsknoten verbunden sind.

Mit Add können Sie den Wert der Eigenschaft Index des eingefügten Elements zurückgeben.


TCustomOutline::BadIndex

TCustomOutline	Siehe auch

Mit der Methode BadIndex können Sie ermitteln, ob der Index eines Elements aktuell ist.

bool __fastcall BadIndex(TOutlineNode* Value);

Beschreibung

Mit BadIndex können Sie bestimmen, ob die Eigenschaft Index eines Elements aktuell ist.

Bei Value handelt es sich um das zu prüfende Element.


TCustomOutline::BeginUpdate

TCustomOutline	Siehe auch

Mit der Methode BeginUpdate können Sie die Aktualisierung des Gliederungsindex verhindern, bis die Methode EndUpdate aufgerufen wird.

void __fastcall BeginUpdate(void);

Beschreibung

Beim Einfügen, Entfernen oder Verschieben kann die Bearbeitungszeit verringert werden, indem Sie zuvor die Methode BeginUpdate aufrufen. Dadurch wird bis zum Aufruf von EndUpdate verhindert, daß die Elemente des Gliederungsindex neu indiziert werden.

Mit BeginUpdate können Sie Aktualisierungen der Bildschirmanzeige verhindern und die Bearbeitung beschleunigen, während die Liste neu erstellt wird.


TCustomOutline::Clear

TCustomOutline

Die Methode Clear löscht alle Einträge aus der Gliederung.

void __fastcall Clear(void);


TCustomOutline::Click

TCustomOutline	Siehe auch

Mit der Methode Click können Sie das ausgewählte Element des Gliederungsindex intern speichern und die Aktionen der geerbten Methode Click durchführen.

virtual void __fastcall Click(void);


TCustomOutline::Collapse

TCustomOutline	Siehe auch

Mit der Methode Collapse können Sie ein Element im Gliederungsindex schließen.

virtual void __fastcall Collapse(long Index);

Beschreibung

Mit der Methode Collapse können Sie ein Element im Gliederungsindex ausblenden, indem Sie seiner Eigenschaft Expanded den Wert False zuweisen. Sobald ein Element geschlossen wird, werden die untergeordneten Elemente ausgeblendet, und das Plus-Bitmap oder das Bitmap für den Zustand Geschlossen wird angezeigt. Dies hängt vom Stil des Gliederungsindex ab, der in der Eigenschaft OutlineStyle festgelegt wurde.


TCustomOutline::DblClick

TCustomOutline	Siehe auch

Mit der Methode DblClick können Sie das ausgewählte Element des Gliederungsindex erweitern und die Aktionen der geerbten Methode DblClick durchführen.

virtual void __fastcall DblClick(void);


TCustomOutline::DefineProperties

TCustomOutline	Siehe auch

Mit der Methode DefineProperties können Sie ein Objekt der Klasse TFiler ändern, damit es mit dem Gliederungsindex kompatibel wird.

virtual void __fastcall DefineProperties(Classes::TFiler* Filer);


TCustomOutline::Delete

TCustomOutline	Siehe auch

Mit der Methode Delete können Sie ein Element aus dem Gliederungsindex löschen.

void __fastcall Delete(long Index);

Beschreibung

Index ist der Index des zu löschenden Elements.


TCustomOutline::DeleteNode

TCustomOutline	See also

DeleteNode aktualisiert den Gliederungsindex, nachdem ein Knoten gelöscht wurde.

void __fastcall DeleteNode(TOutlineNode* Node, long CurIndex);

Beschreibung

DeleteNode wird automatisch immer dann aufgerufen, wenn ein Knoten aus dem Gliederungsindex gelöscht wurde. Die Methode aktualisiert den Index und sorgt dafür, daß die Eigenschaft SelectedItem einen gültigen Wert enthält.

Um einen Knoten aus dem Gliederungsindex zu löschen, rufen Sie entweder die Methode DeleteNode des Gliederungsindex oder die Methode Free des TOulineNode-Objekts auf.


TCustomOutline::DrawCell

TCustomOutline	Siehe auch

Mit der Methode DrawCell können Sie das Ereignis OnDrawCell auslösen.

virtual void __fastcall DrawCell(long ACol, long ARow, const Windows::TRect &ARect,  Grids::TGridDrawState  AState);

Beschreibung

Mit DrawCell können Sie das Ereignis OnDrawCell auslösen.

Die geänderte Darstellung einer Zelle hängt von der Eigenschaft TCustomGrid::DefaultDrawing ab. Hat DefaultDrawing den Wert False, muß die Darstellung der Zelle vom Quelltext in der Ereignisbehandlungsroutine für OnDrawCell gezeichnet werden. Andernfalls wird die Zelle normal durchgeführt, und die Ereignisbehandlungsroutine für OnDrawCell wird aufgerufen.

ACol bezeichnet die Spalte der Zelle.

ARow bezeichnet die Zeile der Zelle.

Bei ARect handelt es sich um den Zellbereich, in dem die Darstellung erfolgt.

AState ist der Status der Zelle. Der Parameter kann eine beliebige Kombination der folgenden Werte enthalten:

Wert	Bedeutung

gdFixed	Die Zelle ist nicht veränderlich.

gdFocused	Die Zelle besitzt den Eingabefokus.

gdSelected	Die Zelle ist ausgewählt.


TCustomOutline::EndUpdate

TCustomOutline	Siehe auch

Die Methode EndUpdate bewirkt ein Neuindizieren und Neuzeichnen,  nachdem dies von einem BeginUpdate verhindert wurde.

void __fastcall EndUpdate(void);

Beschreibung

Mit der Methode EndUpdate am Ende eines Code-Abschnittswird ein Zähler heruntergesetzt, der von einem Aufruf von BeginUpdate hochgesetzt wurde. Wenn dieser Zähler auf 0 steht, werden alle Indizes aktualisiert und die Glideerung wird neu gezeichnet.


TCustomOutline::Expand

TCustomOutline	Siehe auch

Mit der Methode Expand können Sie einen Gliederungsknoten erweitern.

virtual void __fastcall Expand(long Index);

Beschreibung

Mit der Methode Expand können Sie einen Gliederungsknoten erweitern, indem Sie seine Eigenschaft Expanded auf den Wert True setzen. Sobald die nächste Ebene eines Elements erscheint, werden die untergeordneten Elemente und das Minus-Bitmap oder das Bitmap für den Zustand Geöffnet angezeigt. Dies hängt vom Stil des Gliederungsindex ab, der in der Eigenschaft OutlineStyle festgelegt wurde.


TCustomOutline::FullCollapse

TCustomOutline	Siehe auch

Mit der Methode FullCollapse können Sie alle Element im Gliederungsindex schließen.

void __fastcall FullCollapse(void);

Beschreibung

Mit der Methode FullCollapse werden alle Elemente im Gliederungsindex ausgeblendet, indem der Eigenschaft Expanded aller Elemente, die direkte Abkömmlinge des Stammknotens sind, der Wert False zugewiesen wird. Sobald ein Element geschlossen ist, werden die untergeordneten Elemente ausgeblendet, und das Plus-Bitmap oder das Bitmap für den Zustand Geschlossen wird angezeigt. Dies hängt vom Stil des Gliederungsindex ab, der in der Eigenschaft OutlineStyle festgelegt wurde.


TCustomOutline::FullExpand

TCustomOutline	Siehe auch

Mit der Methode Expand können Sie alle Gliederungsknoten erweitern.

void __fastcall FullExpand(void);

Beschreibung

Mit der Methode FullExpand können Sie einen Gliederungsknoten erweitern, indem der Eigenschaft Expanded aller Elemente, die direkte Abkömmlinge des Stammknotens sind, der Wert True zugewiesen wird. Sobald die nächste Ebene eines Elements erscheint, werden die untergeordneten Elemente und das Minus-Bitmap oder das Bitmap für den Zustand Geöffnet angezeigt. Dies hängt vom Stil des Gliederungsindex ab, der in der Eigenschaft OutlineStyle festgelegt wurde.


TCustomOutline::GetDataItem

TCustomOutline	Siehe auch

Die Methode GetDataItem gibt den Index des ersten Knotens zurück, dessen Eigenschaft Data den Wert des zeigers Value hat.

long __fastcall GetDataItem(void * Value);

Beschreibung

Mit der Methode GetDataItem können Sie den Knoten finden, dessen Eigenschaft Data dem Parameter Value entspricht. GetDataItem gibt den Index auf die Arrayeigenschaft Items zurück.


TCustomOutline::GetItem

TCustomOutline	Siehe auch

Die Methode GetItem gibt einen Index auf den Knoten zurück, der sich an der Position befindet, die in den Parametern X und Y übergeben wurde.

long __fastcall GetItem(int X, int Y);

Beschreibung

Mit der Methode GetItem können Sie den Knoten finden, der sich an den Bildschirmkoordinaten befindet, die in X und Y angegeben wurden. GetDataItem gibt den Index auf die Arrayeigenschaft Items zurück.


TCustomOutline::GetNodeDisplayWidth

TCustomOutline	Siehe auch

Die Methode GetNodeDisplayWidth gibt die Länge der Zeile eines bestimmten Knotens zurück.

int __fastcall GetNodeDisplayWidth(TOutlineNode* Node);

Beschreibung

Mit der Methode GetNodeDisplayWidth bestimmen Sie die Länge (in Pixeln) der Zeile der Gliederung, die den Knoten enthält, der in dem parameter Node angegeben wird. GetNodeDisplayWidth berechnet dabei auch den Platz für die Bitmaps, die in der Eigenschaft OutlineStyle angegeben wurden.


TCustomOutline::GetTextItem

TCustomOutline	Siehe auch

Die Methode GetTextItem gibt den Index des ersten Gliederungsknoten zurück, der Value als Wert seiner Eigenschaft Text hat.

long __fastcall GetTextItem(const System::AnsiString Value);

Beschreibung

Mit der Methode GetTextItem finden Sie den Knoten, dessen Text mit dem Parameter Value übereinstimmt. GetTextItem gibt den Index auf die Arrayeigenschaft Items zurück.


TCustomOutline::GetVisibleNode

TCustomOutline	Siehe auch

Die Methode GetVisibleNode gibt das Objekt TOutlineNode zurück, das die Position Index innerhalb der Gliederung hat.

TOutlineNode* __fastcall GetVisibleNode(long Index);

Beschreibung

Mit der Methode GetVisibleNode finden Sie den Knoten an der Position des Parameters Index, wobei alle Knoten, die verborgen sind, weil ihre übergeordneten Knoten geschlossen sind, ignoriert werden. Der Index von 0 steht für den ersten sichtbaren Knoten, der Index 1 für den zweiten usw. Wenn die Gliederung ganz expandiert ist, gibt GetVisibleNode den Wert von Items[Index+1] zurück.


TCustomOutline::Insert

TCustomOutline	Siehe auch

Fügt einen Knoten an der angegebenen Position Index in die Gliederung ein..

long __fastcall Insert(long Index, const System::AnsiString Text);

Beschreibung

Mit der Methode Insert fügen Sie einen neuen Knoten in ein TOutlineNode-Objekt ein. Text ist der Wert der Eigenschaft Text des neuen Knotens.

Index bestimmt die Position des neuen Knotens innerhalb der Gliederung. Der neue Knoten wird in der Gliederung an der Stelle eingefügt, die der Knoten hatte, der sich an der Stelle Index befand. Der neue Knoten wird auf der gleichen Ebene eingefügt wie Knoten, der sich vorher an dieser Stelle befand, so daß der neue Knoten und der Originalknoten gleichgeordnet sind und den gleichen übergeordneten Knoten haben. Um einen Knoten am Anfang des der Gliederung einzufügen, geben Sie 0 als Parameter Index ein.

Knoten, die hinter dem neuen Knoten positioniert sind (auch der, der sich vorher an der Stelle Index befand), werden eine Zeile nach unten versetzt und werden in der Arrayeigenschaft Items mit neuen, gültigen Indizes versehen. Wenn BeginUpdate aufgerufen wurde, wird der Array Items nicht neu indiziert, bis EndUpdate aufgerufen wurde.

Insert gibt die Eigenschaft Index des neuen Knotens zurück.


TCustomOutline::InsertObject

TCustomOutline	Siehe auch

Die Methode InsertObject fügt einen neuen Knoten, der Daten enthält, an der angegebenen Position ein.

long __fastcall InsertObject(long Index, const System::AnsiString Text, void * const Data);

Beschreibung

Mit der Methode InsertObject fügen Sie einen neuen Knoten in ein TOutlineNode-Objekt ein. Text ist der Wert der Eigenschaft Text des neuen Knotens, Data ist der Wert der Eigenschaft Data dieses neuen Knotens.

Index bestimmt die Position des neuen Knotens innerhalb der Gliederung. Der neue Knoten wird in der Gliederung an der Stelle eingefügt, die der Knoten hatte, der sich an der Stelle Index befand. Der neue Knoten wird auf der gleichen Ebene eingefügt wie Knoten, der sich vorher an dieser Stelle befand, so daß der neue Knoten und der Originalknoten gleichgeordnet sind und den gleichen übergeordneten Knoten haben. Um einen Knoten am Anfang des der Gliederung einzufügen, geben Sie 0 als Parameter Index ein.

Knoten, die hinter dem neuen Knoten positioniert sind (auch der, der sich vorher an der Stelle Index befand), werden eine Zeile nach unten versetzt und werden in der Arrayeigenschaft Items mit neuen, gültigen Indizes versehen. Wenn BeginUpdate aufgerufen wurde, wird der Array Items nicht neu indiziert, bis EndUpdate aufgerufen wurde.

InsertObject gibt die Eigenschaft Index des neuen Knotens zurück.


TCustomOutline::KeyDown

TCustomOutline	Siehe auch

Mit der Methode KeyDown können Sie Tastenanschläge verarbeiten, die sich auf die Steuerelemente eines Gliederungsindex beziehen.

virtual void __fastcall KeyDown(unsigned short &Key,  Classes::TShiftState Shift);

Beschreibung

Mit KeyDown können Sie die folgenden Tastenanschläge zusätzlich zu denen verarbeiten, die von der geerbten Methode KeyDown verarbeitet werden:

Taste	Verhalten

Pos1	Das erste Element des Gliederungsindex wird ausgewählt.

Ende	Das letzte Element des Gliederungsindex wird ausgewählt.

Eingabe	Sie können für den ausgewählten Knoten zwischen dem geschlossenen und geöffneten Status umschalten.

Strg+*	Der Gliederungsindex wird vollständig erweitert.

Pfeil Rechts	Das erste untergeordnete Objekt des ausgewählten Elements wird markiert.

Pfeil Links	Das übergeordnete Objekt des ausgewählten Elements wird markiert.

Strg+Pfeil Oben	Das nächste Element wird ausgewählt.

Strg+Pfeil Unten	Das vorhergehende Element wird ausgewählt.


TCustomOutline::KeyPress

TCustomOutline	Siehe auch

Mit der Methode KeyPress können Sie Zeichen verarbeiten, die sich auf die Steuerelemente eines Gliederungsindex beziehen.

virtual void __fastcall KeyPress(char &Key);

Beschreibung

Mit KeyPress können Sie die sich auf die Steuerelemente des Gliederungsindex beziehenden Zeichen zusätzlich zu den Zeichen verarbeiten, die von der geerbten Methode KeyPress verarbeitet werden:

Taste	Verhalten

+	Die nächste Ebene des ausgewählten Elements wird einblendet.

-	Die untergeordnete Ebene des ausgewählten Elements wird ausgeblendet.

*	Der Gliederungsindex wird vollständig erweitert.


TCustomOutline::Loaded

TCustomOutline	Siehe auch

Mit der Methode Loaded können Sie die Bitmaps laden, die mit einem Gliederungsindex verbunden sind.

virtual void __fastcall Loaded(void);


TCustomOutline::LoadFromFile

TCustomOutline	Siehe auch

LoadFromFile lädt die Gliederung aus einer Textdatei.

void __fastcall LoadFromFile(const System::AnsiString FileName);

Beschreibung

Die Methode LoadFromFile wird aufgerufen, um eine Gliederung aus einer Datei zu laden, die im Parameter FileName angegeben wird. Jede Zeile dieser Textdatei repräsentiert einen Knoten des Gliederungsbaums. Die Datei enthält nicht den Stammknoten.

Führende Tabulator- und Leerzeichen werden in Ebenen der Gliederung umgewandelt. Text ohne führende Tabulator- und Leerzeichen wird auf der ersten Ebene plaziert. Der folgende Absatz zeigt, wie eine Gliederung mit drei ersten Ebenen (direkt unter dem Stammknoten) und zwei untergeordneten Einträgen auf der zweiten Ebene für den ersten und dritten Knoten als Text dargestellt werden würde:

ChildA

 ChildA1

ChildB

ChildC

 ChildC1

Um die Gliederung mit Textdaten aus einem Stream zu füllen, verwendet man die Methode LoadFromStream.

Um die Gliederung mit Textdaten aus einem Objekt TStrings zu füllen, verwendet man die Eigenschaft Lines.


TCustomOutline::LoadFromStream

TCustomOutline	Siehe auch

LoadFromStream lädt die Gliederung aus einem Stream.

void __fastcall LoadFromStream(Classes::TStream* Stream);

Beschreibung

Die Methode LoadFromStream wird aufgerufen, um eine Gliederung aus einem Stream zu laden, der im Parameter Stream angegeben wird. So kann man LoadFromStream dazu verwenden, eine Gleiderung aus einer Datenbanktabelle zu laden, indem man ein TBlobStream-Objekt verwendet. Jeder Gliederungsknoten ist durch ein Absatzzeichen getrennt. Der Stream enthält nicht den Stammknoten.

Führende Tabulator- und Leerzeichen werden in Ebenen der Gliederung umgewandelt. Text ohne führende Tabulator- und Leerzeichen wird auf der ersten Ebene plaziert. Der folgende Absatz zeigt, wie eine Gliederung mit drei ersten Ebenen (direkt unter dem Stammknoten) und einem untergeordneten Eintrag auf der zweiten Ebene für den ersten und dritten Knoten als Text dargestellt werden würde:

ChildA

 ChildA1

ChildB

ChildC

 ChildC1

Um die Gliederung mit Textdaten aus einer Textdatei zu füllen, verwendet man die Methode LoadFromFile.

Um die Gliederung mit Textdaten aus einem Objekt TStrings zu füllen, verwendet man die Eigenschaft Lines.


TCustomOutline::MouseDown

TCustomOutline	Siehe auch

Mit der Methode MouseDown können Sie das ausgewählte Element in internen Variablen speichern und die Aktionen der geerbten Methode MouseDown durchführen.

virtual void __fastcall MouseDown(Controls::TMouseButton Button,  Classes::TShiftState Shift, int X, int Y);


TCustomOutline::Move

TCustomOutline	Siehe auch

Mit der Methode Move können Sie ein Element in einem Gliederungsindex verschieben.

void __fastcall Move(long Destination, long Source, TAttachMode AttachMode);

Beschreibung

Destination bezeichnet den neuen Index des Elements.

Bei Source handelt es sich um den aktuellen Index des Elements.

AttachMode hat einen der folgenden TAttachMode-Werte:

Wert	Bedeutung

oaAdd	Das Element wird von der Methode Add hinzugefügt. Das verschobene Element wird zum letzten Abkömmling des Elements, das im Parameter Destination angegeben wurde. Das verschobene Element ist in demselben übergeordneten Element enthalten wie das Element von Destination.

oaAddChild	Das Element wird von der Methode AddChild hinzugefügt. Das verschobene Element wird zum letzten untergeordneten Objekt des Elements, das im Parameter Destination angegeben wurde. Das Element von Destination wird zum übergeordneten Objekt des verschobenen Elements.

oaInsert	Das Element wird von der Methode Insert hinzugefügt. Das Element von Destination wird im Gliederungsindex durch das verschobene Element ersetzt. Das Element von Destination und alle folgenden Einträge werden um eine Zeile nach unten verschoben.


TCustomOutline::SaveToFile

TCustomOutline	Siehe auch

Die Methode SaveToFile speichert die Eigenschaft Lines in einer Datei.

void __fastcall SaveToFile(const System::AnsiString FileName);

Beschreibung

Die Methode SaveToFile wird verwendet, um ein Textabbild der Gliederung in einer Datei zu speichern, deren Namen im Parameter FileName angegeben wurde. Das gespeicherte Textabbild entspricht der Eigenschaft Lines, wobei jede Zeile dieser Datei einem Knoten und jede Gliederungsebene einem Tabulatorzeichen entspricht.

Um eine Gliederung in einen Stream zu schreiben, verwenden Sie die Methode SaveToStream.


TCustomOutline::SaveToStream

TCustomOutline	Siehe auch

Die Methode SaveToStream schreibt die Eigenschaft Lines in einen Stream.

void __fastcall SaveToStream(Classes::TStream* Stream);

Beschreibung

Die Methode SaveToStream wird verwendet, um ein Textabbild der Gliederung in einenStream zu speichern, der im Parameter Stream angegeben wurde. Das gespeicherte Textabbild entspricht der Eigenschaft Lines, wobei jede Zeile dieser Datei einem Knoten und jede Gliederungsebene einem Tabulatorzeichen entspricht.

Um eine Gliederung in eine Datei zu schreiben, verwenden Sie die Methode SaveToFile.


TCustomOutline::SetDisplayWidth

TCustomOutline	Siehe auch

Mit der Methode SetDisplayWidth können Sie die Anzeigebreite eines Gliederungsindex einstellen.

void __fastcall SetDisplayWidth(int Value);

Beschreibung

Value bezeichnet die neue Breite.


TCustomOutline::SetGoodIndex

TCustomOutline	See also

Die Methode SetGoodIndex gibt den ersten Knoten im Array Items zurück, der neu indiziert werden muß, damit der Parameter Value über den korrekten Index verfügt.

TOutlineNode* __fastcall SetGoodIndex(TOutlineNode* Value);

Beschreibung

Mit SetGoodIndex können Sie feststellen, wieviele Elemente im Array Items nach einer Änderung an den Knoten des Gliederungsdiagramms neu indiziert werden müssen. Die Knoten vom Ausgangspunkt bis zu dem von SetGoodIndex zurückgegebenen Wert brauchen nicht neu indiziert zu werden.


TCustomOutline::SetLevel

TCustomOutline	Siehe auch

Mit der Methode SetLevel können Sie die Ebene eines Elements im Gliederungsindex einstellen.

void __fastcall SetLevel(TOutlineNode* Node, unsigned int CurLevel, unsigned int NewLevel);

Beschreibung

Node bezeichnet das Element.

Bei CurLevel handelt es sich um die aktuelle Ebene des Elements.

Bei NewLevel handelt es sich um die neue Ebene des Elements.


TCustomOutline::SetUpdateState

TCustomOutline	Siehe auch

Die Methode SetUpdateState aktiviert oder deaktiviert die Wartung des Gliederungsindex.

void __fastcall SetUpdateState(bool Value);

Beschreibung

Wird die Methode SetUpdateState mit dem Parameter True aufgerufen, wird die Aktualiserung der Indizes verhindert. Wird diese Methode mit dem Parameter False aufgerufen, wird der Gliederungsindex neu berechnet und die Wartung dieses Index bei Änderungen eingeschaltet.

Anders als bei BeginUpdate und EndUpdate wird kein Aufrufzähler gesetzt. Jeder Aufruf von SetUpdateState mit dem Parameter False berechnet den Index neu.

Hinweis

Der Aufruf von SetUpdateState hat Vorrang vor der Aktivierung oder Deaktivierung der Indexwartung durch BeginUpdate oder EndUpdate.


TCustomOutline::TCustomOutline

TCustomOutline	Siehe auch

Der Konstruktor TCustomOutline erzeugt ein neues TCustomOutline-Objekt.

__fastcall virtual TCustomOutline(Classes::TComponent* AOwner);

Beschreibung

AOwner ist die Komponente, die dem Gliederungsdiagramm übergeordnet wird.


Gültigkeitsbereich

Protected

Published

Zugriff

Read-only


Gültigkeitsbereich

Protected


Gültigkeitsbereich

Protected


Hierarchie

TObject

TPersistent

TComponent

TControl

TWinControl

TCustomControl

TCustomGrid


TCustomOutline Beispiel

TCustomOutline


TCustomPanel

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/extctrls.hpp

TCustomPanel ist der abstrakte Basistyp für alle Tafelkomponenten in Borland C++Builder.

Beschreibung

Tafelkomponenten sind Steuerelemente, die andere Steuerelemente aufnehmen und gruppieren. Es können untergeordnete Steuerelemente abgeleitet werden, die aus untergeordneten Steuerelementen von TCustomPanel bestehen.

Eine Tafel kann mit Hilfe der Eigenschaft Align im Formular ausgerichtet werden. Sie behält dann ihre relative Position bei, wenn die Größe des Formulars geändert wird. Sie können eine Tafel beispielsweise so ausrichten, daß sie immer im oberen Bereich des Formulars angezeigt wird, gleichgültig, in welcher Weise der Benutzer Form und Größe des Formulars verändert. Tafeln eignen sich damit gut für die Implementierung von Komponenten wie Werkzeugleisten oder Statusleisten. Sie könnten zum Beispiel eine Werkzeugleiste oder eine Werkzeugpalette erstellen, indem Sie Schaltflächen zur Ausführung von Befehlen oder zum Wechseln der Modi in der Anwendung in eine Tafel einfügen.


Eigenschaften von TCustomPanel

TCustomPanel	Alphabetisch	Legende

In TCustomPanel

Alignment

BevelInner

BevelOuter

BevelWidth

BorderStyle

BorderWidth

FullRepaint

Locked

Abgeleitet von TWinControl

Brush

ClientOrigin

ClientRect

ControlCount

Controls

Handle

HelpContext

Showing

TabOrder

TabStop

Abgeleitet von TControl

Align

BoundsRect

ClientHeight

ClientWidth

Color

ControlState

ControlStyle

Cursor

Enabled

Height

Hint

Left

Name

Parent

ParentColor

ShowHint

Top

Visible

Width

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TCustomPanel

TCustomPanel	Nach Objekten	Legende

Alignment

Align

BevelInner

BevelOuter

BevelWidth

BorderStyle

BorderWidth

BoundsRect

Brush

ClientHeight

ClientOrigin

ClientRect

ClientWidth

Color

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlCount

ControlState

Controls

ControlStyle

Cursor

DesignInfo

Enabled

FullRepaint

Handle

Height

HelpContext

Hint

Left

Locked

Name

Owner

ParentColor

Parent

ShowHint

Showing

TabOrder

TabStop

Tag

Top

Visible

Width


TCustomPanel::Alignment

TCustomPanel	Siehe auch

Die Eigenschaft Alignment legt fest, wie der Titel in der Tafel ausgerichtet wird.

__property Classes::TAlignment Alignment;

Beschreibung

Mit Hilfe der Eigenschaft Alignment legen Sie fest, ob der Titel linksbündig, rechtsbündig oder zentriert in der Tafel angezeigt wird. Wenn Sie zum Beispiel eine Tafel als Statusleiste verwenden und der Eigenschaft Caption die Eigenschaft TApplication::Hint zuweisen, können Sie Alignment auf taLeftJustify setzen, um den Hinweistext auf der linken Seite der Tafel zu plazieren.

Folgende Werte stehen für die Eigenschaft Alignment zur Verfügung:

Wert	Bedeutung

taLeftJustify	Richtet den Text linksbündig in der Tafel aus.

taCenter	Zentriert den Text horizontal in der Tafel.

taRightJustify	Richtet den Text rechtsbündig in der Tafel aus.


TCustomPanel::BevelInner

TCustomPanel	Siehe auch	Beispiel

Die Eigenschaft BevelInner bestimmt den Stil der inneren Schrägkante einer Tafel.

__property TPanelBevel BevelInner;

Beschreibung

Mit Hilfe der Eigenschaft BevelInner können Sie der Tafel ein dreidimensionales Aussehen verleihen.

Eine Tafelkomponente besitzt zwei Schrägkanten. Die äußere Schrägkante befindet sich am Rahmen des Steuerelements. Innerhalb der äußeren Schrägkante befindet sich die innere Schrägkante. Der Abstand zwischen den beiden Kanten wird mit der Eigenschaft BorderWidth in Pixel angegeben. Wenn Schrägkanten gezeichnet werden, wird ihre Breite mit der Eigenschaft BevelWidth festgelegt.

Die Eigenschaft BevelInner legt den Stil der inneren Kante einer Tafelkomponente fest. Folgende Werte stehen für die Eigenschaft BevelInner zur Verfügung:

Wert	Bedeutung

bvNone	Es existiert keine innere Schrägkante.

bvLowered	Die innere Schrägkante wird abgesenkt.

bvRaised	Die innere Schrägkante wird erhöht.


TCustomPanel::BevelOuter

TCustomPanel	Siehe auch	Beispiel

Die Eigenschaft BevelOuter bestimmt den Stil der äußeren Schrägkante einer Tafel.

__property TPanelBevel BevelOuter;

Beschreibung

Mit Hilfe der Eigenschaft BevelOuter können Sie der Tafel ein dreidimensionales Aussehen verleihen.

Eine Tafelkomponente besitzt zwei Schrägkanten. Die äußere Schrägkante wird neben dem Rahmen des Steuerelements gezeichnet. Innerhalb der äußeren Schrägkante befindet sich die innere Schrägkante. Der Abstand zwischen den beiden Kanten wird in der Eigenschaft BorderWidth in Pixel angegeben. Die Breite der äußeren Schrägkante wird in der Eigenschaft BevelWidth in Pixel angegeben.

Folgende Werte stehen für die Eigenschaft BevelOuter zur Verfügung:

Wert	Bedeutung

bvNone	Es existiert keine äußere Schrägkante.

bvLowered	Die äußere Schrägkante wird abgesenkt.

bvRaised	Die äußere Schrägkante wird erhöht.


TCustomPanel::BevelWidth

TCustomPanel	Siehe auch	Beispiel

Die Eigenschaft BevelWidth legt die Gesamtbreite für die innere und äußere Schrägkante einer Tafel in Pixel fest.

__property TBevelWidth BevelWidth;

Beschreibung

Mit Hilfe von BevelWidth geben Sie die Breite an, die die innere und die äußere Schrägkante zusammen besitzen. Verwechseln Sie BevelWidth nicht mit der Eigenschaft BorderWidth. BevelWidth legt die Breite der Schrägkanten fest, während BorderWidth den Abstand zwischen den Schrägkanten angibt.

Wenn für die Eigenschaften BevelInner und BevelOuter byNone festgelegt ist, hat BevelWidth keine Auswirkung. Wenn beide Schrägkanten entfernt werden sollen, setzen Sie die Eigenschaften BevelInner und BevelOuter jeweils auf byNone. Setzen Sie BevelWidth zu diesem Zweck nicht auf 0, da dies beim Zeichnen einen größeren Rechenaufwand verursacht.


TCustomPanel::BorderStyle

TCustomPanel	Siehe auch	Beispiel

Mit der Eigenschaft BorderStyle bestimmen Sie den Stil der Linie, die um die Tafel gezeichnet wird.

__property Forms::TBorderStyle BorderStyle;

Beschreibung

Mit der Eigenschaft BorderStyle legen Sie den Stil für den Rahmen der Tafel fest. Sie haben die Wahl zwischen keiner Linie und einer einfachen Linie. Wenn BorderStyle auf bsSingle gesetzt wird, wird außerhalb der äußeren Schrägkante eine einfache Linie um die Tafel gezeichnet. Folgende Werte stehen für die Eigenschaft BorderStyle zur Verfügung:

Wert	Bedeutung

bsNone	Kein sichtbarer Rahmen.

bsSingle	Rahmen aus einer Linie.

Die Linie, die mit BorderStyle um die Tafel gezeichnet wird, ist nicht mit der Eigenschaft BorderWidth für die Tafel zu verwechseln. BorderWidth legt den Abstand zwischen der äußeren und der inneren Schrägkante für die Tafel fest.


TCustomPanel::BorderWidth

TCustomPanel	Siehe auch	Beispiel

Die Eigenschaft BorderWidth gibt den Abstand zwischen der äußeren und der inneren Schrägkante in Pixel an.

__property TBorderWidth BorderWidth;

Beschreibung

Mit der Eigenschaft BorderWidth legen Sie fest, wie breit der Rahmen um die Tafel sein soll. Die Angabe der Breite erfolgt in Pixel. Der Wert 0 bedeutet, daß kein Rahmen angezeigt wird.

Der Rahmen einer Tafel ist der Bereich zwischen der äußeren und der inneren Schrägkante. Er ist nur sichtbar, wenn die innere Schrägkante erhöht oder abgesenkt wird. Der Rahmen wirkt sich immer auf die Position des Titels in der Tafel aus, auch wenn BevelInner auf byNone gesetzt wird. Wenn Sie für die Eigenschaft Alignment nicht taCenter festlegen, wird der Titel (Eigenschaft Caption) am inneren Rand des Rahmens ausgerichtet. Wenn BevelInner auf byNone gesetzt wird, ist der innere Rand um den in BorderWidth angegeben Pixelbetrag von der äußeren Schrägkante entfernt. Andernfalls ist der innere Rand mit der Innenkante der äußeren Schrägkante identisch.

Der Rahmen der Tafel ist nicht mit der Linie zu verwechseln, die um die Tafel gezeichnet und mit der Eigenschaft BorderStyle festgelegt wird.


TCustomPanel::FullRepaint

TCustomPanel	Siehe auch

Die Eigenschaft FullRepaint bestimmt, ob die Methode Invalidate aufgerufen wird, wenn die benutzerdefinierte Tafel eine WM_SIZE-Botschaft empfängt.

__property bool FullRepaint;

Beschreibung

Setzen Sie FullRepaint auf True, wenn die Tafel und alle darin enthaltenen Steuerelemente bei einer Größenänderung der Tafel neu gezeichnet werden sollen. Wenn FullRepaint den Wert False hat, wird die Tafel mit ihren Steuerelementen nicht neu gezeichnet.


TCustomPanel::Locked

TCustomPanel	Siehe auch

Die Eigenschaft Locked legt fest, ob eine Tafel, die als Werkzeugleiste eingesetzt wird, durch die Werkzeugleiste des OLE-Objekt-Servers ersetzt wird.

__property bool Locked;

Beschreibung

Setzen Sie die Eigenschaft Locked auf False, wenn die Tafel von einer TOleContainer-Komponente als Werkzeugleiste verwendet wird. Wenn die Eigenschaft Locked nicht den Wert True hat, gelten alle Tafeln, die an einem TOleContainer ausgerichtet sind, als austauschbare Werkzeugleisten. Indem Sie die Eigenschaft Locked der Tafel auf True setzen, verhindern Sie, daß sie durch die Werkzeugleiste eines OLE-Servers ersetzt wird.

Hinweis

Die Werkzeugleisten einer Anwendung müssen in Tafeln erstellt werden, die an einer Seite des Formulars ausgerichtet sind. Die Eigenschaft Align einer Werkzeugleistentafel muß somit auf alTop, alBottom, alLeft oder alRight gesetzt werden.


Ereignisse von TCustomPanel

TCustomPanel	Alphabetisch	Legende

In TCustomPanel

OnResize


Ereignisse von TCustomPanel

TCustomPanel	Nach Objekten	Legende

OnResize


TCustomPanel::OnResize

TCustomPanel	Siehe auch

Das Ereignis OnResize tritt ein, wenn die Größe der Tafel während der Ausführung einer Anwendung geändert wird.

__property Classes::TNotifyEvent OnResize;

Beschreibung

Mit der Ereignisbehandlungsroutine für OnResize können Sie eine Aktion festlegen, die bei einer Größenänderung der Tafel stattfindet. Beispielsweise kann es sinnvoll sein, die untergeordneten Steuerelemente der Tafel nach einer Größenänderung neu anzuordnen.


Methoden von TCustomPanel

TCustomPanel	Alphabetisch	Legende

In TCustomPanel

~TCustomPanel

AlignControls

CreateParams

Paint

Resize

TCustomPanel

Abgeleitet von TWinControl

Broadcast

CanFocus

ContainsControl

ControlAtPos

DisableAlign

EnableAlign

Focused

GetTabOrderList

HandleAllocated

HandleNeeded

InsertControl

Invalidate

PaintTo

Realign

RemoveControl

Repaint

ScaleBy

ScrollBy

SetBounds

SetFocus

Update

UpdateControlState

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

GetTextLen

Hide

Perform

Refresh

ScreenToClient

SendToBack

SetTextBuf

Show

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TCustomPanel

TCustomPanel	Nach Objekten	Legende

~TCustomPanel

AlignControls

Assign

BeginDrag

BringToFront

Broadcast

CanFocus

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

ClientToScreen

ContainsControl

ControlAtPos

CreateParams

DefaultHandler

DestroyComponents

Destroying

DisableAlign

Dispatch

DragDrop

Dragging

EnableAlign

EndDrag

FieldAddress

FindComponent

Focused

FreeInstance

FreeNotification

Free

GetParentComponent

GetTabOrderList

GetTextBuf

GetTextLen

HandleAllocated

HandleNeeded

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InsertControl

InstanceSize

Invalidate

MethodAddress

MethodName

NewInstance

Paint

PaintTo

Perform

Realign

Refresh

RemoveComponent

RemoveControl

Repaint

Resize

ScaleBy

ScreenToClient

ScrollBy

SendToBack

SetBounds

SetFocus

SetTextBuf

Show

TCustomPanel

UpdateControlState

Update


TCustomPanel::~TCustomPanel

TCustomPanel

Der Destruktor ~TCustomPanel gibt den Speicher frei, der für das TCustomPanel-Objekt reserviert war. Rufen Sie ~TCustomPanel nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TCustomPanel automatisch aufgerufen wird.

__fastcall virtual ~TCustomPanel(void);


TCustomPanel::AlignControls

TCustomPanel	Siehe auch

Mit der Methode AlignControls werden die Steuerelemente ausgerichtet, die in der Tafel enthalten sind.

virtual void __fastcall AlignControls(Controls::TControl* AControl, Windows::TRect &Rect);

Beschreibung

Durch einen Aufruf von AlignControls können alle Steuerelemente in der Tafel gleichzeitig ausgerichtet werden. Den Bereich, in dem die Steuerelemente ausgerichtet werden sollen, legen Sie mit dem Wert des Parameters Rect fest.

AlignControls legt mit Hilfe der Eigenschaft Align die Ausrichtung jedes untergeordneten Steuerelements fest. Der Parameter AControl kann NULL sein. Wenn Sie in AControl ein Steuerelement angeben, hat die Ausrichtung dieses Elements Vorrang vor der Ausrichtung anderer, gleich ausgerichteter Steuerelemente.


TCustomPanel::CreateParams

TCustomPanel	Siehe auch

Die Methode CreateParams initialisiert einen Datensatz mit Parametern zur Fenstererstellung, der im Parameter Params übergeben wird.

virtual void __fastcall CreateParams(Controls::TCreateParams &Params);

Beschreibung

Die Methode CreateWnd ruft CreateParams zur Initialisierung der Parameter auf, die an CreateWindowHandle übergeben werden. Durch Überschreiben von CreateParams können Sie die Windows-Repräsentation einer benutzerdefinierten Tafel anpassen. Beim Überschreiben von CreateParams muß immer die geerbte Methode zuerst aufgerufen werden, um die Vorgabewerte festzulegen. Anschließend können Sie die gewünschten Anpassungen vornehmen. Die überschreibende Methode muß die Felder des Params-Datensatzes angeben, die als Parameter für den Aufruf der API-Funktion CreateWindowEx verwendet werden sollen.


TCustomPanel::Paint

TCustomPanel	Siehe auch

Die Methode Paint erstellt das Bild für eine Tafel.

virtual void __fastcall Paint(void);

Beschreibung

Durch Überschreiben der Methode Paint können Sie die Art und Weise ändern, in der die Tafel gezeichnet wird. Die Paint-Methode für eine benutzerdefinierte Tafel zeichnet deren Schrägkanten, legt den Pinsel, die Schriftart und die Tafel fest. Anschließend ruft sie die Windows-API-Funktion DrawText auf, um den Titel (Eigenschaft Caption) zu zeichnen.


TCustomPanel::Resize

TCustomPanel	Siehe auch

Resize ist die Methode zur Protected-Implementierung für das OnResize-Ereignis einer benutzerdefinierten Tafel.

virtual void __fastcall Resize(void);

Beschreibung

Durch Überschreiben von Resize können Sie weitere Reaktionen definieren, die zusätzlich zum Aufruf der Ereignisbehandlungsroutine für OnResize erfolgen. Das benutzerdefinierte Steuerelement ruft Resize als Reaktion der WM_SIZE-Botschaft auf, die eine Größenänderung des Steuerelements oder des Formulars anzeigt.

Wenn die Eigenschaft FullRepaint den Wert True hat, kennzeichnet Resize die Tafel als ungültig und ruft anschließend die Methode auf, die dem Ereignis OnResize zugewiesen ist (falls eine solche vorhanden ist).


TCustomPanel::TCustomPanel

TCustomPanel	Siehe auch

Der Konstruktor TCustomPanel erzeugt ein neues TCustomPanel-Objekt.

__fastcall virtual TCustomPanel(Classes::TComponent* AOwner);

Beschreibung

Die Methode TCustomPanel erzeugt und initialisiert eine Instanz von TCustomPanel und fügt sie in das übergeordnete Objekt ein (Parameter AOwner), indem dessen Methode InsertComponent aufgerufen wird.

Nach dem Aufruf des geerbten Konstruktors initialisiert TCustomPanel die folgenden Eigenschaften:

Eigenschaft	Wert

Alignment	taCenter

BevelOuter	bvRaised

BevelWidth	1

BorderStyle	bsNone

Color	BtnFace

ControlStyle	[csAcceptsControls, csCaptureMouse, csClickEvents, csOpaque, csSetCaption, csDoubleClick, cdReplicatable]

FullRepaint	True

Height	41

Width	185


Gültigkeitsbereich

Protected

Published

Zugriff

Read-only


Gültigkeitsbereich

Protected


Gültigkeitsbereich

Protected


Hierarchie

TObject

TPersistent

TComponent

TControl

TWinControl

TCustomControl


TCustomPanel Beispiel

TCustomPanel


TCustomRadioGroup

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/extctrls.hpp

TCustomRadioGroup ist die Basisklasse für Optionsfeldgruppen-Komponenten.

Beschreibung

Eine Optionsfeldgruppe besteht aus Optionsfeldern, die in einem Gruppenfeld zusammengefaßt sind. TCustomRadioGroup ist die abstrakte Klasse, von der alle Optionsfeldgruppen-Komponente einschließlich TRadioGroup und TDBRadioGroup abgeleitet sind.

Optionsfelder heißen „gruppiert“, wenn sie sich in derselben Steuerelementkomponente befinden. Markiert der Benutzer ein Optionsfeld, wird die Markierung von allen anderen Optionsfeldern dieser Gruppe entfernt. Aus diesen Grund können in einem Formular nur dann zwei Optionsfelder gleichzeitig markiert sein, wenn sie sich in verschiedenen Containern (z.B. in unterschiedlichen Gruppenfeldern) befinden.


Eigenschaften von TCustomRadioGroup

TCustomRadioGroup	Alphabetisch	Legende

In TCustomRadioGroup

Columns

ItemIndex

Items

Abgleitet von TWinControl

Brush

ClientOrigin

ClientRect

ControlCount

Controls

Handle

HelpContext

Showing

TabOrder

TabStop

Abgleitet von TControl

Align

BoundsRect

ClientHeight

ClientWidth

ControlState

ControlStyle

Cursor

Enabled

Height

Hint

Left

Name

Parent

ShowHint

Top

Visible

Width

Abgleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TCustomRadioGroup

TCustomRadioGroup	Nach Objekten	Legende

Align

BoundsRect

Brush

ClientHeight

ClientOrigin

ClientRect

ClientWidth

Columns

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlCount

ControlState

Controls

ControlStyle

Cursor

DesignInfo

Enabled

Handle

Height

HelpContext

Hint

ItemIndex

Items

Left

Name

Owner

Parent

ShowHint

Showing

TabOrder

TabStop

Tag

Top

Visible

Width


TCustomRadioGroup::Columns

TCustomRadioGroup

Die Eigenschaft Columns legt die Anzahl der Spalten in einer Optionsfeldgruppe fest.

__property int Columns;

Beschreibung

Die Eigenschaft Columns bestimmt die Anzahl der Spalten, die in einer Optionsfeldgruppe enthalten sind. Es kann ein Wert zwischen 1 und 16 angegeben werden. Voreingestellt ist der Wert 1, der die Optionsfelder untereinander in einer einzelnen Spalte gruppiert.


TCustomRadioGroup::ItemIndex

TCustomRadioGroup	Beispiel

Die Eigenschaft ItemIndex gibt das Optionsfeld an, das aktuell in der Gruppe markiert ist.

__property int ItemIndex;

Beschreibung

ItemIndex enthält die Ordinalzahl des Optionsfeldes, das in der Items-Liste markiert ist. (Das erste Feld hat den Wert 0.) Wenn der Benutzer zur Laufzeit Optionsfelder markiert, ändert sich der Wert von ItemIndex entsprechend. Soll nach dem Start der Anwendung bereits ein bestimmtes Optionsfeld markiert sein, weisen Sie das betreffende Feld während der Anwendungsentwicklung ItemIndex zu. Verwenden Sie andernfalls die Voreinstellung für ItemIndex (-1). In diesem Fall ist kein Optionsfeld markiert


TCustomRadioGroup::Items

TCustomRadioGroup	Siehe auch

Die Eigenschaft Items enthält eine Liste der Optionsfelder in der Optionsfeldgruppe.

__property Classes::TStrings* Items;

Beschreibung

Items enthält ein TString-Objekt mit den Titeln aller Optionsfelder in der Gruppe. Wenn in den TCustomRadioGroup-Nachkommen TRadioGroup und TDBRadioGroup diese Eigenschaft als publish deklariert wird, können Optionsfelder durch eine Bearbeitung der Items-Liste im Objektinspektor hinzugefügt oder entfernt werden.

Hinweis

Die Einträge in einem Optionsfeldgruppenobjekt sind spezielle Instanzen von TRadioButton, die von TCustomRadioGroup erzeugt wurden. TRadioButton-Instanzen, die unabhängig erzeugt wurden, können nicht in eine Optionsfeldgruppe aufgenommen werden.


Methoden von TCustomRadioGroup

TCustomRadioGroup	Alphabetisch	Legende

In TCustomRadioGroup

~TCustomRadioGroup

CanModify

GetChildren

ReadState

TCustomRadioGroup

Abgeleitet von TWinControl

Broadcast

CanFocus

ContainsControl

ControlAtPos

DisableAlign

EnableAlign

Focused

GetTabOrderList

HandleAllocated

HandleNeeded

InsertControl

Invalidate

PaintTo

Realign

RemoveControl

Repaint

ScaleBy

ScrollBy

SetBounds

SetFocus

Update

UpdateControlState

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

GetTextLen

Hide

Perform

Refresh

ScreenToClient

SendToBack

SetTextBuf

Show

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TCustomRadioGroup

TCustomRadioGroup	Nach Objekten	Legende

~TCustomRadioGroup

Assign

BeginDrag

BringToFront

Broadcast

CanFocus

CanModify

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

ClientToScreen

ContainsControl

ControlAtPos

DefaultHandler

DestroyComponents

Destroying

DisableAlign

Dispatch

DragDrop

Dragging

EnableAlign

EndDrag

FieldAddress

FindComponent

Focused

FreeInstance

FreeNotification

Free

GetChildren

GetParentComponent

GetTabOrderList

GetTextBuf

GetTextLen

HandleAllocated

HandleNeeded

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InsertControl

InstanceSize

Invalidate

MethodAddress

MethodName

NewInstance

PaintTo

Perform

ReadState

Realign

Refresh

RemoveComponent

RemoveControl

Repaint

ScaleBy

ScreenToClient

ScrollBy

SendToBack

SetBounds

SetFocus

SetTextBuf

Show

TCustomRadioGroup

UpdateControlState

Update


TCustomRadioGroup::~TCustomRadioGroup

TCustomRadioGroup

Der Destruktor ~TCustomRadioGroup gibt den Speicher frei, der für das TCustomRadioGroup-Objekt reserviert war. Rufen Sie ~TCustomRadioGroup nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TCustomRadioGroup automatisch aufgerufen wird.

__fastcall virtual ~TCustomRadioGroup(void);

Beschreibung

~TCustomRadioGroup gibt für jedes Element der Gruppe den reservierten Speicher frei und ruft anschließend den Destruktor des übergeordneten Objekts auf.


TCustomRadioGroup::CanModify

TCustomRadioGroup	Siehe auch

Diese Methode legt fest, ob der Benutzer ein anderes Optionsfeld der Gruppe markieren kann.

virtual bool __fastcall CanModify(void);

Beschreibung

Ereignisbehandlungsroutinen überprüfen durch einen Aufruf von CanModify, ob der Benutzer ein anderes Optionsfeld in der Gruppe markieren kann. Entsprechend der Definition in TCustomRadioGroup liefert CanModify immer True zurück. Soll dem Benutzer die Markierung eines anderen Optionsfeldes verwehrt werden, können Sie diese Methode überschreiben, damit sie False zurückgibt.


TCustomRadioGroup::GetChildren

TCustomRadioGroup	Siehe auch

Die Methode GetChildren für TCustomRadioGroup ist nicht lauffähig.

virtual void __fastcall GetChildren(Classes::TGetChildProc Proc);

Beschreibung

TCustomRadioGroup überschreibt TWinControl, um die Methode GetChildren zu deaktivieren.


TCustomRadioGroup::ReadState

TCustomRadioGroup	Siehe auch

Liest die Daten der Optionsfeldgruppe aus einem Stream.

virtual void __fastcall ReadState(Classes::TReader* Reader);

Beschreibung

ReadState liest durch einen Aufruf der geerbten Methode ReadState die als published deklarierten Eigenschaften der Optionsfeldgruppe sowie weitere gespeicherte Daten in ein Reader-Objekt ein. Anschließend werden die Optionsfelder der Gruppe neu gezeichnet.


TCustomRadioGroup::TCustomRadioGroup

TCustomRadioGroup	Siehe auch

Der Konstruktor TCustomRadioGroup erzeugt ein neues TCustomRadioGroup-Objekt.

__fastcall virtual TCustomRadioGroup(Classes::TComponent* AOwner);

Beschreibung

TCustomRadioGroup ruft den Konstruktor des übergeordneten Objekts auf und initialisiert die Eigenschaften des TCustomRadioGroup-Objekts. In der Eigenschaft ControlStyle werden die Flags csSetCaption und csDoubleClicks gesetzt.


Gültigkeitsbereich

Protected

Published

Zugriff

Read-only


Gültigkeitsbereich

Protected


Hierarchie

TObject

TPersistent

TComponent

TControl

TWinControl

TCustomControl

TCustomGroupBox


TCustomRadioGroup Beispiel

TCustomRadioGroup


TCustomRichEdit

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/comctrls.hpp

TCustomRichEdit ist der abstrakte Basistyp für RTF-Eingabefelder wie TRichEdit.

Beschreibung

TCustomRichEdit verfügt über neue Eigenschaften und Methoden, um die Funktionsweise der Klasse TCustomMemo in Hinsicht auf das Rich Text Format (RTF) zu erweitern.

Erstellen Sie keine direkten Instanzen von TCustomRichEdit. Verwenden Sie TCustomRichEdit als Basisklasse für das Deklarieren von Steuerobjekten, die das Rich Text Format in einem Eingabefeld implementieren. Die Eigenschaften und Methoden von TCustomRichEdit stellen grundlegende Funktionsweisen bereit, die von den abgeleiteten Klassen geerbt werden, sowie Funktionsweisen, die von den Komponenten überschrieben werden können, um ihr Verhalten anzupassen.


Eigenschaften von TCustomRichEdit

TCustomRichEdit	Alphabetisch	Legende

In TCustomRichEdit

DefAttributes

DefaultConverter

HideScrollBars

HideSelection

Lines

PageRect

Paragraph

PlainText

SelAttributes

Abgeleitet von TCustomEdit

Modified

SelLength

SelStart

SelText

Abgeleitet von TWinControl

Brush

ClientOrigin

ClientRect

ControlCount

Controls

Handle

HelpContext

Showing

TabOrder

TabStop

Abgeleitet von TControl

Align

BoundsRect

ClientHeight

ClientWidth

ControlState

ControlStyle

Cursor

Enabled

Height

Hint

Left

Name

Parent

ShowHint

Text

Top

Visible

Width

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TCustomRichEdit

TCustomRichEdit	Nach Objekten	Legende

Align

BoundsRect

Brush

ClientHeight

ClientOrigin

ClientRect

ClientWidth

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlCount

ControlState

Controls

ControlStyle

Cursor

DefAttributes

DefaultConverter

DesignInfo

Enabled

Handle

Height

HelpContext

HideScrollBars

HideSelection

Hint

Left

Lines

Modified

Name

Owner

PageRect

Paragraph

Parent

PlainText

SelAttributes

SelLength

SelStart

SelText

ShowHint

Showing

TabOrder

TabStop

Tag

Text

Top

Visible

Width


TCustomRichEdit::DefAttributes

TCustomRichEdit	Siehe auch

DefAttributes ist ein TTextAttributes-Objekt, das die Rich Text-Attribute der Standardschrift des RTF-Eingabefeldes beschreibt.

__property TTextAttributes* DefAttributes;

Beschreibung

Mit Hilfe von DefAttributes können Sie die Attribute der Standardschrift abrufen oder ändern, die in einem RTF-Eingabefeld für neu eingefügten Text verwendet werden. Dies sind die Merkmale des Textes vor der Anwendung der speziellen Attribute. Nachdem spezielle Attribute für einen Teil des Textes verwendet wurden, gelten ab dieser Position die Standardattribute intern als nicht mehr für den Text definiert, auch wenn die Attribute mit DefAttributes übereinstimmen.

Sind beispielsweise in einem RTF-Eingabefeld noch keine speziellen Attribute verwendet worden, hat der gesamte Text die Standardattribute. Wird dann in der Mitte des Textes ein Bereich ausgewählt und mit einem bestimmten Attribut versehen (z.B. einer Schriftänderung), ergeben sich drei Bereiche: ein erster Abschnitt mit den Standardattributen, ein mittlerer Abschnitt mit den gewählten Attributen (der Schriftänderung) und ein letzter Abschnitt mit einem Nicht-Standardsatz von Attributen, die mit den Standardattributen übereinstimmen. Wird jetzt der Wert der Eigenschaft DefAttributes geändert, wirkt sich dies nur auf den ersten Abschnitt aus.

Wird neuer Text eingefügt, übernimmt dieser die Attribute an der Cursorposition bzw. die Attribute der Auswahl, falls durch die Eingabe markierter Text ersetzt wird. Der neue Text erhält nur die Standardattribute, wenn er in den Textabschnitt mit den Standardattributen eingegeben wird.

Hinweis

DefAttributes ist nur zur Laufzeit verfügbar.


TCustomRichEdit::DefaultConverter

TCustomRichEdit	Siehe auch

DefaultConverter ist die eigentliche Klasse des TConversion-Objekts, das bei der Arbeit mit Dateien ohne registrierte Namenserweiterung für das Konvertieren zwischen dem nativen Dateiformat und dem internen Format eines RTF-Steuerelements verwendet wird.

__property System::TMetaClass* DefaultConverter;

Beschreibung

Mit DefaultConverter kann festgelegt werden, wie der Text beim Lesen oder Schreiben von Dateien ohne registrierte Namenserweiterung konvertiert wird. Ist DefaultConverter nicht gesetzt, verwendet TCustomRichEdit ein TConversion-Objekt, das jedoch nicht die eigentliche Konvertierung durchführt. TCustomRichEdit codiert die Textattribute im Rich Text Format (RTF). Daher wird bei unbekannten Dateierweiterungen nicht die Konvertierung durchgeführt, die für Dateien verwendet wird, die einfachen Text oder eine Teilmenge des RTF-Formats enthalten.

Um das Lesen oder Schreiben von Dateien zu unterstützen, die RTF-Attribute in einem anderen Format codieren, registrieren Sie das entsprechende Konvertierungsformat für die betreffende Dateierweiterung. Verwenden Sie DefaultConverter nur für das Ändern der Konvertierung, die für nicht registrierte Dateierweiterungen eingesetzt wird.

Hinweis

Verwenden Sie die Eigenschaft Lines, um den Text in eine Datei zu schreiben bzw. aus der Datei zu lesen.


TCustomRichEdit::HideScrollBars

TCustomRichEdit	Siehe auch

Die Eigenschaft HideScrollBars bestimmt, ob die nicht benötigten Bildlaufleisten ausgeblendet werden.

__property bool HideScrollBars;

Beschreibung

Mit HideScrollBars kann bestimmt werden, ob die Bildlaufleisten ausgeblendet werden, wenn der Text vollständig im Eingabefenster angezeigt werden kann. Setzen Sie HideScrollBars auf False, um zu verhindern, daß die Bildlaufleisten bei Änderungen des Inhalts des Steuerelements ständig ein- und ausgeblendet werden.

HideScrollBars führt keine Aktion durch, wenn die Eigenschaft ScrollBars den Wert ssNone (Standardeinstellung für TRichEdit) hat.


TCustomRichEdit::HideSelection

TCustomRichEdit	Siehe auch	Beispiel

Die Eigenschaft HideSelection bestimmt, ob die aktuelle Auswahl sichtbar bleibt, wenn der Fokus zu einem anderen Steuerelement wechselt.

__property bool HideSelection;

Beschreibung

Soll der ausgewählte Text sichtbar bleiben, selbst wenn das Eingabefeld nicht den Fokus hat, setzen Sie HideSelection auf False. Hat HideSelection den Wert True, wird die Markierung nur angezeigt, wenn das Steuerelement den Fokus hat. HideSelection wirkt sich nicht auf den eigentlichen Wert der Auswahl aus, sondern nur auf die sichtbare Anzeige. Wird HideSelection immer auf False gesetzt, wirkt ein Formular mit vielen Steuerelementen sehr unübersichtlich.


TCustomRichEdit::Lines

TCustomRichEdit	Siehe auch

Die Eigenschaft Lines enthält die einzelnen Textzeilen des RTF-Eingabefeldes.

__property Classes::TStrings* Lines;

Beschreibung

Mit Hilfe von Lines kann der Text in einem Eingabefeld zeilenweise bearbeitet werden. Lines ist ein TStrings-Objekt, so daß die TStrings-Methoden für Lines verwendet werden können, um Bearbeitungen wie Zählen der Textzeilen sowie Hinzufügen, Löschen und Ersetzen von Zeilen durchzuführen.

Um den gesamten Text zu bearbeiten, verwenden Sie die Eigenschaft Text. Lines ist jedoch für die Bearbeitung einzelner Zeilen besser geeignet.


TCustomRichEdit::PageRect

TCustomRichEdit	Siehe auch

Die Eigenschaft PageRect legt die Maße (in Twips) der logischen Seitengröße fest, die beim Drucken des im Rich Text-Steuerelements enthaltenen Textes verwendet wird.

__property Windows::TRect PageRect;

Beschreibung

Mit PageRect kann die logische Seitengröße angegeben werden, die beim Formatieren des Inhalts eines RTF-Steuerelements für den Ausdruck verwendet wird. Die Maßangabe erfolgt in Twips (1/20 eines Punktes).


TCustomRichEdit::Paragraph

TCustomRichEdit	Siehe auch 	Beispiel

Die Eigenschaft Paragraph gibt die Formatierungsinformationen des aktuellen Absatzes an.

__property TParaAttributes* Paragraph;

Beschreibung

Mit Hilfe der Eigenschaft Paragraph kann auf das TParaAttributes-Objekt zugegriffen werden, das die absatzbezogenen Formatierungsinformationen des Steuerelements enthält. Das Objekt kann verwendet werden, um die Formatierungsinformationen des aktuellen Absatzes zu lesen oder zu schreiben. Zu diesen Informationen gehören Ausrichtung, Einrückung und Tabulatoren.

Die Eigenschaft Paragraph kann nur gelesen werden, da ein TCustomRichEdit-Objekt nur über ein TParaAttributes-Objekt verfügt, das nicht geändert werden kann. Die Attribute des aktuellen Absatzes können jedoch mit Hilfe der Eigenschaften des TParaAttributes-Objekts geändert werden. Die Attribute können mit Paragraph.Assign einzeln zugewiesen oder zusammen auf den Wert eines vorhandenen TParaAttributes-Objekt gesetzt werden.

Die aktuellen Absätze sind diejenigen, die den ausgewählten Text enthalten. Ist kein Text markiert, ist der aktuelle Absatz derjenige, der den Cursor enthält.

Hinweis

Paragraph ist nur zur Laufzeit verfügbar.


TCustomRichEdit::PlainText

TCustomRichEdit	Siehe auch

Die Eigenschaft PlainText gibt an, ob das Steuerelement den Text beim Lesen oder Schreiben einer Datei als normalen Text oder als Rich Text behandelt.

__property bool PlainText;

Beschreibung

Soll der im Steuerelement enthaltene Text im RTF-Format in eine normale Textdatei geschrieben werden, muß die Eigenschaft PlainText vor der Schreiboperation auf True gesetzt werden. Um die in einer Datei enthaltenen RFT-Informationen zu ignorieren, muß die Eigenschaft vor dem Einlesen der Datei in das Steuerelement ebenfalls auf True gesetzt werden. Sollen die RTF-Attribute beim Lesen oder Schreiben einer Datei erhalten bleiben, setzen Sie PlainText auf False.

Sind die Rich Text-Attribute einer Datei in einem anderen Format als RTF gespeichert, muß der Text konvertiert werden, auch wenn PlainText den Wert True hat.

Hinweis

RTF-Eingabefelder unterstützen kein direktes Lesen oder Schreiben einer Datei. Verwenden Sie dazu die Eigenschaft Lines.


TCustomRichEdit::SelAttributes

TCustomRichEdit	Siehe auch

Die Eigenschaft SelAttributes ist ein TTextAttributes-Objekt, das die RTF-Attribute des im Rich Text-Steuerelement ausgewählten Textes beschreibt.

__property TTextAttributes* SelAttributes;

Beschreibung

Mit Hilfe von SelAttributes können die Schriftattribute des ausgewählten Textes gelesen oder geändert werden. SelAttributes ist ein TTextAttributes-Objekt, das Informationen, wie Schriftart, Farbe, Schriftgrad und Schriftauszeichnung, angibt. Um ein einzelnes Attribut zu ändern, lesen Sie SelAttributes und setzen dann die entsprechende Eigenschaft. Sollen alle Attribute der aktuellen Auswahl geändert werden, setzen Sie SelAttributes auf ein TTextAttributes-Objekt mit der gewünschten Konfiguration. Ist kein Text ausgewählt, enthält SelAttributes die Attribute der aktuellen Cursorposition.

Neu eingegebener Text erhält automatisch die in SelAttributes gespeicherten Schriftattribute.

Hinweis

SelAttributes ist nur zur Laufzeit verfügbar.


Ereignisse von TCustomRichEdit

TCustomRichEdit	Alphabetisch	Legende

In TCustomRichEdit

OnProtectChange

OnResizeRequest

OnSaveClipboard

OnSelectionChange


Ereignisse von TCustomRichEdit

TCustomRichEdit	Nach Objekten	Legende

OnProtectChange

OnResizeRequest

OnSaveClipboard

OnSelectionChange


TCustomRichEdit::OnProtectChange

TCustomRichEdit	Siehe auch

Das Ereignis OnProtectChange wird ausgelöst, sobald ein Benutzer versucht, als geschützt gekennzeichneten Text zu bearbeiten.

typedef void __fastcall (__closure *TRichEditProtectChange)(System::TObject* Sender, int StartPos, int EndPos, bool &AllowChange);

__property TRichEditProtectChange OnProtectChange;

Beschreibung

Schreiben Sie eine Ereignisbehandlungsroutine für OnProtectChange, um die Änderung des geschützten Textes zu ermöglichen. Die Parameter StartPos und EndPos geben Anfang und Ende des von der Änderung betroffenen Textbereichs an (0 ist das erste Zeichen im Text). Um die Änderung des geschützten Textes zu ermöglichen, setzen Sie AllowChange auf True.

Um einen bestimmten Textbereich zu schützen bzw. den Schutz aufzuheben, markieren Sie zuerst den gewünschten Text und verwenden dann die Eigenschaft Protected der Eigenschaft SelAttributes des Steuerelements. Soll Text standardmäßig geschützt sein, verwenden Sie die Eigenschaft Protected der Eigenschaft DefAttributes des Rich Text-Steuerelements.


TCustomRichEdit::OnResizeRequest

TCustomRichEdit	Siehe auch	Beispiel

Das Ereignis OnResizeRequest wird ausgelöst, sobald der Text größer oder kleiner als die aktuelle Fenstergröße des Steuerelements geworden ist.

typedef void __fastcall (__closure *TRichEditResizeEvent)(System::TObject* Sender, const Windows::TRect &Rect);

__property TRichEditResizeEvent OnResizeRequest;

Beschreibung

Schreiben Sie eine Ereignisbehandlungsroutine für OnResizeRequest, um auf die Benachrichtigung zu reagieren, daß das Steuerelement seine Größe entsprechend des geänderten Textvolumens anpassen wird. Der Parameter Rect gibt die Größe des gewünschten Begrenzungsrechtecks in Bildschirmkoordinaten an, in dem der gesamte Text angezeigt werden kann.


TCustomRichEdit::OnSaveClipboard

TCustomRichEdit	Siehe auch

Das Ereignis OnSaveClipboard wird ausgelöst, wenn das Fenster eines Steuerelements freigegeben werden soll und sich noch Informationen des Eingabefeldes in der Zwischenablage befinden.

typedef void __fastcall (__closure *TRichEditSaveClipboard)(System::TObject* Sender, int NumObjects, int NumChars, bool &SaveClipboard);

__property TRichEditSaveClipboard OnSaveClipboard;

Beschreibung

Schreiben Sie eine Ereignisbehandlunsgroutine für OnSaveClipboard, um auf die Benachrichtigung zu reagieren, daß das Fenster des Steuerelements aus dem Speicher freigegeben werden soll und sich noch Informationen des Eingabefeldes in der Zwischenablage befinden. Der Parameter NumObjects gibt die Anzahl der Objekte und NumChars die Anzahl der Zeichen in der Zwischenablage an. Um alle aus dem Steuerelement in die Zwischenablage kopierten Informationen zu löschen, setzen Sie SaveClipboard auf False.


TCustomRichEdit::OnSelectionChange

TCustomRichEdit	Siehe auch

Das Ereignis OnSelectionChange wird bei jeder Änderung der aktuellen Textauswahl ausgelöst.

typedef void __fastcall (__closure *TNotifyEvent)(System::TObject* Sender);

__property Classes::TNotifyEvent OnSelectionChange;

Beschreibung

Schreiben Sie eine Ereignisbehandlungsroutine für OnSelectionChange, um auf Änderungen der aktuellen Textauswahl zu reagieren. Diese Änderungen treten auf, sobald der Benutzer den markierten Text mit Hilfe der Maus bzw. Tastatur ändert oder die Auswahl durch die Eigenschaft SelText geändert wird. Bestimmte Teile der Auswahl können mit der Eigenschaft Lines geändert werden.


Methoden von TCustomRichEdit

TCustomRichEdit	Alphabetisch	Legende

In TCustomRichEdit

~TCustomRichEdit

CreateParams

CreateWnd

DestroyWnd

FindText

Print

RegisterConversionFormat

RequestSize

SelectionChange

TCustomRichEdit

Abgeleitet von TCustomEdit

Clear

ClearSelection

CopyToClipboard

CutToClipboard

GetSelTextBuf

PasteFromClipboard

SelectAll

SetSelTextBuf

Abgeleitet von TWinControl

Broadcast

CanFocus

ContainsControl

ControlAtPos

DisableAlign

EnableAlign

Focused

GetTabOrderList

HandleAllocated

HandleNeeded

InsertControl

Invalidate

PaintTo

Realign

RemoveControl

Repaint

ScaleBy

ScrollBy

SetBounds

SetFocus

Update

UpdateControlState

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

GetTextLen

Hide

Perform

Refresh

ScreenToClient

SendToBack

SetTextBuf

Show

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TCustomRichEdit

TCustomRichEdit	Nach Objekten	Legende

~TCustomRichEdit

Assign

BeginDrag

BringToFront

Broadcast

CanFocus

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

ClearSelection

Clear

ClientToScreen

ContainsControl

ControlAtPos

CopyToClipboard

CreateParams

CreateWnd

CutToClipboard

DefaultHandler

DestroyComponents

Destroying

DestroyWnd

DisableAlign

Dispatch

DragDrop

Dragging

EnableAlign

EndDrag

FieldAddress

FindComponent

FindText

Focused

FreeInstance

FreeNotification

Free

GetParentComponent

GetSelTextBuf

GetTabOrderList

GetTextBuf

GetTextLen

HandleAllocated

HandleNeeded

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InsertControl

InstanceSize

Invalidate

MethodAddress

MethodName

NewInstance

PaintTo

PasteFromClipboard

Perform

Print

Realign

Refresh

RegisterConversionFormat

RemoveComponent

RemoveControl

Repaint

RequestSize

ScaleBy

ScreenToClient

ScrollBy

SelectAll

SelectionChange

SendToBack

SetBounds

SetFocus

SetSelTextBuf

SetTextBuf

Show

TCustomRichEdit

UpdateControlState

Update


TCustomRichEdit::~TCustomRichEdit

TCustomRichEdit	Siehe auch

Der Destruktor ~TCustomRichEdit gibt den Speicher frei, der für das TCustomRichEdit-Objekt reserviert war. Rufen Sie ~TCustomRichEdit nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TCustomRichEdit automatisch aufgerufen wird.

__fastcall virtual ~TCustomRichEdit(void);


TCustomRichEdit::CreateParams

TCustomRichEdit	Siehe auch

CreateParams initialisiert den folgenden Datensatz mit für die Fenstererstellung benötigten Parametern, die in Params übergeben werden.

virtual void __fastcall CreateParams(Controls::TCreateParams &Params);

Beschreibung

Die Methode CreateWnd ruft CreateParams auf, um die Parameter zu initialisieren, die an CreateWindowHandle übergeben werden. TCustomRichEdit überschreibt die geerbte Methode, um ein Windows RTF-Eingabefeld zu erzeugen.


TCustomRichEdit::CreateWnd

TCustomRichEdit	Siehe auch

Die Methode CreateWnd erzeugt ein dem Eingabefeld entsprechendes Windows-Steuerelement.

virtual void __fastcall CreateWnd(void);

Beschreibung

CreateWnd wird beim Erstellen des RTF-Eingabefeldes aufgerufen und immer dann, wenn eine Änderung des Steuerelements ein Aktualisieren des Fensters erfordert. CreateWnd ruft zuerst die geerbte CreateWnd-Methode auf und sendet dann die neu erstellten Fensterbotschaften, um Benachrichtigungen bei Windows-Ereignissen anzufordern. Zuletzt wird der Rich Text aus einem Speicher-Stream erneut geladen, wenn das Fenster aktualisiert wird.


TCustomRichEdit::DestroyWnd

TCustomRichEdit	Siehe auch

Die Methode DestroyWnd gibt das Fenster-Handle des Rich Text-Steuerelements frei.

virtual void __fastcall DestroyWnd(void);

Beschreibung

Bevor das Fenster-Handle freigegeben wird, speichert DestroyWnd eine Kopie des im Steuerelement enthaltenen Textes in einem Speicher-Stream, gibt alle Gerätekontexte frei und ruft dann DestroyWindowHandle auf.


TCustomRichEdit::FindText

TCustomRichEdit	Siehe auch

Die Methode FindText durchsucht einen gegebenen Textbereich nach einem bestimmten String.

int __fastcall FindText(const System::AnsiString SearchStr, int StartPos, int Length,  TSearchTypes  Options);

Beschreibung

Mit Hilfe von FindText kann in einem Textbereich eines Rich Text-Steuerelements nach einem String gesucht werden. Die Suchoperation beginnt an Position StartPos (0 ist das erste Zeichen). Mit Options kann festgelegt werden, ob nur nach ganzen Wörtern gesucht oder die Groß-/Kleinschreibung berücksichtigt werden soll. Verwenden Sie FindText anstatt mit Programmanweisungen den Text des Steuerelements zu durchsuchen, da Sie auf diese Weise verhindern, daß die Operation durch codierte Rich Text-Attribute fehlschlägt.


TCustomRichEdit::Print

TCustomRichEdit	Siehe auch

Die Methode Print formatiert und druckt den Inhalt des RTF-Eingabefelds.

void __fastcall Print(const System::AnsiString Caption);

Beschreibung

Mit Hilfe von Print kann der Inhalt eines RTF-Eingabefeldes gedruckt werden. Der Parameter Caption gibt dabei den Titel an.


TCustomRichEdit::RegisterConversionFormat

TCustomRichEdit	Siehe auch

Die Methode RegisterConversionFormat registriert eine Zuordnung zwischen einer Dateinamenserweiterung und einem TConversion-Objekt, das die Konvertierung zwischen dem nativen Dateiformat und dem RTF-Format durchführt.

static void __fastcall RegisterConversionFormat(const System::TMetaClass* const vmt,  const System::AnsiString AExtension, System::TMetaClass* AConversionClass);

Beschreibung

RTF-Eingabefelder codieren Textattribute im RTF-Format. Für das Lesen und Schreiben von Dateien, die Textattribute in einem anderen Format codieren, wird ein Konvertierer benötigt. Dazu verwendet man ein TConversion-Objekt, das beim Lesen oder Schreiben des Textes das Konvertieren zwischen dem nativen Dateiformat und dem RTF-Format durchführt. RegisterConversionFormat richtet eine Zuordnung zwischen einer Dateierweiterung und einem Konvertierer ein. Bei jedem Datenaustausch zwischen einer Datei mit dieser Erweiterung und einem RTF-Eingabefeld wird dann der entsprechende Konvertierer automatisch aufgerufen.

Hinweis

Verwenden Sie die Eigenschaft Lines, um den Text in die Datei zu schreiben bzw. aus der Datei zu lesen.


TCustomRichEdit::RequestSize

TCustomRichEdit	Siehe auch

Die Methode RequestSize reagiert auf Botschaften vom Fenster des RTF-Eingabefeldes, die besagen, daß der Text größer oder kleiner als die Fenstergröße geworden ist.

virtual void __fastcall RequestSize(const Windows::TRect &Rect);

Beschreibung

RequestSize ruft lediglich die Ereignisbehandlungsroutine für OnResizeRequest auf. RequestSize ist als geschützte Methode definiert, so daß abgeleitete Klassen die Reaktion auf Windows-Botschaften bezüglich einer anstehenden Änderung der Fenstergröße ändern können. Beim Überschreiben von RequestSize sollte auch die Ereignisbehandlungsroutine für OnResizeRequest aufgerufen werden.


TCustomRichEdit::SelectionChange

TCustomRichEdit	Siehe auch

Die Methode SelectionChange reagiert auf Botschaften vom Fenster des RTF-Eingabefeldes, die besagen, daß die Auswahl geändert worden ist.

virtual void __fastcall SelectionChange(void);

Beschreibung

SelectionChange ruft lediglich die Ereignisbehandlungsroutine für OnSelectionChange auf. SelectionChange ist als geschützte Methode definiert, so daß abgeleitete Klassen die Reaktion auf Windows-Botschaften bezüglich einer Auswahländerung modifizieren können. Beim Überschreiben von SelectionChange sollte auch die Ereignisehandlungsroutine für OnSelectionChange aufgerufen werden.


TCustomRichEdit::TCustomRichEdit

TCustomRichEdit	Siehe auch

Der Konstruktor TCustomRichEdit erzeugt ein neues TCustomRichEdit-Objekt.

__fastcall virtual TCustomRichEdit(Classes::TComponent* AOwner);

Beschreibung

Mit TCustomRichEdit wird zur Laufzeit eine Instanz von TCustomRichEdit erzeugt. Für alle Objekt dieses Typs, die während des Entwurfs in einem Formular plaziert wurden, wird TCustomRichEdit automatisch aufgerufen.

TCustomRichEdit überschreibt den geerbten Konstruktor, um Hilfsobjekte zu initialisieren, welche die Verwaltung der RTF-Textattribute übernehmen.


Gültigkeitsbereich

Protected

Published

Zugriff

Read-only


Gültigkeitsbereich

Protected


Gültigkeitsbereich

Protected


Hierarchie

TObject

TPersistent

TComponent

TControl

TWinControl

TCustomEdit

TCustomMemo


TCustomRichEdit Beispiel

TCustomRichEdit


TCustomTabControl

Hierarchie	Eigenschaften	Methoden	Ereignisse

Header

vcl/comctrls.hpp

Die Komponente TCustomTabControl ist der abstrakte Basistyp für Registerkomponenten wie z.B. TTabControl und TPageControl.

Beschreibung

Die meisten der in TCustomTabControl definierten Eigenschaften, Methoden und Ereignisse sind als protected deklariert. Sie können selbst entscheiden, ob Sie sie in Ihren eigenen TTabControl- oder TPageControl-Komponenten als published deklarieren möchten.


Eigenschaften von TCustomTabControl

TCustomTabControl	Alphabetisch	Legende

In TCustomTabControl

DisplayRect

MultiLine

TabHeight

TabIndex

Tabs

TabWidth

Abgeleitet von TWinControl

Brush

ClientOrigin

ClientRect

ControlCount

Controls

Handle

HelpContext

Showing

TabOrder

TabStop

Abgeleitet von TControl

Align

BoundsRect

ClientHeight

ClientWidth

ControlState

ControlStyle

Cursor

Enabled

Height

Hint

Left

Name

Parent

ShowHint

Top

Visible

Width

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TCustomTabControl

TCustomTabControl	Nach Objekten	Legende

Align

BoundsRect

Brush

ClientHeight

ClientOrigin

ClientRect

ClientWidth

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlCount

ControlState

Controls

ControlStyle

Cursor

DesignInfo

DisplayRect

Enabled

Handle

Height

HelpContext

Hint

Left

MultiLine

Name

Owner

Parent

ShowHint

Showing

TabHeight

TabIndex

TabOrder

Tabs

TabStop

TabWidth

Tag

Top

Visible

Width


TCustomTabControl::DisplayRect

TCustomTabControl

Die Eigenschaft DisplayRect gibt die Größe des Client-Bereichs einer Registerkarte in Pixel an.

__property Windows::TRect DisplayRect;

Beschreibung

Die Eigenschaft DisplayRect gibt die Koordinaten für oben, unten, links und rechts in einem Datensatz des Typs TRect zurück.


TCustomTabControl::MultiLine

TCustomTabControl	Siehe auch

Die Eigenschaft MultiLine legt fest, ob die Register mehrzeilig angezeigt werden, wenn sie am oberen Rand der Registerkarte aufgrund ihrer Anzahl nicht nebeneinander Platz finden.

__property bool MultiLine;

Beschreibung

Mit MultiLine können Sie festlegen, wie die Register angezeigt werden. Wenn MultiLine den Wert TRUE hat, werden die Register in mehreren Zeilen angezeigt. Die Anzahl der Zeilen hängt von der Anzahl der Register ab. Wenn MultiLine FALSE ist, werden die Register in nur einer Zeile angezeigt. In diesem Fall muß sich der Benutzer mit Hilfe der Bildlaufpfeile zu den nicht sichtbaren Registern bewegen.


TCustomTabControl::TabHeight

TCustomTabControl	Siehe auch

Die Eigenschaft TabHeight legt die Höhe der Register in Pixel fest.

__property short TabHeight;

Beschreibung

TabHeight ist die vertikale Ausdehnung der einzelnen Register in Pixel. Wenn TabHeight den Wert 0 hat, passen sich die Register automatisch der Texthöhe an.


TCustomTabControl::TabIndex

TCustomTabControl	Siehe auch

Die Eigenschaft TabIndex bezeichnet ein spezielles Register einer Registerkarte.

__property int TabIndex;

Beschreibung

Die einzelnen Register eines TTabControl-Objekts werden über einen Index angesprochen, der bei 0 beginnt. Für das erste Register (ganz links) hat TabIndex denWert 0, für das nächste 1 usw. Der Wert der Eigenschaft TabIndex legt fest, welches Register einer Registerkarte momentan ausgewählt ist. Wenn kein Register aktiv ist, hat TabIndex den Wert -1.


TCustomTabControl::Tabs

TCustomTabControl	Siehe auch	Beispiel

Die Eigenschaft Tabs enthält die Liste der Textstrings der Register einer Registerkarte.

__property Classes::TStrings* Tabs;

Beschreibung

Für jeden String dieser Eigenschaft wird ein neues Register erzeugt, auf dem der String angezeigt wird. Zur Entwurfszeit verwenden Sie für die Eingabe der Strings den Stringlisten-Editor. Doppelklicken Sie auf die rechte Spalte der Eigenschaft Tabs, um den Stringlisten-Editor aufzurufen. Die Strings der Eigenschaft Tabs können auch zur Laufzeit geändert werden.


TCustomTabControl::TabWidth

TCustomTabControl	Siehe auch

Die Eigenschaft TabWidth legt die horizontale Ausdehnung der einzelnen Register in Pixel fest.

__property short TabWidth;

Beschreibung

Wenn TabWidth den Wert 0 hat, passen sich die Register automatisch dem darzustellenden Text an.


Ereignisse von TCustomTabControl

TCustomTabControl	Alphabetisch	Legende

In TCustomTabControl

OnChange

OnChanging


Ereignisse von TCustomTabControl

TCustomTabControl	Nach Objekten	Legende

OnChange

OnChanging


TCustomTabControl::OnChange

TCustomTabControl	Siehe auch

Das Ereignis OnChange tritt ein, wenn ein neues Register ausgewählt wird, und zwar unmittelbar nach dem Ereignis OnChanging.

typedef void __fastcall (__closure *TNotifyEvent)(System::TObject* Sender);

__property Classes::TNotifyEvent OnChange;

Beschreibung

TNotifyEvent zeigt auf die Methode, die auf das Ereignis OnChange reagiert.


TCustomTabControl::OnChanging

TCustomTabControl	Siehe auch	Beispiel

Das Ereignis OnChanging tritt ein, wenn ein neues Registers ausgewählt wird, und zwar bevor das neue Register den Fokus erhält.

typedef void __fastcall (__closure *TTabChangingEvent)(System::TObject* Sender, bool &AllowChange);

__property TTabChangingEvent OnChanging;

Beschreibung

Sie können verhindern, daß der Benutzer zu einer anderen Seite wechselt.

Der Parameter TTabChangingEvent zeigt auf die Methode, die auf das Ereignis OnChanging der Registerkarte reagiert. Der Parameter AllowChange bestimmt, ob ein Wechsel zu einer neuen Seite erlaubt ist. Wenn AllowChange FALSE ist, wechselt die Registerkarte nicht die Seite, wenn der Benutzer ein anderes Register anklickt.


Methoden von TCustomTabControl

TCustomTabControl	Alphabetisch	Legende

In TCustomTabControl

~TCustomTabControl

AlignControls

CanChange

Change

CreateParams

CreateWnd

DestroyWnd

TCustomTabControl

Abgeleitet von TWinControl

Broadcast

CanFocus

ContainsControl

ControlAtPos

DisableAlign

EnableAlign

Focused

GetTabOrderList

HandleAllocated

HandleNeeded

InsertControl

Invalidate

PaintTo

Realign

RemoveControl

Repaint

ScaleBy

ScrollBy

SetBounds

SetFocus

Update

UpdateControlState

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

GetTextLen

Hide

Perform

Refresh

ScreenToClient

SendToBack

SetTextBuf

Show

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TCustomTabControl

TCustomTabControl	Nach Objekten	Legende

~TCustomTabControl

AlignControls

Assign

BeginDrag

BringToFront

Broadcast

CanChange

CanFocus

Change

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

ClientToScreen

ContainsControl

ControlAtPos

CreateParams

CreateWnd

DefaultHandler

DestroyComponents

Destroying

DestroyWnd

DisableAlign

Dispatch

DragDrop

Dragging

EnableAlign

EndDrag

FieldAddress

FindComponent

Focused

FreeInstance

FreeNotification

Free

GetParentComponent

GetTabOrderList

GetTextBuf

GetTextLen

HandleAllocated

HandleNeeded

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InsertControl

InstanceSize

Invalidate

MethodAddress

MethodName

NewInstance

PaintTo

Perform

Realign

Refresh

RemoveComponent

RemoveControl

Repaint

ScaleBy

ScreenToClient

ScrollBy

SendToBack

SetBounds

SetFocus

SetTextBuf

Show

TCustomTabControl

UpdateControlState

Update


TCustomTabControl::~TCustomTabControl

TCustomTabControl	Siehe auch

Der Destruktor ~TCustomTabControl gibt den Speicher frei, der für das TCustomTabControl-Objekt reserviert war. Rufen Sie ~TCustomTabControl nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TCustomTabControl automatisch aufgerufen wird.

__fastcall virtual ~TCustomTabControl(void);

Beschreibung

Die Methode ~TCustomTabControl gibt die String-Liste frei, welche die Beschriftungen der einzelnen Register enthält, und ruft dann den Destruktor seines übergeordneten Objekts auf.


TCustomTabControl::AlignControls

TCustomTabControl	Siehe auch

Die Methode AlignControls richtet die Steuerelemente einer Registerkarte aus.

virtual void __fastcall AlignControls(Controls::TControl* AControl, Windows::TRect &Rect);

Beschreibung

AlignControls richtet die Steuerelemente, denen das Register übergeordnet ist, innerhalb des in Rect übergebenen Rechtecks aus. Die Methode fragt für jedes untergeordnete Steuerelement den Wert der Eigenschaft Align ab, um die Ausrichtung festzulegen. Der Parameter AControl kann NULL sein. Wenn in AControl ein Steuerelement übergeben wird, hat dieses bei der Ausrichtung Vorrang gegenüber anderen, ähnlich ausgerichteten Steuerelementen.


TCustomTabControl::CanChange

TCustomTabControl	Siehe auch

Die Methode CanChange ruft die Ereignisbehandlungsroutine für OnChanging auf.

virtual bool __fastcall CanChange(void);

Beschreibung

CanChange ist die als protected deklarierte Implementierungsmethode für das Ereignis OnChanging. Überschreiben Sie diese Methode, wenn Sie zusätzliche Bearbeitungsschritte durchführen wollen, bevor die Ereignisbehandlungsroutine für OnChanging ausgeführt wird.


TCustomTabControl::Change

TCustomTabControl	Siehe auch

Die Methode Change ruft die Ereignisbehandlungsroutine für OnChange auf.

virtual void __fastcall Change(void);

Beschreibung

Change ist die als protected deklarierte Implementierungsmethode für das Ereignis OnChange. Überschreiben Sie die Methode, wenn Sie vor der Ausführung der Ereignisbehandlungsroutine für OnChange zusätzliche Bearbeitungsschritte durchführen wollen.


TCustomTabControl::CreateParams

TCustomTabControl

Die Methode CreateParams initialisiert eine benutzerdefinierte Registerkarte.

virtual void __fastcall CreateParams(Controls::TCreateParams &Params);

Beschreibung

CreateParams ruft die geerbte Methode CreateParams auf und setzt anschließend im Parameter Params den Parameter Style.


TCustomTabControl::CreateWnd

TCustomTabControl	Siehe auch

Die Methode CreateWnd erzeugt eine Windows-Registerkarte.

virtual void __fastcall CreateWnd(void);

Beschreibung

CreateWnd ruft die geerbte Methode CreateWnd auf und weist anschließend alle intern gespeicherten Register-Textstrings zu.


TCustomTabControl::DestroyWnd

TCustomTabControl	Siehe auch

Die Methode DestroyWnd gibt das Fenster-Handle der Registerkarte frei.

virtual void __fastcall DestroyWnd(void);

Beschreibung

DestroyWnd gibt das Fenster-Handle eines fensterorientierten Objekts frei, nachdem intern eine Kopie der Register-Textstrings gespeichert wurde.


TCustomTabControl::TCustomTabControl

TCustomTabControl	Siehe auch

Der Konstruktor TCustomTabControl erzeugt ein neues TCustomTabControl-Objekt.

__fastcall virtual TCustomTabControl(Classes::TComponent* AOwner);

Beschreibung

TCustomTabControl ruft den Konstruktor seines übergeordneten Objekts auf und setzt die Initialisierungswerte für das Register. Dabei wird auch die String-Liste für die Register aufgebaut.


Gültigkeitsbereich

Protected

Published

Zugriff

Read-only


Gültigkeitsbereich

Protected


Gültigkeitsbereich

Protected


Hierarchie

TObject

TPersistent

TComponent

TControl

TWinControl


TCustomTabControl Beispiel

TCustomTabControl


TCustomTreeView

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/comctrls.hpp

Die Komponente TCustomTreeView ist der abstrakte Basistyp für Baumdiagrammkomponenten, wie TTreeView.

Beschreibung

Die meisten in TCustomTreeView definierten Eigenschaften sind als protected deklariert und können in Ihren eigenen Baumdiagrammkomponenten als publish deklariert werden.


Eigenschaften von TCustomTreeView

TCustomTreeView	Alphabetisch	Legende

In TCustomTreeView

BorderStyle

DropTarget

HideSelection

Images

Indent

Items

ReadOnly

Selected

ShowButtons

ShowLines

ShowRoot

SortType

StateImages

TopItem

Abgeleitet von TWinControl

Brush

ClientOrigin

ClientRect

ControlCount

Controls

Handle

HelpContext

Showing

TabOrder

TabStop

Abgeleitet von TControl

Align

BoundsRect

ClientHeight

ClientWidth

ControlState

ControlStyle

Cursor

Enabled

Height

Hint

Left

Name

Parent

ShowHint

Top

Visible

Width

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TCustomTreeView

TCustomTreeView	Nach Objekten	Legende

Align

BorderStyle

BoundsRect

Brush

ClientHeight

ClientOrigin

ClientRect

ClientWidth

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlCount

ControlState

Controls

ControlStyle

Cursor

DesignInfo

DropTarget

Enabled

Handle

Height

HelpContext

HideSelection

Hint

Images

Indent

Items

Left

Name

Owner

Parent

ReadOnly

Selected

ShowButtons

ShowHint

Showing

ShowLines

ShowRoot

SortType

StateImages

TabOrder

TabStop

Tag

TopItem

Top

Visible

Width


TCustomTreeView::BorderStyle

TCustomTreeView	Siehe auch	Beispiel

BorderStyle legt fest, ob das Steuerelement einen Rahmen hat.

__property Forms::TBorderStyle BorderStyle;

Beschreibung

Folgende Werte stehen für BorderStyle zur Verfügung:

Wert	Bedeutung

bsNone	Kein sichtbarer Rahmen.

bsSingle	Rahmen aus einer Linie.


TCustomTreeView::DropTarget

TCustomTreeView

Legt den Eintrag fest, der Ziele einer Drag & Drop-Operation ist.

__property TTreeNode* DropTarget;


TCustomTreeView::HideSelection

TCustomTreeView	Siehe auch	Beispiel

Die Eigenschaft HideSelection legt fest, ob ein markierter Knoten markiert bleibt, wenn der Fokus an ein anderes Steuerelement übergeben wird.

__property bool HideSelection;

Beschreibung

Ist der Wert True, bleibt der Knoten nicht markiert, bis das Steuerelement den Fokus wieder erhält. Bei False bleibt der Knoten markiert.


TCustomTreeView::Images

TCustomTreeView	Siehe auch	Beispiel

Die Eigenschaft Images legt fest, welche Bilderliste mit dem Baumdiagramm verbunden ist.

__property Controls::TImageList* Images;

Beschreibung

Eine Bilderliste enthält eine Liste mit Bitmaps, die links neben einer Knotenbeschriftung angezeigt werden kann.


TCustomTreeView::Indent

TCustomTreeView	Siehe auch

Die Eigenschaft Indent gibt den Umfang der Einrückung in Pixel an, wenn eine Liste mit untergeordneten Knoten erweitert wird.

__property int Indent;

Beschreibung

Wird eine Liste mit untergeordneten Knoten erweitert, werden diese relativ zum übergeordneten Knoten eingerückt.


TCustomTreeView::Items

TCustomTreeView	Siehe auch	Beispiel

Die Eigenschaft Items enthält die einzelnen Knoten, die im Baumdiagramm-Steuerelement angezeigt werden.

__property TTreeNodes* Items;

Beschreibung

Bei den einzelnen Knoten in einem Baumdiagramm handelt es sich um TTreeNode-Objekte. Auf einzelne Knoten kann über die Eigenschaft Items und den Index des Eintrags im Baumdiagramm zugegriffen werden. Wenn Sie beispielsweise auf den zweiten Eintrag im Baumdiagramm zugreifen wollen, geben Sie folgenden Code an:

MyTreeNode = TreeView1.Items[1];

Wenn Sie diese Eigenschaft beim Entwurf im Objektinspektor setzen, wird der Baumdiagrammeditor angezeigt. Mit Hilfe der Schaltflächen Neuer Eintrag und Neuer Untereintrag können Sie dem Baumdiagramm Einträge hinzufügen. Über die Eigenschaft Text können Sie den Text ändern, der als Beschriftung des Eintrags angezeigt wird.

Zur Laufzeit können Knoten mit Hilfe der folgenden TTreeNodes-Methoden hinzugefügt werden: AddChildFirst, AddChild, AddChildObjectFirst, AddChildObject, AddFirst, Add, AddObjectFirst, AddObject und Insert.

Hinweis

Der Zugriff auf Einträge im Baumdiagramm über den Index kann sehr zeitaufwendig sein, wenn das Diagramm viele Einträge enthält. Um eine optimale Ausführungsgeschwindigkeit zu erreichen, sollten Sie Ihre Anwendung so gestalten, daß möglichst wenig Abhängigkeiten im Index der Einträge des Baumdiagramms vorliegen.


TCustomTreeView::ReadOnly

TCustomTreeView	Siehe auch

Die Eigenschaft ReadOnly legt fest, ob der Benutzer den Inhalt des Eingabefeldes ändern kann.

__property bool ReadOnly;

Beschreibung

Wenn ReadOnly True ist, kann der Benutzer den Inhalt nicht bearbeiten. Ist ReadOnly False, darf der Benutzer den Inhalt ändern. Die Voreinstellung lautet False.


TCustomTreeView::Selected

TCustomTreeView	Example

Legt den ausgewähkten Eintrag des Baumdiagramms fest.

__property TTreeNode* Selected;


TCustomTreeView::ShowButtons

TCustomTreeView	Siehe auch

Mit der Eigenschaft ShowButtons wird festgelegt, ob links neben jedem übergeordneten Eintrag Plus- und Minus-Schaltflächen (+ bzw. -) angezeigt werden sollen.

__property bool ShowButtons;

Beschreibung

Wenn ShowButtons auf True gesetzt ist, wird links neben allen übergeordneten Einträgen eine Schaltfläche eingeblendet. Durch Klicken auf diese Schaltfläche kann der Benutzer die Liste der untergeordneten Einträge anzeigen oder ausblenden. Diese Möglichkeit ist eine Alternative zum Doppelklicken auf den übergeordneten Eintrag.


TCustomTreeView::ShowLines

TCustomTreeView	Siehe auch

Die Eigenschaft ShowLines legt fest, ob Linien angezeigt werden, die untergeordnete Einträge mit den zugehörigen übergeordneten Einträgen verbinden.

__property bool ShowLines;

Beschreibung

Wird ShowLines auf True gesetzt, werden die Verbindungslinien zwischen den untergeordneten und den zugehörigen übergeordneten Knoten angezeigt. Knoten am Ausgangspunkt der Hierarchie werden nicht automatisch verbunden. Um diese Knoten mit Verbindungslinien zu versehen, müssen Sie die Eigenschaft ShowRoot auf True setzen.


TCustomTreeView::ShowRoot

TCustomTreeView	Siehe auch

Mit der Eigenschaft ShowRoot wird festgelegt, ob Verbindungslinien für Knoten am Ausgangspunkt der Hierarchie angezeigt werden.

__property bool ShowRoot;

Beschreibung

Wenn Verbindungslinien für die Knoten am Ausgangspunkt der Hierarchie angezeigt werden sollen, müssen Sie die Eigenschaften ShowRoot und ShowLines auf True setzen.


TCustomTreeView::SortType

TCustomTreeView	Siehe auch

Mit der Eigenschaft SortType wird festgelegt, ob und wie die Knoten in einem Baumdiagramm automatisch sortiert werden.

__property TSortType SortType;

Beschreibung

Wird ein Baumdiagramm sortiert, geht die ursprüngliche Hierarchie verloren. Durch das Zurücksetzen von SortType auf stNone kann also die ursprüngliche Reihenfolge der Einträge nicht wiederhergestellt werden. Folgende Werte stehen für SortType zur Verfügung:

Wert	Bedeutung

nsNone	Es wird keine Sortierung durchgeführt.

nsData	Die Einträge werden sortiert, wenn das Objekt Data oder die Eigenschaft SortType geändert wird.

nsText	Die Einträge werden sortiert, wenn Caption oder SortType geändert wird.

nsBoth	Die Einträge werden sortiert, wenn entweder das Objekt Data, oder die Eigenschaften Caption oder SortType geändert werden.

Optional kann das Ereignis OnCompare zur Durchführung der Vergleiche ausgelöst werden. Dieses Ereignis wird für den Vergleich von zwei Knoten für die Sortierung aufgerufen.


TCustomTreeView::StateImages

TCustomTreeView	Siehe auch	Beispiel

Die Eigenschaft StateImages legt fest, welche Bilderliste für die Statusbilder verwendet werden soll.

__property Controls::TImageList* StateImages;

Beschreibung

Ein Statusbild dient zur Anzeige eines zusätzlichen Bildes links neben dem Symbol des Eintrags.


TCustomTreeView::TopItem

TCustomTreeView	Example

Die Eigenschaft TopItem gibt den obersten Eintrag des Baumdiagramms an.

__property TTreeNode* TopItem;


Ereignisse von TCustomTreeView

TCustomTreeView	Alphabetisch	Legende

In TCustomTreeView

OnChange

OnChanging

OnCollapsed

OnCollapsing

OnCompare

OnDeletion

OnEdited

OnEditing

OnExpanded

OnExpanding

OnGetImageIndex

OnGetSelectedIndex


Ereignisse von TCustomTreeView

TCustomTreeView	Nach Objekten	Legende

OnChange

OnChanging

OnCollapsed

OnCollapsing

OnCompare

OnDeletion

OnEdited

OnEditing

OnExpanded

OnExpanding

OnGetImageIndex

OnGetSelectedIndex


TCustomTreeView::OnChange

TCustomTreeView	Siehe auch

Das Ereignis OnChange tritt ein, wenn die Auswahl von einem Knoten zu einem anderen übertragen wurde.

typedef void __fastcall (__closure *TTVChangedEvent)(System::TObject* Sender, TTreeNode* Node);

__property TTVChangedEvent OnChange;

Beschreibung

Der Typ TTVChangedEvent zeigt auf eine Methode, die aufgerufen wird, wenn sich in der TTreeView-Komponente die Auswahl eines Eintrags geändert hat (Ereignis OnChange).


TCustomTreeView::OnChanging

TCustomTreeView	Siehe auch

Das Ereignis OnChanging tritt ein, wenn die Auswahl (Markierung) von einem Knoten zu einem anderen übertragen wird.

typedef void __fastcall (__closure *TTVChangingEvent)(System::TObject* Sender, TTreeNode* Node, bool &AllowChange);

__property TTVChangingEvent OnChanging;

Beschreibung

Der Typ TTVChangedEvent zeigt auf eine Methode, die aufgerufen wird, wenn sich in der TTreeView-Komponente die Markierung eines Eintrags geändert hat (Ereignis OnChange). Mit dem Parameter AllowChange wird festgelegt, ob die €nderung zulässig ist. Wenn AllowChange auf False gesetzt wird, kann der Benutzer diesen Knoten nicht markieren.


TCustomTreeView::OnCollapsed

TCustomTreeView	Siehe auch

Das Ereignis OnCollapsed tritt ein, nachdem ein Knoten ausgeblendet wurde.

typedef void __fastcall (__closure *TTVExpandedEvent)(System::TObject* Sender, TTreeNode* Node);

__property TTVExpandedEvent OnCollapsed;

Beschreibung

Mit dem Ereignis OnCollapsed können Sie die Ausführung von Quelltext auslösen, der beim Ausblenden eines Knotens ausgeführt werden soll.


TCustomTreeView::OnCollapsing

TCustomTreeView	Siehe auch

Das Ereignis OnCollapsing tritt ein, wenn ein Knoten ausgeblendet wird.

typedef void __fastcall (__closure *TTVCollapsingEvent)(System::TObject* Sender, TTreeNode* Node, bool &AllowCollapse);

__property TTVCollapsingEvent OnCollapsing;

Beschreibung

Der Typ TTVCollapsingEvent zeigt auf eine Methode, die aufgerufen wird, wenn ein Knoten ausgeblendet wird (Ereignis OnCollapsing). Mit dem Parameter AllowCollapse wird festgelegt, ob der übergeordnete Knoten ausgeblendet werden kann. Wenn AllowCollapse auf False gesetzt wird, kann der Benutzer diesen Knoten nicht ausblenden.


TCustomTreeView::OnCompare

TCustomTreeView	Siehe auch

Das Ereignis OnCompare tritt ein, wenn vom übergeordneten Fenster des Baudiagramms die Sortierung eines Knotens angefordert wird.

typedef void __fastcall (__closure *TTVCompareEvent)(System::TObject* Sender, TTreeNode* Node1, TTreeNode* Node2, int Data, int &Compare);

__property TTVCompareEvent OnCompare;

Beschreibung

Der Typ TTVCompareEvent zeigt auf eine Methode, die aufgerufen wird, wenn zwei Knoten im Baumdiagramm miteinander verglichen werden müssen (Ereignis OnCompare).


TCustomTreeView::OnDeletion

TCustomTreeView	Siehe auch

Das Ereignis OnDeletion tritt ein, wenn ein Knoten aus dem Baumdiagramm gelöscht wird.

typedef void __fastcall (__closure *TTVExpandedEvent)(System::TObject* Sender, TTreeNode* Node);

__property TTVExpandedEvent OnDeletion;

Beschreibung

Mit dem Ereignis OnDeletion können Sie die Ausführung eines bestimmten Codes auslösen, wenn ein Knoten aus dem Baumdiagramm gelöscht wird.


TCustomTreeView::OnEdited

TCustomTreeView	Siehe auch

Das Ereignis OnEdited tritt nach der Bearbeitung der Beschriftung der Eigenschaft Text eines Knotens ein, wenn der Beschriftungstext geändert wurde.

typedef void __fastcall (__closure *TTVEditedEvent)(System::TObject* Sender, TTreeNode* Node,  System::AnsiString & S);

__property TTVEditedEvent OnEdited;

Beschreibung

Das Ereignis kann nur eintreten, wenn ReadOnly auf False gesetzt ist.


TCustomTreeView::OnEditing

TCustomTreeView	Siehe auch

Das Ereignis OnEditing tritt zu Beginn der Bearbeitung der Beschriftung der Eigenschaft Text eines Knotens in der Komponente TTreeView ein.

typedef void __fastcall (__closure *TTVEditingEvent)(System::TObject* Sender, TTreeNode* Node, bool &AllowEdit);

__property TTVEditingEvent OnEditing;

Beschreibung

Das Ereignis kann nur eintreten, wenn die Eigenschaft ReadOnly der Komponente auf False gesetzt ist.

Die TTVEditingEvent-Typen zeigen auf eine Methode, die zu Beginn der Bearbeitung der Beschriftung eines Knotens (Ereignis OnEdit) in der Komponente aufgerufen wird. Mit dem Parameter AllowEdit wird festgelegt, ob die Bearbeitung erlaubt ist. Wenn AllowEdit False ist, kann der Benutzer die Knotenbeschriftung im Baumdiagramm nicht ändern.


TCustomTreeView::OnExpanded

TCustomTreeView	Siehe auch

Das Ereignis OnExpanded tritt ein, wenn ein Knoten erweitert wurde.

typedef void __fastcall (__closure *TTVExpandedEvent)(System::TObject* Sender, TTreeNode* Node);

__property TTVExpandedEvent OnExpanded;

Beschreibung

Mit dem Ereignis OnExpanded können Sie die Ausführung von Code auslösen, nachdem ein Knoten im Baumdiagramm erweitert wurde.


TCustomTreeView::OnExpanding

TCustomTreeView	Siehe auch

Das Ereignis OnExpanding tritt ein, wenn ein Knoten erweitert wird.

typedef void __fastcall (__closure *TTVExpandingEvent)(System::TObject* Sender, TTreeNode* Node, bool& AllowExpansion);

__property TTVExpandingEvent OnExpanding;

Beschreibung

Der Typ TTVExpandingEvent zeigt auf eine Methode, die aufgerufen wird, wenn ein Knoten erweitert wird (Ereignis OnExpanding). Mit dem Parameter AllowExpansion wird festgelegt, ob der Eintrag erweitert werden kann. Wenn AllowExpansion auf False gesetzt wird, kann der Benutzer diesen Knoten nicht erweitern.


TCustomTreeView::OnGetImageIndex

TCustomTreeView	Siehe auch

Das Ereignis OnGetImageIndex tritt ein, wenn das Steuerelement die Eigenschaft ImageIndex eines Eintrags abfragt.

typedef void __fastcall (__closure *TTVExpandedEvent)(System::TObject* Sender, TTreeNode* Node);

__property TTVExpandedEvent OnGetImageIndex;

Beschreibung

Mit Hilfe des Ereignisses OnGetImageIndex kann der Programmierer den Bildindex des Knotens ändern, der gezeichnet werden soll. Beispielsweise läßt sich das Bitmap eines Knotens ändern, um einen anderen Status für den Knoten anzuzeigen.


TCustomTreeView::OnGetSelectedIndex

TCustomTreeView	Siehe auch

Das Ereignis OnGetSelectedIndex tritt ein, wenn das Steuerelement die Eigenschaft SelectedIndex des Knotens abfragt.

typedef void __fastcall (__closure *TTVExpandedEvent)(System::TObject* Sender, TTreeNode* Node);

__property TTVExpandedEvent OnGetSelectedIndex;

Beschreibung

Mit Hilfe dieses Ereignisses kann der Programmierer die Eigenschaft SelectedIndex des markierten Knotens ändern, also den Index des Bitmaps des markierten Knotens in der Bilderliste.


Methoden von TCustomTreeView

TCustomTreeView	Alphabetisch

In TCustomTreeView

~TCustomTreeView

AlphaSort

CustomSort

FullCollapse

FullExpand

GetHitTestInfoAt

GetNodeAt

IsEditing

LoadFromFile

LoadFromStream

SaveToFile

SaveToStream

TCustomTreeView

Abgeleitet von TWinControl

Broadcast

CanFocus

ContainsControl

ControlAtPos

DisableAlign

EnableAlign

Focused

GetTabOrderList

HandleAllocated

HandleNeeded

InsertControl

Invalidate

PaintTo

Realign

RemoveControl

Repaint

ScaleBy

ScrollBy

SetBounds

SetFocus

Update

UpdateControlState

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

GetTextLen

Hide

Perform

Refresh

ScreenToClient

SendToBack

SetTextBuf

Show

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TCustomTreeView

TCustomTreeView	Nach Objekten

~TCustomTreeView

AlphaSort

Assign

BeginDrag

BringToFront

Broadcast

CanFocus

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

ClientToScreen

ContainsControl

ControlAtPos

CustomSort

DefaultHandler

DestroyComponents

Destroying

DisableAlign

Dispatch

DragDrop

Dragging

EnableAlign

EndDrag

FieldAddress

FindComponent

Focused

FreeInstance

FreeNotification

Free

FullCollapse

FullExpand

GetHitTestInfoAt

GetNodeAt

GetParentComponent

GetTabOrderList

GetTextBuf

GetTextLen

HandleAllocated

HandleNeeded

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InsertControl

InstanceSize

Invalidate

IsEditing

LoadFromFile

LoadFromStream

MethodAddress

MethodName

NewInstance

PaintTo

Perform

Realign

Refresh

RemoveComponent

RemoveControl

Repaint

SaveToFile

SaveToStream

ScaleBy

ScreenToClient

ScrollBy

SendToBack

SetBounds

SetFocus

SetTextBuf

Show

TCustomTreeView

UpdateControlState

Update


TCustomTreeView::~TCustomTreeView

TCustomTreeView	Siehe auch

Der Destruktor ~TCustomTreeView gibt den Speicher frei, der für das TCustomTreeView-Objekt reserviert war. Rufen Sie ~TCustomTreeView nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TCustomTreeView automatisch aufgerufen wird.

__fastcall virtual ~TCustomTreeView(void);


TCustomTreeView::AlphaSort

TCustomTreeView	Siehe auch

Mit der Methode AlphaSort werden alle Knoten im Baumdiagramm alphabetisch nach der Beschriftung sortiert.

bool __fastcall AlphaSort(void);

Beschreibung

Die Methode gibt nach erfolgreicher Ausführung True zurück.


TCustomTreeView::CustomSort

TCustomTreeView	Siehe auch

Mit der Methode CustomSort können Sie Knoten nach Kriterien sortieren, die Sie selbst definieren.

bool __fastcall CustomSort(Commctrl::TTVCompare SortProc, long Data);

Beschreibung

Bei Verwendung dieser Methode können Sie eine anwendungsdefinierte Callback-Funktion angeben, die vom Baumdiagramm und dem Baumknoten aufgerufen werden kann, wenn die relative Reihenfolge zweier untergeordneter Knoten festgelegt werden muß. Der Parameter SortProc ist ein Zeiger auf die anwendungsdefinierte Callback-Funktion. Der optionale Parameter Data dient zur Übergabe eines Datenwertes an die Funktion.

Die Methode CustomSort des Baumknotens sortiert alle untergeordneten Knoten des Knotens, der die Methode aufgerufen hat.  Die Methode CustomSort des Baumdiagramms sortiert alle Knoten im Baumdiagramm.

An die Callback-Funktion werden die zu vergleichenden zwei Knoten und ein dritter, von Ihnen definierter 32-Bit-Wert übergeben.

Die Callback-Funktion sieht folgendermaßen aus:

int __fastcall CompareFunc(TTreeNode Node1,TTreeNode Node2, int ParamSort);

Die Callback-Funktion muß einen negativen Wert zurückgeben, wenn der erste Knoten vor dem zweiten stehen soll. Soll der erste Knoten dagegen auf den zweiten folgen, muß die Funktion einen positiven Wert zurückgeben. Wenn beide Knoten auf derselben Stufe stehen, muß die Funktion den Wert 0 zurückgeben. Die Parameter Node1 und Node2 sind die beiden Knoten, die verglichen werden sollen.

Ist der Parameter SortProc NULL, wird die Standardmethode AlphaSort aufgerufen. Dies kann von Nutzen sein, weil CustomSort über den Parameter Data verfügt, AlphaSort jedoch nicht.

Beispiel

Im folgenden Beispiel wird ein Baumdiagramm durch Klicken auf eine Schaltfläche in umgekehrter alphabetischer Reihenfolge sortiert. Die Callback-Funktion CustomSortProc ruft die Windows-API-Funktion lstrcmp auf und verwirft deren Rückgabewert.

int __fastcall CustomSortProc(TTreeNode Node1, TTreeNode Node2,int ParamSort)

{

  Result = -lstrcmp(PChar(Item1.Text),  PChar(Item2.Text));

}

void TForm1::Button1Click(TObject *Sender)

{

  TreeView1.CustomSort(&CustomSortProc, 0);

}


TCustomTreeView::FullCollapse

TCustomTreeView	Siehe auch

Mit der Methode FullCollapse werden alle Knoten im Baumdiagramm ausgeblendet.

void __fastcall FullCollapse(void);

Beschreibung

Wenn alle Knoten ausgeblendet sind, werden nur die Knoten am Ausgangspunkt der Hierarchie angezeigt.


TCustomTreeView::FullExpand

TCustomTreeView	Siehe auch

Mit der Methode FullExpand werden alle Knoten im Baumdiagramm erweitert.

void __fastcall FullExpand(void);

Beschreibung

Alle erweiterten Knoten unterhalb des zugehörigen übergeordneten Knotens werden angezeigt. Wenn ShowButtons True ist, werden alle Schaltflächen von '+' zu '-' geändert.


TCustomTreeView::GetHitTestInfoAt

TCustomTreeView	Siehe auch

Die Methode GetHitTestInfoAt der TTreeView-Komponente liefert Informationen über die Position eines Punktes relativ zum Client-Bereich des Baumdiagramms.

THitTests __fastcall GetHitTestInfoAt(int X, int Y);

Beschreibung

GetHitTestInfoAt liefert einen Wert vom Typ THitTests, der eine Wertemenge darstellt. Diese gibt die Position von X,Y relativ zum Baumdiagramm an. Die Methode GetHitTestInfoAt verfügt über folgende Rückgabewerte:

Wert	Bedeutung

htAbove	Der Punkt liegt oberhalb des Client-Bereichs des Baumdiagramms.

htBelow	Der Punkt liegt unterhalb des Client-Bereichs des Baumdiagramms.

htNowhere	Der Punkt liegt zwar im Client-Bereich des Baumdiagramms, aber unterhalb des letzten Eintrags.

htOnItem	Der Punkt befindet sich auf dem Bitmap oder der Beschriftung, das bzw. die mit einem Eintrag verbunden ist.

htOnButton	Der Punkt befindet sich auf der Schaltfläche, die mit einem Eintrag verbunden ist.

htOnIcon	Der Punkt befindet sich auf dem Bitmap, das mit einem Eintrag verbunden ist.

htOnIndent	Der Punkt befindet sich in der Einrückung, die mit einem Eintrag verbunden ist.

htOnLabel	Der Punkt befindet sich auf der Beschriftung (dem Text), die mit einem Eintrag verbunden ist.

htOnRight	Der Punkt befindet sich rechts neben dem Eintrag.

htOnStateIcon	Der Punkt befindet sich auf dem Statussymbol eines Baumdiagrammeintrags, der einen benutzerdefinierten Status besitzt.

htToRight	Der Punkt liegt rechts neben dem Client-Bereich des Baumdiagramms.

htToLeft	Der Punkt liegt links neben dem Client-Bereich des Baumdiagramms.

Beispiel

Im folgenden Code wird eine Liste mit htHitTest-Typen überprüft. Es werden die Typen hinzugefügt, die beim Drücken einer Maustaste im Baumdiagramm eintreten.

void __fastcall TForm1::TreeView1MouseDown(TObject *Sender, TMouseButton Button,

  TShiftState Shift, int x, int y)

{

THitTests MyHitTest;

MyHitTest << TreeView1->GetHitTestInfoAt(X, Y);

if (MyHitTest.Contains(htNowhere))

       ListBox1->Items.Add("NoWhere");

    if (MyHitTest.Contains(htOnItem))

       ListBox1->Items.Add("OnItem");

    if (MyHitTest.Contains(htOnButton))

       ListBox1->Items.Add("OnButton");

    if (MyHitTest.Contains(htOnIndent))

       ListBox1->Items.Add("OnIndent");

    if (MyHitTest.Contains(htOnLabel))

       ListBox1->Items.Add("OnLabel");

    if (MyHitTest.Contains(htOnRight))

       ListBox1->Items.Add("OnRight");

}


TCustomTreeView::GetNodeAt

TCustomTreeView	Siehe auch

Die Methode GetNodeAt liefert den Knoten, der sich an der mit den Parametern X und Y angegebenen Position befindet. Die Angabe erfolgt in Pixel relativ zur oberen linken Ecke des Baumdiagramms.

TTreeNode* __fastcall GetNodeAt(int X, int Y);

Beschreibung

Befindet sich kein Knoten an der Position, wird NULL zurückgegeben.

Beispiel

void __fastcall TForm1::TreeView1DragDrop(TObject *Source, TObject *Sender, int X, int Y)

{

  TTreeNode AnItem;

  TNodeAttachMode AttachMode;

  THitTests HT, HTTest;

  if (TreeView1->Selected == nil)

    return;

  HT = TreeView1->tHitTestInfoAt(X, Y);

  HTTest << htOnItem << htOnIcon <<  htNowhere << htOnIndent;

  AnItem = TreeView1->tNodeAt(X, Y);

  if (HT - HTTest != HT)

  {

    if (HT.Contains(htonitem) || HT.Contains(onIcon))

      AttachMode = naAddChild;

    else if (HT.Contains(htNowhere))

      AttachMode = naAdd;

    else if (HT.Contains(htOnIndent))

      AttachMode = naInsert;

    TreeView1->Selected.MoveTo(AnItem, AttachMode);

  }

}


TCustomTreeView::IsEditing

TCustomTreeView	Siehe auch

Die Methode IsEditing gibt an, ob ein Knoten gerade bearbeitet wird.

bool __fastcall IsEditing(void);

Beschreibung

Die Methode IsEditing liefert True, wenn ein Knoten im Baumdiagramm gerade bearbeitet wird.


TCustomTreeView::LoadFromFile

TCustomTreeView	Siehe auch

Die Methode LoadFromFile liest die in FileName angegebene Datei und lädt die Daten in das Baumdiagramm.

void __fastcall LoadFromFile(const System::AnsiString FileName);

Beschreibung

Verwenden Sie die Methode LoadFromFile, wenn Sie die Baumdiagrammdaten aus einer Datei abrufen und in ein Baumdiagramm laden wollen.


TCustomTreeView::LoadFromStream

TCustomTreeView	Siehe auch

Die Methode LoadFromStream liest Baumdiagrammdaten aus einem Stream und lädt den Inhalt in das Baumdiagramm.

void __fastcall LoadFromStream(Classes::TStream* Stream);

Beschreibung

Verwenden Sie die Methode LoadFromStream, um den Stream zu lesen und den Inhalt in das Baumdiagramm zu laden.


TCustomTreeView::SaveToFile

TCustomTreeView	Siehe auch

Die Methode SaveToFile speichert ein Baumdiagramm in der mit FileName angegebenen Datei.

void __fastcall SaveToFile(const System::AnsiString FileName);

Beschreibung

Verwenden Sie die Methode SaveToFile, um Baumdiagrammdaten in einer Textdatei zu speichern.


TCustomTreeView::SaveToStream

TCustomTreeView	Siehe auch

Die Methode SaveToStream erstellt einen Stream mit dem Inhalt des Baumdiagramms. Der Name des Streams wird im Parameter Stream übergeben.

void __fastcall SaveToStream(Classes::TStream* Stream);

Beschreibung

Verwenden Sie die Methode SaveToStream, um Baumdiagrammdaten in einen Stream zu stellen.


TCustomTreeView::TCustomTreeView

TCustomTreeView	Siehe auch

Der Konstruktor TCustomTreeView erzeugt ein neues TCustomTreeView-Objekt.

__fastcall virtual TCustomTreeView(Classes::TComponent* AOwner);

Beschreibung

Die Methode TCustomTreeView ruft zuerst die geerbte Methode TCustomTreeView auf und initialisiert viele Eigenschaften des Steuerelements.


Gültigkeitsbereich

Protected

Published

Zugriff

Read-only


Gültigkeitsbereich

Protected


Hierarchie

TObject

TPersistent

TComponent

TControl

TWinControl


TCustomTreeView Beispiel

TCustomTreeView


TCustomUpDown

Hierarchie	Eigenschaften	Methoden	Ereignisse

Header

vcl/comctrls.hpp

Die Komponente TCustomUpDown ist der abstrakte Basistyp für Wippregler-Komponenten wie z.B. TUpDown.


Eigenschaften von TCustomUpDown

TCustomUpDown	Alphabetisch	Legende

In TCustomUpDown

AlignButton

ArrowKeys

Associate

Increment

Max

Min

Orientation

Position

Thousands

Wrap

Abgeleitet von TWinControl

Brush

ClientOrigin

ClientRect

ControlCount

Controls

Handle

HelpContext

Showing

TabOrder

TabStop

Abgeleitet von TControl

Align

BoundsRect

ClientHeight

ClientWidth

ControlState

ControlStyle

Cursor

Enabled

Height

Hint

Left

Name

Parent

ShowHint

Top

Visible

Width

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TCustomUpDown

TCustomUpDown	Nach Objekten	Legende

AlignButton

Align

ArrowKeys

Associate

BoundsRect

Brush

ClientHeight

ClientOrigin

ClientRect

ClientWidth

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlCount

ControlState

Controls

ControlStyle

Cursor

DesignInfo

Enabled

Handle

Height

HelpContext

Hint

Increment

Left

Max

Min

Name

Orientation

Owner

Parent

Position

ShowHint

Showing

TabOrder

TabStop

Tag

Thousands

Top

Visible

Width

Wrap


TCustomUpDown::AlignButton

TCustomUpDown	Siehe auch

Die Eigenschaft AlignButton legt die Position des Wippreglers relativ zu seinem in der Eigenschaft Associate angegebenen Begleitelement fest.

__property TUDAlignButton AlignButton;

Beschreibung

Die möglichen Werte für diese Eigenschaft sind:

Wert	Bedeutung

udLeft	Der Wippregler richtet sich an der linken Seite des Begleitelements aus.

udRight	Der Wippregler richtet sich an der rechten Seite des Begleitelements aus.

Der Vorgabewert ist udRight. Das TUpDown-Objekt ändert beim Ausrichten seine Größe.


TCustomUpDown::ArrowKeys

TCustomUpDown	Siehe auch

Die Eigenschaft ArrowKeys stellt eine Tastaturschnittstelle dar, die der Komponente TCustomUpDown erlaubt, auf die Tasten AUF und AB zu reagieren.

__property bool ArrowKeys;

Beschreibung

ArrowKeys wird nur verwendet, wenn der Komponente ein Begleitfenster zugeordnet ist. Die Komponente kann auf die Tasten AUF und AB auch reagieren, wenn das Begleitfenster den Fokus hat. Der Vorgabewert ist True. In der Eigenschaft Associate können Sie der Komponente ein Begleitfenster zuweisen.


TCustomUpDown::Associate

TCustomUpDown	Siehe auch

Die Eigenschaft Associate legt ein Begleitfenster für die Komponente TCustomUpDown fest.

__property Controls::TWinControl* Associate;

Beschreibung

Der Wippregler richtet sich automatisch an der Seite des Begleitfensters aus und paßt seine Größe entsprechend an.

Wenn Sie zur Entwurfszeit den Wippregler verschieben, folgt ihm das Begleitelement nicht automatisch. Sie müssen entweder beide Elemente markieren oder zuerst das Begleitelement verschieben und es dann der Eigenschaft Associate des Wippreglers zuweisen.


TCustomUpDown::Increment

TCustomUpDown	Siehe auch

Die Eigenschaft Increment legt fest, um welchen Wert die Eigenschaft Position erhöht oder erniedrigt wird, wenn der Benutzer auf eines der Pfeilsymbole des Wippreglers klickt.

__property int Increment;

Beschreibung

Der Vorgabewert ist 1. Ein höherer Wert vergrößert das Intervall zwischen den angezeigten Werten.


TCustomUpDown::Max

TCustomUpDown	Siehe auch

Die Eigenschaft Max legt den maximalen Wert fest, den die Eigenschaft Position annehmen kann.

__property short Max;

Beschreibung

Die Eigenschaften Min und Max definieren den Wertebereich für die Eigenschaft Position.


TCustomUpDown::Min

TCustomUpDown	Siehe auch

Die Eigenschaft Min legt den minimalen Wert fest, den die Eigenschaft Position annehmen kann.

__property short Min;

Beschreibung

Die Eigenschaften Min und Max definieren den Wertebereich für die Eigenschaft Position.


TCustomUpDown::Orientation

TCustomUpDown

Die Eigenschaft Orientation legt fest, in welche Richtung die Pfeilsymbole auf dem Wippregler zeigen.

__property TUDOrientation Orientation;

Beschreibung

Die möglichen Werte für diese Eigenschaft sind:

Wert	Bedeutung

udHorizontal	Die Pfeilsymbole zeigen nach links und nach rechts.

udVertical	Die Pfeilsymbole zeigen nach oben und nach unten.

Der Vorgabewert ist udVertical.


TCustomUpDown::Position

TCustomUpDown	Siehe auch	Beispiel

Die Eigenschaft Position enthält den numerischen Wert, der erhöht oder erniedrigt wird, wenn der Benutzer auf eines der Pfeilsymbole klickt.

__property short Position;

Beschreibung

Wenn Sie der Eigenschaft Associate beispielsweise ein Eingabefeld zuweisen, zeigt dieses automatisch den Wert von Position an.

Wenn der Wippregler über kein Begleitfenster verfügt, kann Position als Wert für Zuweisungen verwendet werden.


TCustomUpDown::Thousands

TCustomUpDown	Siehe auch

Die Eigenschaft Thousands legt fest, ob nach jeweils drei Ziffern einer als String angezeigten Dezimalzahl ein Tausendertrennzeichen eingefügt wird.

__property bool Thousands;

Beschreibung

Wenn Thousands den Wert True hat (Vorgabe), wird ein Trennzeichen angezeigt. Der Dezimalwert selbst ist in der Eigenschaft Position gespeichert.


TCustomUpDown::Wrap

TCustomUpDown

Die Eigenschaft Wrap legt fest, was geschehen soll, wenn der Wippregler über den Wert der Eigenschaft Max hinaus inkrementiert wird.

__property bool Wrap;

Beschreibung

Wenn Wrap True ist und der Benutzer der Eigenschaft Position einen Wert zuweist, der den Wert der Eigenschaft Max überschreitet, wird Position der Wert von Min zugewiesen.

Eigenschaft Max, Eigenschaft Min, Eigenschaft Position


Ereignisse von TCustomUpDown

TCustomUpDown	Alphabetisch	Legende

In TCustomUpDown

OnChanging

OnClick


Ereignisse von TCustomUpDown

TCustomUpDown	Nach Objekten	Legende

OnChanging

OnClick


TCustomUpDown::OnChanging

TCustomUpDown	Siehe auch

Das Ereignis OnChanging tritt ein, wenn eines der Pfeilsymbole angeklickt wird. Es folgt unmittelbar auf das Ereignis OnClick.

typedef void __fastcall (__closure *TUDChangingEvent)(System::TObject* Sender, bool &AllowChange);

__property TUDChangingEvent OnChanging;

Beschreibung

TUDChangingEvent zeigt auf die Methode, die auf das Ereignis OnChanging reagiert. Ob sich der Wert der Eigenschaft Position tatsächlich ändert, wenn der Benutzer auf eines der Pfeilsymbole klickt, hängt vom Parameter AllowChange ab.


TCustomUpDown::OnClick

TCustomUpDown	Siehe auch	Beispiel

Das Ereignis OnClick tritt ein, wenn der Benutzer auf eines der Pfeilsymbole klickt. Es geht dem Ereignis OnChanging unmittelbar voran.

enum TUDBtnType { btNext, btPrev };

typedef void __fastcall (__closure *TUDClickEvent)(System::TObject* Sender, TUDBtnType Button);

__property TUDClickEvent OnClick;

Beschreibung

TUDClickEvent zeigt auf die Methode, die auf das Ereignis OnClick reagiert. Der Parameter Button gibt die Schaltfläche an, auf die geklickt wurde: btNext steht für den Pfeil, der nach rechts oder nach oben zeigt, btPrev steht für den nach unten oder nach links zeigenden Pfeil.


Methoden von TCustomUpDown

TCustomUpDown	Alphabetisch	Legende

In TCustomUpDown

~TCustomUpDown

Click

CreateParams

TCustomUpDown

Abgeleitet von TWinControl

Broadcast

CanFocus

ContainsControl

ControlAtPos

DisableAlign

EnableAlign

Focused

GetTabOrderList

HandleAllocated

HandleNeeded

InsertControl

Invalidate

PaintTo

Realign

RemoveControl

Repaint

ScaleBy

ScrollBy

SetBounds

SetFocus

Update

UpdateControlState

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

GetTextLen

Hide

Perform

Refresh

ScreenToClient

SendToBack

SetTextBuf

Show

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TCustomUpDown

TCustomUpDown	Nach Objekten	Legende

~TCustomUpDown

Assign

BeginDrag

BringToFront

Broadcast

CanFocus

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

Click

ClientToScreen

ContainsControl

ControlAtPos

CreateParams

DefaultHandler

DestroyComponents

Destroying

DisableAlign

Dispatch

DragDrop

Dragging

EnableAlign

EndDrag

FieldAddress

FindComponent

Focused

FreeInstance

FreeNotification

Free

GetParentComponent

GetTabOrderList

GetTextBuf

GetTextLen

HandleAllocated

HandleNeeded

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InsertControl

InstanceSize

Invalidate

MethodAddress

MethodName

NewInstance

PaintTo

Perform

Realign

Refresh

RemoveComponent

RemoveControl

Repaint

ScaleBy

ScreenToClient

ScrollBy

SendToBack

SetBounds

SetFocus

SetTextBuf

Show

TCustomUpDown

UpdateControlState

Update


TCustomUpDown::~TCustomUpDown

TCustomUpDown	Siehe auch

Der Destruktor ~TCustomUpDown gibt den Speicher frei, der für das TCustomUpDown-Objekt reserviert war. Rufen Sie ~TCustomUpDown nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TCustomUpDown automatisch aufgerufen wird.

__fastcall virtual ~TCustomUpDown(void);parameter in the Params parameter.


TCustomUpDown::CanChange

TCustomUpDown	Siehe auch

Die Methode CanChange ruft die Ereignisbehandlungsroutine für OnChanging auf.

bool __fastcall CanChange(void);

Beschreibung

CanChange ist die als protected deklarierte Implementierungsmethode für das Ereignis OnChanging. Überschreiben Sie diese Methode, wenn Sie vor der Ausführung der Ereignisbehandlungsroutine für OnChanging zusätzliche Bearbeitungsschritte durchführen wollen.


TCustomUpDown::Click

TCustomUpDown	Siehe auch

Die Methode Click ist die als protected deklarierte Implementierung der Methode OnClick.

virtual void __fastcall Click(TUDBtnType Button);

Beschreibung

Überschreiben Sie diese Methode, wenn Sie vor der Ausführung der Ereignisbehandlungsroutine für OnClick zusätzliche Bearbeitungsschritte durchführen wollen.

TUDClickEvent zeigt auf die Methode, die auf das Ereignis OnClick reagiert. Der Parameter Button gibt an, auf welche Schaltfläche geklickt wurde: btNext steht für den Pfeil, der nach rechts oder nach oben zeigt, btPrev steht für den nach unten oder nach links zeigenden Pfeil.


TCustomUpDown::CreateParams

TCustomUpDown

Die Methode CreateParams weist dem Wippregler Initialisierungswerte zu.

virtual void __fastcall CreateParams(Controls::TCreateParams &Params);


TCustomUpDown::TCustomUpDown

TCustomUpDown

Der Konstruktor TCustomUpDown erzeugt ein neues TCustomUpDown-Objekt.

__fastcall virtual TCustomUpDown(Classes::TComponent* AOwner);

Beschreibung

TCustomUpDown ruft die geerbte Methode TCustomUpDown auf und initialisiert dann den Wippregler.


Gültigkeitsbereich

Protected

Published

Zugriff

Read-only


Gültigkeitsbereich

Protected


Gültigkeitsbereich

Protected


Hierarchie

TObject

TPersistent

TComponent

TControl

TWinControl


TCustomUpDown Beispiel

TCustomUpDown


 TDatabase

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/db.hpp

TDatabase bietet verschiedene Möglichkeiten, in einer Datenbankanwendung die Verbindung mit einer einzelnen Datenbank zu steuern.

Beschreibung

Mit Hilfe von TDatabase können Sie folgende Funktionen für eine Datenbankverbindung implementieren:

•	Dauerhafte Datenbankverbindungen.

•	Angepaßte Datenbank-Server-Anmeldungen.

•	Transaktionskontrolle.

•	Anwendungsspezifische BDE-Aliase.

Die besondere Bedeutung der Klasse TDatabase besteht in der Kontrolle, die sie über die Datenbanktransaktionsverarbeitung mit der BDE ermöglicht, wenn eine Verbindung zu einem entfernten SQL-Datenbank-Server besteht.

Hinweis

Die explizite Deklaration einer TDatabase-Komponente für jede einzelne Datenbankverbindung in einer Anwendung ist optional, wenn die Anwendung keine dieser Steuerungsmöglichkeiten für die betreffende Verbindung benötigt. Wenn für eine Datenbankverbindung nicht explizit eine TDatabase-Komponente deklariert und instantiiert wurde, wird zur Laufzeit eine temporäre Datenbankkomponente mit vorgegebenen Eigenschaften erstellt.


Eigenschaften von TDatabase

TDatabase	Alphabetisch	Legende

In TDatabase

AliasName

Connected

DatabaseName

DataSetCount

DataSets

Directory

DriverName

Handle

InTransaction

IsSQLBased

KeepConnection

Locale

LoginPrompt

Params

Session

SessionAlias

SessionName

Temporary

TraceFlags

TransIsolation

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Name

Owner

Tag


Eigenschaften von TDatabase

TDatabase	Nach Objekten	Legende

AliasName

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

Connected

DatabaseName

DataSetCount

DataSets

DesignInfo

Directory

DriverName

Handle

InTransaction

IsSQLBased

KeepConnection

Locale

LoginPrompt

Name

Owner

Params

SessionAlias

SessionName

Session

Tag

Temporary

TraceFlags

TransIsolation


TDatabase::AliasName

TDatabase	Siehe auch

AliasName gibt den Alias der Borland Database Engine (BDE) an, der von dieser Datenbankverbindung verwendet wird.

__property System::AnsiString AliasName;

Beschreibung

Verwenden Sie AliasName, um den Namen eines existierenden BDE-Alias für die Datenbankkomponente anzugeben. In dem BDE-Alias sind Konfigurationsdaten für eine Verbindung zu einem bestimmten Datenbanktyp (z.B. InterBase, dBASE oder Paradox) enthalten. Die Konfigurationsinformationen, die einem BDE-Alias zugewiesen sind, sind vom jeweiligen Datenbanktyp abhängig.

Der Alias übergibt automatisch einen Treibernamen als Parameter. Wenn eine Anwendung AliasName festlegt, wird deshalb der Wert, der vorher der Eigenschaft DriverName zugewiesen war, gelöscht.  Weitere Alias-Verbindungsinformationen werden in der Eigenschaft Params gespeichert, wenn AliasName gesetzt wird.

Hinweis

Der Versuch, AliasName zu setzen, während die Eigenschaft Connected den Wert True hat, führt zu einer Exception.

Hinweis

Wenn die gewünschte BDE-Aliaskonfiguration noch nicht existiert, kann eine Anwendung auch die Eigenschaften DatabaseName, DriverName und Params festlegen, anstatt AliasName zu setzen. Durch die Festlegung von DatabaseName kann eine Anwendung auch einen anwendungsspezifischen „Aliasnamen“ bestimmen, wenn AliasName bereits gesetzt ist.

Tip

Sie können zur Entwurfszeit auf einer TDatabase-Komponente doppelklikken, um den Datenbankeditor aufzurufen und AliasName zu setzen.


TDatabase::Connected

TDatabase	Siehe auch

Connected gibt an, ob eine Datenbankverbindung aktiv ist.

__property bool Connected;

Beschreibung

Indem Sie die Eigenschaft Connected auf True setzen, können Sie eine Datenbankverbindung einrichten, ohne eine Datenmenge zu öffnen. Wenn eine Datenbankverbindung geschlossen werden soll, setzen Sie Connected auf False. Eine Anwendung kann die Eigenschaft Connected überprüfen und damit den aktuellen Status einer Datenbankverbindung feststellen. Wenn Connected den Wert True besitzt, ist die Datenbankverbindung aktiv. Hat Connected den Wert False und ist die Eigenschaft KeepConnection ebenfalls auf False gesetzt, ist die Verbindung nicht aktiv.

Hinweis

Setzen Sie KeepConnection auf True. Dadurch läßt sich vermeiden, daß bei jeder erneuten öffnung der Datenbankverbindung eine Anmeldung beim Server erfolgen muß.


TDatabase::DatabaseName

TDatabase	Siehe auch

Mit DatabaseName wird der Name der Datenbank angegeben, die mit der Datenbankkomponente verbunden werden soll.

__property System::AnsiString DatabaseName;

Beschreibung

Mit der Eigenschaft DatabaseName geben Sie den Namen der Datenbank an, die mit der Datenbankkomponente verwendet werden soll. Falls DatabaseName einem existierenden Alias für die Borland Database Engine (BDE) entspricht, müssen die Eigenschaft AliasName und DriverName nicht gesetzt werden. Entspricht DatabaseName dagegen keinem existierenden BDE-Alias, muß die Anwendung entweder zusätzlich zur Angabe von DatabaseName einen gültigen Alias in der Eigenschaft AliasName angeben oder die Eigenschaften DriverName und Params entsprechend festlegen.

DatabaseName kann ein vollständiger Pfadname sein, wenn eine Verbindung zu einer Paradox- oder dBASE-Datenbank hergestellt wird. Wird ein vollständiger Pfadname angegeben, muß die Anwendung die Eigenschaften DriverName und Params bereitstellen.

Hinweis

Der Versuch, DatabaseName zu setzen, während die Eigenschaft Connected den Wert True hat, führt zu einer Exception.

Tip

Sie können zur Entwurfszeit auf einer TDatabase-Komponente doppelklikken, um den Datenbankeditor aufzurufen und DatabaseName zu setzen.


TDatabase::DataSetCount

TDatabase	Siehe auch

Die Eigenschaft DataSetCount gibt die Anzahl der aktiven Datenmengen an, die mit der Datenbankkomponente verbunden sind.

__property int DataSetCount;

Beschreibung

Mit DataSetCount kann die Anzahl der aktiven Datenmengen bestimmt werden, die mit der Datenbankkomponente verbunden sind. Wenn Datenmengen geöffnet oder geschlossen werden, wird der Wert von DataSetCount entsprechend korrigiert.


TDatabase::DataSets

TDatabase	Siehe auch

DataSets stellt ein indiziertes Array bereit, das alle aktiven Datenmengen für eine Datenbankkomponente enthält.

void __fastcall ApplyUpdates(TDBDataSet* const *DataSets, const int DataSets_Size);

Beschreibung


TDatabase::Directory

TDatabase	Siehe auch

Mit Directory wird das Arbeitsverzeichnis für eine Paradox- oder dBASE-Datenbank festgelegt.

__property System::AnsiString Directory;

Beschreibung

Mit Hilfe der Eigenschaft Directory kann zur Laufzeit das Arbeitsverzeichnis für eine Paradox- oder dBASE-Datenbank ermittelt oder gewechselt werden. Die Datenbanken legen während ihrer Nutzung temporäre Tabellen in diesem Arbeitsverzeichnis an.

Normalerweise wird die Position eines Verzeichnisses über den PATH-Parameter des Datenbank-Alias festgelegt (Eigenschaft AliasName). In bestimmten Situationen kann es aber vorkommen, daß eine Anwendung nach dem öffnen einer Datenbank das Arbeitsverzeichnis zur Laufzeit ändern muß.

Der Wert von Directory kann zur Laufzeit nur geändert werden, wenn eine Datenbank geöffnet ist. Andernfalls wird eine Exception erzeugt. Das Löschen des aktuellen Wertes von Directory hat zur Folge, daß dieser auf das ursprüngliche Arbeitsverzeichnis zurückgesetzt wird, das beim erstmaligen öffnen der Datenbank eingestellt war.

Hinweis

Die Eigenschaft Directory darf nicht eingesetzt werden, wenn eine Verbindung zu einer entfernten Datenbank besteht. Andernfalls wird eine Exception ausgelöst. Ein Zugriff auf Directory, ohne daß eine Datenbank geöffnet ist, führt ebenfalls zu einer Exception.


TDatabase::DriverName

TDatabase	Siehe auch

TDatabase legt den Namen des BDE-Treiber für die Datenbank fest.

__property System::AnsiString DriverName;

Beschreibung

Mit DriverName kann der Name des BDE-Treibers für Datenbankverbindungen angegeben werden, bei denen zwar die Eigenschaft DatabaseName, nicht aber die Eigenschaft AliasName festgelegt ist. DriverName muß einen gültigen BDE-Treiber bezeichnen (z.B. STANDARD, ORACLE, SYBASE oder INTERBASE).

Hinweis

Eine Anwendung, die DriverName festlegt, muß auch die Verbindungsparameter in der Eigenschaft Params bestimmen. Normalerweise werden die Verbindungsparameter über den Alias zur Verfügung gestellt, der in der Eigenschaft AliasName angegeben ist. Wenn DriverName gesetzt ist, wird die Eigenschaft AliasName jedoch automatisch geleert, um Konflikte mit BDE-Treibernamen zu vermeiden.

Der Versuch, DriverName zu setzen, während die Eigenschaft Connected den Wert True hat, führt zu einer Exception.

Tip

Sie können zur Entwurfszeit auf einer TDatabase-Komponente doppelklikken, um den Datenbankeditor aufzurufen und DriverName zu setzen.


TDatabase::Handle

TDatabase	Siehe auch	Beispiel

Handle bezeichnet das Datenbank-Handle für die Borland Database Engine (BDE).

__property Bde::hDBIDb Handle;

Beschreibung

Mit Hilfe von Handle können Sie unter Umgehung der TDatabase-Methoden direkte Aufrufe an die BDE-API übergeben. Für viele BDE-Funktionsaufrufe wird ein Handle als Parameter benötigt. Beim öffnen einer Datenbank wird Handle ein Anfangswert zugewiesen.

Hinweis

Setzen Sie diese Eigenschaft nur dann, wenn für die Anwendung BDE-Funktionen benötigt werden, die nicht über die Standardkomponenten von Borland C++Builder zugänglich sind.


TDatabase::InTransaction

TDatabase	Siehe auch

InTransaction gibt an, ob aktuell eine Datenbanktransaktion ausgeführt wird.

__property bool InTransaction;

Beschreibung

Durch eine Überprüfung von InTransaction zur Laufzeit kann festgestellt werden, ob gerade eine Datenbanktransaktion ausgeführt wird. InTransaction ist True, wenn eine Transaktion stattfindet, ansonsten False.

Der Wert der Eigenschaft kann nicht direkt geändert werden. InTransaction wird durch den Aufruf der Methode StartTransaction auf True gesetzt. Durch den Aufruf der Methode Commit oder Rollback wird InTransaction auf False gesetzt.


TDatabase::IsSQLBased

TDatabase	Siehe auch

IsSQLBased gibt an, ob eine Datenbankkomponente den SQL Links-Treiber der Borland Database Engine (BDE) oder den ODBC-Socket der BDE verwendet.

__property bool IsSQLBased;

Beschreibung

Durch eine Überprüfung von IsSQLBased zur Laufzeit können Sie feststellen, ob eine Datenbankverbindung einen SQL Links-Treiber der BDE, einen ODBC-Socket oder einen Paradox-, dBASE- oder STANDARD-Treiber für ASCII-Textdateien verwendet. Wenn IsSQLBased True ist, wird für die Verbindung ein SQL Links-Treiber oder der ODBC-Socket für die Kommunikation mit einen ODBC-Treiber eines anderen Herstellers eingesetzt. Wenn die Verbindung den Treiber STANDARD verwendet, hat IsSQLBased den Wert False.


TDatabase::KeepConnection

TDatabase	Siehe auch

KeepConnection legt fest, ob eine Anwendung auch dann mit einer Datenbank verbunden bleibt, wenn keine Datenmengen geöffnet sind.

__property bool KeepConnection;

Beschreibung

Mit KeepConnection können Sie angeben, ob eine Anwendung auch dann mit einer Datenbank verbunden bleibt, wenn aktuell keine Datenmengen geöffnet sind. Wenn KeepConnection True ist (Voreinstellung) wird die Verbindung aufrechterhalten. Setzen Sie bei Verbindungen zu entfernten Datenbank-Servern oder zu Anwendungen, in denen Datenmengen häufig geöffnet und geschlossen werden, KeepConnection auf True. Dadurch läßt sich die Belastung des Netzwerks reduzieren, die Anwendungen werden beschleunigt, und die Anmeldung beim Server zum erneuten Verbindungsaufbau wird vermieden.

Wenn KeepConnection False ist, wird die Verbindung beim Fehlen einer geöffneten Datenmenge gelöst. Durch das Aufheben einer Verbindung werden die ihr zugewiesenen Systemressourcen freigegeben. Wird später wieder eine Datenmenge der Datenbank geöffnet, muß die Verbindung wiederhergestellt und initialisiert werden.

Hinweis

Die Einstellung der Eigenschaft KeepConnection für temporäre Datenbankkomponenten, die Borland C++Builder bei Bedarf automatisch erzeugt, wird durch die Eigenschaft KeepConnections von TSession bestimmt.


TDatabase::Locale

TDatabase	Siehe auch

Die Eigenschaft Locale bezeichnet den Borland Database Engine-Sprachtreiber (BDE-Treiber) für die Datenbankkomponente.

__property void * Locale;

Beschreibung

Überprüfen Sie die Eigenschaft Locale, um den BDE-Sprachtreiber zu bestimmen, der von der Datenbankkomponente verwendet wird. Anwendungen, die die BDE direkt aufrufen, müssen unter Umständen die von der Eigenschaft gelieferten Informationen als Parameter an eine API-Funktion übergeben.

Wenn eine Datenbankkomponente einen BDE-Alias verwendet, können Informationen über Sprachtreiber auch in einem Wert der Eigenschaft Params enthalten sein.

Hinweis

Setzen Sie diese Eigenschaft nur, wenn für die Anwendung BDE-Funktionen benötigt werden, die nicht über die Standardkomponenten von Borland C++Builder zugänglich sind.


TDatabase::LoginPrompt

TDatabase	Siehe auch

LoginPrompt gibt an, ob beim Aufbau einer Datenbankverbindung ein Standarddialogfeld für die Anmeldung angezeigt wird.

__property bool LoginPrompt;

Beschreibung

Mit LoginPrompt können Sie die Anmeldemethode für Verbindungen zu Remote-Datenbanken bestimmen. Hat diese Eigenschaft den Wert True (Voreinstellung), wird beim Versuch, die Verbindung zu einer Datenbank herzustellen, das Standard-Anmeldedialogfeld von Borland C++Builder angezeigt. In diesem Standarddialogfeld wird der Benutzer zur Eingabe eines gültigen Benutzernamens und Kennworts aufgefordert.  Sind die vom Benutzer eingegebenen Informationen ungültig, wird die Verbindung nicht hergestellt.

Wenn in einer Anwendung die Eigenschaft LoginPrompt auf False gesetzt ist, müssen Benutzername und Kennwort entweder in einem OnLogin-Ereignis oder mit den Parametern USERNAME und PASSWORD der Eigenschaft Params angegeben werden.

Hinweis

Wenn der Benutzername und das Kennwort in der Eigenschaft Params oder im Code für ein OnLogin-Ereignis fest codiert werden, ist der Zugriffschutz für den Server nicht mehr gewährleistet.


TDatabase::Params

TDatabase	Siehe auch

Params enthält die Datenbankparameter für den Borland Database Engine-Alias (BDE-Alias), der mit der Datenbankkomponente verbunden ist.

__property Classes::TStrings* Params;

Beschreibung

Mit Params können Sie die Datenbankverbindungsparameter überprüfen oder festlegen. Dazu gehören der Pfadname, die Größe des Struktur-Cache, der Sprachtreiber, der Benutzername und das Kennwort.  Die Parameter der Eigenschaft Params sind vom BDE-Alias und dem Treiber für die Datenbankkomponente abhängig.

Params enthält einige Strings. Jeder Eintrag stellt einen Datenbankverbindungsparameter dar. Ist in der Eigenschaft AliasName ein gültiger BDE-Alias angegeben, enthält Params automatisch die für diesen Alias definierten Parameter. Wenn eine Anwendung keinen Alias angibt, sondern über die Eigenschaft DriverName einen lokalen Alias angibt, muß sie die Params-Werte bereitstellen.

Tip

Sie können zur Entwurfszeit auf einer TDatabase-Komponente doppelklikken, um den Datenbankeditor aufzurufen und Params zu setzen.


TDatabase::Session

TDatabase	Siehe auch

Session zeigt auf die Sitzungskomponente, mit der diese Datenbankkomponente verbunden ist.

__property TSession* Session;

Beschreibung

Mit Session bestimmen Sie die Sitzungskomponente, über die die Datenbankkomponente gesteuert wird. Eine Datenbankkomponente ist standardmäßig mit der Standardsitzungskomponente Session verbunden. Diese wird für alle Datenbankanwendungen automatisch erzeugt. Wenn Sie in einer Multi-Thread-Anwendung eine Datenbankkomponente einer anderen Sitzung zuweisen wollen, geben Sie den Namen der betreffenden Sitzungskomponente in der Eigenschaft SessionName an.


TDatabase::SessionAlias

TDatabase	Siehe auch

SessionAlias gibt an, ob eine Datenbankkomponente einen Sitzungsalias verwendet.

__property bool SessionAlias;

Beschreibung

Durch eine Überprüfung von SessionAlias können Sie feststellen, ob eine Datenbankkomponente einen Sitzungsalias benutzt. Wenn SessionAlias den Wert True hat, wird ein Sitzungsalias verwendet. Ist SessionAlias dagegen False, benutzt die Datenbankkomponente keinen Sitzungsalias.

Ein Sitzungsalias wird automatisch für jede Datenbankkomponente erstellt, die anstelle der Eigenschaft AliasName die Eigenschaften DriverName und Params verwendet und deren Eigenschaft Params Werte enthält. Ein Sitzungsalias kann auch angelegt werden, damit sich der Benutzer mit einem anderen Benutzernamen als dem in der Eigenschaft Params angegebenen bei einem Server anmelden kann.

Ein Sitzungsalias existiert nur während der Ausführung der Anwendung. Er wird nicht in der BDE-Konfigurationsdatei gespeichert. Der Zugriff auf den Sitzungsalias ist daher nur in der Anwendung möglich.


TDatabase::SessionName

TDatabase	Siehe auch

Bezeichnet den Namen der Sitzung, die von dieser Datenbankkomponente benutzt wird.

__property System::AnsiString SessionName;

Beschreibung

Mit SessionName geben Sie die Sitzung an, mit der eine Datenbankkomponente verbunden ist. Wenn SessionName leer ist, wird eine Datenbankkomponente automatisch mit der Standardsitzung Session verbunden.

Wenn eine Datenbankkomponente mit einer anderen Sitzung der Datenbankanwendung verbunden werden soll, muß SessionName mit der Eigenschaft SessionName einer existierenden Sitzungskomponente übereinstimmen.


TDatabase::Temporary

TDatabase	Siehe auch

Temporary ermittelt, ob es sich bei der Datenbankkomponente um eine temporäre Komponente handelt, die vom System bei Bedarf erzeugt wird, oder um eine dauerhafte Komponente, die innerhalb der Anwendung explizit erstellt, verwaltet und freigegeben wird.

__property bool Temporary;

Beschreibung

Durch die Überprüfung von Temporary können Sie feststellen, ob es sich bei einer Datenbankkomponente um eine temporäre Komponente handelt, die intern vom System erzeugt wurde, oder um eine dauerhafte Komponente, die innerhalb der Anwendung erstellt, verwaltet und freigegeben wird. Wenn die Komponente vom System generiert wurde, ist Temporary True, andernfalls False.

Das System erstellt eine temporäre Datenbankkomponente, wenn eine Datenmenge geöffnet wird, die noch nicht mit einer vorhandenen Datenbankkomponente verbunden ist. Bleibt Temporary True, wird die temporäre Datenbankkomponente beim Schließen der zugehörigen Datenmenge freigegeben. Eine Anwendung kann die Freigabe einer temporären Datenbankkomponente verhindern, indem sie Temporary auf False setzt, während die Datenmenge aktiv ist. Die Anwendung muß dann aber die Datenbank schließen, sobald diese nicht mehr benötigt wird.


TDatabase::TraceFlags

TDatabase	Siehe auch

TraceFlags legt die Datenbankoperationen fest, die während der Laufzeit mit dem SQL-Monitor überwacht werden sollen.

__property TTraceFlags TraceFlags;

Beschreibung

Mit TraceFlags können Sie angeben, welche Datenbankoperationen zur Laufzeit der Anwendung vom SQL-Monitor protokolliert werden sollen. TraceFlags wirkt sich nur auf den SQL-Monitor aus. Mit dem SQL-Monitor kann die Leistung bei Verwendung entfernter SQL-Datenbank-Server verbessert werden.

Hinweis

In der Regel werden die Optionen nicht mit Hilfe von TraceFlags im Anwendungscode, sondern direkt im SQL-Monitor festgelegt.

Der Anfangswert der Eigenschaft TraceFlags einer Datenbankkomponente wird durch die Eigenschaft TraceFlags der übergeordneten Sitzungskomponente bestimmt.

Der Typ TTraceFlags definiert die Werte, die in der Eigenschaft TraceFlags angegeben werden können. In der folgenden Tabelle sind diese Werte zusammengefaßt:

Wert	Bedeutung

tfQPrepare	Überwachung von Prepare-Anweisungen.

tfQExecute	Überwachung von ExecSQL-Anweisungen.

tfError	Überwachung von Server-Fehlermeldungen. Diese Meldungen können einen Fehlercode enthalten.

tfStmt	Überwachung aller SQL-Anweisungen.

tfConnect	Überwachung von Operationen, die eine Verbindung zu einer Datenbank aufbauen oder trennen. Dazu gehört auch die Zuweisung und Freigabe von Verbindungs-Handles.

tfTransact	Überwachung von Transaktionsanweisungen wie StartTransaction, Commit und Rollback.

tfBlob	Überwachung von Operationen mit BLOB-Datentypen.

tfMisc	Überwachung aller Anweisungen, die von den anderen TTraceFlags-Werten nicht berücksichtigt werden.

tfVendor	Überwachung direkter API-Funktionsaufrufe an den Datenbank-Server.

Da TraceFlags eine Mengeneigenschaft ist, können in einer Anwendung mehrere Kombinationen von Optionen für unterschiedliche Anweisungen festgelegt werden.


TDatabase::TransIsolation

TDatabase	Siehe auch

TransIsolation legt die Isolationsstufe für Transaktionen fest, die von der Borland Database Engine (BDE) verwaltet werden.

__property TTransIsolation TransIsolation;

Beschreibung

Mit Hilfe von TransIsolation können Sie angeben, welche Isolationsstufe für Datenbanktransaktionen verwendet wird, die von der BDE verwaltet werden. Die Isolationsstufe einer Transaktion bestimmt, wie die Transaktion mit anderen, gleichzeitig ablaufenden Transaktionen interagiert, die auf dieselben Tabellen zugreifen. Außerdem legt die Isolationsstufe fest, welche Operationen anderer Transaktionen für die Transaktion sichtbar sind.

Hinweis

Anwendungen, die die Transaktionsverwaltung über Passthrough-SQL implementieren, müssen mit Hilfe der entsprechenden SQL-Anweisung eine Isolationsstufe direkt an den Datenbank-Server übergeben.

Die folgende Tabelle enthält die Werte, die für TransIsolation angegeben werden können:

Isolationsstufe	Bedeutung

tiDirtyRead	Erlaubt das Lesen von Änderungen, die andere, gleichzeitig ablaufende Transaktionen an der Datenbank vorgenommen haben, und die noch nicht eingetragen wurden. Nicht eingetragene Änderungen sind nicht von Dauer und können jederzeit rückgängig (Rollback) gemacht werden. Eine Transaktion mit dieser Isolationsstufe ist am wenigsten von den Auswirkungen anderer Transaktionen isoliert.

tiReadCommitted	Erlaubt das Lesen von eingetragenen (dauerhaften) Änderungen, die andere, gleichzeitig ablaufende Transaktionen an der Datenbank vorgenommen haben. Dies ist die Vorgabe für den Wert der Eigenschaft TransIsolation.

tiRepeatableRead	Erlaubt ein einmaliges Lesen der Datenbank. Änderungen, die nach diesem Lesevorgang von anderen, gleichzeitig ablaufenden Transaktionen an der Datenbank vorgenommen werden, sind für die Transaktion nicht sichtbar. Durch diese Isolationsstufe ist gewährleistet, daß sich der Inhalt eines Datensatzes, der von der Transaktion gelesen wurde, für diese Transaktion nicht mehr ändert (sofern die Transaktion nicht selbst eine Änderung an dem Datensatz vornimmt). Eine Transaktion mit dieser Isolationsstufe ist von anderen Transaktionen am stärksten isoliert.

 Verschiedene Datenbank-Server unterstützen unterschiedliche Isolationsstufen für Transaktionen. Wenn eine Anwendung TransIsolation auf eine Stufe setzt, die von dem entfernten SQL-Server nicht unterstützt wird, verwendet die BDE die nächsthöhere Stufe, die dieser Server zuläßt. Die folgende Tabelle enthält die Isolationsstufen der von der Borland Database Engine unterstützten Server:

Server	Angegebene Stufe	Verwendete Stufe

Oracle	tiDirtyRead
tiReadCommitted
tiRepeatableRead	tiReadCommitted
tiReadCommitted
tiRepeatableRead (READONLY)

Sybase, MS-SQL	tiDirtyRead
tiReadCommitted
tiRepeatableRead	tiReadCommitted
tiReadCommitted
Nicht unterstützt

DB2	tiDirtyRead
tiReadCommitted
tiRepeatableRead	tiDirtyRead
tiReadCommitted
tiRepeatableRead

Informix	tiDirtyRead
tiReadCommitted
tiRepeatableRead	tiDirtyRead
tiReadCommitted
tiRepeatableRead

InterBase	tiDirtyRead
tiReadCommitted
tiRepeatableRead	tiReadCommitted
tiReadCommitted
tiRepeatableRead

Paradox, dBASE	tiDirtyRead
tiReadCommitted
tiRepeatableRead	tiDirtyRead
Nicht unterstützt
Nicht unterstützt

Hinweis

Für lokale Transaktionen mit Paradox oder dBASE muß TransIsolation auf tiDirtyRead gesetzt werden. Andernfalls wird eine Exception ausgelöst.

Wenn eine Anwendung ODBC als Schnittstelle zu einem Server benutzt, muß auch der ODBC-Treiber die Isolationsstufe unterstützen. Informationen über die unterstützten Isolationsstufen finden Sie in der Dokumentation des verwendeten ODBC-Treibers.


Ereignisse von TDatabase

TDatabase	Alphabetisch	Legende

In TDatabase

OnLogin


Ereignisse von TDatabase

TDatabase	Nach Objekten	Legende

OnLogin


TDatabase::OnLogin

TDatabase	Siehe auch

OnLogin tritt ein, wenn eine Anwendung eine Verbindung zu einer Datenbank aufbaut.

typedef void __fastcall (__closure *TLoginEvent)(TDatabase* Database, Classes::TStrings* LoginParams);

__property TLoginEvent OnLogin;

Beschreibung

Mit Hilfe einer Ereignisbehandlungsroutine für OnLogin können Sie bestimmte Aktionen definieren, die ausgeführt werden, wenn die Anwendung eine Verbindung zu einer Datenbank herstellt. Tritt ein OnLogin-Ereignis ein, wird standardmäßig der aktuelle Benutzername (USERNAME) aus der Eigenschaft Params gelesen und ein Standarddialogfeld zur Anmeldung geöffnet. In diesem Dialogfeld wird der Benutzer zur Eingabe von Benutzername und Kennwort aufgefordert. Die eingegeben Werte werden dann zum Setzen der Werte von USERNAME und PASSWORD in der Eigenschaft Params verwendet.  Anschließend werden diese Werte dann an den Remote-Server übergeben.

Anwendungen, in denen alternative Ereignisbehandlungsroutinen für OnLogin definiert wurden, müssen die Werte von USERNAME und PASSWORD in LoginParams festlegen. Sobald eine Verbindung eingerichtet ist, kann der Wert von PASSWORD verworfen werden, um Beeinträchtigungen des Zugriffschutzes für den Server zu vermeiden.


Methoden von TDatabase

TDatabase	Alphabetisch

In TDatabase

~TDatabase

ApplyUpdates

Close

CloseDataSets

Commit

FlushSchemaCache

Open

Rollback

StartTransaction

TDatabase

ValidateName

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TDatabase

TDatabase	Nach Objekten

~TDatabase

ApplyUpdates

Assign

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

CloseDataSets

Close

Commit

DefaultHandler

DestroyComponents

Destroying

Dispatch

FieldAddress

FindComponent

FlushSchemaCache

FreeInstance

FreeNotification

Free

GetParentComponent

HasParent

InheritsFrom

InitInstance

InsertComponent

InstanceSize

MethodAddress

MethodName

NewInstance

Open

RemoveComponent

Rollback

StartTransaction

TDatabase

ValidateName


TDatabase::~TDatabase

TDatabase	Siehe auch

Der Destruktor ~TDatabase gibt den Speicher frei, der für das TDatabase-Objekt reserviert war. Rufen Sie ~TDatabase nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TDatabase automatisch aufgerufen wird.

__fastcall virtual ~TDatabase(void);

Beschreibung

~TDatabase schließt alle aktiven Datenmengen und beendet gegebenenfalls die Verbindung zum Datenbank-Server. Anschließend werden vor dem Aufruf des Destruktors des übergeordneten Objekts die String-Ressourcen freigegeben, die den Eigenschaften Params und DataSets zugewiesen waren.


TDatabase::ApplyUpdates

TDatabase	Siehe auch

ApplyUpdates trägt alle anstehenden zwischengespeicherten Aktualisierungen für die angegebenen Datenmengen auf dem Datenbank-Server ein.

void __fastcall ApplyUpdates(TDBDataSet* const *DataSets, const int DataSets_Size);

Beschreibung

Durch einen Aufruf von ApplyUpdates können die vorhandenen zwischengespeicherten Aktualisierungen für eine bestimmte Gruppe von geöffneten Datenmengen auf dem Datenbank-Server eingetragen werden. ApplyUpdates wirkt sich nur aus, wenn die Eigenschaft CachedUpdates für die angegebene Datenmenge den Wert True hat.

DataSets enthält eine Liste mit den Namen der Datenmengen, für die das Eintragen der anstehenden Aktualisierungen durchgeführt werden soll. In DataSets muß nicht jede Datenmenge aufgeführt sein, die aktuell geöffnet ist. ApplyUpdates ruft für jede angegebene Datenmenge die zugehörige ApplyUpdates- und CommitUpdates-Methode auf, um die zwischengespeicherten Aktualisierungen einzutragen.

Das Eintragen der Aktualisierungen erfolgt in einer zweistufigen Operation im Kontext der Transaktionskontrolle der Datenbankkomponente.  Wenn eine Anwendung ApplyUpdates aufruft, werden die folgenden Aktionen ausgeführt:

1	Eine Datenbanktransaktion wird begonnen.

2	Zwischengespeicherte Aktualisierungen werden in die Datenbank geschrieben (Stufe 1).

Wenn das Schreiben in die Datenbank erfolgreich war, wird folgendermaßen fortgefahren:

1	Die Änderungen an der Datenbank werden eingetragen, und die Transaktion wird beendet.

2	Zwischengespeicherte Aktualisierungen werden eingetragen, und der interne Zwischenspeicher wird geleert (Stufe 2).

Wenn das Schreiben in die Datenbank fehlschlägt, werden die Änderungen durch einen Rollback zurückgenommen, und die Transaktion wird beendet.

Dieser zweistufige Ansatz ermöglicht eine wirkungsvolle Fehlerbehandlung speziell bei der Aktualisierung mehrerer Datenmengen, die miteinander in Beziehung stehen (z.B. Datenmengen, die in einem Haupt-/Detailformular verbunden sind).


TDatabase::Close

TDatabase	Siehe auch

Close schließt alle geöffneten Datenmengen, die mit der Datenbankkomponente verbunden sind, und beendet die Verbindung zum Datenbank-Server.

void __fastcall Close(void);

Beschreibung

Durch den Aufruf von Close beenden Sie die Verbindung zu einem Datenbank-Server. Dadurch werden alle Systemressourcen freigegeben, die der Verbindung zugewiesen waren.

Hinweis

Close wird automatisch aufgerufen, wenn keine geöffneten Datenmengen mehr mit der Datenbankkomponente verbunden sind und die Eigenschaft KeepConnection den Wert False hat. Sie können eine Datenbankverbindung auch schließen, indem Sie die Eigenschaft Connected auf False setzen.


TDatabase::CloseDataSets

TDatabase	Siehe auch

CloseDataSets schließt alle Datenmengen, die mit der Datenbankkomponente verbunden sind, beendet die Verbindung zum Datenbank-Server aber nicht.

void __fastcall CloseDataSets(void);

Beschreibung

Durch einen Aufruf von CloseDataSets können Sie alle aktiven Datenmengen schließen, ohne die Verbindung zum Datenbank-Server zu beenden. Wenn eine Anwendung Close aufruft, werden alle Datenmengen geschlossen und die Verbindung zum Datenbank-Server wird beendet. Ein Aufruf von CloseDataSets schließt ebenfalls alle aktiven Datenmengen einer Anwendung. Falls zu einem späteren Zeitpunkt wieder ein Zugriff auf den Datenbank-Server erforderlich ist, muß die Verbindung nicht neu aufgebaut werden.


TDatabase::Commit

TDatabase	Siehe auch

Commit speichert alle Änderungen, Einfügungen und Löschungen der Daten der aktuellen Transaktion und beendet sie.

void __fastcall Commit(void);

Beschreibung

Durch einen Aufruf von Commit werden alle Änderungen, Einfügungen und Löschungen der Daten der aktuellen Transaktion dauerhaft auf dem Datenbank-Server gespeichert. Anschließend wird die Transaktion beendet. Die aktuelle Transaktion ist die letzte, die durch einen Aufruf von StartTransaction gestartet wurde.

Hinweis

Vor dem Aufruf von Commit sollte der Status der Eigenschaft InTransaction überprüft werden. Wenn eine Anwendung Commit aufruft, obwohl keine aktuelle Transaktion existiert, führt dies zu einer Exception.


TDatabase::FlushSchemaCache

TDatabase	Siehe auch

Aktualisiert die zwischengespeicherten Strukturinformationen für eine Tabelle.

void __fastcall FlushSchemaCache(const System::AnsiString TableName);

Beschreibung

Rufen Sie FlushSchemaCache auf, wenn sich die Strukturinformationen einer SQL-Tabelle geändert haben (weil beispielsweise ein Feld, ein Index oder eine Tabelle zur Datenbank hinzugefügt oder aus ihr entfernt wurde).

Sobald eine Anwendung eine SQL-Tabelle öffnet, werden Strukturinformationen über die Feldnamen, die Feldtypen und den Index im Arbeitsspeicher abgelegt. Wenn die Struktur einer SQL-Tabelle in einer Anwendung geändert wird, sollten die Strukturinformationen im Speicher durch einen Aufruf von FlushSchemaCache aktualisiert werden.


TDatabase::Open

TDatabase	Siehe auch

Stellt eine Verbindung zu einem Datenbank-Server her.

void __fastcall Open(void);

Beschreibung

Durch den Aufruf von Open kann eine Verbindung zu einem lokalen oder entfernten Datenbank-Server hergestellt werden. Open überprüft, ob die in der Eigenschaft DatabaseName bzw. Directory angegebene Datenbank existiert und ob Benutzername und Kennwort gültig sind. Ist dies der Fall, wird die Verbindung zur Datenbank hergestellt. Falls ein OnLogin-Ereignis für die Datenbank existiert, wird es ausgeführt. Andernfalls wird das Standarddialogfeld für die Anmeldung angezeigt.

Hinweis

Durch das Setzen von Connected auf True kann ebenfalls eine Verbindung zum Datenbank-Server hergestellt werden.


TDatabase::Rollback

TDatabase	Siehe auch

Rollback verwirft alle Änderungen, Einfügungen und Löschungen der aktuellen Transaktion und beendet sie.

void __fastcall Rollback(void);

Beschreibung

Durch den Aufruf von Rollback werden alle Änderungen, Einfügungen und Löschungen zurückgenommen, die an den Daten der aktuellen Transaktion vorgenommen wurden, und die Transaktion wird beendet. Die aktuelle Transaktion ist die letzte, die durch einen Aufruf von StartTransaction gestartet wurde.

Hinweis

Vor dem Aufruf von Rollback sollte der Status der Eigenschaft InTransaction überprüft werden. Wenn eine Anwendung Rollback aufruft, obwohl keine aktuelle Transaktion existiert, führt dies zu einer Exception.


TDatabase::StartTransaction

TDatabase	Siehe auch

StartTransaction startet eine neue Transaktion für den Datenbank-Server.

void __fastcall StartTransaction(void);

Beschreibung

Durch den Aufruf von StartTransaction können Sie eine neue Transaktion für den Datenbank-Server starten. Vor dem Aufruf von StartTransaction sollte der Status der Eigenschaft InTransaction überprüft werden. Wenn InTransaction den Wert True hat, wird bereits eine Transaktion ausgeführt. Wird die aktuelle Transaktion nicht durch einen Commit oder Rollback beendet, führt der Aufruf von StartTransaction zu einer Exception.

Änderungen, Einfügungen und Löschungen, die nach dem Aufruf von StartTransaction stattfinden, werden vom Server zwischengespeichert, bis sie von einer Anwendung mit einem Commit oder mit einem Rollback eingetragen werden.


TDatabase::TDatabase

TDatabase	Siehe auch

Der Konstruktor TDatabase erzeugt ein neues TDatabase-Objekt.

__fastcall virtual TDatabase(Classes::TComponent* AOwner);

Beschreibung

Mit TDatabase können Sie zur Laufzeit eine Datenbank-Komponente erzeugen. Eine Anwendung kann eine Datenbank-Komponente erzeugen, um das Objekt selbst zu kontrollieren und seine Eigenschaften und Ereignisse zu setzen, oder zur Laufzeit die benötigten Datenbank-Komponenten von Borland C++Builder erzeugen lassen.

TDatabase instantiiert eine Datenbank-Komponente und

•	weist der Eigenschaft Session die aktive Sitzung zu.

•	weist der Eigenschaft SessionName den Namen der aktiven Sitzungskomponente zu.

•	fügt diese Komponente der Liste der Datenbank-Komponenten hinzu.

•	erzeugt eine leere Liste von Datenbank-Komponenten für die Eigenschaft DataSets.

•	erzeugt eine leere String-Liste für die Eigenschaft Params.

•	setzt die Eigenschaften LoginPrompt und KeepConnection auf True.

•	weist der Eigenschaft Locale die Ländereinstellungen der Sitzung zu.

•	setzt die Eigenschaft TransIsolation auf tiReadCommitted.


TDatabase::ValidateName

TDatabase	Siehe auch

Diese Methode löst eine Exception aus, wenn die angegebene Datenbank bereits in der aktiven Sitzung geöffnet ist.

void __fastcall ValidateName(const System::AnsiString Name);

Beschreibung

Durch einen Aufruf von ValidateName kann ein Mehrfachzugriff auf dieselbe Datenbank in einer Sitzung verhindert werden. Name ist ein String mit dem Namen der zu überprüfenden Datenbank. Ist die Datenbank bereits geöffnet, löst ValidateName die Exception EDatabaseError aus. Falls die Datenbank noch nicht geöffnet ist, wird die Anwendungsausführung fortgesetzt.

Hinweis

In den meisten Anwendungen ist ein direkter Aufruf dieser Methode nicht erforderlich. Sie wird bei jedem öffnen einer Datenbank automatisch aufgerufen.


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent


TDatabase Beispiel

TDatabase


TDataLink

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/db.hpp

TDataLink ist eine Hilfsklasse, die von datensensitiven Objekten verwendet wird, um die Aktionen von TDataSource und TDataSet zu koordinieren und auf Datenereignisse zu reagieren.

Beschreibung

TDataLink und seine Nachkommen können in beliebigen datensensitiven Objekten verwendet werden, die auf Datenereignisse reagieren oder ihre Verknüpfung mit einer Datenmenge über die Eigenschaft DataSource implementieren.

Der Konstruktor des datensensitiven Objekts sollte den Konstruktor von TDataLink aufrufen und alle relevanten Eigenschaften initialisieren. Das datensensitive Objekt kann dann über die Eigenschaft DataSource des TDataLink-Objekts mit einem TDataSource-Objekt verknüpft werden.

Datensensitive Objekte, die nur mit einem einzigen Feld einer Datenmenge verknüpft sind, sollten statt dessen ein TFieldDataLink-Objekt verwenden.


Eigenschaften von TDataLink

TDataLink	Alphabetisch	Legende

In TDataLink

Active

ActiveRecord

BufferCount

DataSet

DataSource

DataSourceFixed

Editing

ReadOnly

RecordCount


Eigenschaften von TDataLink

TDataLink	Nach Objekten	Legende

ActiveRecord

Active

BufferCount

DataSet

DataSourceFixed

DataSource

Editing

ReadOnly

RecordCount


TDataLink::Active

TDataLink	Siehe auch

Die Eigenschaft Active gibt an, ob die von TDataLink verwaltete Datenmenge aktiv ist.

__property bool Active;

Beschreibung

Mit einem Lesezugriff auf Active können Sie feststellen, ob die Datenmenge des TDataLink-Objekts aktiv ist. Wenn Active den Wert False hat, ist die Datenmenge geschlossen und erlaubt keinen Lese- oder Schreibzugriff auf die Datenbank. Ist Active True, kann aus der Datenmenge gelesen bzw. in die Datenmenge geschrieben werden.


TDataLink::ActiveRecord

TDataLink	Siehe auch

Die Eigenschaft ActiveRecord gibt den Index des aktuellen Datensatzes innerhalb des internen Datensatzpuffers an, der von der Datenmenge für den Eigentümer des TDataLink-Objekts verwaltet wird.

__property int ActiveRecord;

Beschreibung

Mit ActiveRecord können Sie in einer Anzahl von Datensätzen, die von der Datenmenge verwaltet werden, den aktuellen Datensatz ermitteln oder festlegen. Die Datenmenge puffert alle Datensätze, die gleichzeitig sichtbar sind. Wenn dem TDataLink-Objekt beispielsweise ein datensensitives Gitter übergeordnet ist, entspricht die Anzahl der gepufferten Datensätze der Anzahl der Zeilen, die vom Gitter angezeigt werden, wobei ActiveRecord die aktuelle Zeile angibt.


TDataLink::BufferCount

TDataLink	Siehe auch

Die Eigenschaft BufferCount gibt die Größe der Datensatzmenge an, die von der Datenmenge für den Eigentümer des TDataLink-Objekts verwaltet wird.

__property int BufferCount;

Beschreibung

Mit BufferCount können Sie festlegen, wieviele Datensätze für den Eigentümer des TDataLink-Objekts in der Datenmenge gepuffert werden sollen. Ein datensensitives Gitter setzt den Wert dieser Eigenschaft beispielsweise auf die Anzahl der im Gitter sichtbaren Zeilen.

Mit einem Lesezugriff auf BufferCount können Sie alle Datensätze durchlaufen, die von der Datenmenge für den Eigentümer des TDataLink-Objekts gepuffert werden. Ein datensensitives Objekt kann sich z.B. selbst darstellen, indem es die Datensatzmenge durchläuft und ActiveRecord hochzählt.


TDataLink::DataSet

TDataLink	Siehe auch

Die Eigenschaft DataSet gibt an, welches DataSet-Objekt die Daten in der Datenbank repräsentiert, für die das TDataLink-Objekt zuständig ist.

__property TDataSet* DataSet;

Beschreibung

Mit einem Lesezugriff auf DataSet können Sie ermitteln, welche Datenmenge von diesem TDataLink-Objekt verwaltet wird. Das TDataLink-Objekt reagiert auf Datenereignisse, die vom DataSet-Objekt empfangen werden, und nimmt auf Anweisung des dem TDataLink-Objekt übergeordneten Objekts Änderungen an der Datenmenge vor.


TDataLink::DataSource

TDataLink	Siehe auch

Die Eigenschaft DataSource gibt an, welches TDataSource-Objekt der Eigentümer des TDataLink-Objekts für seine Verknüpfung mit einer Datenmenge verwendet.

__property TDataSource* DataSource;

Beschreibung

Mit DataSource können Sie ermitteln oder festlegen, welches TDataSource-Objekt die Verknüpfung mit der Datenmenge herstellt. TDataLink reagiert auf Datenereignisse, die vom DataSource-Objekt empfangen werden.

Hinweis

Um die Eigenschaft DataSource für ein datensensitives Objekt zu implementieren, das einem TDataLink-Objekt oder einem seiner Nachkommen übergeordnet ist, erzeugen Sie eine Methode, in der Sie die Eigenschaft DataSource des von TDataLink abgeleiteten Elements ermitteln oder festlegen.


TDataLink::DataSourceFixed

TDataLink	Siehe auch

Die Eigenschaft DataSourceFixed gibt an, ob der Eigenschaft DataSource ein Wert zugewiesen werden kann.

__property bool DataSourceFixed;

Beschreibung

Mit DataSourceFixed können Sie feststellen, ob der Wert der Eigenschaft DataSource geändert werden kann. Die Vorgabe ist False, was die Änderung der Eigenschaft ermöglicht.

Wenn die Möglichkeit besteht, daß ein asynchrones Ereignis die Eigenschaft DataSource vor dem Abschluß einer Operation ändert, setzen Sie DataSourceFixed vor Beginn der Operation auf True, um sicherzustellen, daß die DataSource während der Ausführung konstant bleibt. Nach Abschluß der Operation können Sie DataSourceFixed auf False zurücksetzen.

Setzen Sie DataSourceFixed auf True, um zu verhindern, daß die Eigenschaft DataSource eines datensensitiven Objekts, das dem TDataLink-Objekt übergeordnet ist, geändert wird.


TDataLink::Editing

TDataLink	Siehe auch

Die Eigenschaft Editing gibt an, ob sich die Datenquelle im Bearbeitungsmodus befindet.

__property bool Editing;

Beschreibung

Durch einen Lesezugriff auf Editing können Sie feststellen, ob die Datenquelle der Datenmenge einen neuen Datensatz hinzufügt oder den aktuellen Datensatz ändert. Mit der Methode Edit können Sie die Datenmenge in den Bearbeitungsmodus versetzen und so der Eigenschaft Editing den Wert True zuweisen.


TDataLink::ReadOnly

TDataLink	Siehe auch

Die Eigenschaft ReadOnly gibt an, ob die Datenmenge des TDataLink-Objekts geändert werden kann.

__property bool ReadOnly;

Beschreibung

Mit ReadOnly können Sie feststellen, ob die Datenmenge dieses TDataLink-Objekts geändert werden kann. Wenn Sie diese Eigenschaft auf True setzen, schlagen alle nachfolgenden Aufrufe der Methode Edit fehl. Falls sich das DataSource-Objekt in einem Bearbeitungsmodus befindet, wird dieser beendet. Wenn ReadOnly den Wert False hat, können die Daten der Datenmenge geändert werden.


TDataLink::RecordCount

TDataLink	Siehe auch

Die Eigenschaft RecordCount gibt die Anzahl der Datensätze im internen Datensatzpuffer an, der von der Datenmenge für das dem TDataLink-Objekt übergeordnete Objekt verwaltet wird.

__property int RecordCount;

Beschreibung

Mit einem Lesezugriff auf RecordCount können Sie feststellen, wieviele Datensätze sich tatsächlich in dem Puffer befinden, der von der Datenmenge für das dem TDataLink-Objekt übergeordnete Objekt verwaltet wird.

In den meisten Fällen haben RecordCount und BufferCount denselben Wert. RecordCount gibt die Anzahl der Datensätze an, die sich tatsächlich im Datensatzpuffer befinden, im Gegensatz zur Anzahl der Datensätze, die die Datenmenge maximal verwalten kann. Wenn ein datensensitives Gitter mit vier Zeilen beispielsweise nur einen Datensatz enthält, ist BufferCount 4, RecordCount dagegen 1.


Methoden von TDataLink

TDataLink	Alphabetisch	Legende

In TDataLink

~TDataLink

ActiveChanged

CheckBrowseMode

DataSetChanged

DataSetScrolled

Edit

EditingChanged

FocusControl

LayoutChanged

RecordChanged

TDataLink

UpdateData

UpdateRecord

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TDataLink

TDataLink	Nach Objekten	Legende

~TDataLink

ActiveChanged

Assign

CheckBrowseMode

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DataSetChanged

DataSetScrolled

DefaultHandler

Dispatch

EditingChanged

Edit

FieldAddress

FocusControl

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

LayoutChanged

MethodAddress

MethodName

NewInstance

RecordChanged

TDataLink

UpdateData

UpdateRecord


TDataLink::~TDataLink

TDataLink	Siehe auch

Der Destruktor ~TDataLink gibt den Speicher frei, der für das TDataLink-Objekt reserviert war. Rufen Sie ~TDataLink nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TDataLink automatisch aufgerufen wird.

__fastcall virtual ~TDataLink(void);

Beschreibung

~TDataLink entfernt vor dem Aufruf des geerbten Destruktors sämtliche Referenzen auf das TDataLink-Objekt aus dem DataSource-Objekt.

Das TDataLink-Objekt sollte im Destruktor seines übergeordneten Objekts aufgelöst werden. Das übergeordnete Objekt ruft TDataLink in seinem Konstruktor auf.


TDataLink::ActiveChanged

TDataLink	Siehe auch

Die Methode ActiveChanged reagiert auf Änderungen an der Eigenschaft Active.

virtual void __fastcall ActiveChanged(void);

Beschreibung

Die von TDataLink definierte Methode ActiveChanged stellt lediglich eine Schnittstelle dar, mit deren Hilfe eine Methode auf Änderungen an der Eigenschaft Active reagieren kann. Abgeleitete Objekte, die auf solche Änderungen nicht zu reagieren brauchen, können der geerbten Methode erlauben, sie zu ignorieren.


TDataLink::CheckBrowseMode

TDataLink	Siehe auch

Die Methode CheckBrowseMode ermöglicht es datensensitiven Objekten, unmittelbar vor einem Ereignis zu reagieren, bei dem sich die Datenmenge ändern wird.

virtual void __fastcall CheckBrowseMode(void);

Beschreibung

Die von TDataLink definierte Methode CheckBrowse stellt lediglich eine Schnittstelle dar, mit deren Hilfe eine Methode beliebige Statusinformationen kurz vor dem Auftreten einer Änderung an der Datenmenge aktualisieren kann. Abgeleitete Objekte, die auf diese Ereignisse nicht zu reagieren brauchen, können der geerbten Methode erlauben, sie zu ignorieren.


TDataLink::DataSetChanged

TDataLink	Siehe auch

Die Methode DataSetChanged reagiert auf Änderungen an der Datenmenge.

virtual void __fastcall DataSetChanged(void);

Beschreibung

DataSetChanged reagiert auf Änderungen am Inhalt der Datenmenge. Alle Aktionen, die solche Änderungen bewirken (also beispielsweise das Bearbeiten der Daten, das Hinzufügen oder Löschen von Datensätzen oder das Ändern des Schlüssels), und alle Änderungen an der Darstellung der Daten im datensensitiven Objekt (beispielsweise das Verschieben des Bildausschnitts oder Änderungen am Layout von Datenelementen innerhalb des Objekts) lösen diese Methode aus. DataSetChanged ruft einfach RecordChanged auf. Die Methode kann von abgeleiteten Klassen überschrieben werden, um bei Änderungen an der Datenmenge weitere Aktionen durchzuführen.


TDataLink::DataSetScrolled

TDataLink	Siehe auch

Die Methode DataSetScrolled ermöglicht es, auf das Verschieben des Bildausschnitts innerhalb des datensensitiven Objekts zu reagieren.

virtual void __fastcall DataSetScrolled(int Distance);

Beschreibung

Diese Methode ignoriert den Parameter Distance und ruft DataSetChanged auf. DataSetScrolled kann von abgeleiteten Klassen überschrieben werden, um zusätzliche Aktionen durchzuführen, wenn der Bildausschnitt verschoben wird.


TDataLink::Edit

TDataLink	Siehe auch

Die Methode Edit versucht, das DataSource-Objekt in einen Bearbeitungsmodus zu versetzen.

bool __fastcall Edit(void);

Beschreibung

Mit Edit können Sie sicherstellen, daß der aktuelle Datensatz geändert werden kann. Der Rückgabewert True bedeutet, daß sich das DataSource-Objekt bereits im Bearbeitungsmodus befand oder erfolgreich in diesen Modus versetzt wurde. Der Rückgabewert False besagt, daß das DataSource-Objekt nicht in den Bearbeitungsmodus versetzt werden konnte. Wenn beispielsweise die Eigenschaft ReadOnly den Wert True hat, erlaubt Edit keine Bearbeitung und gibt False zurück.


TDataLink::EditingChanged

TDataLink	Siehe auch

Die Methode EditingChanged reagiert auf Änderungen am Bearbeitungsmodus des DataSource-Objekts.

virtual void __fastcall EditingChanged(void);

Beschreibung

Die von TDataLink definierte Methode EditingChanged stellt lediglich eine Schnittstelle dar, mit deren Hilfe eine Methode auf Änderungen am Bearbeitungsmodus des DataSource-Objekts reagieren kann. EditingChanged wird unmittelbar nach jeder Änderung am Wert der Eigenschaft Editing aufgerufen. Abgeleitete Objekte, die auf solche Änderungen nicht zu reagieren brauchen, können der geerbten Methode erlauben, sie zu ignorieren.


TDataLink::FocusControl

TDataLink	Siehe auch

Die Methode FocusControl stellt eine Schnittstelle dar, die es einer Methode ermöglicht, den Fokus auf die datensensitive, mit dem TDataLink-Objekt verknüpfte Komponente zu verlagern.

virtual void __fastcall FocusControl(TFieldRef Field);

Beschreibung

Die von TDataLink definierte Methode FocusControl stellt lediglich eine Schnittstelle dar, mit deren Hilfe eine Methode den Eingabefokus auf ein mit dem TDataLink-Objekt verknüpftes datensensitives Objekt verlagern kann. Abgeleitete Objekte, die von dieser Möglichkeit keinen Gebrauch machen, können der geerbten Methode erlauben, die Aufforderung zu ignorieren.


TDataLink::LayoutChanged

TDataLink	Siehe auch

Die Methode LayoutChanged reagiert auf Änderungen an der Darstellung der Daten durch das datensensitive Objekt.

virtual void __fastcall LayoutChanged(void);

Beschreibung

LayoutChanged ruft einfach die Methode DataSetChanged auf. LayoutChanged stellt eine Schnittstelle dar, mit deren Hilfe eine Methode auf Änderungen an der Darstellung der Daten durch das datensensitive Objekt reagieren kann. Eine solche Änderung könnte beispielsweise die Anzahl oder die Reihenfolge der Spalten in einem TCustomDBGrid-Objekt betreffen.


TDataLink::RecordChanged

TDataLink	Siehe auch

Die Methode RecordChanged reagiert auf Änderungen am Inhalt des aktuellen Datensatzes oder Feldes der Datenmenge.

virtual void __fastcall RecordChanged(TField* Field);

Beschreibung

Die von TDataLink definierte Methode RecordChanged stellt lediglich eine Schnittstelle dar, mit deren Hilfe eine Methode auf Änderungen am Inhalt des aktuellen Datensatzes reagieren kann. RecordChanged wird aufgerufen, nachdem im aktuellen Datensatz der Datenmenge Änderungen gespeichert wurden. Auch DataSetChanged ruft diese Methode auf.

Der Parameter Field gibt an, in welchem Feld des aktuellen Datensatzes sich ein Wert geändert hat. Wenn Field den Wert NULL hat, kann sich eine beliebige Anzahl von Feldern innerhalb des aktuellen Datensatzes geändert haben.

Abgeleitete Objekte, die auf solche Änderungen nicht zu reagieren brauchen, können der geerbten Methode erlauben, sie zu ignorieren.


TDataLink::TDataLink

TDataLink	Siehe auch

Der Konstruktor TDataLink erzeugt ein neues TDataLink-Objekt.

__fastcall TDataLink(void);

Beschreibung

TDataLink wird vom Konstruktor aller datensensitiven Objekte aufgerufen, die ein TDataLink-Objekt zur Implementierung der Eigenschaft DataSource verwenden.

Nachdem der geerbte Konstruktor aufgerufen wurde, initialisiert TDataLink die Eigenschaft BufferCount mit dem Wert 1. Datensensitive Objekte, die ihre Verknüpfung zu einem DataSource-Objekt mit Hilfe eines TDataLink-Objekts unterhalten, sollten nach dem Aufruf des geerbten Konstruktors der Eigenschaft BufferCount die Anzahl der von ihnen repräsentierten Datensätze zuweisen.


TDataLink::UpdateData

TDataLink	Siehe auch

Die Methode UpdateData stellt eine Schnittstelle dar, über die Änderungen an einem Datensatz der Datenmenge gespeichert werden können.

virtual void __fastcall UpdateData(void);

Beschreibung

Die von TDataLink definierte Methode UpdateData stellt lediglich eine Schnittstelle dar, über die eine Methode Änderungen am aktuellen Datensatz der Datenmenge vornehmen kann. Gleichzeitig wird der Aufruf von RecordChanged unterdrückt, den solche Änderungen normalerweise auslösen. Abgeleitete Objekte, die keine Änderungen an der Datenmenge vorzunehmen brauchen, können der geerbten Methode erlauben, keine Aktion durchzuführen.


TDataLink::UpdateRecord

TDataLink	Siehe auch

Die Methode UpdateRecord reagiert auf Botschaften, die besagen, daß Änderungen an der Datenmenge gespeichert werden sollen.

void __fastcall UpdateRecord(void);

Beschreibung

UpdateRecord ruft UpdataData auf und unterdrückt Aufrufe von RecordChanged, die während der Ausführung von UpdateData auftreten können.


Zugriff

Read-only


Gültigkeitsbereich

Protected


Hierarchie

TObject

TPersistent


TDataLink Beispiel

TDataLink


TDataModule

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/forms.hpp

TDataModule ist eine spezialisierte Klasse, mit der die nicht-visuellen Komponenten in einer Anwendung zentral verwaltet werden können.

Beschreibung

Mit einem Datenmodulobjekt stellen Sie in Ihrer Anwendung eine zentrale Möglichkeit zum Verwalten der nicht-visuellen Komponenten bereit. Normalerweise werden hier die Datenzugriffskomponenten (TSession, TSessionList, TDatabase, TTable, TQuery, TStoredProc und TBatchMove) angegeben, Sie können aber auch andere Komponenten wie TTimer, TOpenDialog, TImageList oder TOleContainer hinzufügen.

Während des Entwurfs dient ein TDataModule-Objekt als visueller Container, in den ein Entwickler nicht-visuelle Komponenten einfügen, deren Eigenschaften festlegen und Ereignisbehandlungsroutinen schreiben kann. Mit der Menüoption Datei/Neues Datenmodul können Sie ein Datenmodul erstellen.

In der Unit-Datei des Datenmoduls kann auch die der Anwendung zugrundeliegende Geschäftslogik definiert werden.

Damit das Datenmodul für eine andere Unit in der Anwendung verfügbar ist, wählen Sie zuerst die betreffende Unit aus, und wählen Sie anschließend Datei/Unit verwenden. Dadurch wird das Modul in die uses-Klausel der Unit aufgenommen.


Eigenschaften von TDataModule

TDataModule	Alphabetisch	Legende

In TDataModule

DesignOffset

DesignSize

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TDataModule

TDataModule	Nach Objekten	Legende

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

DesignInfo

DesignOffset

DesignSize

Owner

Tag


TDataModule::DesignOffset

TDataModule	Siehe auch

Die Eigenschaft DesignOffset gibt den Entwurfs-Offset des Datenmoduls während des Entwurfs an.

__property POINT DesignOffset;

Beschreibung

Die Eigenschaft DesignOffset gibt den Entwurfs-Offset des Datenmoduls während des Entwurfs an. In einer Anwendung muß dieser Wert nicht gesetzt werden.


TDataModule::DesignSize

TDataModule	Siehe auch

Die Eigenschaft DesignSize gibt die Entwurfsgröße des Datenmoduls während des Entwurfs an.

__property POINT DesignSize;

Beschreibung

Die Eigenschaft DesignSize gibt die Entwurfsgröße des Datenmoduls während des Entwurfs an. In einer Anwendung muß dieser Wert nicht gesetzt werden.


Ereignisse von TDataModule

TDataModule	Alphabetisch	Legende

In TDataModule

OnCreate

OnDestroy


Ereignisse von TDataModule

TDataModule	Nach Objekten	Legende

OnCreate

OnDestroy


TDataModule::OnCreate

TDataModule	Siehe auch

Das Ereignis OnCreate wird ausgelöst, sobald ein Datenmodul in einer Anwendung instantiiert wird.

__property Classes::TNotifyEvent OnCreate;

Beschreibung

Mit einer Ereignisbehandlungsroutine für OnCreate können spezielle Aktionen durchgeführt werden, wenn ein Datenmodul in einer Anwendung instantiiert wird. Enthält ein Datenmodul beispielsweise Datenbank- und Datenmengenkomponenten, kann eine Anwendung sofort eine Datenbankverbindung einrichten. Enthält das Modul einen Timer, kann dieser von der Anwendung initialisiert werden.


TDataModule::OnDestroy

TDataModule	Siehe auch

Das Ereignis OnDestroy wird ausgelöst, sobald ein Datenmodul in einer Anwendung freigegeben wird.

__property Classes::TNotifyEvent OnDestroy;

Beschreibung

Mit einer Ereignisbehandlungsroutine für OnDestroy können spezielle Aktionen durchgeführt werden, wenn ein Datenmodul in einer Anwendung freigegeben wird. Werden beispielsweise im Unit-Quelltext des Datenmoduls eigene Objekte instantiiert (z. B. Stringlisten), können diese in der Ereignisbehandlungsroutine für OnDestroy freigegeben werden.


Methoden von TDataModule

TDataModule	Alphabetisch

In TDataModule

~TDataModule

TDataModule

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TDataModule

TDataModule	Nach Objekten

~TDataModule

Assign

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

DestroyComponents

Destroying

Dispatch

FieldAddress

FindComponent

FreeInstance

FreeNotification

Free

GetParentComponent

HasParent

InheritsFrom

InitInstance

InsertComponent

InstanceSize

MethodAddress

MethodName

NewInstance

RemoveComponent

TDataModule


TDataModule::~TDataModule

TDataModule	Siehe auch

Der Destruktor ~TDataModule gibt den Speicher frei, der für das TDataModule-Objekt reserviert war. Rufen Sie ~TDataModule nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TDataModule automatisch aufgerufen wird.

__fastcall virtual ~TDataModule(void);


TDataModule::TDataModule

TDataModule	Siehe auch

TDataModule erstellt eine Instanz eines Datenmoduls.

__fastcall virtual TDataModule(Classes::TComponent* AOwner);

-Or-

__fastcall TDataModule(Classes::TComponent* AOwner, int Dummy);

Beschreibung

Mit TDataModule kann ein Datenmodul zur Laufzeit instantiiert werden, falls dies nicht bereits während des Entwurfs geschehen ist. TDataModule ruft CreateNew auf. Bei einem Fehler wird eine Exception ausgelöst. Andernfalls ruft TDataModule die Ereignisbehandlungsroutine für OnCreate des Datenmoduls auf, falls eine solche zugewiesen wurde.


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent


TDataModule Beispiel

TDataModule


TDataSet

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/db.hpp

TDataSet ist die abstrakte Basisklasse für alle Datenmengenkomponenten. Mit diesen Komponenten kann auf die Daten in einer Datenbanktabelle zugegriffen werden.

Beschreibung

In einem TDataSet-Objekt werden die in einer Datenbank gespeicherten Daten gekapselt. TDataSet-Objekte sollten jedoch nicht direkt erstellt oder verwendet werden. Verwenden Sie statt dessen für den Zugriff auf die Datenbank die Nachfahren von TDataSet und TDBDataSet: TTable, TQuery und TStoredProc.

Benutzerdefinierte Datenmengenobjekte sollten nach Bedarf von TDataSet oder TDBDataSet abgeleitet werden. Von TDataSet abgeleitete Objekte sind für Datenmengenobjekte geeignet, die die BDE (Borland Database Engine) umgehen. Die Klasse TDBDataSet ergänzt die grundlegende Datenmengenunterstützung von TDataSet um BDE-Unterstützung in Bezug auf Datenbankverbindungen und Sitzungsverwaltung.


Eigenschaften von TDataSet

TDataSet	Alphabetisch	Legende

In TDataSet

Active

AutoCalcFields

BOF

Bookmark

CachedUpdates

CanModify

DataSource

DefaultFields

Designer

EOF

ExpIndex

FieldCount

FieldDefs

Fields

FieldValues

Filter

Filtered

FilterOptions

Found

Handle

KeySize

Locale

Modified

RecNo

RecordCount

RecordSize

State

UpdateObject

UpdateRecordTypes

UpdatesPending

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TDataSet

TDataSet	Nach Objekten	Legende

Active

AutoCalcFields

BOF

Bookmark

CachedUpdates

CanModify

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

DataSource

DefaultFields

Designer

DesignInfo

EOF

ExpIndex

FieldCount

FieldDefs

Fields

FieldValues

Filtered

FilterOptions

Filter

Found

Handle

KeySize

Locale

Modified

Owner

RecNo

RecordCount

RecordSize

State

Tag

UpdateObject

UpdateRecordTypes

UpdatesPending


TDataSet::Active

TDataSet	Siehe auch

Die Eigenschaft Active gibt an, ob eine Datenmenge geöffnet ist.

__property bool Active;

Beschreibung

Mit Active können Sie die Verbindung einer Datenmenge mit den Daten in einer Datenbank steuern. Hat Active den Wert False, ist die Datenmenge geschlossen und kann nicht auf die Daten in der Datenbank zugreifen. Ist Active auf True gesetzt, können die Datenbankdaten gelesen und geschrieben werden.

Wird Active auf True gesetzt, werden folgende Aktionen durchgeführt:

•	Die Ereignisbehandlungsroutine für BeforeOpen wird ausgelöst (falls vorhanden).

•	Der Status der Datenmenge wird in dsBrowse geändert.

•	Ein BDE-Cursor in die Datenmenge wird geöffnet.

•	Die Ereignisbehandlungsroutine für AfterOpen wird ausgelöst (falls vorhanden).

Tritt beim öffnen der Datenmenge ein Fehler auf, wird ihr Modus in dsInactive geändert und der Cursor geschlossen.

Active muß auf False gesetzt werden, damit die anderen Eigenschaften geändert werden können, die sich auf den Status der Datenbank oder der Steuerelemente auswirken. Soll beispielsweise die Eigenschaft DataSource einer Datenmenge geändert werden, muß Active zuerst auf False gesetzt werden, um die Datenmenge zu schließen. Erhält Active den Wert False, wird die Datenmenge in den Status dsInactive versetzt und der BDE-Cursor geschlossen.

Hinweis

Durch den Aufruf der Methode Open wird Active automatisch auf True, durch den Aufruf von Close automatisch auf False gesetzt.


TDataSet::AutoCalcFields

TDataSet	Siehe auch

Die Eigenschaft AutoCalcFields bestimmt, wann das Ereignis OnCalcFields ausgelöst wird.

__property bool AutoCalcFields;

Beschreibung

Mit AutoCalcFields können Sie steuern, wann das Ereignis OnCalcFields ausgelöst wird, um die Werte der berechneten Felder während der Verarbeitung der Datenmenge zu aktualisieren. Ein berechnetes Feld bezieht seine Werte aus den anderen Feldern in der Datenmenge. Manchmal werden dabei zusätzliche Verarbeitungen durchgeführt. Hat AutoCalcFields den Wert True, wird OnCalcFields in den folgenden Situationen ausgelöst:

•	Beim öffnen einer Datenmenge.

•	Beim Wechseln des Fokus von einem visuellen Steuerelement zu einem anderen bzw. von einer Spalte einer datensensitiven Gitterkomponente zu einer anderen.

•	Beim Abrufen eines Datensatzes aus der Datenbank.

Damit OnCalcFields weniger aufgerufen wird, kann AutoCalcFields auf False gesetzt werden. OnCalcFields wird dann nur bei einem Aufruf der Methode Post ausgelöst. Werden den Benutzern Datenänderungen erlaubt, wird OnCalcFields sehr oft ausgelöst. In diesen Fällen kann mit AutoCalcFields die Aufrufhäufigkeit verringert werden.


TDataSet::BOF

TDataSet	Siehe auch

Die Eigenschaft BOF gibt an, ob sich der Cursor auf dem ersten Datensatz einer Datenmenge befindet.

__property bool Bof;

Beschreibung

Mit BOF können Sie feststellen, ob sich der Cursor auf dem ersten Datensatz einer Datenmenge befindet. Hat BOF den Wert True, befindet sich der Cursor auf der ersten Datenzeile der Datenmenge. BOF wird in den folgenden Situationen in einer Anwendung auf True gesetzt:

•	Eine Datenmenge wird geöffnet.

•	Die Methode First einer Datenmenge wird aufgerufen.

•	Die Methode Prior einer Datenmenge wird aufgerufen und schlägt fehl, weil sich der Cursor bereits im ersten Datensatz befindet.

•	Die Methode SetRange wird für einen leeren Bereich bzw. eine leere Datenmenge aufgerufen.

In allen anderen Fällen hat BOF den Wert False. Sie können daher meistens davon ausgehen, daß BOF den Wert False hat, es sein denn, eine der oben genannten Bedingungen trifft zu und die Eigenschaft wird in der Anwendung direkt abgerufen.

Tip

Haben BOF und EOF den Wert True, ist die Datenmenge bzw. der Bereich leer.


TDataSet::Bookmark

TDataSet	Siehe auch

Die Eigenschaft Bookmark gibt die aktuelle Positionsmarke in einer Datenmenge an.

__property System::AnsiString Bookmark;

Beschreibung

Bookmark ermöglicht den Zugriff auf die aktuelle Positionsmarke in der Datenmenge. Eine Positionsmarke bietet eine bequeme Möglichkeit, eine bestimmte Position in einer Datenmenge zu markieren, um später rasch zu diesem Datensatz zurückzukehren. In einer Anwendung kann Bookmark gelesen werden, um die aktuelle Positionsmarke zu ermitteln, oder auf einen bestimmten Wert gesetzt werden, um die aktuelle Positionsmarke zu ändern.


TDataSet::CachedUpdates

TDataSet	Siehe auch

Die Eigenschaft CachedUpdates legt fest, ob zwischengespeicherte Aktualisierungen für eine Datenmenge verwendet werden.

property CachedUpdates: Boolean;

Beschreibung

Mit CachedUpdates können Sie für eine Datenmenge zwischengespeicherte Aktualisierungen aktivieren oder deaktivieren. Hat CachedUpdates den Wert True, wird die Zwischenspeicherung aktiviert, bei False wird sie deaktiviert.

Bei aktivierter Zwischenspeicherung werden die Aktualisierungen einer Datenmenge (z.B. Eintragen von Änderungen, Einfügen neuer Datensätze oder Löschen von Datensätzen) in einem internen Puffer auf dem Client-Rechner zwischengespeichert und nicht direkt in die zugrundeliegenden Datenbanktabellen geschrieben. Sind die Änderungen abgeschlossen, werden die Daten aus dem Zwischenspeicher in einer einzigen Transaktion in die Datenbank eingetragen.

Zwischengespeicherte Aktualisierungen sind am nützlichsten in Client-Anwendungen, die mit Remote-Datenbank-Servern arbeiten. Die wichtigsten Vorteile dieser Technik sind:

•	Weniger Transaktionen und kürzere Transaktionszeiten.

•	Weniger Datenverkehr im Netzwerk.

Es gibt jedoch auch die folgenden potentiellen Nachteile:

•	Andere Anwendungen können auf die eigentlichen Daten auf dem Server zugreifen und sie ändern, während Benutzer mit den lokalen Kopien der Daten arbeiten. Dadurch können Aktualisierungskonflikte entstehen, sobald die Aktualisierungen aus dem Puffer in die Datenbank geschrieben werden.

•	Andere Anwendungen haben erst Zugriff auf die Änderungen, nachdem die Aktualisierungen aus dem Puffer in die Datenbank geschrieben wurden.


TDataSet::CanModify

TDataSet	Siehe auch

Die Eigenschaft CanModify gibt an, ob die einer Datenmenge zugrundeliegende Datenbank Schreibzugriffe auf die Daten zuläßt.

 __property bool CanModify;

Beschreibung

Mit einem Lesezugriff auf CanModify können Sie feststellen, ob die Datenbank, die einer Datenmenge zugrundeliegt, einen Schreibzugriff auf die Daten zuläßt. Wenn eine Datenbankverbindung eingerichtet ist, fordert eine Datenmenge normalerweise Schreibzugriff an. CanModify signalisiert, ob dies möglich ist. Der Wert True bedeutet, daß Server-Daten geändert und geschrieben werden können. Der Wert False bedeutet, daß Daten nur gelesen werden können.

Hinweis

Bei einem SQL-Server können Einschränkungen des Schreibzugriffs dazu führen, daß bestimmte Benutzer auch dann keinen Schreibzugriff erhalten, wenn CanModify den Wert True hat.


TDataSet::DataSource

TDataSet	Siehe auch

Die Eigenschaft DataSource gibt NULL für Datenmengen zurück, die keine Datenquelle angeben können.

__property TDataSource* DataSource;

Beschreibung

Die Eigenschaft DataSource gibt den Wert NULL zurück, wenn eine Datenmenge keine eigene Datenquelle angeben kann.

Abgeleitete Datenmengenobjekte, die das Angeben einer Datenquelle unterstützen, deklarieren und implementieren Methoden für das Lesen und Schreiben der Eigenschaft DataSource.


TDataSet::DefaultFields

TDataSet	Siehe auch

Die Eigenschaft DefaultFields gibt an, ob die Feldkomponenten beim öffnen einer Datenmenge dynamisch generiert werden.

__property bool DefaultFields;

Beschreibung

Mit DefaultFields können Sie feststellen, ob in einer Datenmenge dynamisch generierte oder persistente Feldkomponenten verwendet werden. Hat DefaultFields den Wert True, werden die Feldkomponenten dynamisch erstellt. Ist DefaultFields auf False gesetzt, werden persistente Komponenten verwendet.

Die Feldkomponenten einer Datenmenge werden immer anhand der Struktur der zugrundeliegenden Datenbanktabelle dynamisch erstellt, wenn während des Entwurfs keine persistenten Komponenten im Feldeditor zugewiesen werden.


TDataSet::Designer

TDataSet	Siehe auch

Die Eigenschaft Designer gibt einen NULL-Zeiger auf den Designer einer Datenmenge zurück.

__property TDataSetDesigner* Designer;

Beschreibung

Die Eigenschaft Designer gibt den Wert NULL zurück, wenn eine Datenmenge keinen Designer angibt. Mit einem Designer (z.B. Feldeditor) kann der Entwickler zur Entwurfszeit die Felder für eine Datenmenge definieren.

Abgeleitete Datenmengenobjekte, die das Angeben eines Designers unterstützen, deklarieren und implementieren Methoden für das Lesen und Schreiben der Eigenschaft Designer.


TDataSet::EOF

TDataSet	Siehe auch

Die Eigenschaft EOF gibt an, ob sich der Cursor auf dem letzten Datensatz einer Datenmenge befindet.

__property bool Eof;

Beschreibung

Mit EOF können Sie feststellen, ob sich der Cursor auf dem letzten Datensatz einer Datenmenge befindet. Hat EOF den Wert True, befindet sich der Cursor auf der letzten Datenzeile der Datenmenge. EOF wird in einer Anwendung in den folgenden Situationen auf True gesetzt:

•	Eine leere Datenmenge wird geöffnet.

•	Die Methode Last einer Datenmenge wird aufgerufen.

•	Die Methode Next einer Datenmenge wird aufgerufen und schlägt fehl, weil sich der Cursor bereits auf dem letzten Datensatz befindet.

•	Die Methode SetRange wird für einen leeren Bereich bzw. eine leere Datenmenge aufgerufen.

In allen anderen Fällen hat EOF den Wert False. Sie können daher davon ausgehen, daß EOF den Wert False hat, sofern keine der oben genannten Bedingungen zutrifft und die Eigenschaft in der Anwendung direkt abgefragt wird.

Tip

Haben EOF und BOF den Wert True, ist die Datenmenge bzw. der Bereich leer.


TDataSet::ExpIndex

TDataSet

Die Eigenschaft ExpIndex gibt an, ob eine Datenmenge einen berechneten Index verwendet.

property ExpIndex: Boolean;

Beschreibung

Mit ExpIndex können Sie ermitteln, ob eine Datenmenge einen berechneten Index verwendet. Hat ExpIndex den Wert True, ist ein berechneter Index in Gebrauch, andernfalls hat ExpIndex den Wert False.


TDataSet::FieldCount

TDataSet	Siehe auch

Die Eigenschaft FieldCount gibt die Anzahl der Feldkomponenten in einer Datenmenge an.

__property int FieldCount;

Beschreibung

Mit FieldCount können Sie feststellen, wie viele Feldkomponenten eine Datenmenge enthält. Werden dynamisch erstellte Felder verwendet, kann der Wert FieldCount bei jedem öffnen der Datenmenge unterschiedlich sein. Bei Datenmengen mit persistenten Feldern sollte FieldCount bei jedem öffnen der Datenmenge identisch sein.


TDataSet::FieldDefs

TDataSet	Siehe auch

Diese Eigenschaft FieldDefs zeigt auf die Liste der Felddefinitionen für die Datenmenge.

__property TFieldDefs* FieldDefs;

Beschreibung

FieldDefs zeigt auf eine interne Liste mit den Felddefinitionen für die Datenmenge. Sie können diesen Wert zwar in Anwendungen lesen, um die Felddefinitionen zu untersuchen, sollten die Definitionen aber nicht ändern. FieldDefs dient hauptsächlich der internen Verwendung durch die anderen Eigenschaften, Ereignisse und Methoden der Klasse TDataSet und ihrer Nachkommen.

Um auf die Felder und Feldwerte in einer Datenmenge zuzugreifen, verwenden Sie die Eigenschaften Fields und FieldValues sowie die Methode FieldsByName.


TDataSet::Fields

TDataSet	Siehe auch

Die Eigenschaft Fields enthält ein indiziertes Array mit allen Feldkomponenten einer Datenmenge.

Bde::hDBIFilter __fastcall CreateLookupFilter(Classes::TList* Fields, const System::Variant &Values,  TLocateOptions Options, int Priority);

Beschreibung

Mit Fields können Sie auf die Feldkomponenten einer Datenmenge über deren Indexnummern zugreifen. Werden die Felder zur Laufzeit dynamisch erstellt, ist die Reihenfolge der Komponenten in Fields mit der Anordnung der Spalten in der zugrundeliegenden Tabelle identisch. Bei persistenten Feldern entspricht die Anordnung der Feldkomponenten der Reihenfolge, die für die Felder im Feldeditor während des Entwurfs festgelegt wurde.

Der Zugriff auf die Felder mit der Eigenschaft Fields ist in folgenden Situationen sinnvoll:

•	Einige oder alle Felder einer Datenmenge sollen in einer Schleife verarbeitet werden.

•	Es muß mit Tabellen gearbeitet werden, deren Struktur zur Laufzeit nicht bekannt ist.

Sind die Datentypen der Felder bekannt, können ihre Werte mit der Eigenschaft Fields gelesen oder geschrieben werden.

Hinweis

Für das Lesen und Schreiben von Feldwerten sollte die Eigenschaft FieldValues verwendet werden.


TDataSet::FieldValues

TDataSet	Siehe auch

Die Eigenschaft FieldValues ermöglicht den Zugriff auf alle Feldwerte im aktuellen Datensatz der Datenmenge.

__property System::Variant FieldValues[System::AnsiString FieldName];

Beschreibung

Mit FieldValues können die Werte der Felder in einer Datenmenge gelesen und geschrieben werden. Der Parameter FieldName gibt den Namen des gewünschten Feldes an und muß in Anführungszeichen gesetzt werden.

FieldValues arbeitet mit jedem Feldtyp zusammen, da für Parameter und Rückgabewert Varianten verwendet werden.


TDataSet::Filter

TDataSet	Siehe auch

Die Eigenschaft Filter legt den Text des aktuellen Filters einer Datenmenge fest.

__property System::AnsiString Filter;

Beschreibung

Mit Filter können Sie einen Filter für eine Datenmenge angeben. Wird eine Datenmenge gefiltert, sind nur die Datensätze für eine Anwendung verfügbar, die den angegebenen Bedingungen entsprechen. Die Eigenschaft Filter enthält den String, der die Filterbedingung beschreibt.

Hinweis

Die Filterbedingung kann auch zur Laufzeit geändert werden (beispielsweise als Reaktion auf eine Benutzereingabe).


TDataSet::Filtered

TDataSet	Siehe auch

Die Eigenschaft Filtered gibt an, ob eine Datenmenge gefiltert wird.

__property bool Filtered;

Beschreibung

Mit Filtered können Sie feststellen, ob die Datenmenge gefiltert wird. Hat Filtered den Wert True, ist ein Filter aktiviert. Bei deaktiviertem Filter hat Filtered den Wert False. Um die mit der Eigenschaft Filter angegebenen Filterbedingungen oder die Ereignisbehandlungsroutine für OnFilterRecord auf die Datenmenge anzuwenden, setzen Sie Filtered auf True.

Hinweis

Bei aktiviertem Filter können Änderungen eines Datensatzes durch den Benutzer dazu führen, daß der Datensatz bei aktiviertem Filter nicht mehr die Filterbedingung erfüllt. Wird der Datensatz erneut bei aktiviertem Filter aus der Datenmenge abgerufen, wird er nicht mehr angezeigt. Falls dies geschieht, wird die nächste der Filterbedingung entsprechende Zeile zum aktuellen Datensatz.


TDataSet::FIlterOptions

TDataSet	Siehe auch

Die Eigenschaft FilterOptions legt fest, ob die Groß- und Kleinschreibung sowie Teilübereinstimmungen beim Filtern der Datensätze berücksichtigt werden.

__property TFilterOptions FilterOptions;

Beschreibung

Mit FilterOptions können Sie festlegen, ob die Groß-/Kleinschreibung beim Filtern von String- oder Zeichenfeldern berücksichtigt wird und ob Teilübereinstimmungen in den Filterbedingungen zulässig sind.

Standardmäßig ist FilterOptions auf eine leere Menge gesetzt. Setzen Sie beim Filtern von Stringfeldern FilterOptions auf foCaseInsensitive, um alle Vorkommen eines Strings unabhängig von der Großschreibung zu erhalten. Setzen Sie bei auf mehreren Bedingungen oder Feldern basierenden Filterbedingungen FilterOptions auf foNoPartialCompare, damit bei Vergleichen eine genaue Übereinstimmung erforderlich ist. Wie bei allen Mengen können beide Werte zugleich angegeben werden.


TDataSet::Found

TDataSet	Siehe auch

Die Eigenschaft Found gibt an, ob das Wechseln zu einem anderen Datensatz erfolgreich war.

__property bool Found;

Beschreibung

Dem Status von Found können Sie entnehmen, ob ein Aufruf der Methode FindFirst, FindLast, FindNext, FindPrior, First, Last, Next oder Prior erfolgreich verlaufen ist. Der Wert True gibt einen erfolgreichen Aufruf an. Hat die Eigenschaft den Wert False, ist die Methode fehlgeschlagen.


TDataSet::Handle

TDataSet	Siehe auch	Beispiel

Die Eigenschaft Handle gibt das Handle des BDE-Cursors (Borland Database Engine) für die Datenmenge an.

__property Bde::hDBICur Handle;

Beschreibung

Handle wird nur benötigt, wenn die BDE unter Umgehung der TDataSet-Methoden direkt aufgerufen werden soll. Viele BDE-Funktionsaufrufe benötigen ein Cursor-Handle als Parameter. Handle wird beim öffnen einer Datenmenge automatisch ein Anfangswert zugewiesen.

Hinweis

Verwenden Sie diese Eigenschaft nur, wenn Sie auf BDE-Funktionen zugreifen wollen, die nicht über die Standardkomponenten verfügbar sind.


TDataSet::KeySize

TDataSet	Siehe auch

Die Eigenschaft KeySize gibt die Größe des aktuellen Schlüssels einer Datenmenge an.

__property unsigned short KeySize;

Beschreibung

Mit KeySize können Sie die Größe des aktuellen Schlüssels der Datenmenge ermitteln. KeySize entspricht der Größe der Schlüsselfelder im Primärindex der Datenmenge. Bei dBASE-Tabellen mit berechnetem Index ist KeySize mit der Größe dieses Index identisch.


TDataSet::Locale

TDataSet	Siehe auch

Die Eigenschaft Locale gibt den BDE-Sprachtreiber der Datenmenge an.

__property void * Locale;

Beschreibung

Mit Locale können Sie den BDE-Sprachtreiber einer Datenmenge bestimmen. Wird in einer Anwendung die BDE-API direkt aufgerufen, müssen gegebenenfalls Sprachtreiberinformationen als Funktionsparameter übergeben werden.

Sprachtreiberinformationen sind auch in der Eigenschaft Params der Datenbankkomponente verfügbar, zu der die Datenmenge gehört.

Hinweis

Verwenden Sie diese Eigenschaft nur, wenn Sie auf BDE-Funktionen zugreifen wollen, die nicht über die Standardkomponenten verfügbar sind.


TDataSet::Modified

TDataSet	Siehe auch	Beispiel

Die Eigenschaft Modified gibt an, ob der aktuelle Datensatz geändert wurde.

__property bool Modified;

Beschreibung

Mit Modified können Sie feststellen, ob der aktuelle Datensatz geändert wurde. Hat Modified den Wert True, wurde der aktuelle Datensatz geändert. Ansonsten hat die Eigenschaft den Wert False.

Hinweis

Normalerweise muß in einer Anwendung der Status von Modified nicht überprüft werden. Die Eigenschaften, Ereignisse und Methoden der Klasse TDataSet und ihrer Nachkommen, die Datensätze ändern, überprüfen diesen Status automatisch und führen dann spezielle Aktionen durch.


TDataSet::RecNo

TDataSet	Siehe auch

Die Eigenschaft bezeichnet den aktuellen Datensatz in der Datenmenge.

__property long RecNo;

Beschreibung

Mit einem Schreibzugriff auf RecNo läßt sich die Datensatznummer des aktuellen Datensatzes in der Datenmenge ermitteln. Anwendungen können die diese Eigenschaft in Verbindung mit RecordCount verwenden, um alle Datensätze einer Datenmenge in einer Schleife zu verarbeiten. Bei einer solchen Iteration werden typischerweise die Methoden First, Last, MoveBy, Next und Prior verwendet.


TDataSet::RecordCount

TDataSet	Siehe auch

Die Eigenschaft RecordCount gibt die Gesamtzahl der Datensätze in einer Datenmenge an.

__property long RecordCount;

Beschreibung

Mit RecordCount können Sie bestimmen, wie viele Datensätze in einer Datenmenge vorhanden sind. In einer Anwendung kann diese Eigenschaft zusammen mit RecNo verwendet werden, um die Datensätze in einer Schleife zu verarbeiten. Normalerweise werden dazu aber die Methoden First, Last, MoveBy, Next und Prior verwendet.


TDataSet::RecordSize

TDataSet	Siehe auch

Die Eigenschaft RecordSize gibt die Größe der Datensätze in einer Datenmenge an.

__property unsigned short RecordSize;

Beschreibung

Mit RecordSize können Sie die physikalische Größe (in Bytes) des Puffers ermitteln, der für einen Datensatz der Datenmenge von Delphi zugewiesen wurde. Beim öffnen einer Datenmenge fordert die Prozedur Open Informationen über die Größe des Datensatzpuffers von der BDE an und speichert diesen Wert in RecordSize. Diese Informationen werden intern verwendet und so gut wie nie in einer Anwendung benötigt.


TDataSet::State

TDataSet	Siehe auch	Beispiel

Die Eigenschaft State gibt den aktuellen Modus einer Datenmenge an.

__property TDataSetState State;

Beschreibung

Mit State können Sie den aktuellen Status einer Datenmenge feststellen. Der Modus bestimmt, welche Operationen mit den Daten in der Datenmenge durchgeführt werden können (z.B. Bearbeiten vorhandener Daten oder Einfügen neuer Datensätze). Der Modus einer Datenmenge ändert sich bei der Verarbeitung der Daten in einer Anwendung ständig. Der folgenden Tabelle können Sie die möglichen Werte für State und ihre Bedeutung entnehmen:

Wert	Bedeutung

dsInactive	Die Datenmenge ist geschlossen. Auf ihre Daten kann nicht zugegriffen werden.

dsBrowse	Die Daten können angezeigt, jedoch nicht geändert werden. Dies ist der Standardmodus einer geöffneten Datenmenge.

dsEdit	Der aktuelle Datensatz kann geändert werden.

dsInsert	Ein neuer Datensatz kann eingefügt werden.

dsSetKey	Nur für TTable. Die Datensatzsuche ist aktiviert oder eine SetRange-Operation wird durchgeführt. Eine eingeschränkte Datenmenge kann angezeigt, jedoch können keine Datensätze geändert oder eingefügt werden.

dsCalcFields	Ein OnCalcFields-Ereignis wurde ausgelöst. Die nicht berechneten Felder können bearbeitet und neue Datensätze eingefügt werden.

dsUpdateNew	Eine zwischengespeicherte Aktualisierung wird durchgeführt. Daten können weder bearbeitet noch eingefügt werden.

dsUpdateOld	Eine zwischengespeicherte Aktualisierung wird durchgeführt. Daten können weder bearbeitet noch eingefügt werden.

dsFilter	Ein OnFilterRecord-Ereignis wurde ausgelöst. Eine eingeschränkte Datenmenge kann angezeigt, jedoch können keine Datensätze geändert oder eingefügt werden.

Beim öffnen einer Datenmenge ändert sich State von dsInactive in dsBrowse. Die Datenmenge kann dann mit der Methode Edit in den Modus dsEdit oder mit Insert in den Modus dsInsert versetzt werden. Bei einem TTable-Objekt kann der Modus mit SetKey oder SetRange in dsSetKey geändert werden.

Durch das Eintragen oder Verwerfen von Änderungen, Einfügen neuer Datensätze oder durch Löschoperationen wird der aktuelle Status in dsBrowse geändert. Wird eine Datenmenge geschlossen, ändert sich ihr Modus in dsInactive.

Einige Modi wie dsCalcFields, dsFilter, dsUpdateNew und dsUpdateOld können nicht direkt gelesen oder gesetzt werden. Sie werden automatisch gesetzt, sobald OnCalcField- und OnFilterRecord-Ereignisse ausgelöst oder zwischengespeicherte Aktualisierungen verarbeitet werden.


TDataSet::UpdateObject

TDataSet	Siehe auch

Die Eigenschaft UpdateObject gibt das Aktualisierungsobjekt an, mit dem eine Nur-Lesen-Ergebnismenge bei aktivierter Zwischenspeicherung aktualisiert wird.

__property TDataSetUpdateObject* UpdateObject;

Beschreibung

Mit UpdateObject können Sie die TUpdateObject-Komponente angeben, mit der eine von der BDE zurückgegebene Nur-Lesen-Ergebnismenge aktualisiert werden kann.

Die BDE versucht immer, ein aktualisierbares Abfrageergebnis zurückzugeben, wenn die Anwendung nicht explizit eine Nur-Lesen-Sicht der Daten anfordert. In manchen Fällen (z.B. bei einer Abfrage mit mehreren Tabellen) kann jedoch keine aktualisierbare Ergebnismenge zurückgegeben werden. Sie können dann mit UpdateObject ein Hilfsobjekt angeben, das die Aktualisierungen als eine separate, für die Anwendung transparente Transaktion durchführt.


TDataSet::UpdateRecordTypes

TDataSet	Siehe auch

Die Eigenschaft UpdateRecordTypes gibt den Datensatztyp an, der bei aktivierter Zwischenspeicherung in einer Datenmenge sichtbar ist.

__property TUpdateRecordTypes UpdateRecordTypes;

Beschreibung

Mit UpdateRecordTypes können Sie festlegen, welche Datensätze bei aktivierter Zwischenspeicherung in einer Datenmenge sichtbar sind. UpdateRecordTypes ist eine Menge, die folgende Werte enthalten kann:

Wert	Bedeutung

rtModified	Geänderte Datensätze sind sichtbar.

rtInserted	Eingefügte Datensätze sind sichtbar.

rtDeleted	Gelöschte Datensätze sind sichtbar.

rtUnmodified	Nicht geänderte Datensätze sind sichtbar.

Standardmäßig wird eine Datenmenge mit der Menge UpdateRecordTypes [rtModified, rtInserted, rtUnmodified] erstellt. Es sind dann alle vorhandenen, geänderten und eingefügten Datensätze für den Benutzer sichtbar.

Sollen gelöschte Datensätze in einer Schleife wiederhergestellt werden, kann UpdateRecordTypes in der Wiederherstellungsmethode geändert werden, damit die gelöschten Datensätze lange genug „sichtbar“ sind, um sie wiederherzustellen.

UpdateRecordTypes kann auch als Filter verwendet werden, um die sichtbaren Datensätze vorübergehend auf die vom Benutzer während der aktuellen Sitzung hinzugefügten zu beschränken.


TDataSet::UpdatesPending

TDataSet	Siehe auch

Das Ereignis UpdatesPending gibt an, ob der Puffer noch nicht eingetragene zwischengespeicherte Aktualisierungen enthält.

__property bool UpdatesPending;

Beschreibung

Mit UpdatesPending können Sie den Status des Puffers für zwischengespeicherte Aktualisierungen überprüfen. Hat UpdatesPending den Wert True, sind bearbeitete, gelöschte oder eingefügte Datensätze im Puffer vorhanden. Ist UpdatesPending auf False gesetzt, enthält der Puffer keine Datensätze.


Ereignisse von TDataSet

TDataSet	Alphabetisch	Legende

In TDataSet

AfterCancel

AfterClose

AfterDelete

AfterEdit

AfterInsert

AfterOpen

AfterPost

BeforeCancel

BeforeClose

BeforeDelete

BeforeEdit

BeforeInsert

BeforeOpen

BeforePost

OnCalcFields

OnDeleteError

OnEditError

OnFilterRecord

OnNewRecord

OnPostError

OnServerYield

OnUpdateError

OnUpdateRecord


Ereignisse von TDataSet

TDataSet	Nach Objekten	Legende

AfterCancel

AfterClose

AfterDelete

AfterEdit

AfterInsert

AfterOpen

AfterPost

BeforeCancel

BeforeClose

BeforeDelete

BeforeEdit

BeforeInsert

BeforeOpen

BeforePost

OnCalcFields

OnDeleteError

OnEditError

OnFilterRecord

OnNewRecord

OnPostError

OnServerYield

OnUpdateError

OnUpdateRecord


TDataSet::AfterCancel

TDataSet	Siehe auch

Das Ereignis AfterCancel wird nach dem Verwerfen der Änderungen des aktuellen Datensatzes ausgelöst.

__property TDataSetNotifyEvent AfterCancel;

Beschreibung

Mit einer Ereignisbehandlungsroutine für AfterCancel können spezielle Aktionen durchgeführt werden, nachdem in einer Anwendung die Änderungen des aktuellen Datensatzes verworfen wurden. AfterCancel wird von der Methode Cancel ausgelöst, nachdem diese die Position des BDE-Cursors aktualisiert, die Sperre des aktuellen Datensatzes (falls vorhanden) entfernt und den Modus der Datenmenge in dsBrowse geändert hat. Sind weitere Verarbeitungen erforderlich, bevor die Steuerung nach einem Cancel-Ereignis an den Benutzer zurückgegeben wird, führen Sie diese mit dem Ereignis AfterCancel durch.


TDataSet::AfterClose

TDataSet	Siehe auch

Das Ereignis AfterClose wird nach dem Schließen einer Datenmenge ausgelöst.

__property TDataSetNotifyEvent AfterClose;

Beschreibung

In einer Ereignisbehandlungsroutine für AfterClose können unmittelbar nach dem Schließen einer Datenmenge spezielle Aktionen durchgeführt werden. So kann beispielsweise als Sicherheitsmaßnahme das Element PASSWORD aus der Eigenschaft Params einer Datenbankkomponente gelöscht werden.

AfterClose wird ausgelöst, nachdem die Datenmenge geschlossen und ihr Status auf dsInactive gesetzt wurde.


TDataSet::AfterDelete

TDataSet	Siehe auch

Das Ereignis AfterDelete wird nach dem Löschen eines Datensatzes ausgelöst.

__property TDataSetNotifyEvent AfterDelete;

Beschreibung

Mit einer Ereignisbehandlungsroutine für AfterDelete können direkt nach dem Löschen des aktuellen Datensatzes spezielle Aktionen durchgeführt werden. AfterDelete wird von der Methode Delete ausgelöst, nachdem diese den Datensatz gelöscht, den Modus der Datenmenge in dsBrowse geändert und den Cursor auf dem Datensatz vor dem gelöschten positioniert hat.


TDataSet::AfterEdit

TDataSet	Siehe auch

Das Ereignis AfterEdit wird nach dem Bearbeiten eines Datensatzes ausgelöst.

__property TDataSetNotifyEvent AfterEdit;

Beschreibung

In einer Ereignisbehandlungsroutine für AfterEdit können unmittelbar nach dem Bearbeiten eines Datensatzes in einer Anwendung spezielle Aktionen durchgeführt werden. AfterEdit wird von der Methode Edit aufgerufen, nachdem diese das Bearbeiten des Datensatzes aktiviert, die Werte der berechneten Felder aktualisiert und die Daten-Ereignisbehandlungsroutine zum Verarbeiten einer Datensatzänderung aufgerufen hat.


TDataSet::AfterInsert

TDataSet	Siehe auch

Das Ereignis AfterInsert wird nach dem Einfügen eines neuen Datensatzes ausgelöst.

__property TDataSetNotifyEvent AfterInsert;

Beschreibung

In einer Ereignisbehandlungsroutine für AfterInsert können nach dem Einfügen eines Datensatzes spezielle Aktionen durchgeführt werden. AfterInsert wird von den Methoden Insert und Append nach dem Ein- oder Anfügen eines neuen Datensatzes aufgerufen.


TDataSet::AfterOpen

TDataSet	Siehe auch

Das Ereignis AfterOpen wird nach dem öffnen einer Datenmenge und vor dem Zugriff auf die Daten ausgelöst.

__property TDataSetNotifyEvent AfterOpen;

Beschreibung

In einer Ereignisbehandlungsroutine für AfterOpen können direkt nach dem öffnen einer Datenmenge spezielle Aktionen durchgeführt werden. AfterOpen wird aufgerufen, nachdem der BDE-Cursor der Datenmenge geöffnet und ihr Modus in dsBrowse geändert wurde. So kann beispielsweise in einer Ereignisbehandlungsroutine für AfterOpen der in der letzen Sitzung aktuelle Datensatz aus der Registrierung des Systems gelesen und der Cursor auf diesem positioniert werden.


TDataSet::AfterPost

TDataSet	Siehe auch

Das Ereignis AfterPost wird ausgelöst, nachdem der aktuelle Datensatz in die Datenbank bzw. den Zwischenspeicher geschrieben wurde und bevor die Datenmenge in den Status dsBrowse zurückgesetzt wird.

__property TDataSetNotifyEvent AfterPost;

Beschreibung

Mit einer Ereignisbehandlungsroutine für AfterPost können nach dem Eintragen der Änderungen des aktuellen Datensatzes spezielle Aktionen durchgeführt werden. AfterPost wird aufgerufen, nachdem ein Datensatz geändert, gelöscht oder eingefügt wurde.


TDataSet::BeforeCancel

TDataSet	Siehe auch

Das Ereignis BeforeCancel wird ausgelöst, bevor die Änderungen des aktuellen Datensatzes verworfen werden.

__property TDataSetNotifyEvent BeforeCancel;

Beschreibung

Mit einer Ereignisbehandlungsroutine für BeforeCancel können spezielle Aktionen durchgeführt werden, bevor eine Anforderung zum Verwerfen der Änderungen ausgeführt wird. BeforeCancel wird von der Methode Cancel vor dem Verwerfen einer Datenmengenoperation wie dem Bearbeiten, Einfügen oder Löschen von Datensätzen aufgerufen.

BeforeCancel kann beispielsweise verwendet werden, um die Änderungen des Benutzers in einem Puffer zum Rückgängigmachen der Operation zwischenzuspeichern.


TDataSet::BeforeClose

TDataSet	Siehe auch

Das Ereignis BeforeClose wird ausgelöst, bevor eine Datenmenge geschlossen wird.

__property TDataSetNotifyEvent BeforeClose;

Beschreibung

In einer Ereignisbehandlungsroutine für BeforeClose können vor dem Schließen einer Datenmenge spezielle Aktionen durchgeführt werden. Die Ereignisbehandlungsroutine wird aufgerufen, sobald die Methode Close aufgerufen oder die Eigenschaft Active auf False gesetzt wird.


TDataSet::BeforeDelete

TDataSet	Siehe auch

Das Ereignis BeforeDelete wird ausgelöst, bevor in einer Anwendung der aktuelle Datensatz gelöscht wird.

__property TDataSetNotifyEvent BeforeDelete;

Beschreibung

In einer Ereignisbehandlungsroutine für BeforeDelete können vor dem Löschen des aktuellen Datensatzes spezielle Aktionen durchgeführt werden. BeforeDelete wird von der Methode Delete vor dem Löschen des Datensatzes aufgerufen.

So kann beispielsweise mit diesem Ereignis ein Dialogfeld angezeigt werden, in dem der Löschvorgang bestätigt werden muß. Wird keine Bestätigung eingegeben, kann die Operation mit der Prozedur Abort abgebrochen werden.


TDataSet::BeforeEdit

TDataSet	Siehe auch

Das Ereignis BeforeEdit wird ausgelöst, bevor das Bearbeiten des aktuellen Datensatzes ermöglicht wird.

__property TDataSetNotifyEvent BeforeEdit;

Beschreibung

In einer Ereignisbehandlungsroutine für BeforeEdit können spezielle Aktionen durchgeführt werden, bevor das Bearbeiten des aktuellen Datensatzes ermöglicht wird. Sie können beispielsweise ein Protokoll der Datenbankbearbeitungen führen und dazu die Bearbeitungsanforderung sowie Zeit und Benutzer aufzeichnen.


TDataSet::BeforeInsert

TDataSet	Siehe auch

Das Ereignis BeforeInsert wird vor dem Wechseln in den Einfügemodus (dsInsert) ausgelöst.

__property TDataSetNotifyEvent BeforeInsert;

Beschreibung

In einer Ereignisbehandlungsroutine für BeforeInsert können spezielle Aktionen durchgeführt werden, bevor ein neuer Datensatz ein- oder angefügt wird. BeforeInsert wird von den Methoden Insert und Append vor dem Ändern des Datenmengenmodus in dsInsert aufgerufen.


TDataSet::BeforeOpen

TDataSet	Siehe auch

Das Ereignis BeforeOpen wird vor dem öffnen einer Datenmenge ausgelöst.

__property TDataSetNotifyEvent BeforeOpen;

Beschreibung

In einer Ereignisbehandlungsroutine für BeforeOpen können spezielle Aktionen durchgeführt werden, bevor eine Datenmenge zum Lesen oder Schreiben geöffnet wird. BeforeOpen wird ausgelöst, sobald die Eigenschaft Active auf True gesetzt oder die Methode Open aufgerufen wird.


TDataSet::BeforePost

TDataSet	Siehe auch

Das Ereignis BeforePost wird ausgelöst, bevor die Änderungen des aktuellen Datensatzes in die Datenbank bzw. den Zwischenspeicher geschrieben werden.

__property TDataSetNotifyEvent BeforePost;

Beschreibung

In einer Ereignisbehandlungsroutine für BeforePost können Aktionen vor dem Eintragen von Änderungen in die Datenbank durchgeführt werden. BeforePost wird ausgelöst, sobald die Methode Post in einer Anwendung aufgerufen wird. Post überprüft, ob alle erforderlichen Felder vorhanden sind, ruft BeforePost auf und trägt den Datensatz ein.

Sie können mit BeforePost beispielsweise Gültigkeitsprüfungen vor dem Eintragen der Daten in die Datenbank durchführen. Bei ungültigen Daten können Sie dann Abort aufrufen, um die Post-Operation abzubrechen.


TDataSet::OnCalcFields

TDataSet	Siehe auch

Das Ereignis OnCalcFields wird beim Aktualisieren der berechneten Felder ausgelöst.

def void __fastcall (__closure *TDataSetNotifyEvent)(TDataSet* DataSet);

__property TDataSetNotifyEvent OnCalcFields;

Beschreibung

Mit einer Ereignisbehandlungsroutine für OnCalcFields können beim Aktualisieren der berechneten Felder spezielle Aktionen durchgeführt werden. Ein berechnetes Feld bezieht seinen Wert aus einem oder mehreren Feldern in der Datenmenge. Dabei werden gegebenenfalls zusätzliche Verarbeitungen durchgeführt.

OnCalcFields wird häufig aufgerufen. Sie sollten daher den Quelltext der Ereignisbehandlungsroutine möglichst knapp halten.

Hat die Eigenschaft AutoCalcFields den Wert True, wird OnCalcFields in den folgenden Situationen ausgelöst:

•	Eine Datenmenge wird geöffnet.

•	Der Fokus wechselt von einem visuellen Steuerelement zu einem anderen oder von einer Spalte einer datensensitiven Gitterkomponente zu einer anderen.

•	Ein Datensatz wird aus einer Datenbank abgerufen.

Hinweis

Hat AutoCalcFields den Wert True, sollte in der Ereignisbehandlungsroutine für OnCalcFields die Datenmenge (oder eine verbundene Datenmenge in einer Haupt/Detail-Beziehung) nicht geändert werden. Diese Änderungen lösen das Ereignis OnCalcField erneut aus und führen dadurch zu einer Rekursion.

Setzen Sie AutoCalcFields auf False, damit OnCalcFields weniger aufgerufen wird. OnCalcFields wird dann nur bei einem Aufruf der Methode Post ausgelöst. Können die Benutzer Änderungen an den Daten vornehmen, wird OnCalcFields sehr oft ausgelöst. In diesen Fällen kann AutoCalcFields auf False gesetzt werden, um die Aufrufhäufigkeit zu verringern.


TDataSet::OnDeleteError

TDataSet	Siehe auch

Das Ereignis OnDeleteError wird ausgelöst, wenn beim Löschen eines Datensatzes eine Exception auftritt.

enum TDataAction { daFail, daAbort, daRetry };

typedef void __fastcall (__closure *TDataSetErrorEvent)(TDataSet* DataSet, EDatabaseError* E, TDataAction &Action);

__property TDataSetErrorEvent OnDeleteError;

Beschreibung

Mit einer Ereignisbehandlungsroutine für OnDeleteError können Exceptions verarbeitet werden, die bei einem fehlgeschlagenen Löschversuch eines Datensatzes auftreten. E ist ein Zeiger auf das Fehlerobjekt mit der Exception-Fehlermeldung, so daß in der Anwendung eine entsprechende Fehlermeldung angezeigt werden kann. Die Variable Action gibt an, wie die Ereignisbehandlungsroutine auf den Fehler reagieren soll. Die folgende Tabelle enthält die verschiedenen Einstellungen von Action und ihre Bedeutung:

Wert	Bedeutung

daFail	Die Löschoperation wird abgebrochen und eine Fehlermeldung angezeigt.

daAbort	Die Löschoperation wird ohne Ausgabe einer Fehlermeldung abgebrochen.

daRetry	Die Löschoperation wird erneut durchgeführt. Berichtigen Sie die Fehlerbedingung in der Fehler-Ereignisbehandlungsroutine, bevor Sie Action auf daRetry setzen.

Beim ersten Aufruf von OnDeleteError wird Action immer auf daFail gesetzt. Kann in der Fehler-Ereignisbehandlungsroutine die Fehlerbedingung korrigiert werden, durch die die aufgerufen wurde, setzen Sie Action vor Verlassen der Ereignisbehandlungsroutine auf daRetry. Die Löschoperation wird daraufhin wiederholt.

Kann eine Fehlerbedingung nicht beseitigt werden, können Sie die Anzeige der Fehlermeldung unterdrücken, indem Sie Action auf daAbort statt auf daFail setzen.


TDataSet::OnEditError

TDataSet	Siehe auch

Das Ereignis OnEditError wird ausgelöst, wenn beim Ändern oder Einfügen eines Datensatzes eine Exception auftritt.

__property TDataSetErrorEvent OnEditError;

Beschreibung

Mit einer Ereignisbehandlungsroutine für OnEditError können Exceptions verarbeitet werden, die bei einem fehlgeschlagenen Bearbeitungsversuch eines Datensatzes auftreten. E ist ein Zeiger auf das Fehlerobjekt mit der Exception-Fehlermeldung, so daß in der Anwendung eine entsprechende Fehlermeldung angezeigt werden kann. Die Variable Action gibt an, wie die Ereignisbehandlungsroutine auf den Fehler reagieren soll. Die folgende Tabelle enthält die verschiedenen Einstellungen von Action und ihre Bedeutung:

Wert	Bedeutung

daFail	Die Operation wird abgebrochen und eine Fehlermeldung angezeigt.

daAbort	Die Operation wird ohne Ausgabe einer Fehlermeldung abgebrochen.

daRetry	Die Operation wird erneut durchgeführt. Beseitigen Sie die Fehlerbedingung in der Fehler-Ereignisbehandlungsroutine, bevor Sie Action auf daRetry setzen.

Beim ersten Aufruf von OnEditError wird Action immer auf daFail gesetzt. Kann in der Fehler-Ereignisbehandlungsroutine die Fehlerbedingung beseitigt werden, durch die er aufgerufen wurde, setzen Sie Action vor Verlassen der Ereignisbehandlungsroutine auf daRetry. Die Operation wird daraufhin wiederholt.

Kann eine Fehlerbedingung nicht korrigiert werden, können Sie die Anzeige der Fehlermeldung unterdrücken, indem Sie Action auf daAbort und nicht auf daFail setzen.


TDataSet::OnFilterRecord

TDataSet	Siehe auch

Das Ereignis OnFilterRecord wird jedesmal ausgelöst, wenn eine andere Datenzeile in der Datenmenge zum aktuellen Datensatz wird und das Filtern aktiviert ist.

typedef void __fastcall (__closure *TFilterRecordEvent)(TDataSet* DataSet, bool &Accept);

__property TFilterRecordEvent OnFilterRecord;

Beschreibung

In der Ereignisbehandlungsroutine für OnFilterRecord kann jeder Datensatz in einer Datenmenge auf eine Bedingung getestet werden, die bestimmt, ob er in der Anwendung sichtbar ist.

Erfüllt ein Datensatz die Filterbedingung, muß in der Filter-Ereignisbehandlungsroutine der Parameter Accept auf True gesetzt werden, damit der Datensatz angezeigt wird. Erhält Accept den Wert False, wird der Datensatz ausgeschlossen.

Das Filtern ist aktiviert, wenn die Eigenschaft Filtered den Wert True hat. Beim Verarbeiten eines Filters wird der Modus der Datenmenge in dsFilter geändert. Mit der Eigenschaft FilterOptions kann festgelegt werden, ob dabei die Groß-/Kleinschreibung oder Teilübereinstimmungen berücksichtigt wird.

Hinweis

Ein Filter kann auch mit der Eigenschaft Filter festgelegt werden, die die Ereignisbehandlungsroutine für OnFilterRecord ergänzt. Berücksichtigen Sie die Interaktionen zwischen der Eigenschaft Filter und der Ereignisbehandlungsroutine für OnFilterRecord, wenn Sie beide gleichzeitig in einer Anwendung verwenden.


TDataSet::OnNewRecord

TDataSet	Siehe auch

Das Ereignis OnNewRecord wird beim Ein- oder Anfügen eines neuen Datensatzes in der Datenmenge ausgelöst.

typedef void __fastcall (__closure *TDataSetNotifyEvent)(TDataSet* DataSet);

__property TDataSetNotifyEvent OnNewRecord;

Beschreibung

In einer Ereignisbehandlungsroutine für OnNewRecord können beim Ein- oder Anfügen eines neuen Datensatzes spezielle Aktionen durchgeführt werden. OnNewRecord wird während des eigentlichen Ein- oder Anfügens aufgerufen. In einer Anwendung kann OnNewRecord verwendet werden, um aufeinanderfolgende Einfügeoperationen in verbundenen Datenmengen zu implementieren.


TDataSet::OnPostError

TDataSet	Siehe auch

Das Ereignis OnPostError wird ausgelöst, wenn beim Eintragen eines Datensatzes eine Exception auftritt.

enum TDataAction { daFail, daAbort, daRetry };

typedef void __fastcall (__closure *TDataSetErrorEvent)(TDataSet* DataSet, EDatabaseError* E, TDataAction &Action);

__property TDataSetErrorEvent OnPostError;

Beschreibung

Mit einer Ereignisbehandlungsroutine für OnPostError können Exceptions verarbeitet werden, die beim Fehlschlagen des Eintrags eines Datensatzes auftreten. E ist ein Zeiger auf das Fehlerobjekt mit der Exception-Fehlermeldung, so daß in der Anwendung eine entsprechende Fehlermeldung angezeigt werden kann. Die Variable Action gibt an, wie die Ereignisbehandlungsroutine auf den Fehler reagieren soll. Die folgende Tabelle enthält die verschiedenen Einstellungen von Action und ihre Bedeutung:

Wert	Bedeutung

daFail	Die Operation wird abgebrochen und eine Fehlermeldung angezeigt.

daAbort	Die Operation wird ohne Ausgabe einer Fehlermeldung abgebrochen.

daRetry	Die Operation wird erneut durchgeführt. Berichtigen Sie die Fehlerbedingung in der Fehler-Ereignisbehandlungsroutine, bevor Sie Action auf daRetry setzen.

Beim ersten Aufruf von OnPostError wird Action immer auf daFail gesetzt. Kann in der Fehler-Ereignisbehandlungsroutine die Fehlerbedingung beseitigt werden, durch die sie aufgerufen wurde, setzen Sie Action vor Verlassen der Ereignisbehandlungsroutine auf daRetry. Hat Action den Wert daRetry, wird die Operation wiederholt.

Kann eine Fehlerbedingung nicht berichtigt werden, können Sie die Anzeige der Fehlermeldung unterdrücken, indem Sie Action auf daAbort und nicht auf daFail setzen.


TDataSet::OnServerYield

TDataSet	Siehe auch

Das Ereignis OnServerYield wird ausgelöst, wenn ein Remote-Datenbank-Server während der Bearbeitung einer Abfrage ein Callback an die BDE sendet.

typedef void __fastcall (__closure *TOnServerYieldEvent)(TDataSet* DataSet, bool &AbortQuery);

__property TOnServerYieldEvent OnServerYield;

Beschreibung

In einer Ereignisbehandlungsroutine für OnServerYield können Sie auf eine BDE-Callback-Funktion reagieren, wenn ein Datenbank-Server während einer Abfrage die Steuerung vorübergehend der BDE übergibt. Diese ruft dann OnServerYield auf, falls die Ereignisbehandlungsroutine vorhanden ist.

Um die Bearbeitung der Abfrage fortzusetzen, sollte in der Ereignisbehandlungsroutine für OnServerYield der Parameter AbortQuery auf False gesetzt werden. Soll die Abfrageverarbeitung beendet werden, muß AbortQuery auf True gesetzt werden.

Hinweis

Zur Zeit übergibt nur Sybase die Steuerung während der Abfrageverarbeitung.


TDataSet::OnUpdateError

TDataSet	Siehe auch

Das Ereignis OnUpdateError wird ausgelöst, wenn beim Schreiben der zwischengespeicherten Aktualisierungen in die Datenbank eine Exception auftritt.

enum TUpdateKind { ukModify, ukInsert, ukDelete };

enum TUpdateAction { uaFail, uaAbort, uaSkip, uaRetry, uaApplied };

typedef void __fastcall (__closure *TUpdateErrorEvent)(TDataSet* DataSet, EDatabaseError* E, TUpdateKind UpdateKind, TUpdateAction &UpdateAction);

__property TUpdateErrorEvent OnUpdateError;

Beschreibung

In einer Ereignisbehandlungsroutine für OnUpdateError können Sie auf Exceptions reagieren, die beim Schreiben der zwischengespeicherten Aktualisierungen in die Datenbank generiert werden.

Da zwischen dem Schreiben eines Datensatzes in den Puffer und dem Eintragen der Aktualisierungen in die Datenbank eine bestimmte Zeitspanne liegt, besteht die Möglichkeit, daß ein oder mehrere Datensätze inzwischen von einer anderen Anwendung geändert wurden. Die BDE (Borland Database Engine) prüft dies und generiert gegebenenfalls eine Exception. Als Reaktion darauf wird die Ereignisbehandlungsroutine für OnUpdateError (falls vorhanden) aufgerufen.

DataSet gibt die zu aktualisierende Datenmenge an.

E ist ein Zeiger auf ein EDBEngineError-Objekt, aus dem Sie eine Fehlermeldung und den Grund der Fehlerbedingung extrahieren können. Diese Informationen können dann in einer Ereignisbehandlungsroutine für OnUpdateError verwendet werden, um die Reaktion auf die Fehlerbedingung festzulegen.

UpdateKind beschreibt den Typ der Aktualisierung, die zum Fehler geführt hat. Die folgende Tabelle enthält die möglichen Werte für UpdateKind und ihre Bedeutung:

Wert	Bedeutung

ukModify	Das Bearbeiten eines vorhandenen Datensatzes hat zu einem Fehler geführt.

ukInsert	Das Ein- oder Anfügen eines neuen Datensatzes hat zu einem Fehler geführt.

ukDelete	Das Löschen eines vorhandenen Datensatzes hat zu einem Fehler geführt.

UpdateAction gibt die Aktion an, die durchgeführt wird, wenn die Ereignisbehandlungsroutine für OnUpdateError vorhanden ist. Beim Eintritt in die Ereignisbehandlungsroutine wird UpdateAction immer auf uaFail gesetzt. Kann in OnUpdateError der Fehler verarbeitet oder korrigiert werden, setzen Sie UpdateAction vor Verlassen der Routine auf uaRetry. Die folgende Tabelle enthält die möglichen Werte für UpdateAction und ihre Bedeutung:

Wert	Bedeutung

uaAbort	Die Aktualisierung wird ohne Ausgabe einer Fehlermeldung abgebrochen.

uaApplied	Wird nicht in Fehlerbehandlungsroutinen verwendet.

uaFail	Die Aktualisierung wird abgebrochen und eine Fehlermeldung angezeigt.

uaRetry	Die Aktualisierung, die zu der Fehlerbedingung geführt hat, wird wiederholt.

uaSkip	Die Aktualisierung des Datensatzes, bei dem die Fehlerbedingung aufgetreten ist, wird übersprungen. Die nicht eingetragenen Änderungen bleiben im Zwischenspeicher.

Hinweis

Führt ein Aufruf von ApplyUpdates zu einer Exception und erfolgt der Aufruf nicht in einem try...except-Block, wird eine Fehlermeldung angezeigt. Kann die Fehlerbedingung in der Ereignisbehandlungsroutine für OnUpdateError nicht beseitigt werden, erhält UpdateAction den Wert uaFail, und die Fehlermeldung wird zweimal angezeigt. Um die erneute Anzeige zu verhindern, setzen Sie UpdateAction in der Fehler-Ereignisbehandlungsroutine auf uaAbort.

Hinweis

In einer Ereignisbehandlungsroutine für OnUpdateError dürfen keine Methoden aufgerufen werden, die einen anderen Datensatz zum aktuellen Datensatz machen.


TDataSet::OnUpdateRecord

TDataSet	Siehe auch

Das Ereignis OnUpdateRecord wird ausgelöst, wenn zwischengespeicherte Aktualisierungen in einen Datensatz geschrieben werden.

enum TUpdateKind { ukModify, ukInsert, ukDelete };

enum TUpdateAction { uaFail, uaAbort, uaSkip, uaRetry, uaApplied };

typedef void __fastcall (__closure *TUpdateRecordEvent)(TDataSet* DataSet, TUpdateKind UpdateKind, TUpdateAction &UpdateAction);

__property TUpdateRecordEvent OnUpdateRecord;

Beschreibung

In einer Ereignisbehandlungsroutine für OnUpdateRecord können Sie Aktualisierungen verarbeiten, die nicht von einer einzelnen Aktualisierungskomponente durchgeführt werden können. Dazu gehört beispielsweise die Implementierung von nachfolgenden Aktualisierungs-, Einfüge- und Löschoperationen in verbundenen Datenbanktabellen. Diese Ereignisbehandlungsroutine ist auch in Anwendungen hilfreich, in denen eine weitreichende Kontrolle über die Parameterersetzung in Aktualisierungskomponenten nötig ist.

DataSet ist der Name der Datenmenge, die aktualisiert wird.

UpdateKind beschreibt den Typ der durchzuführenden Aktualisierung. Die folgende Tabelle enthält die möglichen Werte für UpdateKind und ihre Bedeutung:

Wert	Bedeutung

ukModify	Einen vorhandenen Datensatz bearbeiten.

ukInsert	Einen neuen Datensatz ein- oder anfügen.

ukDelete	Einen vorhandenen Datensatz löschen.

UpdateAction gibt die Aktion an, die in der Ereignisbehandlungsroutine für OnUpdateRecord durchgeführt wird. Beim Eintritt in die Ereignisbehandlungsroutine wird UpdateAction immer auf uaFail gesetzt. Ist OnUpdateRecord erfolgreich, sollte UpdateAction vor dem Beenden der Routine auf uaApplied gesetzt werden. Die folgende Tabelle enthält die möglichen Werte für UpdateAction und ihre Bedeutung:

Wert	Bedeutung

uaAbort	Die Aktualisierung wird ohne Ausgabe einer Fehlermeldung abgebrochen.

uaApplied	Die Aktualisierung wird durchgeführt und der betreffende Datensatz aus dem Zwischenspeicher freigegeben.

uaFail	Die Aktualisierung wird abgebrochen und eine Fehlermeldung angezeigt.

uaRetry	Wird nicht für Datensatzaktualisierungen verwendet.

uaSkip	Die Aktualisierung wird übersprungen. Der Datensatz bleibt im Zwischenspeicher.

Hinweis

In einer Ereignisbehandlungsroutine für OnUpdateRecord dürfen keine Methoden aufgerufen werden, die einen anderen Datensatz zum aktuellen Datensatz machen.


Methoden von TDataSet

TDataSet	Alphabetisch

In TDataSet

~TDataSet

ActiveBuffer

Append

AppendRecord

ApplyUpdates

Cancel

CancelUpdates

CheckBrowseMode

ClearFields

Close

CommitUpdates

ControlsDisabled

CursorPosChanged

Delete

DisableControls

Edit

EnableControls

FetchAll

FieldByName

FindField

FindFirst

FindLast

FindNext

FindPrior

First

FreeBookmark

GetBookmark

GetCurrentRecord

GetFieldList

GetFieldNames

GotoBookmark

Insert

InsertRecord

IsLinkedTo

Last

Locate

Lookup

MoveBy

Next

Open

Post

Prior

Refresh

Resync

RevertRecord

SetDetailFields

SetFields

TDataSet

UpdateCursorPos

UpdateRecord

UpdateStatus

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TDataSet

TDataSet	Nach Objekten

~TDataSet

ActiveBuffer

AppendRecord

Append

ApplyUpdates

Assign

Cancel

CancelUpdates

CheckBrowseMode

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

ClearFields

Close

CommitUpdates

ControlsDisabled

CursorPosChanged

DefaultHandler

Delete

DestroyComponents

Destroying

DisableControls

Dispatch

Edit

EnableControls

FetchAll

FieldAddress

FieldByName

FindComponent

FindField

FindFirst

FindLast

FindNext

FindPrior

First

FreeBookmark

FreeInstance

FreeNotification

Free

GetBookmark

GetCurrentRecord

GetFieldList

GetFieldNames

GetParentComponent

GotoBookmark

HasParent

InheritsFrom

InitInstance

InsertComponent

InsertRecord

Insert

InstanceSize

IsLinkedTo

Last

Locate

Lookup

MethodAddress

MethodName

MoveBy

NewInstance

Next

Open

Post

Prior

Refresh

RemoveComponent

Resync

RevertRecord

SetDetailFields

SetFields

TDataSet

UpdateCursorPos

UpdateRecord

UpdateStatus


TDataSet::~TDataSet

TDataSet	Siehe auch

Der Destruktor ~TDataSet gibt den Speicher frei, der für das TDataSet-Objekt reserviert war. Rufen Sie ~TDataSet nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TDataSet automatisch aufgerufen wird.

__fastcall virtual ~TDataSet(void);

Beschreibung

~TDataSet führt die folgenden Operationen aus:

•	Die Datenmenge wird geschlossen.

•	Das UpdateObject für die Datenmenge wird geschlossen (falls vorhanden).

•	Der Datenmengen-Designer für die Datenmenge wird freigegeben (falls vorhanden).

•	Die Zuordnung zwischen Datenmenge und den Datenquellenkomponenten wird aufgehoben. Der reservierte Speicher wird freigegeben.

•	Die zugeordneten Felder werden zusammen mit dem reservierten Speicher freigegeben.

•	Der für Felddefinitionen reservierte Speicher wird freigegeben.

•	Wenn eine Callback-Funktion existiert, wird der zugeordnete Speicher freigegeben.

•	Der Konstruktor des übergeordneten Objekts wird aufgerufen.


TDataSet::ActiveBuffer

TDataSet	Siehe auch

Die Methode ActiveBuffer gibt einen Zeiger auf den Puffer des aktuellen Datensatzes zurück.

char * __fastcall ActiveBuffer(void);

Beschreibung

ActiveBuffer wird von vielen Datenmengenmethoden intern verwendet, um sicherzustellen, daß der aktive Puffer auf den des aktuellen Datensatzes zeigt. Die vorhandenen Datenmengenmethoden verwenden immer den richtigen aktiven Puffer. Deshalb muß ActiveBuffer normalerweise nicht direkt aufgerufen werden.

ActiveBuffer wird auch von den Positionsmarkenmethoden verwendet, um aus dem Puffer des aktuellen Datensatzes Positionsmarken-Informationen abzurufen.

Verwenden Sie in Ihren Anwendungen selbstdefinierte Datenmengenroutinen, müssen Sie mit ActiveBuffer den Pufferzeiger aktualisieren, insbesondere beim Verarbeiten einer Gruppe von Datensätzen in einer Schleife. Jedoch wird selbst in diesen Fällen der aktive Puffer automatisch gesetzt, wenn Sie in Ihren selbstdefinierten Routinen Methoden wie Next oder Prior aufrufen.


TDataSet::Append

TDataSet	Siehe auch

Die Methode Append fügt einen neuen leeren Datensatz am Ende der Datenmenge hinzu.

void __fastcall Append(void);

Beschreibung

Append führt folgende Aktionen durch:

1	Ein neuer leerer Datensatz wird am Ende der Datenmenge hinzugefügt.

2	Der neue Datensatz wird zum aktuellen Datensatz.

Nach dem Aufruf von Append kann die Anwendung den Benutzern die Eingabe von Daten in die Felder des neuen Datensatzes ermöglichen. Anschließend können die Änderungen mit Post (oder mit ApplyUpdates bei aktivierter Zwischenspeicherung) in die Datenbank eingetragen werden. Ein neuer Datensatz wird auf eine der folgenden drei Arten in die Datenbank eingetragen:

•	Bei indizierten Paradox- und dBASE-Tabellen wird der Datensatz an der seinem Index entsprechenden Position in die Datenmenge eingefügt.

•	Bei nicht indizierten Paradox- und dBASE-Tabellen wird der Datensatz am Ende der Datenmenge angefügt.

•	Bei SQL-Datenbanken ist die physische Position des Datensatzes implementationsabhängig. Ist die Tabelle indiziert, wird der Index mit den neuen Datensatzinformationen aktualisiert.


TDataSet::AppendRecord

TDataSet	Siehe auch

Die Methode AppendRecord fügt einen neuen Datensatz mit Daten am Ende der Datenmenge hinzu und trägt ihn in die Datenbank ein.

void __fastcall AppendRecord(const System::TVarRec *Values, const int Values_Size);

Beschreibung

Mit AppendRecord können Sie einen leeren Datensatz am Ende der Datenmenge erstellen, ihn mit den in Values übergebenen Feldwerten füllen und in die Datenbank eintragen. Ein neuer Datensatz wird auf eine der folgenden drei Arten in die Datenbank eingetragen:

•	Bei indizierten Paradox- und dBASE-Tabellen wird der Datensatz an der seinem Index entsprechenden Position in die Datenmenge eingefügt.

•	Bei nicht indizierten Paradox- und dBASE-Tabellen wird der Datensatz am Ende der Datenmenge hinzugefügt.

•	Bei SQL-Datenbanken ist die physische Position des Datensatzes implementationsabhängig. Ist die Tabelle indiziert, wird der Index mit den neuen Datensatzinformationen aktualisiert.

Der neue Datensatz wird dann zum aktuellen Datensatz.


TDataSet::ApplyUpdates

TDataSet	Siehe auch

Die Methode ApplyUpdates schreibt die anstehenden zwischengespeicherten Aktualisierungen einer Datenmenge in die Datenbank.

void __fastcall ApplyUpdates(void);

Beschreibung

Mit ApplyUpdates können Sie die zwischengespeicherten Aktualisierungen einer Datenmenge in eine Datenbank schreiben. Dabei werden die zwischengespeicherten Daten zum Speichern an die Datenbank übergeben, jedoch werden die Änderungen nicht in die Datenbank eingetragen. In einer Anwendung muß explizit die Methode Commit der Datenbankkomponente aufgerufen werden, um die Änderungen nach dem erfolgreichen Schreiben in die Datenbank einzutragen, oder die Methode Rollback verwendet werden, um bei einem Fehler die Änderungen rückgängig zu machen.

Nachdem die Daten erfolgreich in die Datenbank geschrieben und mit Commit eingetragen wurden, sollte der Aktualisierungspuffer mit der Methode CommitUpdates geleert werden.

Hinweis

Sollen die zwischengespeicherten Aktualisierungen mehrerer mit einer Datenbank verbundenen Datenmengen geschrieben werden, verwenden Sie statt dessen die Methode ApplyUpdates der Datenbankkomponente. Die Datenbankmethode ApplyUpdates berücksichtigt den Commit- bzw. Rollback-Status von Transaktionen und löscht nach erfolgreicher Operation den Zwischenspeicher.


TDataSet::Cancel

TDataSet	Siehe auch	Beispiel

Die Methode Cancel verwirft die Änderungen des aktuellen Datensatzes, falls diese noch nicht eingetragen wurden.

void __fastcall Cancel(void);

Beschreibung

Mit Cancel können Sie die Änderungen in einem oder mehreren Feldern des aktuellen Datensatzes rückgängig machen. Sind die Änderungen noch nicht in die Datenbank eingetragen, wird der alte Zustand des Datensatzes wiederhergestellt, und der Modus der Datenmenge in dsBrowse geändert.

Normalerweise wird Cancel verwendet, um auf eine Benutzeranforderung hin Änderungen zurückzunehmen oder in einer Feldvalidierungsroutine unzulässige Feldwerte zu verwerfen. Das Objekt TDBNavigator enthält den Schalter Abbrechen, mit dem Cancel aufgerufen werden kann.


TDataSet::CancelUpdates

TDataSet	Siehe auch

Die Methode CancelUpdates löscht alle Aktualisierungen aus dem Zwischenspeicher und stellt den vorherigen Zustand der Datenmenge wieder her.

void __fastcall CancelUpdates(void);

Beschreibung

Durch einen Aufruf von CancelUpdates werden alle Aktualisierungen aus dem Zwischenspeicher gelöscht, und die Datenmenge wird in dem Zustand wiederhergestellt, den sie beim letzten öffnen der Tabelle, beim letzten Aktivieren zwischengespeicherter Aktualisierungen oder beim letzten erfolgreichen Schreiben der Änderungen aus dem Puffer in die Datenbank hatte.

Wird eine Datenbank geschlossen oder die Eigenschaft CachedUpdates auf False gesetzt, erfolgt der Aufruf von CancelUpdates automatisch.

Hinweis

Mit der Methode RevertRecord können die Änderungen an einem einzelnen Datensatz rückgängig gemacht werden.


TDataSet::CheckBrowseMode

TDataSet	Siehe auch

Die Methode CheckBrowseMode trägt automatisch Datenänderungen ein oder verwirft diese, wenn eine Methode aufgerufen wird, die zu einem anderen Datensatz wechselt.

void __fastcall CheckBrowseMode(void);

Beschreibung

CheckBrowseMode wird intern von vielen Datenmengenmethoden verwendet. Sie stellt sicher, daß die Änderungen des aktuellen Datensatzes in die Datenbank eingetragen werden, wenn sich die Datenmenge im Modus dsEdit, dsInsert oder dsSetKey befindet und eine Methode aufgerufen wird, die zu einem anderen Datensatz wechselt.

Hat State den Wert dsEdit oder dsInsert, ruft CheckBrowseMode zuerst UpdateRecord auf. Ist die Eigenschaft Modified der Datenmenge auf True gesetzt, wird anschließend Post aufgerufen. Hat Modified den Wert False, wird statt dessen Cancel aufgerufen.

Hat State den Wert dsSetKey, ruft CheckBrowseMode die Methode Post auf.

Hat State den Wert dsInactive, löst CheckBrowseMode eine Exception aus.

Werden in einer Anwendung die vorhandenen Datenmengenmethoden verwendet, wird CheckBrowseMode gegebenenfalls automatisch aufgerufen. In diesem Fall muß CheckBrowseMode nicht direkt aufgerufen werden.

In selbstdefinierten Datenmengenroutinen müssen Sie durch einen Aufruf von CheckBrowseMode sicherstellen, daß die Änderungen beim Wechseln zu einem anderen Datensatz in die Datenbank eingetragen werden.


TDataSet::ClearFields

TDataSet	Siehe auch

Die Methode ClearFields löscht den Inhalt aller Felder des aktuellen Datensatzes.

void __fastcall ClearFields(void);

Beschreibung

Mit ClearFields können Sie den Inhalt aller Felder des aktuellen Datensatzes löschen. Befindet sich die Datenmenge dabei nicht im Modus dsInsert oder dsEdit, löst ClearFields eine Exception aus. Andernfalls ruft sie die Ereignisbehandlungsroutine für DataEvent auf, um CheckBrowseMode aufzurufen und anschließend die BDE, um die Felder des Datensatzes zu initialisieren (also zu löschen). Ist keine SetKey-Operation aktiv, aktualisiert ClearFields die Werte der berechneten Felder und ruft dann die Ereignisbehandlungsroutine für DataEvent mit einem Parameter auf, der die Änderung des Datensatzes anzeigt. Die Ereignisbehandlungsroutine für DataEvent ruft anschließend die Ereignisbehandlungsroutine für OnDataChange der mit der Datenmenge verbundenen Datenquelle auf.


TDataSet::Close

TDataSet	Siehe auch

Die Methode Close schließt eine Datenmenge.

void __fastcall Close(void);

Beschreibung

Durch einen Aufruf der Methode Close wird die Eigenschaft Active einer Datenmenge auf False gesetzt. Die Datenmenge wird daraufhin geschlossen und kann nicht mehr für den Zugriff auf die zugrundeliegende Datenbank verwendet werden.

Active muß auf False gesetzt werden, bevor die anderen Eigenschaften geändert werden können, die sich auf den Status der Datenbank oder der visuellen Steuerelemente auswirken. Soll beispielsweise die Eigenschaft DataSource einer Datenmenge geändert werden, muß sie vorher durch Setzen von Active auf False geschlossen werden. Dadurch wird der Modus der Datenmenge in dsInactive geändert und der BDE-Cursor geschlossen.


TDataSet::CommitUpdates

TDataSet	Siehe auch

Die Methode CommitUpdates löscht den Puffer für zwischengespeicherte Aktualisierungen.

void __fastcall CommitUpdates(void);

Beschreibung

Mit CommitUpdates kann der Puffer mit den zwischengespeicherten Aktualisierungen nach erfolgreichen Aufrufen von ApplyUpdates und der Datenbankmethode Commit gelöscht werden. Auf diese Weise wird sichergestellt, daß der Puffer außer den Datensätzen, die nicht bearbeitet werden konnten und von den Ereignisbehandlungsroutinen für OnUpdateRecord oder OnUpdateError übersprungen wurden, keine weiteren Informationen enthält. Die noch im Puffer verbliebenen Datensätze können weiterhin von einer Anwendung geändert werden.

Werden nach dem Aufruf von CommitUpdates Datensätze geändert, wird der Puffer wieder gefüllt. Sie müssen daher anschließend ApplyUpdates aufrufen, um die Datensätze in die Datenbank zu schreiben.

Hinweis

CommitUpdates muß nicht aufgerufen werden, wenn die anstehenden Aktualisierungen aller Datenmengen mit der Datenbankmethode ApplyUpdates geschrieben und eingetragen werden.


TDataSet::ControlsDisabled

TDataSet	Siehe auch

Die Methode ControlsDisabled bestimmt, ob die Datenanzeige in den datensensitiven Steuerelementen zur Zeit für die Datenmenge deaktiviert ist.

bool __fastcall ControlsDisabled(void);

Beschreibung

Mit ControlsDisabled können Sie feststellen, ob die Datenanzeige in den datensensitiven Steuerelementen zur Zeit für die Datenmenge deaktiviert ist. Werden viele Datensätze in einer Schleife verarbeitet, sollten die Steuerelemente aus Geschwindigkeitsgründen deaktiviert werden. In komplexen Anwendungen kann es vorkommen, daß dieselben Steuerelemente von verschiedenen Prozessen (Threads) deaktiviert werden. Mit ControlsDisabled kann dann der aktuelle Status der Anzeige überprüft werden.


TDataSet::CursorPosChanged

TDataSet	Siehe auch

Die Methode CursorPosChanged setzt die Position des BDE-Cursors der Datenmenge auf -1.

void __fastcall CursorPosChanged(void);

Beschreibung

CurPosChanged ist eine interne Methode und setzt den Wert der BDE-Cursorposition in der Datenmenge auf -1. Dieser Wert entspricht keiner gültigen Position. CurPosChanged wird von den Methoden Locate und Lookup aufgerufen, bevor ein angeforderter Datensatz gesucht wird. Diese Methoden sollten bei Erfolg den Cursor auf den ersten übereinstimmenden Datensatz setzen.


TDataSet::Delete

TDataSet	Siehe auch

Die Methode Delete löscht den aktuellen Datensatz und setzt den Cursor auf die nächste Zeile.

void __fastcall Delete(void);

Beschreibung

Mit Delete können sie den aktuellen Datensatz aus der Datenbank entfernen. Ist die Datenmenge nicht aktiv, löst Delete eine Exception aus. Andernfalls werden folgende Aktionen ausgeführt:

•	Es wird überprüft, ob die Datenmenge nicht leer ist. Ist sie leer, wird eine Exception ausgelöst.

•	CheckBrowseMode wird aufgerufen, um gegebenenfalls die Änderungen für einen anderen Datensatz einzutragen.

•	Die Ereignisbehandlungsroutine für BeforeDelete wird aufgerufen.

•	Die BDE wird aufgerufen, um den Datensatz zu löschen.

•	Der für den Datensatz reservierte Puffer wird freigegeben.

•	Der Modus der Datenmenge wird in dsBrowse geändert.

•	Die Datenmenge wird neu synchronisiert, um den Cursor auf den nächsten nicht gelöschten Datensatz zu positionieren.

•	Die Ereignisbehandlungsroutine für AfterDelete wird aufgerufen.


TDataSet::DisableControls

TDataSet	Siehe auch

Die Methode DisableControls deaktiviert die Datenanzeige in den datensensitiven Steuerelementen, die über eine Datenquellenkomponente mit der Datenmenge verbunden sind.

void __fastcall DisableControls(void);

Beschreibung

Mit DisableControls können Sie die Datenanzeige in den datensensitiven Steuerelementen deaktivieren, bevor Sie eine große Anzahl von Datensätzen in einer Schleife verarbeiten. Auf diese Weise können Sie den ständigen Bildaufbau in den Steuerelementen während der Iteration verhindern und die Verarbeitung beschleunigen, da die Anzeige nicht laufend aktualisiert werden muß.

Sind die Steuerelemente nicht deaktiviert, zeichnet DisableControls den aktuellen Status der Datenmenge auf, setzt das aktivierende Ereignis der Datenmenge auf deDataSetChange und inkrementiert den Deaktivierungszähler der Datenmenge. Andernfalls wird nur der Deaktivierungszähler inkrementiert.

Das aktivierende Ereignis und der Deaktivierungszähler werden intern von anderen Methoden und Objekten verwendet, um zu bestimmen, ob Daten in den datensensitiven Steuerelementen angezeigt werden sollen. Enthält die Zählervariable einen Wert größer Null, werden keine Daten angezeigt.

Normalerweise wird DisableControls in einem try...finally-Block aufgerufen. Dadurch werden die Steuerelemente bei Auftreten einer Exception wieder aktiviert.

Hinweis

DisableControls kann auch aufgerufen werden, wenn die Steuerelemente bereits deaktiviert sind. In komplexen Anwendungen sind verschachtelte Operationen möglich, in denen die Steuerelemente mehrfach deaktiviert werden müssen.


TDataSet::Edit

TDataSet	Siehe auch

Die Methode Edit ermöglicht das Bearbeiten der Daten in einer Datenmenge.

void __fastcall Edit(void);

Beschreibung

Mit Edit können Sie das Bearbeiten des aktuellen Datensatzes einer Datenmenge ermöglichen. Edit ermittelt zunächst den aktuellen Status der Datenmenge. Ist sie leer, wird die Methode Insert aufgerufen. Andernfalls werden folgende Aktionen durchgeführt:

•	CheckBrowseMode wird aufgerufen, um gegebenenfalls die Änderungen eines früheren Datensatzes einzutragen.

•	Die Ereignisbehandlungsroutine für BeforeEdit wird aufgerufen.

•	Der Datensatz wird abgerufen und eine Sperre gesetzt (falls möglich).

•	Der Modus der Datenmenge wird in dsEdit geändert, damit die Anwendung oder der Benutzer die Felder des Datensatzes bearbeiten kann.

•	Das Datensatzänderungsereignis wird ausgelöst.

•	Die Ereignisbehandlungsroutine für AfterEdit wird aufgerufen.


TDataSet::EnableControls

TDataSet	Siehe auch

Die Methode EnableControls aktiviert die Datenanzeige in den datensensitiven Steuerelementen, die durch eine Datenquellenkomponente mit der Datenmenge verbunden sind.

void __fastcall EnableControls(void);

Beschreibung

Mit EnableControls können Sie nach einem vorhergehenden Aufruf von DisableControls die Datenanzeige in datensensitiven Steuerelementen wieder aktivieren. Dabei wird der Deaktivierungszähler der Datenmenge dekrementiert, wenn er größer als null ist. Enthält die Zählervariable den Wert Null, wird der aktuelle Status der Datenmenge nötigenfalls aktualisiert und eine Ereignisbehandlungsroutine für das erneute Aktivieren der Datenanzeige aufgerufen.


TDataSet::FetchAll

TDataSet	Siehe auch

Die Methode FetchAll ruft alle Datensätze von der aktuellen Cursorposition bis zum Ende der Datei ab und speichert sie lokal.

void __fastcall FetchAll(void);

Beschreibung

Mit FetchAll können Sie bei aktivierter Zwischenspeicherung den Datenverkehr im Netzwerk verringern. FetchAll ruft zuerst CheckBrowseMode auf, um die Änderungen einzutragen. Anschließend werden alle Datensätze von der aktuellen Cursorposition bis zum Ende der Datei abgerufen und lokal gespeichert.

Normalerweise werden in einer Transaktion nur die Daten abgerufen, die für die Anzeige benötigt werden, und bei jeder neuen Leseoperation wird eine neue Nur-Lesen-Transaktion gestartet. Um die Transaktionen zu konsolidieren und die Netzwerkbelastung zu verringern, können mit FetchAll die gesamten Daten in einer Transaktion abgerufen werden.

Hinweis

Sollen alle Datensätze einer Datenmenge abgerufen werden, rufen Sie vor FetchAll die Methode First auf.

Ist ein Filter für die Datenmenge aktiviert, berücksichtigt FetchAll nur die Datensätze, die den Filterkriterien entsprechen.

Hinweis

FetchAll ist nicht für alle Situationen geeignet. Greift eine Anwendung beispielsweise auf eine Datenbank zu, die von vielen Clients gleichzeitig verwendet wird, die dieselben Datensätze aktualisieren wollen, ist das Abrufen aller Datensätze nicht von Vorteil, da einige Datensätze möglicherweise von anderen Anwendungen geändert werden. Sie sollten immer zwischen dem Vorteil reduzierter Netzwerkbelastung und dem Bedürfnis nach geringerer Datensatzkonkurrenz abwägen.


TDataSet::FieldByName

TDataSet	Siehe auch

Die Methode FieldByName sucht ein Feld anhand des angegebenen Feldnamens.

TField* __fastcall FieldByName(const System::AnsiString FieldName);

Beschreibung

Mit FieldByName können Sie Informationen zu einem Feld abrufen, von dem nur der Name bekannt ist. Der Parameter FieldName gibt den Namen eines vorhandenen Feldes an. Die Methode gibt die TField-Komponente des gesuchten Feldes zurück.

Sie können direkt auf bestimmte Eigenschaften und Methoden des Feldes zugreifen.

FieldByName ist insbesondere während des Entwurfs nützlich, wenn Sie keinen Zugriff auf die zugrundeliegende Tabelle haben.

Hinweis

Um den Wert eines bestimmten Feldes zu lesen oder zu schreiben, rufen Sie statt FieldByName die Standard-Datenmengenmethode FieldValues auf.


TDataSet::FindField

TDataSet	Siehe auch

Die Methode FindField sucht in einer Datenmenge nach dem angegebenen Feldobjekt.

TField* __fastcall FindField(const System::AnsiString FieldName);

Beschreibung

Mit FindField können Sie feststellen, ob die angegebene Feldkomponente in einer Datenmenge vorhanden ist. Der Parameter FieldName gibt den Namen des gesuchten Feldes an. Findet FindField ein Feld mit einem übereinstimmenden Namen, wird die TField-Komponente des betreffenden Feldes zurückgegeben. Schlägt die Methode fehl, wird der Wert NULL zurückgegeben.

FindField sollte vor anderen Datenmengenmethoden (z.B. FieldByName) aufgerufen werden, die einen gültigen Feldnamen als Parameter benötigen.


TDataSet::FindFirst

TDataSet	Siehe auch

Die Methode FindFirst setzt den Cursor in den ersten Datensatz einer gefilterten Datenmenge.

bool __fastcall FindFirst(void);

Beschreibung

Mit FindFirst können Sie die Datensätze einer gefilterten Datenmenge abrufen und den Cursor auf den ersten Datensatz setzen. Dabei werden alle Änderungen des aktuellen Datensatzes eingetragen, die Cursorposition aktualisiert, die Datenmenge erneut gefiltert und der Cursor auf den ersten Datensatz der gefilterten Menge gesetzt.

Bei Erfolg gibt FindLast den Wert True zurück und setzt den Cursor auf den ersten Datensatz. Wird kein Datensatz gefunden, gibt die Methode False zurück und ändert die Position des Cursors nicht.

Hinweis

Verwenden Sie FindFirst und nicht die Methode First, damit die Datenmenge vor dem Ändern der Cursorposition erneut gefiltert wird. FindFirst stellt sicher, daß Datensätze in der Anwendung sichtbar sind, die ursprünglich die Filterkriterien nicht erfüllt haben, aber ihnen mittlerweile aufgrund von Änderungen durch andere Anwendungen entsprechen.


TDataSet::FindLast

TDataSet	Siehe auch

Die Methode FindLast setzt den Cursor auf den letzten Datensatz einer gefilterten Datenmenge.

 bool __fastcall FindLast(void);

Beschreibung

Mit FindLast können Sie die Datensätze einer gefilterten Datenmenge erneut abrufen und den Cursor auf den letzten Datensatz setzen. Dabei werden alle Änderungen des aktuellen Datensatzes eingetragen, die Cursorposition aktualisiert, die Datenmenge erneut gefiltert und der Cursor auf den letzten Datensatz der gefilterten Menge gesetzt.

Bei Erfolg gibt FindLast den Wert True zurück und setzt den Cursor auf den letzten Datensatz. Wird kein Datensatz gefunden, gibt die Methode False zurück und ändert die Position des Cursors nicht.

Hinweis

Verwenden Sie FindLast und nicht Last, damit die Datenmenge vor dem Ändern der Cursorposition erneut gefiltert wird. FindLast stellt sicher, daß Datensätze in der Anwendung sichtbar werden, die ursprünglich die Filterkriterien nicht erfüllt haben, aber ihnen mittlerweile aufgrund von Änderungen durch andere Anwendungen entsprechen.


TDataSet::FindNext

TDataSet	Siehe auch

Die Methode FindNext setzt den Cursor auf den nächsten Datensatz einer gefilterten Datenmenge.

bool __fastcall FindNext(void);

Beschreibung

Mit FindNext können Sie die Datensätze einer gefilterten Datenmenge erneut abrufen und den Cursor auf den nächsten Datensatz setzen. Dabei werden alle Änderungen des aktuellen Datensatzes eingetragen, die Cursorposition aktualisiert, die Datenmenge erneut gefiltert und der Cursor auf den nächsten Datensatz der gefilterten Menge gesetzt.

Bei Erfolg gibt FindNext den Wert True zurück und setzt den Cursor auf den nächsten Datensatz. Wird kein Datensatz gefunden, gibt die Methode False zurück und ändert die Position des Cursors nicht.

Hinweis

Verwenden Sie FindNext und nicht die Methode Next, damit die Datenmenge vor dem Ändern der Cursorposition erneut gefiltert wird. FindFirst stellt sicher, daß Datensätze in der Anwendung sichtbar sind, die ursprünglich die Filterkriterien nicht erfüllt haben, aber ihnen jetzt aufgrund von Änderungen durch andere Anwendungen entsprechen.


TDataSet::FindPrior

TDataSet	Siehe auch

Die Methode FindPrior setzt den Cursor auf den vorhergehenden Datensatz einer gefilterten Datenmenge.

 bool __fastcall FindPrior(void);

Beschreibung

Mit FindPrior können Sie die Datensätze einer gefilterten Datenmenge erneut abrufen und den Cursor auf den vorhergehenden Datensatz setzen. Dabei werden alle Änderungen des aktuellen Datensatzes eingetragen, die Cursorposition aktualisiert, die Datenmenge erneut gefiltert und der Cursor auf den vorhergehenden Datensatz der gefilterten Menge gesetzt.

Bei Erfolg gibt FindPrior den Wert True zurück und setzt den Cursor auf den vorhergehenden Datensatz. Wird kein Datensatz gefunden, gibt die Methode False zurück und ändert die Position des Cursors nicht.

Hinweis

Verwenden Sie FindPrior und nicht die Methode Prior, damit die Datenmenge vor dem Ändern der Cursorposition erneut gefiltert wird. FindFirst stellt sicher, daß Datensätze in der Anwendung sichtbar sind, die ursprünglich die Filterkriterien nicht erfüllt haben, aber ihnen jetzt aufgrund von Änderungen durch andere Anwendungen entsprechen.


TDataSet::First

TDataSet	Siehe auch

Die Methode First setzt den Cursor auf den ersten Datensatz einer Datenmenge.

void __fastcall First(void);

Beschreibung

Mit First können Sie den Cursor auf den ersten Datensatz einer Datenmenge setzen und ihn zum aktuellen Datensatz machen. Dabei werden zuerst die Änderungen des aktuellen Datensatzes eingetragen und dann folgende Aktionen durchgeführt:

•	Der Datensatzpuffer wird gelöscht.

•	Der Cursor wird an den Anfang der Datenmenge gesetzt.

•	Der erste Datensatz wird abgerufen, der Cursor auf ihm positioniert, und er wird zum aktuellen Datensatz gemacht.

•	Die anderen für die Anzeige benötigten Datensätze werden abgerufen, um beispielsweise eine Gitterkomponente zu füllen.

•	Die Eigenschaft BOF wird auf True gesetzt.

•	Eine Ereignisbehandlungsroutine für Änderungsereignisse in der Datenmenge wird ausgelöst.


TDataSet::FreeBookmark

TDataSet	Siehe auch

Die Methode FreeBookmark gibt die einer bestimmten Positionsmarke zugewiesenen Ressourcen frei.

void __fastcall FreeBookmark(void * Bookmark);

Beschreibung

Mit FreeBookmark können Sie folgende Aufgaben durchführen:

Eine vorhandene Positionsmarke wird freigeben, bevor sie erneut zugewiesen wird.

Der von der Positionsmarke belegte Speicher wird freigeben, wenn sie nicht mehr benötigt wird.


TDataSet::GetBookmark

TDataSet	Siehe auch

Die Methode GetBookmark weist der aktuellen Cursorposition in einer Datenmenge eine Positionsmarke zu.

void * __fastcall GetBookmark(void);

Beschreibung

Mit GetBookmark können Sie für den aktuellen Datensatz in der Datenmenge eine Positionsmarke einrichten. Anschließen können Sie jederzeit in der Anwendung zu diesem Datensatz zurückkehren.

GetBookmark setzt voraus, daß bereits eine Variable des Typs TBookmark in der Anwendung deklariert ist. Weisen Sie der Variablen dann mit GetBookmark einen Wert zu, der bei einem späteren Aufruf von GotoBookmark und FreeBookmark verwendet werden kann.


TDataSet::GetCurrentRecord

TDataSet	Siehe auch

Die Methode GetCurrentRecord liest den aktuellen Datensatz in einen Puffer ein.

bool __fastcall GetCurrentRecord(char * Buffer);

Beschreibung

In den meisten Anwendungen muß GetCurrentRecord nicht direkt aufgerufen werden. Die Klasse TDataSet weist automatisch einen Puffer für den aktuellen Datensatz zu. GetCurrentRecord wird nur intern verwendet, wenn ein Datensatzpuffer für ein TBlobStream-Objekt (BLOB-Feld) reserviert wird.

Mit GetCurrentRecord können Sie den aktuellen Datensatz in einen Puffer kopieren, den Sie zuvor in Ihrer Anwendung angelegt haben. Der Parameter Buffer muß mindestens so groß wie die von der Eigenschaft RecordSize angegebene Datensatzgröße sein. So zeigt beispielsweise das folgende Codefragment, das dem Konstruktor für TBlobStream entnommen wurde, wie ein lokaler Puffer für einen BLOB-Stream zugewiesen und mit einem BLOB-Feldobjekt verbunden werden kann:


TDataSet::GetFieldList

TDataSet	Siehe auch

Die Methode GetFieldList kopiert die angegebenen Feldobjekte in eine Liste.

void __fastcall GetFieldList(Classes::TList* List, const System::AnsiString FieldNames);

Beschreibung

Mit GetFieldList können Sie die angegebenen Feldobjekte in ein von der Anwendung erstelltes und verwaltetes Listenobjekt kopieren.

List gibt das TList-Objekt an, in das die Felder kopiert werden. FieldNames ist ein String mit den Namen der Feldobjekte. Die verschiedenen Feldnamen müssen durch Semikolons voneinander getrennt werden. Daraufhin wird eine Liste mit den Feldobjekten erstellt, die mit den Feldern in der Liste der Datenmenge übereinstimmen.

Hinweis

Normalerweise muß GetFieldList nicht aufgerufen werden. Auf die Felder kann durch die Datenmenge selbst zugegriffen werden. In manchen Fällen ist es jedoch besser, statt mit dem eigentlichen Feldobjekt in der Datenmenge mit einer Kopie oder mit seinen Daten zu arbeiten. Verwenden Sie in diesen Situationen die Methode GetFieldList.


TDataSet::GetFieldNames

TDataSet	Siehe auch

Die Methode GetFieldNames ruft eine Liste mit den Namen der Felder in einer Datenmenge ab.

void __fastcall GetFieldNames(Classes::TStrings* List);

Beschreibung

Mit GetFieldNames erhalten Sie eine Liste aller Feldnamen in einer Datenmenge. List ist ein TStrings-Objekt, das in der Anwendung erstellt und verwaltet werden muß.

Die Liste mit den Feldnamen ist besonders für die Arbeit mit Datenmengen nützlich, deren Feldobjekte zur Laufzeit dynamisch erstellt werden. In der Anwendung können dann die zur Laufzeit vorhandenen Feldnamen verwendet werden.


TDataSet::GotoBookmark

TDataSet	Siehe auch

Die Methode GotoBookmark setzt den Cursor auf den Datensatz, auf den eine bestimmte Positionsmarke zeigt.

void __fastcall GotoBookmark(void * Bookmark);

Beschreibung

Mit GotoBookmark können Sie den Cursor auf den Datensatz setzen, auf den eine zuvor mit GetBookmark erstellte Positionsmarke zeigt. Der Parameter Bookmark gibt die gewünschte Positionsmarke an.


TDataSet::Insert

TDataSet	Siehe auch

Die Methode Insert fügt einen neuen leeren Datensatz in eine Datenmenge ein.

void __fastcall Insert(void);

Beschreibung

Insert führt folgende Aktionen durch:

1	Ein neuer leerer Datensatz wird in der Datenmenge geöffnet.

2	Der neue Datensatz wird zum aktuellen Datensatz.

Nach dem Aufruf von Insert können die Benutzer Daten in die Felder des neuen Datensatzes eingeben und anschließend die Änderungen mit Post (oder mit ApplyUpdates bei aktivierter Zwischenspeicherung) in die Datenbank eintragen. Ein neuer Datensatz wird auf eine der folgenden drei Arten in die Datenbank eingetragen:

•	Bei indizierten Paradox- und dBASE-Tabellen wird der Datensatz an der seinem Index entsprechenden Position in die Datenmenge eingefügt.

•	Bei nicht indizierten Paradox- und dBASE-Tabellen wird der Datensatz an der aktuellen Cursorposition eingefügt.

•	Bei SQL-Datenbanken ist die physische Position des Datensatzes implementationsabhängig. Ist die Tabelle indiziert, wird der Index mit den neuen Datensatzinformationen aktualisiert.


TDataSet::InsertRecord

TDataSet	Siehe auch

Die Methode InsertRecord fügt einen neuen Datensatz mit Daten in die Datenmenge ein und trägt ihn in die Datenbank ein.

void __fastcall InsertRecord(const System::TVarRec *Values, const int Values_Size);

Beschreibung

Mit InsertRecord können Sie einen neuen leeren Datensatz in die Datenmenge einfügen, ihn mit den in Values übergebenen Feldwerten füllen und in die Datenbank eintragen. Ein neuer Datensatz wird auf eine der folgenden drei Arten in die Datenbank eingetragen:

•	Bei indizierten Paradox- und dBASE-Tabellen wird der Datensatz an der seinem Index entsprechenden Position in die Datenmenge eingefügt.

•	Bei nicht indizierten Paradox- und dBASE-Tabellen wird der Datensatz an der aktuellen Cursorposition eingefügt.

•	Bei SQL-Datenbanken ist die physische Position des Datensatzes implementationsabhängig. Ist die Tabelle indiziert, wird der Index mit den neuen Datensatzinformationen aktualisiert.

Der neue Datensatz wird zum aktuellen Datensatz.


TDataSet::IsLinkedTo

TDataSet	Siehe auch

Die Methode IsLinkedTo prüft, ob eine Datenmenge mit einer bestimmten Datenquelle verbunden ist.

bool __fastcall IsLinkedTo(TDataSource* DataSource);

Beschreibung

Mit IsLinkedTo können Sie überprüfen, ob eine Datenmenge mit einer bestimmten Datenquelle verbunden ist. Der Parameter DataSource gibt den Namen der betreffenden Datenquelle an.

Wird die angegebene Datenquelle bereits von der Datenmenge verwendet, gibt IsLinkedTo den Wert True zurück. Ist die Datenquelle zwar vorhanden, jedoch nicht mit der Datenmenge verbunden, setzt IsLinkedTo die Eigenschaft DataSource der Datenmenge auf den Wert des Parameters DataSource und gibt True zurück.

Verwendet die Datenmenge die angegebene Datenquelle nicht, und ist diese mit keiner anderen Datenmenge verbunden, gibt IsLinkedTo den Wert False zurück.


TDataSet::Last

TDataSet	Siehe auch

Die Methode Last setzt den Cursor auf den letzten Datensatz einer Datenmenge.

void __fastcall Last(void);

Beschreibung

Mit Last können Sie den Cursor auf den letzten Datensatz einer Datenmenge setzen und ihn zum aktuellen Datensatz machen. Dabei werden zuerst die Änderungen des aktuellen Datensatzes eingetragen und dann folgende Aktionen durchgeführt:

•	Der Datensatzpuffer wird gelöscht.

•	Der Cursor wird an das Ende der Datenmengendatei gesetzt.

•	Der letzte Datensatz wird abgerufen, der Cursor auf ihm positioniert, und er wird zum aktuellen Datensatz gemacht.

•	Die anderen für die Anzeige benötigten Datensätze werden abgerufen, um beispielsweise eine Gitterkomponente zu füllen.

•	Die Eigenschaft EOF wird auf True gesetzt.

•	Eine Ereignisbehandlungsroutine für Änderungsereignisse in der Datenmenge wird ausgelöst.


TDataSet::Locate

TDataSet	Siehe auch

Die Methode Locate sucht in einer Datenmenge nach einer bestimmten Zeile und macht sie zum aktuellen Datensatz.

bool __fastcall Locate(const System::AnsiString KeyFields, const System::Variant &KeyValues,  TLocateOptions  Options);

Beschreibung

Mit Locate können Sie in einer Datenmenge nach einem bestimmten Datensatz suchen und den Cursor auf diesen setzen. KeyFields ist ein String, der den gesuchten Datensatz enthält. Mehrere Datensätze werden in einer durch Semikolons getrennten Liste angegeben.

KeyValues ist ein Varianten-Array mit den gesuchten Schlüsselwerten. Sollen mehrere Suchwerte angegeben werden, übergeben Sie KeyValues als Varianten-Array oder erstellen während der Laufzeit ein Array mit der Routine VarArrayOf. Ein Beispiel:

with CustTable do

  Locate('Firma;Kontakt;Telefon', VarArrayOf(['Maier', 'P']), loPartialKey);

Options ist eine Menge, mit der optional weitere Einstellungen für die Suche in Stringfeldern vorgenommen werden können. Enthält Options die Option loCaseInsensitive, wird die Groß-/Kleinschreibung bei der Suche nicht berücksichtigt. Die Einstellung loPartialKey gibt an, daß auch Datensätze gefunden werden, bei denen nur der Anfang der KeyValues-Kriterien übereinstimmt. Wird mit Options eine leere Menge übergeben, oder enthält KeyFields keine Stringfelder, wird Options ignoriert.

Locate gibt True zurück, wenn ein übereinstimmender Datensatz gefunden wird, und setzt den Cursor auf diesen. Schlägt die Methode fehl, wird False zurückgegeben.

Locate verwendet die schnellstmögliche Technik, um übereinstimmende Datensätze zu suchen. Sind die in KeyFields übergebenen Suchfelder indiziert, und ist der Index mit den angegebenen Suchoptionen kompatibel, wird er für die Suche verwendet. Andernfalls erstellt Locate automatisch einen Filter für die Operation.


TDataSet::Lookup

TDataSet	Siehe auch

Die Methode Lookup gibt die Feldwerte eines Datensatzes zurück, der mit den angegebenen Suchwerten übereinstimmt.

System::Variant __fastcall Lookup(const System::AnsiString KeyFields, const System::Variant &KeyValues, const System::AnsiString ResultFields);

Beschreibung

Mit Lookup können Sie die Werte der angegebenen Felder eines Datensatzes abrufen, der mit den Suchkriterien übereinstimmt. KeyFields ist ein String, der die zu durchsuchenden Feldnamen in einer durch Semikolons getrennten Liste enthält.

KeyValues ist ein Varianten-Array mit den gesuchten Schlüsselwerten. Sollen mehrere Suchwerte angegeben werden, übergeben Sie KeyValues als Varianten-Array oder erstellen während der Laufzeit ein Array mit Hilfe der Routine VarArrayOf.

ResultFields enthält die durch Semikolons getrennten Felder, deren Werte zurückgegeben werden sollen.

Lookup gibt ein Varianten-Array mit den Werten der in ResultFields angegebenen Felder zurück.

Lookup verwendet die schnellstmögliche Technik, um übereinstimmende Datensätze zu suchen. Sind die in KeyFields übergebenen Suchfelder indiziert, wird der Index für die Suche verwendet. Andernfalls erstellt Lookup automatisch einen Filter für die Operation.


TDataSet::MoveBy

TDataSet	Siehe auch

Die Methode MoveBy positioniert den Cursor in einer Datenmenge um eine bestimmte Anzahl Datensätze vor oder zurück.

int __fastcall MoveBy(int Distance);

Beschreibung

Mit MoveBy können Sie den Cursor relativ zum aktuellen Datensatz in der Datenmenge positionieren. Distance gibt die Anzahl der Datensätze an, um die der Cursor verschoben werden soll. Bei einem positiven Wert wird der Cursor nach vorn, bei einem negativen Wert nach hinten bewegt. Im folgenden Beispiel wird der Cursor in einer Datenmenge um zehn Datensätze nach hinten verschoben:

MoveBy(-10);

MoveBy trägt zuerst die Änderungen des aktuellen Datensatzes ein und führt dann folgende Aktionen durch:

•	Die Eigenschaften BOF und EOF werden auf False gesetzt.

•	Ist Distance positiv, werden wiederholt nachfolgende Datensätze abgerufen, der Wert von Distance dekrementiert, bis er Null ist und der Cursor auf den letzten abgerufenen Datensatz gesetzt. Bei einem Versuch, hinter das Ende der Datei zu gelangen, wird EOF auf True gesetzt.

•	Ist Distance negativ, werden wiederholt vorhergehende Datensätze abgerufen, der Wert von Distance inkrementiert, bis er Null ist und der Cursor auf den letzten abgerufenen Datensatz gesetzt. Bei einem Versuch, vor den Anfang der Datei zu gelangen, wird BOF auf True gesetzt.

•	Eine Ereignisbehandlungsroutine für Datenmengen-Bildlaufereignisse wird ausgelöst.

•	Die tatsächliche Anzahl der Datensätze, um die der Cursor versetzt wurde, wird zurückgegeben. In den meisten Fällen, entspricht der Rückgabewert (Result) dem absoluten Wert von Distance. Wird jedoch vor Erreichen von Distance der Anfang oder das Ende der Datei erreicht, ist Result kleiner als Distance.


TDataSet::Next

TDataSet	Siehe auch

Die Methode Next setzt den Cursor auf den nächsten Datensatz einer Datenmenge.

void __fastcall Next(void);

Beschreibung

Mit Next können Sie den Cursor auf den nächsten Datensatz der Datenmenge setzen und ihn zum aktuellen Datensatz machen. Dabei werden zuerst die Änderungen des aktuellen Datensatzes eingetragen und anschließend folgende Aktionen durchgeführt:

•	Die Eigenschaften BOF und EOF werden auf False gesetzt.

•	Der nächste Datensatz wird abgerufen (falls möglich) und der Cursor auf diesen Datensatz gesetzt.

•	Die Eigenschaft EOF wird auf True gesetzt, wenn sich der Cursor bereits auf dem letzten Datensatz befindet.

•	Eine Ereignisbehandlungsroutine für Datenmengen-Bildlaufereignisse wird ausgelöst.


TDataSet::Open

TDataSet	Siehe auch

Die Methode Open öffnet eine Datenmenge.

void __fastcall Open(void);

Beschreibung

Durch einen Aufruf von Open wird die Eigenschaft Active einer Datenmenge auf True gesetzt. Daraufhin wird die Datenmenge geöffnet, und die Daten in der Datenbank können gelesen und geschrieben werden.

Hat Active den Wert True, werden folgende Aktionen durchgeführt:

•	Die Ereignisbehandlungsroutine für BeforeOpen der Datenmenge wird aufgerufen (falls vorhanden).

•	Der Status der Datenmenge wird auf dsBrowse gesetzt.

•	Ein BDE-Cursor für die Datenmenge wird geöffnet.

•	Die Ereignisbehandlungsroutine für AfterOpen der Datenmenge wird aufgerufen (falls vorhanden).

Tritt beim öffnen der Datenmenge ein Fehler auf, wird ihr Modus in dsInactive geändert und der Cursor geschlossen.


TDataSet::Post

TDataSet	Siehe auch

Die Methode Post schreibt einen geänderten Datensatz in die Datenbank oder in den Aktualisierungspuffer.

void __fastcall Post(void);

Beschreibung

Mit Post können Sie einen geänderten Datensatz in die Datenbank oder in den Aktualisierungspuffer eintragen. Post wird von allen Datenmengenmethoden automatisch aufgerufen, die den Modus der Datenmenge ändern (z.B. Edit, Insert oder Append) oder von einem Datensatz zu einem anderen wechseln (z.B. First, Last, Next und Prior).

Post ruft UpdateRecord auf, um ein Aktualisierungsereignis aufzurufen oder eine Exception auszulösen, wenn der Modus der Datenmenge keine Änderungen zuläßt. Hat die Eigenschaft State der Datenmenge den Wert dsEdit oder dsInsert, führt Post auch die folgenden Aktionen aus:

•	Ein Ereignis zum Prüfen des Browse-Modus wird ausgelöst.

•	Es wird überprüft, ob alle Felder Werte enthalten, bei denen eine Eingabe erforderlich ist.

•	Die Ereignisbehandlungsroutine für BeforePost wird aufgerufen.

•	Der Datensatz wird in die Datenbank oder den Puffer eingetragen.

•	Die den Feldern oder dem Datensatz zugewiesenen Puffer werden freigegeben.

•	Die Eigenschaft State der Datenmenge wird auf dsBrowse gesetzt.

•	Resync wird aufgerufen, um den aktuellen Datensatz sowie die anderen für die Anzeige benötigten Datensätze abzurufen.

•	Die Ereignisbehandlungsroutine für AfterPost wird aufgerufen.

Hat State den Wert dsSetKey, löscht Post die Schlüsselpuffer und ändert den Modus der Datenmenge in dsBrowse.


TDataSet::Prior

TDataSet	Siehe auch

Die Methode Prior setzt den Cursor auf den vorhergehenden Datensatz einer Datenmenge.

void __fastcall Prior(void);

Beschreibung

Mit Prior können Sie den Cursor auf den vorhergehenden Datensatz der Datenmenge setzen und ihn zum aktuellen Datensatz machen. Dabei werden zuerst die Änderungen des aktuellen Datensatzes eingetragen und anschließend folgende Aktionen durchgeführt:

•	Die Eigenschaften BOF und EOF werden auf False gesetzt.

•	Der vorherige Datensatz wird abgerufen (falls möglich) und zum aktuellen Datensatz gemacht.

•	Die Eigenschaft BOF wird auf True gesetzt, wenn sich der Cursor bereits auf dem ersten Datensatz befindet.

•	Eine Ereignisbehandlungsroutine für Datenmengen-Bildlaufereignisse wird ausgelöst.


TDataSet::Refresh

TDataSet	Siehe auch

Die Methode Refresh aktualisiert eine Datenmenge durch erneutes Abrufen der Daten aus der Datenbank.

void __fastcall Refresh(void);

Beschreibung

Mit Refresh können Sie sicherstellen, daß die neuesten Daten aus einer Datenbank verwendet werden. Wird beispielsweise in einer Anwendung der Filter einer Datenmenge deaktiviert, sollte anschließend sofort Refresh aufgerufen werden, damit alle Datensätze in der Datenmenge angezeigt werden und nicht nur diejenigen, die mit der Filterbedingung übereinstimmen.

Refresh führt folgende Aktionen durch:

•	CheckBrowseMode wird aufgerufen, um alle Aktualisierungen einzutragen.

•	UpdateCursorPos wird aufgerufen, um die Position des Cursors in der Datenmenge zu aktualisieren.

•	Die BDE wird aufgerufen, um das erneute Lesen der Daten zu ermöglichen.

•	Resync wird aufgerufen, um den aktuellen Datensatz sowie die anderen für die Anzeige benötigten Datensätze abzurufen.


TDataSet::Resync

TDataSet	Siehe auch

Die Methode Resync ruft den aktuellen Datensatz sowie die anderen für die Anzeige benötigten Datensätze ab.

void __fastcall Resync( TResyncMode Mode);

Beschreibung

Resync ist eine interne Routine, die von den anderen Datenmengenmethoden verwendet wird, um Datensätze nach Operationen abzurufen, die die in einer Datenmenge sichtbaren Datensätze ändern (z.B. Aktivieren oder Deaktivieren eines Filters). Mit Resync kann in einer Anwendung jederzeit sichergestellt werden, daß mit den aktuellen Daten gearbeitet wird.

Mode gibt optionale Verarbeitungsschritte an, die von Resync durchgeführt werden sollen.

Enthält Mode den Wert rmExact, werden die aktuelle Datensatznummer auf -1 gesetzt und der aktuelle Datensatz erneut abgerufen. Andernfalls versucht Resync, den aktuellen Datensatz und die beiden benachbarten Datensätze zu lesen. Schlagen diese Operationen fehl, löscht Resync die Datensatzpuffer, löst ein Datenänderungsereignis aus und beendet die Operation.

Enthält Mode den Wert rmCenter, versucht Resync anhand der Gesamtzahl der Datensätze in der Datenmenge zu ermitteln, wie viele Datenzeilen vor und nach dem aktuellen Datensatz gelesen werden sollen.

Unabhängig vom Wert in Mode aktiviert Resync auch die Puffer für den aktuellen Datensatz, ruft die für die Anzeige benötigten Datensätze ab und löst ein Datenmengen-Änderungsereignis aus.


TDataSet::RevertRecord

TDataSet	Siehe auch

Die Methode RevertRecord macht die Änderungen des aktuellen Datensatzes rückgängig, wenn mit zwischengespeicherten Aktualisierungen gearbeitet wird.

void __fastcall RevertRecord(void);

Beschreibung

Mit RevertRecord können Sie die Änderungen des aktuellen Datensatzes rückgängig machen, wenn mit zwischengespeicherten Aktualisierungen gearbeitet wird. Wie im folgenden Beispiel zu sehen ist, können mit RevertRecord gelöschte Datensätze mit minimalen Aufwand wiederhergestellt werden:

Hinweis

Mit der Methode CancelUpdates können alle Änderungen rückgängig gemacht werden, die sich im Zwischenspeicher für Aktualisierungen befinden.


TDataSet::SetDetailFields

TDataSet	Siehe auch

Die Methode SetDetailFields setzt die Detailfelder für eine Haupt/Detail-Beziehung.

void __fastcall SetDetailFields(Classes::TList* MasterFields);

Beschreibung

Mit SetDetailFields können Sie Felder für eine Haupt/Detail-Beziehung zuweisen. MasterFields ist ein TList-Objekt, das in der Anwendung erstellt und verwaltet werden muß. In die Liste dürfen nur vorhandene TField-Objekte aufgenommen werden.


TDataSet::SetFields

TDataSet	Siehe auch

Die Methode SetFields weist den Feldern in einem Datensatz die angegebenen Werte zu.

void __fastcall SetFields(const System::TVarRec *Values, const int Values_Size);

Beschreibung

Mit SetFields können Sie einigen oder allen Feldern des aktuellen Datensatzes in einer Operation Werte zuweisen.

Values enthält die Werte, die den Feldern zugewiesen werden sollen. Die Zuweisung erfolgt in der Reihenfolge der Spalten in der zugrundeliegenden Tabelle. Als Werte können Literale, Variablen sowie NULL oder NULL angegeben werden. Enthält der Parameter Values weniger Werte, als Felder im Datensatz vorhanden sind, werden die verbleibenden Felder auf NULL gesetzt. Dabei werden die vorhandenen Feldwerte überschrieben.

Rufen Sie vor SetFields die Methode Edit auf, um den Modus der Datenmenge in dsEdit zu ändern. Tragen Sie nach dem Aufruf von SetFields die Änderungen mit der Methode Post in die Datenbank ein.

Hinweis

Um nur einigen Feldern einen Wert zuzuweisen und die vorhandenen Werte der anderen Felder zu erhalten, übergeben Sie für jedes nicht zu ändernde Feld den Wert NIL.


TDataSet::TDataSet

TDataSet	Siehe auch

Der Konstruktor TDataSet erzeugt ein neues TDataSet-Objekt.

__fastcall virtual TDataSet(Classes::TComponent* AOwner);

Beschreibung

Mit TDataSet wird zur Laufzeit eine Datenmengenkomponente instantiiert. Normalerweise werden in Anwendungen Nachkommen von TDataSet instantiiert, wie etwa TTable, TQuery oder TStoredProc.

Andererseits kann es notwendig sein, TDataSet aufzurufen, wenn spezialisierte Datenmengenkomponenten erzeugt werden sollen, welche die BDE umgehen. Dann werden die folgenden Initialisierungen vorgenommen:

•	Für die Datenmenge werden Definitionen für leere Felder erzeugt.

•	Es wird eine leere Feldliste für die Datenmenge aufgebaut.

•	Es wird eine leere Liste von Datenquellen aufgebaut.

•	Die Eigenschaft AutoCalcFields wird auf True gesetzt.

•	Die Eigenschaft Locale wird auf den benötigten Sprachtreiber gesetzt.


TDataSet::UpdateCursorPos

TDataSet	Siehe auch

Die Methode UpdateCursorPos setzt den Cursor in den aktuellen Datensatz.

void __fastcall UpdateCursorPos(void);

Beschreibung

UpdateCursorPos ist eine interne Routine, die von vielen Datenmengenmethoden verwendet wird. Mit ihr kann sichergestellt werden, daß sich der Cursor auf dem aktuellen Datensatz befindet. Normalerweise muß UpdateCursorPos in einer Anwendung nicht direkt aufgerufen werden. UpdateCursorPos wird immer verwendet, wenn sich der aktuelle Datensatz aufgrund einer Operation wie dem Wechseln zu einem anderen Datensatz, dem Eintragen von Änderungen oder dem Aktivieren/Deaktivieren eines Filters geändert haben könnte.


TDataSet::UpdateRecord

TDataSet	Siehe auch

Die Methode UpdateRecord löst bei einer Datensatzaktualisierung das entsprechende Datenereignis aus.

void __fastcall UpdateRecord(void);

Beschreibung

UpdateRecord ist eine interne Routine, die von einigen Datenmengenmethoden verwendet wird, um bei aktivierter Zwischenspeicherung ein OnUpdateRecord-Ereignis auszulösen. Sie sollten UpdateRecord nicht direkt aufrufen, wenn Sie keine eigenen Datenmengenmethoden definieren, um die integrierten Methoden zu umgehen.


TDataSet::UpdateStatus

TDataSet	Siehe auch

Die Methode gibt den Aktualisierungsstatus einer Datenmenge zurück.

TUpdateStatus __fastcall UpdateStatus(void);

Beschreibung

Mit UpdateStatus können Sie den Aktualisierungsstatus einer Datenmenge ermitteln, wenn mit zwischengespeicherten Aktualisierungen gearbeitet wird. Der Status ändert sich beim Bearbeiten, Einfügen oder Löschen von Datensätzen sehr oft. UpdateStatus bietet eine komfortable Möglichkeit, den aktuellen Status abzufragen, bevor Operationen durchgeführt oder abgeschlossen werden, die vom Aktualisierungsstatus der Datenmenge abhängig sind.


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent


TDataSet Beispiel

TDataSet


 TDataSource

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/db.hpp

Die Klasse TDataSource stellt eine Schnittstelle zwischen einer Datenmengenkomponente und den datensensitiven Steuerelementen in einem Formular bereit.

Beschreibung

Mit TDataSource können Sie eine Verbindung zwischen einer Datenmenge und den datensensitiven Steuerelementen herstellen, mit denen die der Datenmenge zugrundeliegenden Daten angezeigt und bearbeitet werden können.

Jeder Datenmenge muß eine Datenquellenkomponente zugeordnet werden, damit ihre Daten in den Steuerelementen angezeigt und bearbeitet werden können. Ebenso muß jedes datensensitive Steuerelement mit einer Datenquellenkomponente verbunden werden, um Daten empfangen und bearbeiten zu können.

Datenquellen verbinden auch Datenmengen in Haupt/Detail-Beziehungen.


Eigenschaften von TDataSource

TDataSource	Alphabetisch	Legende

In TDataSource

AutoEdit

DataSet

Enabled

State

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Name

Owner

Tag


Eigenschaften von TDataSource

TDataSource	Nach Objekten	Legende

AutoEdit

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

DataSet

DesignInfo

Enabled

Name

Owner

State

Tag


TDataSource::AutoEdit

TDataSource	Siehe auch

Die Eigenschaft AutoEdit bestimmt, ob eine Datenquellenkomponente automatisch die Methode Edit der Datenmenge aufruft, sobald ein zugeordnetes datensensitives Steuerelement den Fokus erhält.

__property bool AutoEdit;

Beschreibung

Hat AutoEdit den Wert True (Standardeinstellung), wird die Methode Edit der Datenmenge aufgerufen, sobald ein Benutzer die im Steuerelement angezeigten Daten ändert.

Sie können die Daten vor unbeabsichtigten Änderungen schützen, indem Sie AutoEdit auf False setzen. Wenn AutoEdit den Wert False hat, kann die Methode Edit direkt aufgerufen werden, um Datenänderungen zuzulassen.


TDataSource::DataSet

TDataSource	Siehe auch

Die Eigenschaft DataSet gibt die Datenmenge an, für die die Datenquellenkomponente als Verbindung zu den datensensitiven Steuerelementen dient.

__property TDataSet* DataSet;

Beschreibung

DataSet kann entweder zur Entwurfs- oder zur Laufzeit auf den Namen einer vorhandenen Datenmengenkomponente gesetzt werden. Wird der Wert von DataSet zur Laufzeit in einer Anwendung geändert, können die Daten verschiedener Datenmengen in denselben Steuerelementen angezeigt und bearbeitet werden.

Hinweis

Um eine Datenmenge in einem Datenmodul während des Entwurfs mit einem Formular zu verbinden, wählen Sie Datei/Unit verwenden.


TDataSource::Enabled

TDataSource	Siehe auch	Beispiel

Die Eigenschaft Enabled bestimmt, ob in den mit der Datenquelle verbundenen Steuerelementen Daten angezeigt werden.

__property bool Enabled;

Beschreibung

Mit Enabled können Sie steuern, ob in den mit der Datenmenge verbundenen Steuerelementen Daten angezeigt werden. Hat Enabled den Wert True (Standardeinstellung), werden Daten angezeigt. Wird Enabled auf False gesetzt, werden in den Steuerelementen keinen Daten angezeigt.

Hinweis

In einer Anwendung kann zwar Enabled auf False gesetzt werden, um die Datenanzeige beim Verarbeiten mehrerer Datensätze zu deaktivieren, es ist aber besser, dazu die TDataSet-Methoden EnableControls und DisableControls zu verwenden. Diese Methoden löschen die Anzeige in den Steuerelementen während der Verarbeitung nicht.


TDataSource::State

TDataSource	Siehe auch	Beispiel

Die Eigenschaft State liest den aktuellen Status der mit einer Datenquelle verbundenen Datenmengenkomponente.

__property TDataSetState State;

Beschreibung

Mit State kann der aktuelle Status der mit einer Datenquelle verbundenen Datenmenge ermittelt werden. Der Status gibt an, welche Aktion mit der Datenmenge durchgeführt wird. Die folgende Tabelle enthält die möglichen Werte für State und ihre Bedeutung:

Status	Bedeutung

dsInactive	Die Datenmenge ist geschlossen. Die Eigenschaft DataSet ist nicht zugewiesen oder Enabled hat den Wert False.

dsBrowse	Die Datenmenge ist für die Anzeige geöffnet. Dies ist der Standardmodus einer Datenmenge.

dsEdit	Die Datenmenge ist geöffnet. Der aktuelle Datensatz kann geändert werden.

dsInsert	Die Datenmenge ist geöffnet. Ein neuer Datensatz wird eingefügt.

dsSetKey	Die Datenmenge ist geöffnet. Das Suchen nach Datensätzen anhand indizierter Felder ist aktiviert oder eine SetRange-Operation wird durchgeführt. In beiden Fällen kann eine eingeschränkte Menge der Daten angezeigt werden. Es können keine Daten geändert werden.

dsCalcFields	Die Datenmenge ist geöffnet und ein OnCalcFields-Ereignis ist aktiv. Nicht berechnete Felder können nicht geändert werden.

dsFilter	Die Datenmenge ist geöffnet und eine Filteroperation wird durchgeführt. Eine eingeschränkte Menge der Daten kann angezeigt werden. Es können keine Daten geändert werden.

Diese Werte werden auch für die Datenmengeneigenschaft State verwendet. Die Werte beider Eigenschaften sind von der folgenden Ausnahme abgesehen identisch: hat Enabled den Wert False oder ist DataSet nicht zugewiesen, wird State unabhängig vom Status der Datenmenge auf dsInactive gesetzt.


Ereignisse von TDataSource

TDataSource	Alphabetisch	Legende

In TDataSource

OnDataChange

OnStateChange

OnUpdateData


Ereignisse von TDataSource

TDataSource	Nach Objekten	Legende

OnDataChange

OnStateChange

OnUpdateData


TDataSource::OnDataChange

TDataSource	Siehe auch

Das Ereignis OnDataChange wird ausgelöst, wenn der aktuelle Datensatz geändert wurde und in der Anwendung von einem Feld bzw. Datensatz zu einem anderen der zugeordneten Datenmenge gewechselt wird.

typedef void __fastcall (__closure *TDataChangeEvent)(System::TObject* Sender, TField* Field);

__property TDataChangeEvent OnDataChange;

Beschreibung

In einer Ereignisbehandlungsroutine für OnDataChange können spezifische Aktionen durchgeführt werden, wenn ein Feld im aktuellen Datensatz geändert wurde und in der Anwendung von einem Feld bzw. Datensatz zu einem anderen der zugeeordneten Datenmenge gewechselt wird. Zu den Methoden, die dieses Ereignis auslösen können, gehören beispielsweise die Methoden Next und Prior der Datenmenge.

Die datensensitiven Steuerelemente benachrichtigen eine Datenquelle von einer Datenänderung in folgenden Fällen:

•	Wechseln zu einem neuen Datensatz.

•	Änderungen der Felddaten.

Der Parameter Field enthält den Wert NULL, wenn mehrere der Felder geändert wurden (weil beispielsweise zu einem anderen Datensatz gewechselt wurde). Andernfalls gibt Field das geänderte Feld an.

OnDataChange ist besonders für Anwendungen hilfreich, in denen die Datenanzeige in Steuerelementen synchronisiert werden muß, die nicht datensensitiv sind.


TDataSource::OnStateChange

TDataSource	Siehe auch

Das Ereignis OnStateChange wird ausgelöst, wenn sich der Status einer mit der Datenquellenkomponente verbundenen Datenmenge ändert.

typedef void __fastcall (__closure *TNotifyEvent)(System::TObject* Sender);

__property Classes::TNotifyEvent OnStateChange;

Beschreibung

Mit einer Ereignisbehandlungsroutine für OnStateChange können spezielle Aktionen durchgeführt werden, sobald sich der Status einer mit der Datenquellenkomponente verbundenen Datenmenge ändert.

Während des Verlaufs einer normalen Verbindung mit einer Datenbank ändert sich der Modus einer Datenmenge sehr oft. So wird beispielsweise jedesmal der Modus einer Datenmenge von dsBrowse in dsEdit geändert, wenn der Benutzer mit dem Bearbeiten eines Feldes in einem datensensitiven Steuerelement beginnt. In einer Ereignisbehandlungsroutine für OnStateChange kann dann auf diesen Moduswechsel reagiert werden, indem beispielsweise die entsprechenden Menüoptionen und Schalter aktiviert oder deaktiviert werden.


TDataSource::OnUpdateData

TDataSource	Siehe auch

Das Ereignis OnUpdateData wird beim Aktualisieren der Daten im aktuellen Datensatz ausgelöst.

type

def void __fastcall (__closure *TNotifyEvent)(System::TObject* Sender);

__property Classes::TNotifyEvent OnUpdateData;

Beschreibung

In einer Ereignisbehandlungsroutine für OnUpdateData können bestimmte Aktionen vor dem Eintragen der Datenänderungen durchgeführt werden. Die Ereignisbehandlungsroutine für OnUpdateData wird vor der Methode Post der Datenmenge aufgerufen, wenn in einer Anwendung geänderte Datensätze in die Datenbank eingetragen werden. Mit dieser Ereignisbehandlungsroutine können Sie dann zusätzliche Datenverarbeitungen oder -validierungen durchführen.


Methoden von TDataSource

TDataSource	Alphabetisch

In TDataSource

~TDataSource

Edit

IsLinkedTo

TDataSource

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TDataSource

TDataSource	Nach Objekten

~TDataSource

Assign

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

DestroyComponents

Destroying

Dispatch

Edit

FieldAddress

FindComponent

FreeInstance

FreeNotification

Free

GetParentComponent

HasParent

InheritsFrom

InitInstance

InsertComponent

InstanceSize

IsLinkedTo

MethodAddress

MethodName

NewInstance

RemoveComponent

TDataSource


TDataSource::~TDataSource

TDataSource	Siehe auch

Der Destruktor ~TDataSource gibt den Speicher frei, der für das TDataSource-Objekt reserviert war. Rufen Sie ~TDataSource nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TDataSource automatisch aufgerufen wird.

__fastcall virtual ~TDataSource(void);

Beschreibung

~TDataSource setzt OnStateChange und die Datenmenge der Komponente auf NULL und gibt vor dem Aufruf des geerbten Destruktors die Liste der Datenverbindungen frei.


TDataSource::Edit

TDataSource	Siehe auch

Die Methode Edit bestimmt, ob die Methode Edit einer mit der Datenquellenkomponente verbundenen Datenmenge aufgerufen wird.

void __fastcall Edit(void);

Beschreibung

Nach dem Aufruf von Edit kann eine Datenquellenkomponente steuern, ob eine mit ihr verbundene Datenmenge bearbeitet werden kann. Edit überprüft zuerst, ob die Eigenschaft AutoEdit der Datenquelle auf True sowie ihre Eigenschaft State auf dsBrowse gesetzt ist und ruft danach die Methode Edit der Datenmenge auf. Durch das Prüfen dieser Eigenschaften vor dem Aufruf der Methode Edit der Datenmenge wird sichergestellt, daß der Modus der Datenmenge Änderungen zuläßt und auch die Datenquelle Bearbeitungen erlaubt.


TDataSource::IsLinkedTo

TDataSource	Siehe auch

Die Methode IsLinkedTo prüft, ob eine Datenquelle mit einer bestimmten Datenmenge verbunden ist.

bool __fastcall IsLinkedTo(TDataSet* DataSet);

Beschreibung

Mit IsLinkedTo können Sie überprüfen, ob eine Datenquelle mit einer bestimmten Datenmenge verbunden ist. Der Parameter DataSet gibt den Namen der betreffenden Datenmenge an.

Wird die angegebene Datenmenge bereits von der Datenquelle verwendet, gibt IsLinkedTo den Wert True zurück. Ist die Datenmenge zwar vorhanden, jedoch nicht mit der Datenquelle verbunden, setzt IsLinkedTo die Eigenschaft DataSet der Datenquellenkomponente auf den Wert des Parameters DataSet und gibt True zurück.

Verwendet die Datenquelle die angegebene Datenmenge nicht, und ist diese mit keiner anderen Datenquelle verbunden, gibt IsLinkedTo den Wert False zurück.

Note

IsLinkedTo ist eine Low-Level-Methode, die hauptsächlich von Komponentenentwicklern verwendet wird, um zirkuläre Bezüge zu ermitteln. Ansonsten sollte diese Methode nicht direkt aufgerufen werden.


TDataSource::TDataSource

TDataSource	Siehe auch

Der Konstruktor TDataSource erzeugt ein neues TDataSource-Objekt.

__fastcall virtual TDataSource(Classes::TComponent* AOwner);

Beschreibung

Mit TDataSource können Sie zur Laufzeit eine TDataSource-Komponente instantiieren. Bei Datenmengenkomponenten, die Sie zur Entwurfszeit einem Datenmodul hinzufügen, fügt Borland C++Builder automatisch einen Aufruf von TDataSource ein.

TDataSource instantiiert eine Liste der datenverbindungen und setzt die Eigenschaften Enabled und AutoEdit der Komponente auf True.


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent


TDataSource Beispiel

TDataSource


TDateField

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/dbtables.hpp

Ein TDateField-Objekt repräsentiert ein Datumsfeld in einer Datenmenge.

Beschreibung

Datumsfelder enthalten Datumswerte.

TDateField unterscheidet sich von seinem direkten Vorfahren TDateTimeField nur durch seinen Datentyp ftDate. Obwohl sich das zugrundeliegende physikalische Format eines Datumsfeldes in einer Datenbank von dem eines Datums-/Zeitfeldes unterscheidet, verwendet TDateField einen TDateTime-Wert, um Datumswerte zu speichern und zu ändern.

Als Nachkomme von TDateTimeField verfügt TDateField über viele Eigenschaften, Methoden und Ereignisse, die für die Bearbeitung der Werte und Eigenschaften eines Datums- oder Zeitfeldes in einer Datenbank von Nutzen sind.


Eigenschaften von TDateField

TDateField	Alphabetisch	Legende

Abgeleitet von TDateTimeField

DisplayFormat

Value

Abgeleitet von TField

Alignment

AsBoolean

AsCurrency

AsDateTime

AsFloat

AsInteger

AsString

AsVariant

AttributeSet

BDECalcField

Calculated

CanModify

DataSet

DataSize

DataType

DisplayLabel

DisplayName

DisplayText

DisplayWidth

EditMask

EditMaskPtr

FieldKind

FieldName

FieldNo

Index

IsIndexField

IsNull

KeyFields

Lookup

LookupDataSet

LookupKeyFields

LookupResultField

NewValue

OldValue

ReadOnly

Required

Size

Text

Visible

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Name

Owner

Tag


Eigenschaften von TDateField

TDateField	Nach Objekten	Legende

Alignment

AsBoolean

AsCurrency

AsDateTime

AsFloat

AsInteger

AsString

AsVariant

AttributeSet

BDECalcField

Calculated

CanModify

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

DataSet

DataSize

DataType

DesignInfo

DisplayFormat

DisplayLabel

DisplayName

DisplayText

DisplayWidth

EditMaskPtr

EditMask

FieldKind

FieldName

FieldNo

Index

IsIndexField

IsNull

KeyFields

LookupDataSet

LookupKeyFields

LookupResultField

Lookup

Name

NewValue

OldValue

Owner

ReadOnly

Required

Size

Tag

Text

Value

Visible


Ereignisse von TDateField

TDateField	Alphabetisch	Legende

Abgeleitet von TField

OnChange

OnGetText

OnSetText

OnValidate


Ereignisse von TDateField

TDateField	Nach Objekten	Legende

OnChange

OnGetText

OnSetText

OnValidate


Methoden von TDateField

TDateField	Alphabetisch

In TDateField

~TDateField

TDateField

Abgeleitet von TField

Assign

AssignValue

Clear

FocusControl

GetData

IsValidChar

SetData

SetFieldType

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TDateField

TDateField	Nach Objekten

~TDateField

Assign

AssignValue

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

Clear

DefaultHandler

DestroyComponents

Destroying

Dispatch

FieldAddress

FindComponent

FocusControl

FreeInstance

FreeNotification

Free

GetData

GetParentComponent

HasParent

InheritsFrom

InitInstance

InsertComponent

InstanceSize

IsValidChar

MethodAddress

MethodName

NewInstance

RemoveComponent

SetData

SetFieldType

TDateField


TDateField::~TDateField

TDateField

Der Destruktor ~TDateField gibt den Speicher frei, der für das TDateField-Objekt reserviert war. Rufen Sie ~TDateField nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TDateField automatisch aufgerufen wird.

__fastcall virtual ~TDateField(void);


TDateField::TDateField

TDateField

Der Konstruktor TDateField erzeugt ein neues TDateField-Objekt.

__fastcall virtual TDateField(Classes::TComponent* AOwner);

Beschreibung

Mit TDateField können Sie eine Instanz von TDateField erzeugen und initialisieren. Nach dem Aufruf des geerbten Konstruktors setzt TDateField die Eigenschaft DataType auf ftDate.

Es ist nur selten erforderlich, TDateField direkt aufzurufen, da für alle Datenfelder einer Datenmenge automatisch ein Datumsfeld-Objekt instantiiert wird.


Gültigkeitsbereich

Published


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TField

TDateTimeField


TDateField Beispiel

TDateField


TDateTimeField

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/db.hpp

Ein TDateTimeField-Objekt repräsentiert ein Datums-/Zeitfeld in einer Datenmenge.

Beschreibung

Datums-/Zeitfelder enthalten kombinierte Datums- und Zeitinformationen, die manchmal auch als Zeitstempel bezeichnet werden.

TDateTimeField führt neue Eigenschaften ein, mit denen Datums-/Zeitwerte für die Anzeige formatiert und in andere Datentypen konvertiert werden können. Als Nachkomme von TField verfügt TDateTimeField über viele Eigenschaften, Methoden und Ereignisse, mit denen die Werte und Eigenschaften von Datenbankfeldern bearbeitet werden können.

TDateTimeField ist auch der direkte Vorfahr von zwei weiteren Feldtypen, die Datums-/Zeitwerte aufnehmen können: TDateField und TTimeField.


Eigenschaften von TDateTimeField

TDateTimeField	Alphabetisch	Legende

Abgeleitet von TField

Alignment

AsBoolean

AsCurrency

AsDateTime

AsFloat

AsInteger

AsString

AsVariant

AttributeSet

read-only	BDECalcField

Calculated

read-only	CanModify

DataSet

read-only	DataSize

read-only	DataType

DisplayLabel

read-only	DisplayName

read-only	DisplayText

DisplayWidth

EditMask

read-only	EditMaskPtr

FieldKind

FieldName

read-only	FieldNo

Index

read-only	IsIndexField

read-only	IsNull

KeyFields

Lookup

LookupDataSet

LookupKeyFields

LookupResultField

NewValue

read-only	OldValue

ReadOnly

Required

Size

Text

Visible

In TDateTimeField

DisplayFormat

Value

Abgeleitet von TComponent

read-only	ComponentCount

ComponentIndex

read-only	Components

read-only	ComponentState

read-only	ComponentStyle

DesignInfo

Name

read-only	Owner

Tag


Eigenschaften von TDateTimeField

TDateTimeField	Nach Objekten	Legende

read-only	BDECalcField

read-only	CanModify

read-only	DataSize

read-only	DataType

read-only	DisplayName

read-only	DisplayText

read-only	EditMaskPtr

read-only	FieldNo

read-only	IsIndexField

read-only	IsNull

read-only	OldValue

read-only	ComponentCount

read-only	Components

read-only	ComponentState

read-only	ComponentStyle

read-only	Owner

Alignment

AsBoolean

AsCurrency

AsDateTime

AsFloat

AsInteger

AsString

AsVariant

AttributeSet

Calculated

ComponentIndex

DataSet

DesignInfo

DisplayFormat

DisplayLabel

DisplayWidth

EditMask

FieldKind

FieldName

Index

KeyFields

LookupDataSet

LookupKeyFields

LookupResultField

Lookup

Name

NewValue

ReadOnly

Required

Size

Tag

Text

Value

Visible


TDateTimeField::DisplayFormat

TDateTimeField	Siehe auch

Die Eigenschaft DisplayFormat enthält den String, der zu Anzeigezwecken die automatische Formatierung des Datums-/Zeitfeldes außer Kraft setzt.

__property System::AnsiString DisplayFormat;

Beschreibung

In DisplayFormat können Sie einen String angeben, der als Formatierungsanweisung für Datums-/Zeitwerte dient, wenn diese als String angezeigt werden.

Wenn DisplayFormat kein String zugewiesen wurde, wird der Wert so formatiert, wie es in der Systemsteuerung festgelegt ist.

Aus folgenden Formatbezeichnern können Sie einen DisplayFormat-String zusammensetzen:

Bezeichner	Ergebnis

c	Das Datum im von der globalen Variablen ShortDateFormat festgelegten Format, gefolgt von der Zeit im von der globalen Variablen LongTimeFormat festgelegten Format. Die Zeit wird nicht angezeigt, wenn der Nachkommaanteil des Datums-/Zeitwertes gleich Null ist.

d	Der Tag als Zahl ohne führende Null (1-31).

dd	Der Tag als Zahl mit führender Null (01-31).

ddd	Der Tag als Abkürzung (So-Sa) unter Verwendung der von der globalen Variablen ShortDayNames festgelegten Strings.

dddd	Der Tag als vollständiger Name (Sonntag-Samstag) unter Verwendung der von der globalen Variablen LongDayNames festgelegten Strings.

ddddd	Das Datum im von der globalen Variablen ShortDateFormat festgelegten Format.

dddddd	Das Datum im von der globalen Variablen LongDateFormat festgelegten Format.

m	Der Monat als Zahl ohne führende Null (1-12). Wenn der Bezeichner m unmittelbar auf ein h oder hh folgt, wird nicht der Monat, sondern die Minute angezeigt.

mm	Der Monat als Zahl mit führender Null (01-12). Wenn der Bezeichner mm unmittelbar auf ein h oder hh folgt, wird nicht der Monat, sondern die Minute angezeigt.

mmm	Der Monat als Abkürzung (Jan-Dez) unter Verwendung der von der globalen Variablen ShortMonthNames festgelegten Strings.

mmmm	Der Monat als vollständiger Name (Januar-Dezember) unter Verwendung der von der globalen Variablen LongMonthNames vorgegebenen Strings.

yy	Das Jahr als zweistellige Zahl (00-99).

yyyy	Das Jahr als vierstellige Zahl (0000-9999).

h	Die Stunde ohne führende Null (0-23).

hh	Die Stunde mit führender Null (00-23).

n	Die Minute ohne führende Null (0-59).

nn	Die Minute mit führender Null (00-59).

s	Die Sekunde ohne führende Null (0-59).

ss	Die Sekunde mit führender Null (00-59).

t	Die Zeit im von der globalen Variablen ShortTimeFormat festgelegten Format.

tt	Die Zeit im von der globalen Variablen LongTimeFormat festgelegten Format.

am/pm	Die Zeit im 12-Stunden-Format für den vorangehenden Bezeichner h oder hh, gefolgt von "am" für die Stunden vor Mittag oder "pm" für die Stunden nach Mittag. Für die Bezeichner am/pm können sowohl Groß- oder Kleinbuchstaben als auch beide gemeinsam verwendet werden. Das Ergebnis wird entsprechend angezeigt.

a/p	Die Zeit im 12-Stunden-Format für den vorangehenden Bezeichner h oder hh, gefolgt von "a" für die Stunden vor Mittag oder "p" für die Stunden nach Mittag. Für die Bezeichner a/p können sowohl Groß- oder Kleinbuchstaben als auch beide gemeinsam verwendet werden.

ampm	Die Zeit im 12-Stunden-Format für den vorangehenden Bezeichner h oder hh, gefolgt vom Inhalt der globalen Variablen TimeAMString für die Stunden vor Mittag oder dem Inahlt der globalen Variablen TimePMString für die Stunden nach Mittag.

/	Das in der globalen Variablen DateSeparator festgelegte Trennzeichen für Datumsangaben.

:	Das in der globalen Variablen TimeSeparator festgelegte Trennzeichen für Zeitangaben.

'xx'/"xx"	Zeichen, die in halbe oder ganze Anführungszeichen eingeschlossen sind, werden ohne weitere Formatierung angezeigt.

Als Formatbezeichner können Sie sowohl Groß- als auch Kleinbuchstaben verwenden. Das Ergebnis ist in beiden Fällen dasselbe.

Wenn der im Formatparameter festgelegte String leer ist, wird der Datums- und Zeitwert so formatiert, als ob der Formatbezeichner c angegeben wäre.


TDateTimeField::Value

TDateTimeField	Siehe auch

Die Eigenschaft Value gibt den Wert an, den ein Datums-/Zeitfeld enthält.

__property System::TDateTime Value;

Beschreibung

Mit Value können Sie zur Laufzeit Daten in eine Datums-/Zeitfeld-Komponente schreiben oder aus ihr lesen. TDateTimeField-Komponenten speichern und bearbeiten ihre Daten als TDateTime-Werte. Daher ist bei Datums-/Zeitfeldern die Eigenschaft Value mit der Eigenschaft AsDateTime identisch.


Ereignisse von TDateTimeField

TDateTimeField	Alphabetisch	Legende

Abgeleitet von TField

OnChange

OnGetText

OnSetText

OnValidate


Ereignisse von TDateTimeField

TDateTimeField	Nach Objekten	Legende

OnChange

OnGetText

OnSetText

OnValidate


Methoden von TDateTimeField

TDateTimeField	Alphabetisch

Abgeleitet von TField

Assign

AssignValue

Clear

FocusControl

GetData

IsValidChar

SetData

SetFieldType

In TDateTimeField

~TDateTimeField

TDateTimeField

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TDateTimeField

TDateTimeField	Nach Objekten

~TDateTimeField

Assign

AssignValue

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

Clear

DefaultHandler

DestroyComponents

Destroying

Dispatch

FieldAddress

FindComponent

FocusControl

FreeInstance

FreeNotification

Free

GetData

GetParentComponent

HasParent

InheritsFrom

InitInstance

InsertComponent

InstanceSize

IsValidChar

MethodAddress

MethodName

NewInstance

RemoveComponent

SetData

SetFieldType

TDateTimeField


TDateTimeField::~TDateTimeField

TDateTimeField

Der Destruktor ~TDateTimeField gibt den Speicher frei, der für das TDateTimeField-Objekt reserviert war. Rufen Sie ~TDateTimeField nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TDateTimeField automatisch aufgerufen wird.

__fastcall virtual ~TDateTimeField(void);


TDateTimeField::TDateTimeField

TDateTimeField	Siehe auch

Die Methode TDateTimeField instantiiert ein TDateTimeField-Objekt.

__fastcall virtual TDateTimeField(Classes::TComponent* AOwner);

Beschreibung

Mit TDateTimeField können Sie eine Instanz von TDateTimeField erzeugen und initialisieren. Nach dem Aufruf des geerbten Konstruktors setzt TDateTimeField die Eigenschaft DataType auf ftDateTime.

Es ist nur selten erforderlich, TDateTimeField direkt aufzurufen, da für jedes Datums-/Zeitfeld einer Datenmenge automatisch ein Datums-/Zeitfeld-Objekt instantiiert wird.


Gültigkeitsbereich

Published


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TField


TDateTimeField Beispiel

TDateTimeField


TDataSourceLink

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/dbctrls.hpp

TDataSourceLink ist ein Hilfsobjekt, das für ein TDBLookupControl-Objekt die Verknüpfung mit der Datenquelle verwaltet.

Beschreibung

Dieses Objekt ist auf die Zusammenarbeit mit TDBLookupControl abgestimmt. Es sollte nur von der Klasse TDBLookupControl verwendet werden.


Eigenschaften von TDataSourceLink

TDataSourceLink	Alphabetisch	Legende

Abgeleitet von TDataLink

Active

ActiveRecord

BufferCount

DataSet

DataSource

DataSourceFixed

Editing

ReadOnly

RecordCount


Eigenschaften von TDataSourceLink

TDataSourceLink	Nach Objekten	Legende

ActiveRecord

Active

BufferCount

DataSet

DataSourceFixed

DataSource

Editing

ReadOnly

RecordCount


Methoden von TDataSourceLink

TDataSourceLink	Alphabetisch	Legende

In TDataSourceLink

~TDataSourceLink

ActiveChanged

RecordChanged

TDataSourceLink

Abgeleitet von TDataLink

Edit

UpdateRecord

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TDataSourceLink

TDataSourceLink	Nach Objekten	Legende

~TDataSourceLink

ActiveChanged

Assign

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

Edit

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance

RecordChanged

TDataSourceLink

UpdateRecord


TDataSourceLink::~TDataSourceLink

TDataSourceLink

Der Destruktor ~TDataSourceLink gibt den Speicher frei, der für das TDataSourceLink-Objekt reserviert war. Rufen Sie ~TDataSourceLink nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TDataSourceLink automatisch aufgerufen wird.

__fastcall virtual ~TDataSourceLink(void);


TDataSourceLink::ActiveChanged

TDataSourceLink	Siehe auch

Die Methode ActiveChanged informiert das TDBLookupControl-Objekt über Änderungen an der Eigenschaft Active des DataSource-Objekts.

virtual void __fastcall ActiveChanged(void);

Beschreibung

Diese Methode kann von Anwendungen nicht direkt aufgerufen werden. Sie wird von Änderungen an der Eigenschaft Active ausgelöst. Wenn die Eigenschaft Active den Wert True annimmt, veranlaßt ActiveChanged das TDBLookupControl-Objekt, seine Eigenschaft DataField neu abzufragen. Damit ist sichergestellt, daß das Lookup-Steuerelement mit der richtigen Feldkomponente arbeitet.


TDataSourceLink::RecordChanged

TDataSourceLink	Siehe auch

Die Methode RecordChanged informiert das TDBLookupControl-Objekt über Änderungen am aktuellen Datensatz oder Feld des DataSource-Objekts.

virtual void __fastcall RecordChanged(Db::TField* Field);

Beschreibung

Diese Prozedur kann von Anwendungen nicht direkt aufgerufen werden. Sie wird bei Änderungen am Inhalt des aktuellen Datensatzes automatisch ausgelöst. Wenn der Parameter Field das Schlüsselfeld des Lookup-Steuerelements ist oder den Wert NIL hat, zeigt dies an, daß der gesamte Datensatz geändert wurde, und RecordChanged veranlaßt das Lookup-Steuerelement, den Wert seines Schlüsselfeldes erneut abzurufen.


TDataSourceLink::TDataSourceLink

TDataSourceLink

Der Konstruktor TDataSourceLink erzeugt ein neues TDataSourceLink-Objekt.

__fastcall TDataSourceLink(void);


Zugriff

Read-only


Gültigkeitsbereich

Protected


Hierarchie

TObject

TPersistent

TDataLink


TDataSourceLink Beispiel

TDataSourceLink


 TDBCheckBox

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/dbctrls.hpp

Ein TDBCheckBox-Kontrollfeld ist ein datensensitives Steuerelement, das der Benutzer aktivieren oder deaktivieren kann.

Beschreibung

Ein Kontrollfeld bietet dem Benutzer eine Option an. Er kann das Feld markieren, um die Option zu aktivieren, oder die Markierung aufheben, um die Option zu deaktivieren. Ein Datenbank-Kontrollfeld (TDBCheckBox) ähnelt einem normalen Kontrollfeld (TCheckBox), korrespondiert aber im Gegensatz zu diesem mit den Daten eines bestimmten Feldes einer Datenmenge.

Sie können ein Datenbank-Kontrollfeld mit einer Datenmenge verknüpfen, indem Sie in der Eigenschaft DataSource des Kontrollfeldes die entsprechende Datenquelle (TDataSource) angeben. Das Feld der Datenmenge, auf das Sie zugreifen möchten, legen Sie in der Eigenschaft DataField fest.

Wenn der Inhalt eines Feldes im aktuellen Datensatz mit dem String der Eigenschaft ValueChecked übereinstimmt, wird das Datenbank-Kontrollfeld markiert. Stimmt der Feldinhalt mit dem String der Eigenschaft ValueUnchecked überein, wird die Markierung des Kontrollfelders aufgehoben.

Wenn der Benutzer ein Datenbank-Kontrollfeld aktiviert oder deaktiviert, wird der String der Eigenschaft ValueChecked oder ValueUnchecked dem Feld der Datenmenge zugewiesen, vorausgesetzt, die Eigenschaft ReadOnly ist False und die Datenmenge befindet sich im Bearbeitungsmodus. Wenn der Benutzer die die Daten lediglich anzeigen, sie aber nicht bearbeiten soll, setzen Sie ReadOnly auf True. Nähere Informationen finden Sie unter „Felder aktualisieren“.

Wenn die datensensitiven Eigenschaften von TDBCheckBox nicht benötigt werden, verwenden Sie statt dessen gewöhnliche Kontrollfelder (TCheckBox), um Systemressourcen zu sparen.


Eigenschaften von TDBCheckBox

TDBCheckBox	Alphabetisch	Legende

In TDBCheckBox

DataField

DataSource

Field

ReadOnly

ValueChecked

ValueUnchecked

Abgeleitet von TCustomCheckBox

Alignment

AllowGrayed

Checked

State

Abgeleitet von TWinControl

Brush

ClientOrigin

ClientRect

ControlCount

Controls

Ctl3D

Handle

HelpContext

ParentCtl3D

Showing

TabOrder

TabStop

Abgeleitet von TControl

Align

BoundsRect

Caption

ClientHeight

ClientWidth

Color

ControlState

ControlStyle

Cursor

DragCursor

DragMode

Enabled

Font

Height

Hint

Left

Name

Parent

ParentColor

ParentFont

ParentShowHint

PopupMenu

ShowHint

Top

Visible

Width

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TDBCheckBox

TDBCheckBox	Nach Objekten	Legende

Alignment

Align

AllowGrayed

BoundsRect

Brush

Caption

Checked

ClientHeight

ClientOrigin

ClientRect

ClientWidth

Color

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlCount

ControlState

Controls

ControlStyle

Ctl3D

Cursor

DataField

DataSource

DesignInfo

DragCursor

DragMode

Enabled

Field

Font

Handle

Height

HelpContext

Hint

Left

Name

Owner

ParentColor

ParentCtl3D

ParentFont

ParentShowHint

Parent

PopupMenu

ReadOnly

ShowHint

Showing

State

TabOrder

TabStop

Tag

Top

ValueChecked

ValueUnchecked

Visible

Width


TDBCheckBox::DataField

TDBCheckBox	Siehe auch

Die Eigenschaft DataField bezeichnet das Feld, dessen Daten vom datensensitiven Steuerelement angezeigt werden.

__property System::AnsiString DataField;

Beschreibung

Die Datenmenge, zu der das Feld gehört, wird als Datenquelle (TDataSource) in der Eigenschaft DataSource des datensensitiven Steuerelements angegeben.


TDBCheckBox::DataSource

TDBCheckBox	Siehe auch

Die Eigenschaft DataSource gibt an, woher das Steuerelement seine Daten bezieht.

__property Db::TDataSource* DataSource;

Beschreibung

DataSource gibt die Datenquelle an, die die Datenmenge mit den anzuzeigenden Daten bezeichnet.


TDBCheckBox::Field

TDBCheckBox	Siehe auch

Die Eigenschaft Field gibt das TField-Objekt zurück, mit dem das datensensitive Steuerelement verbunden ist.

__property Db::TField* Field;

Beschreibung

Über das TField-Objekt können Sie den Wert der Felddaten programmseitig ändern.


TDBCheckBox::ReadOnly

TDBCheckBox	Siehe auch

Die Eigenschaft ReadOnly legt fest, ob der Inhalt des Steuerelements vom Benutzer geändert werden kann.

__property bool ReadOnly;

Beschreibung

ReadOnly legt fest, ob der Benutzer den Inhalt des Steuerelements ändern kann. Wenn ReadOnly True ist, kann der Benutzer den Inhalt nicht ändern. Ist ReadOnly False, kann der Inhalt vom Benutzer geändert werden. Die Vorgabe ist False.

Die Eigenschaft ReadOnly legt fest, ob der Benutzer das datensensitive Steuerelement dazu verwenden kann, den Wert des Feldes im aktuellen Datensatz zu ändern, oder ob der Wert lediglich angezeigt wird. Wenn ReadOnly False ist, kann der Benutzer den Wert des Feldes ändern, sofern sich die Datenmenge im Bearbeitungsmodus befindet.


TDBCheckBox::ValueChecked

TDBCheckBox	Siehe auch

Wenn die Eigenschaft ValueChecked Daten enthält, die mit den Felddaten übereinstimmen, wird das Kontrollfeld markiert.

__property System::AnsiString ValueChecked;

Beschreibung

Wenn der Wert der Eigenschaft ValueChecked mit den Daten im Feld des aktuellen Datensatzes übereinstimmt, wird das Datenbank-Kontrollfeld markiert.

Sie können ValueChecked eine durch Strichpunkte getrennte Liste von Elementen zuweisen. Wenn ein beliebiges Element mit dem Inhalt des Feldes im aktuellen Datensatz übereinstimmt, wird das Kontrollfeld markiert. Sie können ValueChecked beispielsweise folgenden String zuweisen:

DBCheckBox1.ValueChecked := "Wahr;Ja;Ein";

Wenn das Feld, das in der Eigenschaft DataField des Datenbank-Kontrollfeldes angegeben ist, einen der Strings 'Wahr', 'Ja' oder 'Ein' enthält, wird das Kontrollfeld markiert. Die Groß-/Kleinschreibung der Strings spielt keine Rolle.

Wenn das Feld einen der Strings der Eigenschaft ValueUnchecked enthält, wird das Feld deaktiviert. Wenn der Feldinhalt mit keinem der Strings in ValueChecked oder ValueUnchecked übereinstimmt, wird das Kontrollfeld grau dargestellt.

Wenn dem Datenbank-Kontrollfeld ein logisches Feld zugeordnet ist, wird das Kontrollfeld immer aktiviert, wenn der Feldinhalt True ist, und immer deaktiviert, wenn der Feldinhalt False ist. Die Werte der Eigenschaften ValueChecked und ValueUnchecked haben bei logischen Feldern keine Wirkung.

Wenn der Anwender ein Datenbank-Kontrollfeld aktiviert und die Eigenschaft ReadOnly den Wert False hat, wird der String der Eigenschaft ValueChecked dem Datenbankfeld zugewiesen. Wenn ValueChecked eine durch Strichpunkte getrennte Liste ist, wird das erste Element verwendet.

Der Vorgabewert von ValueChecked ist der String 'True'.

Beispiel

Der folgende Code ändert den Wert der Eigenschaft ValueChecked von DBCheckBox1 von 'Wahr' auf 'Falsch' oder umgekehrt:

if ( (ValueChecked == "True") || (ValueChecked == "False")

{

if (DBCheckBox1->ValueChecked == "True") dbCheckBox1->ValueChecked = "False";

  	else DBCheckBox1->ValueChecked = "True";

}


TDBCheckBox::ValueUnchecked

TDBCheckBox	Siehe auch

Wenn die Eigenschaft ValueUnchecked Daten enthält, die mit den Felddaten übereinstimmen, wird die Markierung des Kontrollfeldes aufgehoben.

__property System::AnsiString ValueUnchecked;

Beschreibung

Wenn der Wert der Eigenschaft ValueChecked mit den Daten im Feld des aktuellen Datensatzes übereinstimmt, wird die Markierung des Datenbank-Kontrollfeldes aufgehoben.

Sie können ValueUnchecked eine durch Strichpunkte getrennte Liste von Elementen zuweisen. Wenn ein beliebiges Element mit dem Inhalt des Feldes des aktuellen Datensatzes übereinstimmt, wird die Markierung des Kontrollfeldes aufgehoben. Sie können ValueUnchecked beispielsweise folgenden String zuweisen:

DBCheckBox1->ValueUnchecked = "True;Yes;On";

Wenn das Feld, das in der Eigenschaft DataField des Datenbank-Kontrollfeldes angegeben ist, einen der Strings 'Falsch', 'Nein' oder 'Aus' enthält, wird die Markierung des Kontrollfeldes aufgehoben.

Wenn das Feld einen der Strings der Eigenschaft ValueChecked enthält, wird das Feld markiert. Wenn der Inhalt des Feldes mit keinem der Strings in ValueChecked oder ValueUnchecked übereinstimmt, wird das Kontrollfeld grau dargestellt.

Wenn dem Datenbank-Kontrollfeld ein logisches Feld zugeordnet ist, wird das Kontrollfeld immer aktiviert, wenn der Feldinhalt True ist, und immer deaktiviert, wenn der Feldinhalt False ist. Die Werte der Eigenschaften ValueChecked und ValueUnchecked haben bei logischen Feldern keine Wirkung.

Wenn der Anwender ein Datenbank-Kontrollfeld deaktiviert und die Eigenschaft ReadOnly den Wert False hat, wird der String der Eigenschaft ValueUnchecked dem Datenbankfeld zugewiesen. Wenn ValueChecked eine durch Strichpunkte getrennte Liste ist, wird das erste Element verwendet.

Der Vorgabewert von ValueUnchecked ist der String 'False'.


Ereignisse von TDBCheckBox

TDBCheckBox	Alphabetisch	Legende

Abgeleitet von TWinControl

OnEnter

OnExit

OnKeyDown

OnKeyPress

OnKeyUp

Abgeleitet von TControl

OnClick

OnDragDrop

OnDragOver

OnEndDrag

OnMouseDown

OnMouseMove

OnMouseUp

OnStartDrag


Ereignisse von TDBCheckBox

TDBCheckBox	Nach Objekten	Legende

OnClick

OnDragDrop

OnDragOver

OnEndDrag

OnEnter

OnExit

OnKeyDown

OnKeyPress

OnKeyUp

OnMouseDown

OnMouseMove

OnMouseUp

OnStartDrag


Methoden von TDBCheckBox

TDBCheckBox	Alphabetisch

In TDBCheckBox

~TDBCheckBox

TDBCheckBox

Abgeleitet von TWinControl

Broadcast

CanFocus

ContainsControl

ControlAtPos

DisableAlign

EnableAlign

Focused

GetTabOrderList

HandleAllocated

HandleNeeded

InsertControl

Invalidate

PaintTo

Realign

RemoveControl

Repaint

ScaleBy

ScrollBy

SetBounds

SetFocus

Update

UpdateControlState

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

GetTextLen

Hide

Perform

Refresh

ScreenToClient

SendToBack

SetTextBuf

Show

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TDBCheckBox

TDBCheckBox	Nach Objekten

~TDBCheckBox

Assign

BeginDrag

BringToFront

Broadcast

CanFocus

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

ClientToScreen

ContainsControl

ControlAtPos

DefaultHandler

DestroyComponents

Destroying

DisableAlign

Dispatch

DragDrop

Dragging

EnableAlign

EndDrag

FieldAddress

FindComponent

Focused

FreeInstance

FreeNotification

Free

GetParentComponent

GetTabOrderList

GetTextBuf

GetTextLen

HandleAllocated

HandleNeeded

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InsertControl

InstanceSize

Invalidate

MethodAddress

MethodName

NewInstance

PaintTo

Perform

Realign

Refresh

RemoveComponent

RemoveControl

Repaint

ScaleBy

ScreenToClient

ScrollBy

SendToBack

SetBounds

SetFocus

SetTextBuf

Show

TDBCheckBox

UpdateControlState

Update


TDBCheckBox::~TDBCheckBox

TDBCheckBox	Siehe auch

Der Destruktor ~TDBCheckBox gibt den Speicher frei, der für das TDBCheckBox-Objekt reserviert war. Rufen Sie ~TDBCheckBox nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TDBCheckBox automatisch aufgerufen wird.

__fastcall virtual ~TDBCheckBox(void);

Beschreibung

Bevor ~TDBCheckBox den Destruktor seines übergeordneten Objekts aufruft, werden die Hilfsobjekte des TDBCheckBox-Objekts freigegeben.


TDBCheckBox::TDBCheckBox

TDBCheckBox	Siehe auch

Der Konstruktor TDBCheckBox erzeugt ein neues TDBCheckBox-Objekt.

__fastcall virtual TDBCheckBox(Classes::TComponent* AOwner);

Beschreibung

Mit TDBCheckBox wird zur Laufzeit ein TDBCheckBox-Objekt instantiiert. Für alle TDBCheckBox-Objekte, die zur Entwurfszeit in Formularen oder Datenmodulen plaziert wurden, wird der Konstruktor automatisch aufgerufen.

Über den Konstruktor des übergeordneten Objekts wird ein generisches RTF-Eingabefeld erzeugt. Dann nimmt TDBCheckBox die folgenden Initialisierungen vor:

•	csReplicatable wird zu ControlStyle hinzugefügt.

•	Die Hilfsobjekte für die Verknüpfung zur Datenmenge werden erzeugt und initialisiert.


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TControl

TWinControl

TButtonControl

TCustomCheckBox


TDBCheckBox Beispiel

TDBCheckBox


 TDBComboBox

Hierarchie	Eigenschaften	Methoden	Ereignisse

Header

vcl/dbctrls.hpp

Ein TDBComboBox-Objekt ist ein datensensitives Kombinationsfeld. Mit ihm kann der Benutzer den Wert eines Feldes im aktuellen Datensatz ändern, indem er entweder ein Element aus einer Liste wählt oder im dazugehörigen Eingabefeld selbst einen Wert eingibt. Wenn die Eigenschaft ReadOnly des Kombinationsfeldes False ist, wird dem Datenbankfeld das markierte Element oder der eingegebene Text zugewiesen.

Beschreibung

Das Erscheinungsbild und das Verhalten eines Datenbank-Kombinationsfeldes hängt vom Wert seiner Eigenschaft Style ab.

Sie können das Datenbank-Kombinationsfeld mit einer Datenmenge verknüpfen, indem Sie seiner Eigenschaft DataSource eine Datenquelle (TDataSource) zuweisen. In der Eigenschaft DataField geben Sie das Feld an, auf das Sie zugreifen möchten.

Die Werte, aus denen der Benutzer wählen kann, werden in der Eigenschaft Items festgelegt. Soll der Benutzer beispielsweise zwischen fünf verschiedenen Werten wählen können, müssen Sie der Eigenschaft Items fünf Strings zuweisen. Wie bei einem gewöhnlichen Kombinationsfeld können Sie mit den Methoden Add, Delete und Insert des Items-Objekts, das vom Typ TStrings ist, Elemente hinzufügen, löschen oder einfügen.

Die Eigenschaft ItemIndex gibt an, welches Element im Datenbank-Kombinationsfeld markiert ist.

Mit der Eigenschaft Sorted können die Elemente in der Liste sortiert werden.

Zur Laufzeit können Sie den gesamten Text im Eingabefeld des Datenbank-Kombinationsfeldes mit der Methode SelectAll markieren. Mit der Eigenschaft SelText können Sie markierten Text ersetzen oder feststellen, welchen Text der Anwender markiert hat. Mit den Eigenschaften SelStart und SelLength können Sie einen Teil des Textes markieren oder feststellen, welcher Teil des Textes markiert ist.


Eigenschaften von TDBComboBox

TDBComboBox	Alphabetisch	Legende

In TDBComboBox

DataField

DataSource

Field

Items

ReadOnly

Style

Abgeleitet von TCustomComboBox

Canvas

DropDownCount

DroppedDown

ItemHeight

ItemIndex

SelLength

SelStart

SelText

Sorted

Abgeleitet von TWinControl

Brush

ClientOrigin

ClientRect

ControlCount

Controls

Ctl3D

Handle

HelpContext

ParentCtl3D

Showing

TabOrder

TabStop

Abgeleitet von TControl

Align

BoundsRect

ClientHeight

ClientWidth

Color

ControlState

ControlStyle

Cursor

DragCursor

DragMode

Enabled

Font

Height

Hint

Left

Name

Parent

ParentColor

ParentFont

ParentShowHint

PopupMenu

ShowHint

Text

Top

Visible

Width

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TDBComboBox

TDBComboBox	Nach Objekten	Legende

Align

BoundsRect

Brush

Canvas

ClientHeight

ClientOrigin

ClientRect

ClientWidth

Color

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlCount

ControlState

Controls

ControlStyle

Ctl3D

Cursor

DataField

DataSource

DesignInfo

DragCursor

DragMode

DropDownCount

DroppedDown

Enabled

Field

Font

Handle

Height

HelpContext

Hint

ItemHeight

ItemIndex

Items

Left

Name

Owner

ParentColor

ParentCtl3D

ParentFont

ParentShowHint

Parent

PopupMenu

ReadOnly

SelLength

SelStart

SelText

ShowHint

Showing

Sorted

Style

TabOrder

TabStop

Tag

Text

Top

Visible

Width


TDBComboBox::DataField

TDBComboBox	Siehe auch

Die Eigenschaft DataField bezeichnet das Feld, dessen Daten das datensensitive Steuerelement anzeigt.

__property System::AnsiString DataField;

Beschreibung

Die Datenmenge, zu der das Feld gehört, wird als Datenquelle (TDataSource) in der Eigenschaft DataSource angegeben.


TDBComboBox::DataSource

TDBComboBox	Siehe auch

Die Eigenschaft DataSource gibt an, woher die Komponente die anzuzeigenden Daten bezieht.

__property Db::TDataSource* DataSource;

Beschreibung

In dieser Eigenschaft geben Sie an, aus welcher Datenquelle die Komponente ihre Daten bezieht.


TDBComboBox::Field

TDBComboBox	Siehe auch

Die Eigenschaft Field gibt das TField-Objekt zurück, mit dem das Datenbank-Kombinationsfeld verknüpft ist.

__property Db::TField* Field;

Beschreibung

Field gibt das TField-Objekt zurück, mit dem das Steuerelement verknüpft ist. Mit dieser Eigenschaft können Sie den Wert der Felddaten programmseitig ändern.


TDBComboBox::Items

TDBComboBox	Siehe auch

Die Eigenschaft Items enthält die Strings, die im Datenbank-Kombinationsfeld angezeigt werden.

__property Items;

Beschreibung

Da diese Eigenschaft vom Typ TStrings ist, können Sie mit den TStrings-Methoden Add, Delete, Insert, Exchange und Move Elemente hinzufügen, löschen, einfügen und neu anordnen.

Die Eigenschaft ItemIndex gibt an, welches Element markiert ist.

Mit der Eigenschaft Selected können Sie ermitteln, ob in der Liste, die die Eigenschaft Items eines Kombinationsfeldes bildet, ein bestimmtes Element markiert ist,.


TDBComboBox::ReadOnly

TDBComboBox	Siehe auch

Die Eigenschaft ReadOnly legt fest, ob der Inhalt des Steuerelements vom Benutzer geändert werden kann.

__property bool ReadOnly;

Beschreibung

Wenn ReadOnly False ist, kann der Benutzer den Inhalt ändern, andernfalls nicht.

Die Eigenschaft ReadOnly legt fest, ob der Benutzer das datensensitive Steuerelement dazu verwenden kann, den Wert des Feldes im aktuellen Datensatz zu ändern, oder ob der Wert lediglich angezeigt wird. Wenn ReadOnly False ist und die Datenmenge sich im Bearbeitungsmodus befindet, kann der Benutzer den Wert des Feldes ändern.


TDBComboBox::Style

TDBComboBox	Siehe auch

Die Eigenschaft Style legt fest, wie ein Kombinationsfeld seine Elemente darstellt.

__property Style;

Beschreibung

Der Vorgabewert für Style ist csDropDown, was bedeutet, daß das Kombinationsfeld jedes Element als String in einer Dropdown-Liste anzeigt. Bei den Elementen kann es sich auch um Grafiken mit fester oder variabler Höhe handeln. Style kann jeden Wert der folgenden Liste annehmen:

Wert	Bedeutung

csDropDown	Erzeugt eine Dropdown-Liste mit einem Eingabefeld, in dem der Anwender Text eingeben kann. Alle Elemente sind Strings und haben die gleiche Höhe. In Datenbank-Kombinationsfeldern zeigt das Kombinationsfeld den Inhalt des Feldes im aktuellen Datensatz an. Der Benutzer kann den Wert des Feldes ändern, indem er ein anderes Element aus der Dropdown-Liste auswählt oder im Bearbeitungsfeld einen neuen Wert eingibt.

csSimple	Erzeugt ein Eingabefeld ohne Liste. Bei Datenbank-Kombinationsfeldern wird der aktuelle Inhalt des verknüpften Feldes angezeigt. Der Benutzer kann den Wert des Feldes ändern, indem er im Bearbeitungsfeld einen neuen Wert eingibt.

csDropDownList	Erzeugt eine Dropdown-Liste ohne Bearbeitungsfeld, so daß der Benutzer keine Elemente bearbeiten oder neu hinzufügen kann. Alle Elemente sind Strings und haben die gleiche Höhe. Bei Datenbank-Kombinationsfeldern bleibt das Eingabefeld leer, wenn der aktuelle Inhalt des Datenbankfeldes nicht mit einem der Elemente der Dropdown-Liste übereinstimmt. Der Benutzer kann den Inhalt des Feldes nur ändern, indem er einen String aus der Dropdown-Liste auswählt.

csOwnerDrawFixed	Jedes Element des Kombinationsfeldes hat die Höhe, die in der Eigenschaft ItemHeight festgelegt ist. Bei Datenbank-Kombinationsfeldern bleibt das Eingabefeld leer, wenn der aktuelle Inhalt des Datenbankfeldes nicht mit einem der Elemente der Dropdown-Liste übereinstimmt. Der Benutzer kann den Inhalt des Feldes nur ändern, indem er einen String aus der Dropdown-Liste auswählt.

csOwnerDrawVariable	Die Elemente im Kombinationsfeld können in ihrer Höhe variieren. Bei Datenbank-Kombinationsfeldern bleibt das Eingabefeld leer, wenn der aktuelle Inhalt des Datenbankfeldes nicht mit einem der Elemente der Dropdown-Liste übereinstimmt. Der Benutzer kann den Inhalt des Feldes nur ändern, indem er einen String aus der Dropdown-Liste auswählt.

Kombinationsfelder, deren Eigenschaft Style entweder csOwnerDrawVariable oder csOwnerDrawFixed ist, können nicht nur Strings anzeigen, sondern auch andere Elemente. Ein Kombinationsfeld könnte beispielsweise Grafiken zusammen mit oder anstelle von Strings darstellen. Solche Kombinationsfelder erfordern allerdings einen höheren Programmieraufwand, da die Anwendung Informationen darüber benötigt, wie die Grafik für jedes Element der Liste ausgegeben werden soll.

Wenn in einem Kombinationsfeld vom Typ csOwnerDrawFixed ein Element angezeigt wird, wird das Ereignis OnDrawItem ausgelöst. Die Ereignisbehandlungsroutine für OnDrawItem zeichnet das angegebene Element. Die Eigenschaft ItemHeight legt die Höhe aller Elemente fest.

Wenn in einem Kombinationsfeld vom Typ csOwnerDrawVariable ein Element angezeigt wird, werden zwei Ereignisse ausgelöst. Das erste Ereignis ist OnMeasureItem. Die Ereignisbehandlungsroutine für OnMeasureItem weist jedem Element eine Höhe zu. Anschließend wird das Ereignis OnDrawItem ausgelöst. Die Ereignisbehandlungsroutine für OnDrawItem zeichnet jedes Element im Listenfeld unter Verwendung der Größe, welche die Ereignisbehandlungsroutine für OnMeasureItem festgelegt hat.


Ereignisse von TDBComboBox

TDBComboBox	Alphabetisch	Legende

Abgeleitet von TCustomComboBox

OnChange

OnDrawItem

OnDropDown

OnMeasureItem

Abgeleitet von TWinControl

OnEnter

OnExit

OnKeyDown

OnKeyPress

OnKeyUp

Abgeleitet von TControl

OnClick

OnDblClick

OnDragDrop

OnDragOver

OnEndDrag

OnStartDrag


Ereignisse von TDBComboBox

TDBComboBox	Nach Objekten	Legende

OnChange

OnClick

OnDblClick

OnDragDrop

OnDragOver

OnDrawItem

OnDropDown

OnEndDrag

OnEnter

OnExit

OnKeyDown

OnKeyPress

OnKeyUp

OnMeasureItem

OnStartDrag


Methoden von TDBComboBox

TDBComboBox	Alphabetisch

In TDBComboBox

~TDBComboBox

TDBComboBox

Abgeleitet von TCustomComboBox

Clear

SelectAll

Abgeleitet von TWinControl

Broadcast

CanFocus

ContainsControl

ControlAtPos

DisableAlign

EnableAlign

Focused

GetTabOrderList

HandleAllocated

HandleNeeded

InsertControl

Invalidate

PaintTo

Realign

RemoveControl

Repaint

ScaleBy

ScrollBy

SetBounds

SetFocus

Update

UpdateControlState

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

GetTextLen

Hide

Perform

Refresh

ScreenToClient

SendToBack

SetTextBuf

Show

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TDBComboBox

TDBComboBox	Nach Objekten

~TDBComboBox

Assign

BeginDrag

BringToFront

Broadcast

CanFocus

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

Clear

ClientToScreen

ContainsControl

ControlAtPos

DefaultHandler

DestroyComponents

Destroying

DisableAlign

Dispatch

DragDrop

Dragging

EnableAlign

EndDrag

FieldAddress

FindComponent

Focused

FreeInstance

FreeNotification

Free

GetParentComponent

GetTabOrderList

GetTextBuf

GetTextLen

HandleAllocated

HandleNeeded

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InsertControl

InstanceSize

Invalidate

MethodAddress

MethodName

NewInstance

PaintTo

Perform

Realign

Refresh

RemoveComponent

RemoveControl

Repaint

ScaleBy

ScreenToClient

ScrollBy

SelectAll

SendToBack

SetBounds

SetFocus

SetTextBuf

Show

TDBComboBox

UpdateControlState

Update


TDBComboBox::~TDBComboBox

TDBComboBox	Siehe auch

Der Destruktor ~TDBComboBox gibt den Speicher frei, der für das TDBComboBox-Objekt reserviert war. Rufen Sie ~TDBComboBox nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TDBComboBox automatisch aufgerufen wird.

__fastcall virtual ~TDBComboBox(void);


TDBComboBox::TDBComboBox

TDBComboBox	Siehe auch

Die Methode TDBComboBox erzeugt eine Instanz von TDBComboBox.

__fastcall virtual TDBComboBox(Classes::TComponent* AOwner);

Beschreibung

Mit TDBComboBox können Sie zur Laufzeit ein TDBComboBox-Objekt erstellen. Für TDBComboBox-Objekte, die zur Entwurfszeit in Formulare oder Datenmodule eingefügt werden, wird TDBComboBox automatisch aufgerufen.

Nach dem Aufruf des geerbten Konstruktors, der das generische Kombinationsfeld erzeugt und ihm Speicher zuweist, erzeugt und initialisiert TDBComboBox die für die Verknüpfung mit einer Datenmenge benötigten Hilfsobjekte.


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TControl

TWinControl

TCustomComboBox


TDBComboBox Beispiel

TDBComboBox


TDBCtrlPanel

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/dbcgrids.hpp

Die Komponente TDBCtrlPanel ist eine Tafel in einem TDBCtrlGrid-Objekt.

Beschreibung

In einem TDBCtrlPanel-Objekt können Sie die Felder eines Datensatzes der Datenmenge darstellen. Das TDBCtrlGrid-Objekt zeigt die Datensätze an, indem es Kopien von ein und demselben TDBCtrlPanel-Objekt in Zeilen oder Spalten anordnet, wobei jede Kopie einen einzelnen Datensatz repräsentiert.

Zur Entwurfszeit benötigen Sie nur eine einzige Tafel. Fügen Sie dieser Tafel datensensitive Eingabefelder oder Anzeigeobjekte hinzu. Zur Laufzeit erzeugt das TDBCtrlGrid-Objekt für jeden Datensatz der Datenmenge eine Kopie der Tafel.

Das Aussehen der Tafel wird von den Eigenschaften des TDBCtrlGrid-Objekts bestimmt, in dem sie enthalten ist. Das Ereignis OnPaintPanel von TDBCtrlGrid ermöglicht es, der Tafel ein benutzerdefiniertes Aussehen zu verleihen.


Eigenschaften von TDBCtrlPanel

TDBCtrlPanel	Alphabetisch	Legende

Abgeleitet von TWinControl

Brush

ClientOrigin

ClientRect

ControlCount

Controls

Handle

HelpContext

ParentWindow

Showing

TabOrder

TabStop

Abgeleitet von TControl

Align

BoundsRect

ClientHeight

ClientWidth

ControlState

ControlStyle

Cursor

Enabled

Height

Hint

Left

Name

Parent

ShowHint

Top

Visible

Width

WindowProc

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TDBCtrlPanel

TDBCtrlPanel	Nach Objekten	Legende

Align

BoundsRect

Brush

ClientHeight

ClientOrigin

ClientRect

ClientWidth

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlCount

ControlState

Controls

ControlStyle

Cursor

DesignInfo

Enabled

Handle

Height

HelpContext

Hint

Left

Name

Owner

Parent

ParentWindow

ShowHint

Showing

TabOrder

TabStop

Tag

Top

Visible

Width

WindowProc


Methoden von TDBCtrlPanel

TDBCtrlPanel	Alphabetisch

In TDBCtrlPanel

~TDBCtrlPanel

TDBCtrlPanel

Abgeleitet von TWinControl

Broadcast

CanFocus

ContainsControl

ControlAtPos

DisableAlign

EnableAlign

Focused

GetTabOrderList

HandleAllocated

HandleNeeded

InsertControl

Invalidate

PaintTo

Realign

RemoveControl

Repaint

ScaleBy

ScrollBy

SetBounds

SetFocus

Update

UpdateControlState

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

GetTextLen

Hide

Perform

Refresh

ScreenToClient

SendToBack

SetTextBuf

Show

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TDBCtrlPanel

TDBCtrlPanel	Nach Objekten

~TDBCtrlPanel

Assign

BeginDrag

BringToFront

Broadcast

CanFocus

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

ClientToScreen

ContainsControl

ControlAtPos

DefaultHandler

DestroyComponents

Destroying

DisableAlign

Dispatch

DragDrop

Dragging

EnableAlign

EndDrag

FieldAddress

FindComponent

Focused

FreeInstance

FreeNotification

Free

GetParentComponent

GetTabOrderList

GetTextBuf

GetTextLen

HandleAllocated

HandleNeeded

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InsertControl

InstanceSize

Invalidate

MethodAddress

MethodName

NewInstance

PaintTo

Perform

Realign

Refresh

RemoveComponent

RemoveControl

Repaint

ScaleBy

ScreenToClient

ScrollBy

SendToBack

SetBounds

SetFocus

SetTextBuf

Show

TDBCtrlPanel

UpdateControlState

Update


TDBCtrlPanel::~TDBCtrlPanel

TDBCtrlPanel

Der Destruktor ~TDBCtrlPanel gibt den Speicher frei, der für das TDBCtrlPanel-Objekt reserviert war. Rufen Sie ~TDBCtrlPanel nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TDBCtrlPanel automatisch aufgerufen wird.

__fastcall virtual ~TDBCtrlPanel(void);


TDBCtrlPanel::TDBCtrlPanel

TDBCtrlPanel	Siehe auch

Die Methode TDBCtrlPanel erzeugt und initialisiert eine Instanz von TDBCtrlPanel.

__fastcall TDBCtrlPanel(TDBCtrlGrid* DBCtrlGrid);

Beschreibung

Rufen Sie den Konstruktor für TDBCtrlPanel nicht direkt auf. Das TDBCtrlGrid-Objekt ruft TDBCtrlPanel in seinem eigenen Konstruktor auf.

TDBCtrlPanel weist der Eigenschaft Parent den Wert des Parameters DBCtrlGrid zu und initialisiert die Eigenschaft ControlStyle mit [csAcceptsControls, csCaptureMouse, csClickEvents, csDoubleClicks, csOpaque, csReplicatable].


Gültigkeitsbereich

Published

Zugriff

Read-only


Hierarchie

TObject

TPersistent

TComponent

TControl

TWinControl


TDBCtrlPanel Beispiel

TDBCtrlPanel


 TDBCtrlGrid

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/dbcgrids.hpp

Ein TDBCtrlGrid-Objekt zeigt die Datensätze einer Datenquelle in einem frei formatierten Layout an.

Beschreibung

Um die Datensätze einer Datenbanktabelle oder einer Abfrage anzuzeigen und zu bearbeiten, fügen Sie ein TDBCtrlGrid-Objekt in ein Formular ein. Im Gegensatz zum TDBGrid-Objekt, das die Datensätze jeweils in einer Zeile anzeigt, können die Datensätze der Datenmenge in einem TDBCtrlGrid-Objekt in einem benutzerdefinierten Format dargestellt werden. Jeder Datensatz wird in einer eigenen Tafel angezeigt. Erstellen Sie eine Tafel während des Entwurfs. Für jeden angezeigten Datensatz wird automatisch eine Kopie der Tafel erzeugt.

Zur Laufzeit können die Daten des TDBCtrlGrid-Objekts mit dem Datenbanknavigator (TDBNavigator-Objekt) durchsucht, gelöscht und bearbeitet werden. Außerdem können Daten eingefügt werden. Die im Datengitter vorgenommenen €nderungen werden erst in die zugrundeliegende Datenmenge übernommen, wenn der Cursor zu einem anderen Datensatz verschoben oder die Anwendung geschlossen wird.


Eigenschaften von TDBCtrlGrid

TDBCtrlGrid	Alphabetisch	Legende

In TDBCtrlGrid

AllowDelete

AllowInsert

Canvas

ColCount

DataSource

EditMode

Orientation

PanelBorder

PanelCount

PanelHeight

PanelIndex

PanelWidth

RowCount

SelectedColor

ShowFocus

Abgeleitet von TWinControl

Brush

ClientOrigin

ClientRect

ControlCount

Controls

Handle

HelpContext

ParentWindow

Showing

TabOrder

TabStop

Abgeleitet von TControl

Align

BoundsRect

ClientHeight

ClientWidth

Color

ControlState

ControlStyle

Cursor

DragCursor

DragMode

Enabled

Font

Height

Hint

Left

Name

Parent

ParentColor

ParentFont

ParentShowHint

PopupMenu

ShowHint

Top

Visible

Width

WindowProc

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TDBCtrlGrid

TDBCtrlGrid	Nach Objekten	Legende

Align

AllowDelete

AllowInsert

BoundsRect

Brush

Canvas

ClientHeight

ClientOrigin

ClientRect

ClientWidth

ColCount

Color

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlCount

ControlState

Controls

ControlStyle

Cursor

DataSource

DesignInfo

DragCursor

DragMode

EditMode

Enabled

Font

Handle

Height

HelpContext

Hint

Left

Name

Orientation

Owner

PanelBorder

PanelCount

PanelHeight

PanelIndex

PanelWidth

ParentColor

ParentFont

ParentShowHint

Parent

ParentWindow

PopupMenu

RowCount

SelectedColor

ShowFocus

ShowHint

Showing

TabOrder

TabStop

Tag

Top

Visible

Width

WindowProc


TDBCtrlGrid::AllowDelete

TDBCtrlGrid	Siehe auch

Mit der Eigenschaft AllowDelete können Sie bestimmen, ob der aktuelle Datensatz mit der Tastenkombination STRG+ENTF entfernt werden kann.

__property bool AllowDelete;

Beschreibung

Damit aus dem TDBCtrlGrid-Objekt keine Datensätze gelöscht werden können, setzen Sie AllowDelete auf False ein.

In diesem Fall werden keine Datensätze aus der Datenmenge gelöscht, wenn die Tastenkombination STRG+ENTF gedrückt oder die Methode DoKey mit dem Wert gkDelete für den Parameter Key aufgerufen wird. Es können jedoch weiterhin Datensätze in das TDBCtrlGrid-Objekt eingefügt werden.

Hat AllowDelete den Wert True (Standard), wird der aktuelle Datensatz aus der Datenmenge gelöscht, wenn die Tastenkombination STRG+ENTF gedrückt oder die Methode DoKey mit dem Wert gkDelete für den Parameter Key aufgerufen wird. Auch wenn AllowDelete auf True gesetzt wurde, können Datensätze nur gelöscht werden, wenn sich die Datenmenge im Bearbeitungsmodus befindet.


TDBCtrlGrid::AllowInsert

TDBCtrlGrid	Siehe auch

Mit der Eigenschaft AllowInsert können Sie bestimmen, ob neue Datensätze mit der Taste EINFG eingefügt oder mit der Tastenkombination STRG+EINFG angefügt werden können.

__property bool AllowInsert;

Beschreibung

Damit keine Datensätze in das TDBCtrlGrid-Objekt eingefügt werden können, setzen Sie AllowInsert auf False ein.

In diesem Fall werden keine Datensätze in die Datenmenge eingefügt, wenn die Taste EINFG oder die Tastenkombination STRG+EINFG gedrückt oder die Methode DoKey mit dem gkInsert im Parameter Key aufgerufen wird. Es können weiterhin Datensätze aus dem TDBCtrlGrid-Objekt gelöscht werden.

Hat AllowInsert den Wert True (Standard), fügt das TDBCtrlGrid-Objekt einen neuen Datensatz vor dem aktuellen Datensatz in die Datenmenge ein, wenn die Taste EINFG gedrückt wird. Der neue Datensatz wird am Ende der Datenmenge angefügt, wenn die Tastenkombination STRG+EINFG gedrückt wird. Auch wenn AllowInsert auf True gesetzt wurde, können Datensätze nur eingefügt werden, wenn sich die Datenmenge im Bearbeitungsmodus befindet.


TDBCtrlGrid::Canvas

TDBCtrlGrid	Siehe auch

Die Eigenschaft Canvas bezeichnet die Zeichenfläche, auf der das TDBCtrlGrid-Objekt gezeichnet wird.

__property Graphics::TCanvas* Canvas;

Beschreibung

Mit den Eigenschaften und Methoden der Zeichenfläche können Sie im TDBCtrlGrid-Objektmit der Ereignisbehandlungsroutine für OnPaintPanel eine Tafel zeichnen.


TDBCtrlGrid::ColCount

TDBCtrlGrid	Siehe auch	Beispiel

Mit der Eigenschaft ColCount können Sie die Spaltenzahl der im Gitter angezeigten Tafeln festlegen.

__property int ColCount;

Beschreibung

Setzen Sie ColCount auf die Anzahl der Spalten in den Tafeln, die im TDBCtrlGrid-Objekt angezeigt werden sollen. Jede Tafel repräsentiert einen Datensatz der Datenmenge.

Durch die Einstellung von ColCount wird das TDBCtrlGrid-Objekt an die neue Anzahl von Spalten angepaßt. Die Eigenschaft PanelWidth wird nicht geändert.


TDBCtrlGrid::DataSource

TDBCtrlGrid	Siehe auch

Die Eigenschaft DataSource gibt die Verbindung des TDBCtrlGrid-Objekts mit einer Datenmenge an.

__property Db::TDataSource* DataSource;

Beschreibung

Weisen Sie DataSource das TDataSource-Objekt zu, das mit der Datenmenge verbunden ist, aus der das Gitter Daten abruft. Mit Hilfe von DataSource kann das datensensitive Gitter die Datenmenge lesen, beschreiben und durchsuchen. Außerdem wird der parallele Datensatzzugriff mit anderen datensensitiven Objekten verwaltet, die dieselbe Datenquelle verwenden.


TDBCtrlGrid::EditMode

TDBCtrlGrid	Siehe auch

Mit der Eigenschaft EditMode können Sie bestimmen, ob mit dem TDBCtrlGrid-Objekt Datensätze eingefügt, gelöscht und bearbeitet werden können.

__property bool EditMode;

Beschreibung

Damit die Datenmenge mit Hilfe des Gitters bearbeitet werden kann, setzen Sie EditMode auf True. EditMode kann mit der Taste F2 oder der Eingabetaste umausgeschaltet werden. Beim Einfügen und Löschen von Datensätzen mit Hilfe des Gitters wird EditMode auf True gesetzt.


TDBCtrlGrid::Orientation

TDBCtrlGrid	Siehe auch

Mit der Eigenschaft Orientation können Sie die Richtung bestimmen, in der die Datensätze der Datenmenge im TDBCtrlGrid-Objekt angezeigt werden.

__property TDBCtrlGridOrientation Orientation;

Beschreibung

Indem Sie Orientation den Wert goVertical (Standard) zuweisen, können Sie die Tafeln in Zeilen anordnen und eine vertikale Bildlaufleiste einfügen. Um die Tafeln in Spalten anzuordnen und eine horizontale Bildlaufleiste einzufügen, setzen Sie Orientation auf goHorizontal.


TDBCtrlGrid::PanelBorder

TDBCtrlGrid	Siehe auch

Mit der Eigenschaft PanelBorder können Sie bestimmen, ob die Tafeln mit einem hervorgehobenen Rahmen gezeichnet werden.

__property TDBCtrlGridBorder PanelBorder;

Beschreibung

Beim Standardwert gbRaised wird ein Rahmen gezeichnet. Um den Rahmen wegzulassen, setzen Sie PanelBorder auf gbNone.


TDBCtrlGrid::PanelCount

TDBCtrlGrid	Siehe auch

Die Eigenschaft PanelCount enthält die Anzahl der Datensätze, die im Gitter sichtbar sind.

__property int PanelCount;

Beschreibung

Das TDBCtrlGrid-Objekt kann maximal ColCount * RowCount Tafeln anzeigen. Normalerweise hat PanelCount diesen Wert. Die Eigenschaft enthält einen kleineren Wert, falls das Gitter mit den Datensätzen der Datenmenge nicht vollständig gefüllt werden kann.


TDBCtrlGrid::PanelHeight

TDBCtrlGrid	Siehe auch

Die Eigenschaft PanelHeight bezeichnet die Höhe der Tafeln in Pixel.

__property int PanelHeight;

Beschreibung

Weisen Sie PanelHeight die gewünschte Größe der einzelnen Tafeln im Gitter zu. Sobald die Eigenschaft PanelHeight geändert wird, wird das Gitter an die neue Tafelhöhe angepaßt.


TDBCtrlGrid::PanelIndex

TDBCtrlGrid	Siehe auch

Die Eigenschaft PanelIndex enthält den Index der Tafel im Gitter, die den aktuellen Datensatz repräsentiert.

__property int PanelIndex;

Beschreibung

Mit PanelIndex können Sie bestimmen, welche Tafel den aktuellen Datensatz der Datenmenge repräsentiert. Mit PanelIndex können Sie den Cursor in der Datenmenge zu dem Datensatz verschieben, der einer bestimmten Tafel im Gitter entspricht.

PanelIndex ist eine Zahl aus dem Bereich von 0 bis PanelCount - 1. Der Wert 0 enspricht der ersten Tafel, der Wert 1 der zweiten Tafel usw. Die Position der Tafel mit dem Index PanelIndex hängt von der Eigenschaft Orientation ab. Hat Orientation den Wert goVertical, werden die Tafeln zeilenweise gezählt. Hat Orientation den Wert goHorizontal, werden die Tafeln spaltenweise gezählt.


TDBCtrlGrid::PanelWidth

TDBCtrlGrid	Siehe auch

Die Eigenschaft PanelWidth bezeichnet die Breite der Tafeln in Pixel.

__property int PanelWidth;

Beschreibung

Weisen Sie PanelWidth die gewünschte Größe der einzelnen Tafeln im Gitter zu. Sobald die Eigenschaft PanelWidth geändert wird, wird das Gitter an die neue Tafelbreite angepaßt.


TDBCtrlGrid::RowCount

TDBCtrlGrid	Siehe auch	Beispiel

Mit der Eigenschaft RowCount können Sie die Zeilenzahl für die im Gitter angezeigten Tafeln festlegen.

__property int RowCount;

Beschreibung

Weisen Sie RowCount die Anzahl der Zeilen mit Tafeln zu, die im TDBCtrlGrid-Objekt angezeigt werden sollen. Jede Tafel repräsentiert einen Datensatz der Datenmenge.

Durch die Einstellung von RowCount wird das TDBCtrlGrid-Objekt an die neue Anzahl von Zeilen angepaßt. Die Eigenschaft PanelHeight wird nicht geändert.


TDBCtrlGrid::ShowFocus

TDBCtrlGrid	Siehe auch

Die Eigenschaft ShowFocus zeigt an, ob das TDBCtrlGrid-Objekt den aktuellen Datensatz mit einem Fokusrechteck umgibt, wenn dieser den Eingabefokus besitzt.

__property bool ShowFocus;

Beschreibung

Indem Sie ShowFocus den Wert True zuweisen, können Sie ein Fokusrechteck um den aktuellen Datensatz des TDBCtrlGrid-Objekts zeichnen, wenn dieser den Eingabefokus besitzt. Setzen Sie ShowFocus in einer Ereignisbehandlungsroutine für OnPaintPanel auf False, wenn Sie eine abweichende visuelle Darstellung des Fokus benötigen.


TDBCtrlGrid::SelectedColor

TDBCtrlGrid	Siehe auch

Die Eigenschaft SelectedColor enthält die Hintergrundfarbe für die Tafel, die den aktuellen Datensatz der Datenmenge repräsentiert.

Beschreibung

Um die Tafel des aktuellen Datensatzes hervorzuheben, weisen Sie SelectedColor einen anderen Wert als der Eigenschaft Color zu. Die ausgewählte Tafel wird im TDBCtrlGrid-Objekt mit der Farbe SelectedColor gezeichnet, auch wenn sie den Eingabefokus nicht besitzt. Alle anderen Tafeln werden mit der Hintergrundfarbe gezeichnet, die in der Eigenschaft Color eingestellt wurde.

Die Eigenschaft kann einen der folgenden Werte annehmen:

Wert	Beschreibung

clBlack	Schwarz

clMaroon	Rotbraun

clGreen	Grün

clOlive	Olivgrün

clNavy	Marineblau

clPurple	Violett

clTeal	Blaugrün

clGray	Grau

clSilver	Silbergrau

clRed	Rot

clLime	Limonengrün

clBlue	Blau

clFuchsia	Pink

clAqua	Türkis

clWhite	Weiß

clBackground	Aktuelle Hintergrundfarbe des Windows-Desktops

clActiveCaption	Aktuelle Farbe der Titelleiste des aktiven Fensters

clInactiveCaption	Aktuelle Farbe der Titelleiste inaktiver Fenster

clMenu	Aktuelle Hintergrundfarbe der Menüs

clWindow	Aktuelle Hintergrundfarbe der Fenster

clWindowFrame	Aktuelle Farbe der Fensterrahmen

clMenuText	Aktuelle Farbe von Texten in Menüs

clWindowText	Aktuelle Farbe des Textes in Fenstern

clCaptionText	Aktuelle Farbe des Textes in der Titelleiste des aktiven Fensters

clActiveBorder	Aktuelle Rahmenfarbe des aktiven Fensters

clInactiveBorder	Aktuelle Rahmenfarbe inaktiver Fenster

clAppWorkSpace	Aktuelle Farbe des Arbeitsbereichs der Anwendung

clHighlight	Aktuelle Hintergrundfarbe von markiertem Text

clHightlightText	Aktuelle Farbe von markiertem Text

clBtnFace	Aktuelle Farbe einer Schaltfläche

clBtnShadow	Aktuelle Farbe des Schattens einer Schaltfläche

clGrayText	Aktuelle Farbe von grau dargestelltem Text (deaktivierte Steuerelemente)

clBtnText	Aktuelle Farbe von Text auf einer Schaltfläche

clInactiveCaptionText	Aktuelle Farbe des Textes in der Titelleiste eines inaktiven Fensters

clBtnHighlight	Aktuelle Farbe für die Hervorhebung einer Schaltfläche

cl3DDkShadow	Nur Windows 95 oder NT 4.0: Dunkler Schatten für dreidimensionale Anzeigeelemente

cl3DLight 	Nur Windows 95 oder NT 4.0: Helle Farbe für dreidimensionale Anzeigeelemente (Kanten, die der Lichtquelle zugewandt sind).

clInfoText 	Nur Windows 95 oder NT 4.0: Textfarbe für Tool-Tip-Steuerelemente

clInfoBk 	Nur Windows 95 oder NT 4.0: Hintergrundfarbe für Tool-Tip-Steuerelemente


Ereignisse von TDBCtrlGrid

TDBCtrlGrid	Alphabetisch	Legende

In TDBCtrlGrid

OnPaintPanel

Abgeleitet von TWinControl

OnEnter

OnExit

OnKeyDown

OnKeyPress

OnKeyUp

Abgeleitet von TControl

OnClick

OnDblClick

OnDragDrop

OnDragOver

OnEndDrag

OnMouseDown

OnMouseMove

OnMouseUp

OnStartDrag


Ereignisse von TDBCtrlGrid

TDBCtrlGrid	Nach Objekten	Legende

OnClick

OnDblClick

OnDragDrop

OnDragOver

OnEndDrag

OnEnter

OnExit

OnKeyDown

OnKeyPress

OnKeyUp

OnMouseDown

OnMouseMove

OnMouseUp

OnPaintPanel

OnStartDrag


TDBCtrlGrid::OnPaintPanel

TDBCtrlGrid	Siehe auch

Das Ereignis OnPaintPanel wird ausgelöst, wenn das TDBCtrlGrid-Objekt eine Tafel im Gitter zeichnen muß.

typedef void __fastcall (__closure *TPaintPanelEvent)(TDBCtrlGrid* DBCtrlGrid, int Index);

__property TPaintPanelEvent OnPaintPanel;

Beschreibung

Mit einer Ereignisbehandlungsroutine für OnPaintPanel können Sie das Zeichnen einer Tafel im TDBCtrlGrid-Objekt an die jeweiligen Anforderungen anpassen. Der Hintergrund wird in der Farbe der Eigenschaft Color oder SelectedColor gezeichnet. Falls die Eigenschaft PanelBorder entsprechend eingestellt wurde, wird auch ein Rahmen angezeigt. Anschließend wird das Ereignis OnPaintPanel ausgelöst, damit eine Ereignisbehandlungsroutine das Bild der Tafel einfügen kann.

Der Parameter DBCtrlGrid bezeichnet das Gitter, das die Tafel enthält. Der Parameter Index ist der Index der zu zeichnenden Tafel. Der Wert 0 bezieht sich auf die erste Tafel, der Wert 1 auf die zweite Tafel usw. Mit der Eigenschaft PanelIndex können Sie bestimmen, ob die gezeichnete Tafel ausgewählt ist.

Mit der Eigenschaft Canvas können Sie die Tafel zeichnen. Der Punkt (0,0) der Zeichenfläche entspricht der linken oberen Ecke der Tafel und der Punkt (PanelWidth,PanelHeight) der rechten unteren Ecke.

Die Steuerelemente werden einzeln in die Tafel eingefügt und müssen nicht mit einer Ereignisbehandlungsroutine für OnPaintPanel gezeichnet werden.


Methoden von TDBCtrlGrid

TDBCtrlGrid	Alphabetisch

In TDBCtrlGrid

~TDBCtrlGrid

DoKey

GetTabOrderList

KeyDown

TDBCtrlGrid

Abgeleitet von TWinControl

Broadcast

CanFocus

ContainsControl

ControlAtPos

DisableAlign

EnableAlign

Focused

HandleAllocated

HandleNeeded

InsertControl

Invalidate

PaintTo

Realign

RemoveControl

Repaint

ScaleBy

ScrollBy

SetBounds

SetFocus

Update

UpdateControlState

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

GetTextLen

Hide

Perform

Refresh

ScreenToClient

SendToBack

SetTextBuf

Show

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TDBCtrlGrid

TDBCtrlGrid	Nach Objekten

~TDBCtrlGrid

Assign

BeginDrag

BringToFront

Broadcast

CanFocus

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

ClientToScreen

ContainsControl

ControlAtPos

DefaultHandler

DestroyComponents

Destroying

DisableAlign

Dispatch

DoKey

DragDrop

Dragging

EnableAlign

EndDrag

FieldAddress

FindComponent

Focused

FreeInstance

FreeNotification

Free

GetParentComponent

GetTabOrderList

GetTextBuf

GetTextLen

HandleAllocated

HandleNeeded

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InsertControl

InstanceSize

Invalidate

KeyDown

MethodAddress

MethodName

NewInstance

PaintTo

Perform

Realign

Refresh

RemoveComponent

RemoveControl

Repaint

ScaleBy

ScreenToClient

ScrollBy

SendToBack

SetBounds

SetFocus

SetTextBuf

Show

TDBCtrlGrid

UpdateControlState

Update


TDBCtrlGrid::~TDBCtrlGrid

TDBCtrlGrid

Der Destruktor ~TDBCtrlGrid gibt den Speicher frei, der für das TDBCtrlGrid-Objekt reserviert war. Rufen Sie ~TDBCtrlGrid nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TDBCtrlGrid automatisch aufgerufen wird.

__fastcall virtual ~TDBCtrlGrid(void);

Beschreibung

Bevor der Destruktor des übergeordneten Objekts aufgerufen wird, gibt ~TDBCtrlGrid die vom TDBCtrlGrid-Objekt verwendeten Hilfsobjekte frei.


TDBCtrlGrid::DoKey

TDBCtrlGrid

Die Methode DoKey implementiert die Reaktionen auf eine Reihe von Standard-Tastenanschlägen.

void __fastcall DoKey(TDBCtrlGridKey Key);

Beschreibung

Mit DoKey können Sie die Operation durchführen, die im Parameter Key festgelegt wurde. Beispielsweise können Sie mit DoKey die Tastenzuordnungen der Ereignisbehandlungsroutine für OnKeyDown ändern.

Die folgende Tabelle enthält die Aktionen, die für die verschiedenen Werte von Key durchgeführt werden.

Wert	Aktion

gkNull	Keine Aktion.

gkEditMode	Die Eigenschaft EditMode wird umgeschaltet.

gkPriorTab	Der Cursor wird zur vorhergehenden Tafel verschoben.

gkNextTab	Der Cursor wird zur nächsten Tafel verschoben.

gkLeft	Der Cursor wird um eine Tafel nach links verschoben.

gkRight	Der Cursor wird um eine Tafel nach rechts verschoben.

gkUp	Der Cursor wird um eine Tafel nach oben verschoben.

gkDown	Der Cursor wird um eine Tafel nach unten verschoben.

gkScrollUp	Der Cursor wird um eine Tafel nach oben verschoben.

gkScrollDown	Der Cursor wird um eine Tafel nach unten verschoben.

gkPageUp	Der Cursor wird in der Datenmenge um ColCount * RowCount Datensätze nach oben verschoben.

gkPageDown	Der Cursor wird in der Datenmenge um ColCount * RowCount Datensätze nach unten verschoben.

gkHome	Der Cursor wird zum ersten Datensatz der Datenmenge verschoben.

gkEnd	Der Cursor wird zum letzten Datensatz der Datenmenge verschoben.

gkInsert	Ein neuer Datensatz wird vor dem aktuellen Datensatz in die Datenmenge eingefügt, und EditMode wird auf True gesetzt.

gkAppend	Ein neuer Datensatz wird am Ende der Datenmenge angefügt, und EditMode wird auf True gesetzt.

gkDelete	Der aktuelle Datensatz wird aus der Datenmenge gelöscht, und EditMode wird auf False gesetzt.

gkCancel	Die nicht in die Datenmenge eingetragenen €nderungen werden verworfen, und EditMode wird auf False gesetzt.


TDBCtrlGrid::GetTabOrderList

TDBCtrlGrid	Siehe auch

Die Methode GetTabOrderList überschreibt die Standardwerte, um alle untergeordneten Steuerelemente aus der Tabulatorreihenfolge zu entfernen.

virtual void __fastcall GetTabOrderList(Classes::TList* List);

Beschreibung

GetTabOrderList gibt eine leere Liste zurück. Das TDBCtrlGrid-Objekt implementiert eigene Aktionen für die Taste TAB, um die Tafeln in der Reihenfolge der Datenbank zu aktivieren.


TDBCtrlGrid::KeyDown

TDBCtrlGrid

Mit der Methode KeyDown können Sie spezielle Aktionen durchführen, sobald eine Taste gedrückt wird.

virtual void __fastcall KeyDown(unsigned short &Key,  Classes::TShiftState Shift);

Beschreibung

Nachdem die Ereignisbehandlungsroutine für OnKeyDown aufgerufen wurde, übersetzt KeyDown alle Kombinationen der Parameter Key und Shift in einen virtuellen Tastencode und ruft die Methode DoKey auf, um die entsprechende Aktion durchzuführen.

Mit KeyDown werden folgende Übersetzungen durchgeführt:

Werte für
Key und Shift	Tastencode

Links	gkLeft

Rechts	gkRight

Auf	gkUp

Ab	gkDown

Bild auf	gkPageUp

Bild ab	gkPageDown

Pos1	gkHome

Ende	gkEnd

Eingabe	gkEditMode

F2	gkEditMode

Einfg	gkAppend

Strg+Einfg	gkInsert

Strg+Entf	gkDelete

Esc	gkCancel

Alle anderen Tasten	gkNull


TDBCtrlGrid::TDBCtrlGrid

TDBCtrlGrid	Siehe auch

Der Konstruktor TDBCtrlGrid erzeugt ein neues TDBCtrlGrid-Objekt.

__fastcall virtual TDBCtrlGrid(Classes::TComponent* AOwner);

Beschreibung

Mit TDBCtrlGrid wird zur Laufzeit ein TDBCtrlGrid-Objekt erzeugt. Alle TDBCtrlGrid-Objekte, die zur Entwurfszeit in einem Formular plaziert wurden, werden automatisch erzeugt.

TDBCtrlGrid reserviert Speicher für die benötigten Hilfsobjekte und nimmt folgende Initialisierungen vor:

•	AllowInsert und AllowDelete werden auf True gesetzt.

•	ColCount wird auf 1 und RowCount auf 3 gesetzt.

•	ControlStyle wird auf [csOpaque, csDoubleClicks] gesetzt.

•	PanelBorder wird auf gbRaised gesetzt.

•	PanelWidth wird auf 200 und PanelHeight auf 72 gesetzt.

•	SelectedColor wird auf Color gesetzt.

•	ShowFocus wird auf True gesetzt.

•	TabStop wird auf True gesetzt.


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TControl

TWinControl


TDBCtrlGrid Beispiel

TDBCtrlGrid


TDBCtrlGridLink

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/dbcgrids.hpp

TDBCtrlGridLink ist ein Hilfsobjekt, das TDBCtrlGrid-Objekte bei der Verwaltung von Datenereignissen unterstützt.

Beschreibung

TDBCtrlGridLink ist auf die Zusammenarbeit mit einem TDBCtrlGrid-Objekt abgestimmt. Es sollte nur von der Klasse TDBCtrlGrid verwendet werden.


Eigenschaften von TDBCtrlGridLink

TDBCtrlGridLink	Alphabetisch	Legende

Abgeleitet von TDataLink

Active

ActiveRecord

BufferCount

DataSet

DataSource

DataSourceFixed

Editing

ReadOnly

RecordCount


Eigenschaften von TDBCtrlGridLink

TDBCtrlGridLink	Nach Objekten	Legende

ActiveRecord

Active

BufferCount

DataSet

DataSourceFixed

DataSource

Editing

ReadOnly

RecordCount


Methoden von TDBCtrlGridLink

TDBCtrlGridLink	Alphabetisch	Legende

In TDBCtrlGridLink

~TDBCtrlGridLink

ActiveChanged

DataSetChanged

TDBCtrlGridLink

Abgeleitet von TDataLink

Edit

UpdateRecord

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TDBCtrlGridLink

TDBCtrlGridLink	Nach Objekten	Legende

~TDBCtrlGridLink

ActiveChanged

Assign

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DataSetChanged

DefaultHandler

Dispatch

Edit

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance

TDBCtrlGridLink

UpdateRecord


TDBCtrlGridLink::~TDBCtrlGridLink

TDBCtrlGridLink

Der Destruktor TDBCtrlGridLink gibt den Speicher frei, der für das TDBCtrlGridLink-Objekt reserviert war. Rufen Sie TDBCtrlGridLink nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit TDBCtrlGridLink automatisch aufgerufen wird.

__fastcall virtual ~TDBCtrlGridLink(void);


TDBCtrlGridLink::ActiveChanged

TDBCtrlGridLink	Siehe auch

Die Methode ActiveChanged informiert das TDBCtrlGrid-Objekt über Änderungen an der Eigenschaft Active.

virtual void __fastcall ActiveChanged(void);

Beschreibung

ActiveChanged kann von Anwendungen nicht direkt aufgerufen werden. Die Methode wird durch Änderungen an der Eigenschaft Active ausgelöst. ActiveChanged veranlaßt das TDBCtrlGrid-Objekt, seine Darstellung auf dem Bildschirm entsprechend den Änderungen in der Datenmenge zu aktualisieren.


TDBCtrlGridLink::TDBCtrlGridLink

TDBCtrlGridLink	Siehe auch

Die Methode TDBCtrlGridLink erzeugt eine Instanz von TDBCtrlGridLink.

__fastcall TDBCtrlGridLink(TDBCtrlGrid* DBCtrlGrid);

Beschreibung

TDBCtrlGridLink sollte für TDBCtrlGridLink-Objekte von Anwendungen nicht direkt aufgerufen werden. Das dem TDBCtrlGridLink-Objekt übergeordnete TDBCtrlGrid-Objekt ruft TDBCtrlGridLink in seinem Konstruktor auf.


TDBCtrlGridLink::DataSetChanged

TDBCtrlGridLink	Siehe auch

Die Methode DataSetChanged informiert das TDBCtrlGrid-Objekt über Änderungen an der Datenmenge.

virtual void __fastcall DataSetChanged(void);

Beschreibung

Diese Methode kann von Anwendungen nicht direkt aufgerufen werden. Sie wird automatisch ausgelöst, wenn sich der Inhalt einer Datenmenge ändert. Wenn der Bildausschnitt über der Datenmenge verschoben wird oder sich ihre Darstellung im TDBCtrlGrid-Objekt ändert, wird DataSetChanged indirekt aufgerufen. DataSetChanged veranlaßt das TDBCtrlGrid-Objekt, seine Darstellung auf dem Bildschirm entsprechend den Änderungen in der Datenmenge zu aktualisieren..


Zugriff

Read-only


Gültigkeitsbereich

Protected


Hierarchie

TObject

TPersistent

TDataLink


TDBCtrlGridLink Beispiel

TDBCtrlGridLink


TDBDataSet

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/dbtables.hpp

TDBDataSet kapselt die Datenbank-Konnektivität für abgeleitete Datenmengen-Objekte.

Beschreibung

TDBDataSet ist ein Datenmengen-Objekt, das Eigenschaften und Methoden für die Datenbank-Konnektivität definiert. Anwendungen verwenden TDBDataSet-Objekte niemals direkt, sondern immer in Form ihrer Nachkommen wie z.B. TQuery, TStoredProc und TTable, die die datenbankbezogenen Eigenschaften und Methoden erben.

Entwickler, die benutzerdefinierte Datenmengenkomponenten erzeugen, sollten diese von TDBDataSet ableiten. Dadurch stehen ihnen neben der Funktionalität von TDataSet auch die datenbankbezogenen Eigenschaften und Methoden von TDBDataSet zur Verfügung.


Eigenschaften von TDBDataSet

TDBDataSet	Alphabetisch	Legende

In TDBDataSet

Database

DatabaseName

DBHandle

DBLocale

DBSession

SessionName

UpdateMode

Abgeleitet von TDataSet

Active

AutoCalcFields

BOF

Bookmark

CachedUpdates

CanModify

DataSource

DefaultFields

Designer

EOF

ExpIndex

FieldCount

FieldDefs

Fields

FieldValues

Filter

Filtered

FilterOptions

Found

Handle

KeySize

Locale

Modified

RecNo

RecordCount

RecordSize

State

UpdateObject

UpdateRecordTypes

UpdatesPending

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TDBDataSet

TDBDataSet	Nach Objekten	Legende

Active

AutoCalcFields

BOF

Bookmark

CachedUpdates

CanModify

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

DatabaseName

Database

DataSource

DBHandle

DBLocale

DBSession

DefaultFields

Designer

DesignInfo

EOF

ExpIndex

FieldCount

FieldDefs

Fields

FieldValues

Filtered

FilterOptions

Filter

Found

Handle

KeySize

Locale

Modified

Owner

RecNo

RecordCount

RecordSize

SessionName

State

Tag

UpdateMode

UpdateObject

UpdateRecordTypes

UpdatesPending


TDBDataSet::Database

TDBDataSet	Siehe auch

Die Eigenschaft Database bezeichnet die Datenbank-Komponente, deren Tabellen die Datenmenge repräsentiert.

__property TDatabase* Database;

Beschreibung

Mit Database können Sie auf die Eigenschaften, Ereignisse und Methoden der Datenbank-Komponente zugreifen, die mit der Datenmenge verknüpft ist. Der Wert dieser Eigenschaft kann nicht geändert werden. Er wird automatisch zugewiesen, wenn die in der Eigenschaft DatabaseName angegebene Datenbank geöffnet wird.


TDBDataSet::DatabaseName

TDBDataSet	Siehe auch

Die Eigenschaft DatabaseName gibt den Namen der Datenbank an, die dieser Datenmenge zugeordnet werden soll.

__property System::AnsiString DatabaseName;

Beschreibung

Mit DatabaseName können Sie den Namen der Datenbank festlegen, die dieser Datenmengenkomponente zugeordnet werden soll. Der Wert dieser Eigenschaft sollte der Name einer Datenbank-Komponente sein, die in der Anwendung verwendet wird.

Hinweis

Der Versuch, dieser Eigenschaft einen Wert zuzuweisen, während eine der Komponente bereits zugeordnete Datenbank geöffnet ist, löst eine Exception aus.

Tip

Indem Sie zur Entwurfszeit doppelt auf eine TDatabase-Komponente klicken, können Sie den Datenbankeditor aufrufen und dort die Eigenschaft DatabaseName setzen.


TDBDataSet::DBHandle

TDBDataSet	Siehe auch

Die Eigenschaft DBHandle gibt das Datenbank-Handle der Borland Database Engine (BDE) für die Datenmenge an.

__property Bde::hDBIDb DBHandle;

Beschreibung

Mit DBHandle können Sie das Datenbank-Handle der Datenmenge ermitteln. Die Eigenschaft ist nur für Anwendungen von Bedeutung, die die entsprechenden Methoden umgehen und direkt mit der BDE-API arbeiten. Viele BDE-Funktionen erwarten die Übergabe eines Handles als Parameter. Die Eigenschaft wird initialisiert, wenn eine Sitzung aktiviert wird.

Hinweis

Verwenden Sie diese Eigenschaft nur, wenn in einer Anwendung BDE-Funktionen benötigt werden, die über die standardmäßigen Borland C++Builder-Komponenten nicht verfügbar sind.


TDBDataSet::DBLocale

TDBDataSet	Siehe auch

Die Eigenschaft DBLocale gibt den Sprachtreiber der Borland Database Engine (BDE) für die Datenmenge an.

__property void * DBLocale;

Beschreibung

Mit DBLocale können Sie ermitteln, welchen BDE-Sprachtreiber die Datenbank-Komponente verwendet, die dieser Datenmenge zugeordnet ist. Wenn eine Anwendung direkt mit der BDE arbeitet, muß der Wert dieser Eigenschaft möglicherweise einer API-Funktion als Parameter übergeben werden.

Hinweis

 Verwenden Sie diese Eigenschaft nur, wenn in einer Anwendung BDE-Funktionen benötigt werden, die über die standardmäßigen Borland C++Builder-Komponenten nicht verfügbar sind.


TDBDataSet::DBSession

TDBDataSet	Siehe auch

Die Eigenschaft DBSession zeigt auf die Sitzungskomponente, der diese Datenmenge zugeordnet ist.

__property TSession* DBSession;

Beschreibung

Mit DBSession können Sie ermitteln, von welcher Sitzung die Datenbank-Komponente gesteuert wird, die der Datenmenge zugeordnet ist. Standardmäßig wird eine Datenbank-Komponente mit der Standardsitzung Session verknüpft, die für alle Datenbankanwendungen automatisch erzeugt wird.


TDBDataSet::SessionName

TDBDataSet	Siehe auch

Die Eigenschaft SessionName gibt den Namen der Sitzung an, mit der die Datenmenge verknüpft ist.

__property System::AnsiString SessionName;

Beschreibung

Mit dieser Eigenschaft können Sie ermitteln oder festlegen, mit welcher Sitzung die Datenmenge verknüpft ist. SessionName wird automatisch der Wert der gleichnamigen Eigenschaft der Datenbank-Komponente zugewiesen, der die Datenmenge zugeordnet ist. Wenn SessionName kein Wert zugewiesen ist, wird die Datenmenge automatisch mit der Standardsitzung Session verbunden.

Um eine Datenmengenkomponente mit einer anderen Sitzung zu verbinden, weisen Sie SessionName den Wert der Eigenschaft SessionName einer bestehenden Sitzungskomponente zu, die auch von der mit der Datenmenge verknüpften Datenbank-Komponente verwendet wird.


TDBDataSet::UpdateMode

TDBDataSet

Die Eigenschaft UpdateMode enthält den Aktualisierungsmodus der Datenmengenkomponente

__property TUpdateMode UpdateMode;

UpdateMode wird von anderen Datenbankobjekten wie TQuery verwendet.


Ereignisse von TDBDataSet

TDBDataSet	Alphabetisch	Legende

Abgeleitet von TDataSet

AfterCancel

AfterClose

AfterDelete

AfterEdit

AfterInsert

AfterOpen

AfterPost

BeforeCancel

BeforeClose

BeforeDelete

BeforeEdit

BeforeInsert

BeforeOpen

BeforePost

OnCalcFields

OnDeleteError

OnEditError

OnFilterRecord

OnNewRecord

OnPostError

OnServerYield

OnUpdateError

OnUpdateRecord


Ereignisse von TDBDataSet

TDBDataSet	Nach Objekten	Legende

AfterCancel

AfterClose

AfterDelete

AfterEdit

AfterInsert

AfterOpen

AfterPost

BeforeCancel

BeforeClose

BeforeDelete

BeforeEdit

BeforeInsert

BeforeOpen

BeforePost

OnCalcFields

OnDeleteError

OnEditError

OnFilterRecord

OnNewRecord

OnPostError

OnServerYield

OnUpdateError

OnUpdateRecord


Methoden von TDBDataSet

TDBDataSet	Alphabetisch

In TDBDataSet

~TDBDataSet

CheckOpen

TDBDataSet

Abgeleitet von TDataSet

ActiveBuffer

Append

AppendRecord

ApplyUpdates

Cancel

CancelUpdates

CheckBrowseMode

ClearFields

Close

CommitUpdates

ControlsDisabled

CursorPosChanged

Delete

DisableControls

Edit

EnableControls

FetchAll

FieldByName

FindField

FindFirst

FindLast

FindNext

FindPrior

First

FreeBookmark

GetBookmark

GetCurrentRecord

GetFieldList

GetFieldNames

GotoBookmark

Insert

InsertRecord

IsLinkedTo

Last

Locate

Lookup

MoveBy

Next

Open

Post

Prior

Refresh

Resync

RevertRecord

SetDetailFields

SetFields

UpdateCursorPos

UpdateRecord

UpdateStatus

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TDBDataSet

TDBDataSet	Nach Objekten

~TDBDataSet

ActiveBuffer

AppendRecord

Append

ApplyUpdates

Assign

Cancel

CancelUpdates

CheckBrowseMode

CheckOpen

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

ClearFields

Close

CommitUpdates

ControlsDisabled

CursorPosChanged

DefaultHandler

Delete

DestroyComponents

Destroying

DisableControls

Dispatch

Edit

EnableControls

FetchAll

FieldAddress

FieldByName

FindComponent

FindField

FindFirst

FindLast

FindNext

FindPrior

First

FreeBookmark

FreeInstance

FreeNotification

Free

GetBookmark

GetCurrentRecord

GetFieldList

GetFieldNames

GetParentComponent

GotoBookmark

HasParent

InheritsFrom

InitInstance

InsertComponent

InsertRecord

Insert

InstanceSize

IsLinkedTo

Last

Locate

Lookup

MethodAddress

MethodName

MoveBy

NewInstance

Next

Open

Post

Prior

Refresh

RemoveComponent

Resync

RevertRecord

SetDetailFields

SetFields

TDBDataSet

UpdateCursorPos

UpdateRecord

UpdateStatus


TDBDataSet::~TDBDataSet

TDBDataSet

Der Destruktor ~TDBDataSet gibt den Speicher frei, der für das TDBDataSet-Objekt reserviert war. Rufen Sie ~TDBDataSet nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TDBDataSet automatisch aufgerufen wird.

__fastcall virtual ~TDBDataSet(void);


TDBDataSet::CheckOpen

TDBDataSet	Siehe auch

Die Methode CheckOpen überprüft das Ergebnis eines Aufrufs der Borland Database Engine (BDE).

bool __fastcall CheckOpen(unsigned short Status);

Beschreibung

Mit CheckOpen können Sie ermitteln, ob die BDE bei einem Zugriffsversuch auf eine Tabelle einen Fehler zurückgibt. Status ist der Rückgabewert eines vorhergehenden BDE-Aufrufs. CheckOpen gibt True zurück, wenn der Zugriff erfolgreich war. Wenn der Parameter Status auf ungenügende Zugriffsrechte für eine Paradox-Tabelle hinweist, wird die Methode GetPassword der Datenbanksitzung aufgerufen, die vom Benutzer die Eingabe eines Kennworts verlangt. Wenn das richtige Kennwort eingegeben wird, gibt CheckOpen True zurück.

Wenn CheckOpen False zurückgibt, bedeutet dies, daß auf die Datenmenge nicht zugegriffen werden konnte.


TDBDataSet::TDBDataSet

TDBDataSet

Der Konstruktor TDBDataSet erzeugt ein neues TDBDataSet-Objekt.

__fastcall virtual TDBDataSet(Classes::TComponent* Aowner);


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TDataSet


TDBDataSet Beispiel

TDBDataSet


 TDBEdit

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/dbctrls.hpp

Ein TDBEdit-Objekt ist ein einzeiliges Eingabefeld, in dem ein Feld einer Datenmenge angezeigt und bearbeitet werden kann.

Beschreibung

Mit Hilfe eines TDBEdit-Objekts können Benutzer ein Datenbankfeld bearbeiten. Das Objekt kann eine Maske verwenden, um die Eingabe auf Daten zu beschränken, die für das Datenbankfeld gültig sind. Die Eigenschaft Text enthält den Inhalt des Feldes.

TDBEdit-Objekte erlauben nur einzeiligen Text. Wenn das Feld möglicherweise umfangreiche Daten enthält, die sich über mehrere Zeilen erstrecken, sollten Sie die Verwendung eines TDBMemo-Objekts in Betracht ziehen.

Wenn die datensensitiven Möglichkeiten von TDBEdit nicht benötigt werden, verwenden Sie statt dessen ein gewöhnliches Eingabefeld (TEdit) oder ein Eingabefeld mit Maske (TMaskEdit), um Systemressourcen zu sparen.


Eigenschaften von TDBEdit

TDBEdit	Alphabetisch	Legende

In TDBEdit

DataField

DataSource

Field

ReadOnly

Abgeleitet von TCustomMaskEdit

EditText

IsMasked

MaxLength

Text

Abgeleitet von TCustomEdit

AutoSelect

AutoSize

BorderStyle

CharCase

Modified

PasswordChar

SelLength

SelStart

SelText

Abgeleitet von TWinControl

Brush

ClientOrigin

ClientRect

ControlCount

Controls

Ctl3D

Handle

HelpContext

ParentCtl3D

Showing

TabOrder

TabStop

Abgeleitet von TControl

Align

BoundsRect

ClientHeight

ClientWidth

Color

ControlState

ControlStyle

Cursor

DragCursor

DragMode

Enabled

Font

Height

Hint

Left

Name

Parent

ParentColor

ParentFont

ParentShowHint

PopupMenu

ShowHint

Top

Visible

Width

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TDBEdit

TDBEdit	Nach Objekten	Legende

Align

AutoSelect

AutoSize

BorderStyle

BoundsRect

Brush

CharCase

ClientHeight

ClientOrigin

ClientRect

ClientWidth

Color

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlCount

ControlState

Controls

ControlStyle

Ctl3D

Cursor

DataField

DataSource

DesignInfo

DragCursor

DragMode

EditText

Enabled

Field

Font

Handle

Height

HelpContext

Hint

IsMasked

Left

MaxLength

Modified

Name

Owner

ParentColor

ParentCtl3D

ParentFont

ParentShowHint

Parent

PasswordChar

PopupMenu

ReadOnly

SelLength

SelStart

SelText

ShowHint

Showing

TabOrder

TabStop

Tag

Text

Top

Visible

Width


TDBEdit::DataField

TDBEdit	Siehe auch

Die Eigenschaft DataField gibt das Feld an, dessen Daten vom Eingabefeld angezeigt werden.

__property System::AnsiString DataField;

Beschreibung

Mit der Eigenschaft DataField können Sie das Eingabefeld mit einem Feld der Datenmenge verknüpfen. Zur detaillierten Angabe eines Datenbankfeldes gehört neben dem Feld auch die Datenmenge. Die Eigenschaft DataSource des Eingabefeldes gibt an, in welcher Datenmenge das Feld enthalten ist.

Wenn die Eigenschaft DataField auf ein Datenbankfeld zeigt, das Ganzzahlen oder Gleitkommazahlen enthält, können im Eingabefeld nur Zeichen eingegeben werden, die für das Datenbankfeld gültig sind. Ungültige Zeichen werden nicht akzeptiert.


TDBEdit::DataSource

TDBEdit	Siehe auch

Die Eigenschaft DataSource verknüpft das Eingabefeld mit der Datenmenge, die das darzustellende Feld enthält.

__property Db::TDataSource* DataSource;

Beschreibung

Mit der Eigenschaft DataSource können Sie das Eingabefeld mit der Datenmenge verknüpfen, die die Daten enthält. Zur vollständigen Angabe eines Datenbankfeldes gehört neben der Datenmenge auch ein Feld dieser Datenmenge. Mit der Eigenschaft DataField können Sie ein bestimmtes Feld der Datenmenge angeben.


TDBEdit::Field

TDBEdit	Siehe auch

Die Eigenschaft Field gibt das TField-Objekt an, das dem vom Eingabefeld dargestellten Datenbankfeld zugeordnet ist.

__property Db::TField* Field;

Beschreibung

Mit einem Lesezugriff auf diese Eigenschaft können Sie unter Umgehung des Eingabefeldes direkt auf den Inhalt und die Eigenschaften des Datenbankfeldes zugreifen und den Inhalt des Datenbankfeldes programmseitig ändern. Wenn Sie den Inhalt des Eingabefeldes ändern möchten, ohne die Änderungen sofort zu speichern, verwenden Sie statt dessen die Eigenschaft Text. Änderungen an dieser Eigenschaft können vom Benutzer verworfen werden.


TDBEdit::ReadOnly

TDBEdit	Siehe auch

Die Eigenschaft ReadOnly legt fest, ob der Benutzer das Datenbank-Eingabefeld dazu verwenden kann, den Wert des Feldes im aktuellen Datensatz zu ändern.

__property bool ReadOnly;

Beschreibung

Setzen Sie ReadOnly auf True, um zu verhindern, daß der Inhalt des Datenbankfeldes durch den Benutzer geändert wird. Das Eingabefeld dient in diesem Fall nur zur Anzeige des Feldinhalts. Wenn ReadOnly False ist, kann der Benutzer den Wert des Feldes ändern, solange sich die Datenmenge im Bearbeitungsmodus befindet.


Ereignisse von TDBEdit

TDBEdit	Alphabetisch	Legende

Abgeleitet von TCustomEdit

OnChange

Abgeleitet von TWinControl

OnEnter

OnExit

OnKeyDown

OnKeyPress

OnKeyUp

Abgeleitet von TControl

OnClick

OnDblClick

OnDragDrop

OnDragOver

OnEndDrag

OnMouseDown

OnMouseMove

OnMouseUp

OnStartDrag


Ereignisse von TDBEdit

TDBEdit	Nach Objekten	Legende

OnChange

OnClick

OnDblClick

OnDragDrop

OnDragOver

OnEndDrag

OnEnter

OnExit

OnKeyDown

OnKeyPress

OnKeyUp

OnMouseDown

OnMouseMove

OnMouseUp

OnStartDrag


Methoden von TDBEdit

TDBEdit	Alphabetisch	Legende

In TDBEdit

~TDBEdit

Change

EditCanModify

KeyDown

KeyPress

Notification

Reset

TDBEdit

Abgeleitet von TCustomMaskEdit

Clear

GetTextLen

ValidateEdit

Abgeleitet von TCustomEdit

ClearSelection

CopyToClipboard

CutToClipboard

GetSelTextBuf

PasteFromClipboard

SelectAll

SetSelTextBuf

Abgeleitet von TWinControl

Broadcast

CanFocus

ContainsControl

ControlAtPos

DisableAlign

EnableAlign

Focused

GetTabOrderList

HandleAllocated

HandleNeeded

InsertControl

Invalidate

PaintTo

Realign

RemoveControl

Repaint

ScaleBy

ScrollBy

SetBounds

SetFocus

Update

UpdateControlState

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

Hide

Perform

Refresh

ScreenToClient

SendToBack

SetTextBuf

Show

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TDBEdit

TDBEdit	Nach Objekten	Legende

~TDBEdit

Assign

BeginDrag

BringToFront

Broadcast

CanFocus

Change

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

ClearSelection

Clear

ClientToScreen

ContainsControl

ControlAtPos

CopyToClipboard

CutToClipboard

DefaultHandler

DestroyComponents

Destroying

DisableAlign

Dispatch

DragDrop

Dragging

EditCanModify

EnableAlign

EndDrag

FieldAddress

FindComponent

Focused

FreeInstance

FreeNotification

Free

GetParentComponent

GetSelTextBuf

GetTabOrderList

GetTextBuf

GetTextLen

HandleAllocated

HandleNeeded

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InsertControl

InstanceSize

Invalidate

KeyDown

KeyPress

MethodAddress

MethodName

NewInstance

Notification

PaintTo

PasteFromClipboard

Perform

Realign

Refresh

RemoveComponent

RemoveControl

Repaint

Reset

ScaleBy

ScreenToClient

ScrollBy

SelectAll

SendToBack

SetBounds

SetFocus

SetSelTextBuf

SetTextBuf

Show

TDBEdit

UpdateControlState

Update

ValidateEdit


TDBEdit::~TDBEdit

TDBEdit	Siehe auch

Der Destruktor ~TDBEdit gibt den Speicher frei, der für das TDBEdit-Objekt reserviert war. Rufen Sie ~TDBEdit nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TDBEdit automatisch aufgerufen wird.

__fastcall virtual ~TDBEdit(void);

Beschreibung

~TDBEdit überschreibt den geerbten Destruktor, um alle Hilfsobjekte freizugeben, die zur verwaltung der Anzeige und der Datenbankinteraktionen angelegt wurden.


TDBEdit::Change

TDBEdit	Siehe auch

Die Methode Change überprüft, ob der Text geändert wurde. Erst nach dieser Prüfung darf die geerbte Methode die Ereignisbehandlungsroutine aufrufen (falls eine solche zugewiesen wurde).

virtual void __fastcall Change(void);

Beschreibung

Change ist als protected deklariert. Anwendungen können die Methode nicht direkt aufrufen. Sie wird durch Windows-Ereignisse automatisch ausgelöst. Change reagiert diese Ereignisse, indem es intern festhält, daß solche Änderungen vorgenommen wurden. Anhand dieser Information kann dann entschieden werden, ob Änderungen gespeichert oder verworfen werden müssen, wenn der Anwender dies wünscht.


TDBEdit::EditCanModify

TDBEdit	Siehe auch

Die Methode EditCanModify erlaubt oder verhindert Änderungen am Text in Abhängigkeit davon, ob sich die Datenmenge im Bearbeitungsmodus befindet.

virtual bool __fastcall EditCanModify(void);

Beschreibung

EditCanModify überschreibt die geerbte Methode, so daß das Steuerelement Änderungen nur zuläßt, wenn sich die Datenmenge im Bearbeitungsmodus befindet. Wenn das Eingabefeld grundsätzlich keine Bearbeitung erlauben soll, setzen Sie die Eigenschaft ReadOnly auf True.

Hinweis

EditCanModify ist als protected deklariert. Anwendungen können die Methode nicht direkt aufrufen.


TDBEdit::KeyDown

TDBEdit	Siehe auch

Die Methode KeyDown ersetzt die geerbte Methode, um die Datenmenge in den Bearbeitungsmodus zu versetzen, wenn der Benutzer ENTF oder STRG+EINFG drückt.

virtual void __fastcall KeyDown(unsigned short &Key,  Classes::TShiftState Shift);

Beschreibung

KeyDown ruft zuerst die geerbte Methode auf, die ihrerseits die Ereignisbehandlungsroutine für OnKeyDown aufruft. Als nächstes versucht KeyDown, die Datenmenge in den Bearbeitungsmodus zu versetzen, wenn der Benutzer ENTF oder STRG+EINFG drückt. Die Methode kann von abgeleiteten Klassen überschrieben werden, um weitere Tastenkombinationen abzufangen. Die geerbte Methode sollte jedoch immer aufgerufen werden.

Hinweis

KeyDown ist als protected deklariert. Anwendungen können die Methode nicht direkt aufrufen. Sie wird automatisch als Reaktion auf Windows-Ereignisse aufgerufen.


TDBEdit::KeyPress

TDBEdit	Siehe auch

Die Methode KeyPress ersetzt die geerbte Methode, um alle Tastatureingaben abzufangen, die den Status des Eingabefeldes verändern.

virtual void __fastcall KeyPress(char &Key);

Beschreibung

KeyPress ruft zuerst die geerbte Methode auf, die ihrerseits die Ereignisbehandlungsroutine für OnKeyPress aufruft. Als nächstes verwirft KeyPress die Eingabe, wenn es sich nicht um ein für den vorliegenden Feldtyp gültiges Zeichen handelt oder wenn keine Verknüpfung zu einem Datenbankfeld besteht. Ist die Eingabe gültig, versucht KeyPress, die Datenmenge in den Bearbeitungsmodus zu versetzen.

Das Drücken von ESCAPE hat zur Folge, daß KeyPress Reset aufruft und alle nicht gespeicherten Änderungen verwirft.

Hinweis

KeyPress ist als protected deklariert. Anwendungen können die Methode nicht direkt aufrufen. Sie wird automatisch als Reaktion auf Windows-Ereignisse aufgerufen.


TDBEdit::Notification

TDBEdit	Siehe auch

Die Methode Notification überschreibt die geerbte Methode, um auf opRemove-Benachrichtigungen zu reagieren, die das DataSource-Objekt betreffen.

virtual void __fastcall Notification(Classes::TComponent* AComponent, Classes::TOperation Operation );

Beschreibung

Notification überprüft nach dem Aufruf der geerbten Methode, ob aus der Benachrichtigung hervorgeht, daß das DataSource-Objekt entfernt wurde. In diesem Fall wird die Eigenschaft DataSource auf NULL gesetzt.

Notification kann von abgeleiteten Klassen überschrieben werden, um weitere Benachrichtigungen zu verarbeiten. Die geerbte Methode sollte jedoch immer aufgerufen werden.

Hinweis

Notification ist als protected deklariert. Anwendungen können die Methode nicht direkt aufrufen.


TDBEdit::Reset

TDBEdit	Siehe auch

Die Methode Reset verwirft alle nicht gespeicherten Änderungen.

virtual void __fastcall Reset(void);

Beschreibung

Reset überschreibt die Standardmethode, um alle Änderungen an der Datenmenge zu verwerfen, wenn der Benutzer die ESC-Taste drückt.

Hinweis

Reset ist als protected deklariert. Anwendungen können die Methode nicht direkt aufrufen. Sie wird automatisch aufgerufen, wenn der Benutzer die ESC-Taste drückt.


TDBEdit::TDBEdit

TDBEdit	Siehe auch

Der Konstruktor TDBEdit erzeugt ein neues TDBEdit-Objekt.

__fastcall virtual TDBEdit(Classes::TComponent* AOwner);

Beschreibung

TDBEdit initialisiert die datenbankspezifischen Funktionen des Eingabefeldes.


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Protected


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TControl

TWinControl

TCustomEdit

TCustomMaskEdit


TDBEdit Beispiel

TDBEdit


TDBError

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/db.hpp

Die Klasse TDBError wird von der Exception-Klasse EDBEngineError zur Repräsentation von BDE-Fehlern verwendet.

Beschreibung

Eine EDBEngineError-Exception wird ausgelöst, wenn ein BDE-Fehler (Borland Database Engine) auftritt. EDBEngineError liest den BDE-Fehler-Stack und erstellt für jeden Fehler ein separates TDBError-Objekt. Diese Objekte sind in der Eigenschaft Errors von EDBEngineError enthalten.


Eigenschaften von TDBError

TDBError	Alphabetisch	Legende

In TDBError

Category

ErrorCode

Message

NativeError

SubCode


Eigenschaften von TDBError

TDBError	Nach Objekten	Legende

Category

ErrorCode

Message

NativeError

SubCode


TDBError::Category

TDBError

Die Eigenschaft Category bezeichnet die Kategorie des von ErrorCode angegebenen Fehlers.

__property unsigned char Category;

Beschreibung

Category enthält den Teil des BDE-Fehlercodes.


TDBError::ErrorCode

TDBError	Siehe auch

Die Eigenschaft ErrorCode enthält den von der BDE zurückgegebenen Fehlercode.

__property unsigned short ErrorCode;

Beschreibung

ErrorCode ist der von der BDE zurückgegebene Fehlercode. Er besteht aus einer Kategorie (Category) und einem Subcode.

DBIResult ist ein spezieller Datentyp, der von der Prozedur DBIError für BDE-Fehlercodes verwendet wird.


TDBError::Message

TDBError

Die Eigenschaft Message enthält den Text der Fehlermeldung.

__property System::AnsiString Message;

Beschreibung

Message enthält die Meldung des Remote-Servers bei Server-Fehlern oder die BDE-Meldung, wenn kein Server-Fehler vorliegt.


TDBError::NativeError

TDBError

Die Eigenschaft NativeError enthält den vom Server zurückgegebenen Remote-Fehlercode.

__property long NativeError;

Beschreibung

Hat NativeError den Wert 0, liegt kein Server-Fehler vor.


TDBError::SubCode

TDBError

Die Eigenschaft SubCode enthält den Subcode des von ErrorCode angegebenen Fehlers.

__property unsigned char SubCode;

Beschreibung

SubCode enthält den Subcode des BDE-Fehlercodes.


Methoden von TDBError

TDBError	Alphabetisch

In TDBError

~TDBError

TDBError

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TDBError

TDBError	Nach Objekten

~TDBError

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance

TDBError


TDBError::~TDBError

TDBError

Der Destruktor ~TDBError gibt den Speicher frei, der für das TDBError-Objekt reserviert war. Rufen Sie ~TDBError nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TDBError automatisch aufgerufen wird.

__fastcall virtual ~TDBError(void);


TDBError::TDBError

TDBError	Siehe auch

Der Konstruktor TDBError erzeugt ein neues TDBError-Objekt mit den von der BDE zurückgegebenen Fehlerinformationen.

__fastcall TDBError(EDBEngineError* Owner, unsigned short ErrorCode, long NativeError, char * Message );

Beschreibung

Die Methode TDBError wird von der Klasse EDBEngineError aufgerufen.


Zugriff

Read-only


Hierarchie

TObject


TDBError Beispiel

TDBError


TDBGridColumns

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/dbgrids.hpp

TDBGridColumns ist ein Container für TColumn-Objekte.

Beschreibung

Jede TDBGridColumns-Komponente enthält eine Kollektion von TColumn-Objekten in einem Datengitter (TDBGrid). TDBGridColumns verwaltet einen Index der Spalten im Array Items. Die Eigenschaft Count enthält die Anzahl der Spalten in der Kollektion. Während des Entwurfs können im Spalteneditor des Datengitters Spalten hinzugefügt, entfernt oder geändert werden.


Eigenschaften von TDBGridColumns

TDBGridColumns	Alphabetisch	Legende

In TDBGridColumns

Grid

Items

State

Abgeleitet von TCollection

Count


Eigenschaften von TDBGridColumns

TDBGridColumns	Nach Objekten	Legende

Count

Grid

Items

State


TDBGridColumns::Grid

TDBGridColumns	Siehe auch

Die Eigenschaft Grid bezeichnet die Datengitterkomponente, zu der die TDBGridColumns-Instanz gehört.

__property TCustomDBGrid* Grid;

Beschreibung

Die Nur-Lesen-Eigenschaft Grid gibt an, zu welchem Datengitter (TDBGrid) das TDBGridColumns-Objekt gehört.


TDBGridColumns::Items

TDBGridColumns

Die Eigenschaft Items enthält einen Index der Spalten in der Kollektion.

__property TColumn* Items[int Index];

Beschreibung

Der Wert des Parameters Index entspricht der Eigenschaft Index von TColumn. Er gibt die Position der Spalte im Datengitter an.


TDBGridColumns::State

TDBGridColumns	Siehe auch	Beispiel

Die Eigenschaft State bestimmt, ob die Spalten im Datengitter von den Datenmengenfeldern abhängig sind.

__property TDBGridColumnsState State;

Beschreibung

Hat State den Wert csDefault, werden die Spalten im Datengitter anhand der Feldinformationen der zugrundeliegenden Datenmenge dynamisch erstellt. Das Aussehen, die Reihenfolge und die anderen Eigenschaften werden dann aus den Datenmengenfeldern ermittelt. Änderungen an den Spalten werden auch in den Feldern der Datenmenge durchgeführt (und umgekehrt).

Wird State auf csCustomized gesetzt, sind viele Eigenschaften der Datengitterspalten von der zugeordneten Datenmenge unabhängig. So ist beispielsweise der Titel einer Spalte mit der Eigenschaft DisplayLabel des zugehörigen Feldes identisch. Hat State jedoch den Wert csCustomized, können die Eigenschaft Caption des Spaltentitels und die Eigenschaft DisplayLabel des Feldes unabhängig voneinander geändert werden. Tatsächlich muß eine benutzerdefinierte (oder „persistente“) Spalte keinem Datenmengenfeld zugeordnet werden.

Hinweis

Werden die Spalten des Datengitters mit dem Spalteneditor konfiguriert, wird State automatisch auf csCustomized gesetzt. Wird die Eigenschaft State zur Laufzeit geändert, werden alle vorhandenen Spalten gelöscht.


Methoden von TDBGridColumns

TDBGridColumns	Alphabetisch

In TDBGridColumns

~TDBGridColumns

Add

RebuildColumns

RestoreDefaults

TDBGridColumns

Abgeleitet von TCollection

Assign

BeginUpdate

Clear

EndUpdate

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TDBGridColumns

TDBGridColumns	Nach Objekten

~TDBGridColumns

Add

Assign

BeginUpdate

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

Clear

DefaultHandler

Dispatch

EndUpdate

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance

RebuildColumns

RestoreDefaults

TDBGridColumns


TDBGridColumns::~TDBGridColumns

TDBGridColumns

Der Destruktor ~TDBGridColumns gibt den Speicher frei, der für das TDBGridColumns-Objekt reserviert war. Rufen Sie ~TDBGridColumns nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TDBGridColumns automatisch aufgerufen wird.

__fastcall virtual ~TDBGridColumns(void);


TDBGridColumns::Add

TDBGridColumns	Siehe auch

Die Methode Add erstellt eine neue TColumn-Instanz und fügt sie dem Array Items hinzu.

TColumn* __fastcall Add(void);

Beschreibung

Add gibt die neue Spalte zurück. Während des Entwurfs können Sie neue Spalten mit dem Spalteneditor dem Datengitter hinzufügen.


TDBGridColumns::RebuildColumns

TDBGridColumns

Die Methode RebuildColumns löscht die vorhandenen Spalten und erstellt anhand der Feldinformationen der zugeordneten Datenmenge neue Spalten.

void __fastcall RebuildColumns(void);

Beschreibung

RebuildColumns initialisiert das TDBGridColumns-Objekt, indem zuerst die vorhandenen Spalten gelöscht und dann anhand der Feldinformationen der zugeordneten Datenmenge neue Spalten erstellt werden. Ist das Gitter nicht mit einer Datenmenge verbunden, werden nur die bestehenden Spalten gelöscht.


TDBGridColumns::RestoreDefaults

TDBGridColumns	Siehe auch

Die Methode RestoreDefaults stellt die Standardeinstellungen aller Spalten wieder her.

void __fastcall RestoreDefaults(void);

Beschreibung

RestoreDefaults verarbeitet die Elemente des Arrays Items in einer Schleife und ruft für jedes TColumn-Objekt die Methode RestoreDefaults auf. Diese Methode macht alle an den Eigenschaften der Spalten vorgenommenen Änderungen rückgängig und stellt die Standardeinstellungen wieder her.


TDBGridColumns::TDBGridColumns

TDBGridColumns	Siehe auch

Der Konstruktor TDBGridColumns erzeugt ein neues TDBGridColumns-Objekt.

__fastcall TDBGridColumns(TCustomDBGrid* Grid, System::TMetaClass* ColumnClass);

Beschreibung

TDBGridColumns erwartet zwei Parameter: eine Instanz eines Datengitters und TColumn (oder den Namen einer von TColumn abgeleiteten Klasse).


Zugriff

Read-only


Hierarchie

TObject

TPersistent

TCollection


TDBGridColumns Beispiel

TDBGridColumns


 TDBGrid

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/dbgrids.hpp

Ein TDBGrid-Objekt zeigt die Daten einer Datenmenge in einem Tabellengitter an.

Beschreibung

Indem Sie einem Formular ein TDBGrid-Objekt hinzufügen, können Sie die Datensätze einer Datenbanktabelle oder Abfrage anzeigen und bearbeiten. Anwendungen haben die Möglichkeit, im Datengitter Daten einzufügen, zu löschen und zu bearbeiten oder sie einfach nur anzuzeigen.

Zur Laufzeit kann sich der Benutzer mit Hilfe eines Datenbanknavigators (TDBNavigator) durch das Gitter bewegen und Daten einfügen, löschen und bearbeiten. Eingaben im Datengitter werden erst dann in der zugrundeliegenden Datenmenge gespeichert, wenn der Benutzer zu einem anderen Datensatz wechselt oder die Anwendung beendet.

TDBGrid implementiert das allgemeine Verhalten von TCustomDBGrid. Die Klasse deklariert viele der von TCustomDBGrid geerbten Eigenschaften als published, führt jedoch selbst kein neues Verhalten ein.


Eigenschaften von TDBGrid

TDBGrid	Alphabetisch	Legende

Abgeleitet von TCustomDBGrid

bmc publishd.bmp}	Columns

DataSource

DefaultDrawing

FieldCount

Fields

Options

ReadOnly

SelectedField

SelectedIndex

SelectedRows

TitleFont

Abgeleitet von TCustomGrid

BorderStyle

EditorMode

FixedColor

Abgeleitet von TCustomControl

Canvas

Abgeleitet von TWinControl

Brush

ClientOrigin

ClientRect

ControlCount

Controls

Ctl3D

Handle

HelpContext

ParentCtl3D

ParentWindow

Showing

TabOrder

TabStop

Abgeleitet von TControl

Align

BoundsRect

ClientHeight

ClientWidth

Color

ControlState

ControlStyle

Cursor

DragCursor

DragMode

Enabled

Font

Height

Hint

Left

Name

Parent

ParentColor

ParentFont

ParentShowHint

PopupMenu

ShowHint

Top

Visible

Width

WindowProc

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TDBGrid

TDBGrid	Nach Objekten	Legende

Align

BorderStyle

BoundsRect

Brush

Canvas

ClientHeight

ClientOrigin

ClientRect

ClientWidth

Color

Columns

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlCount

ControlState

Controls

ControlStyle

Ctl3D

Cursor

DataSource

DefaultDrawing

DesignInfo

DragCursor

DragMode

EditorMode

Enabled

FieldCount

Fields

FixedColor

Font

Handle

Height

HelpContext

Hint

Left

Name

Options

Owner

ParentColor

ParentCtl3D

ParentFont

ParentShowHint

Parent

ParentWindow

PopupMenu

ReadOnly

SelectedField

SelectedIndex

SelectedRows

ShowHint

Showing

TabOrder

TabStop

Tag

TitleFont

Top

Visible

Width

WindowProc


Ereignisse von TDBGrid

TDBGrid	Alphabetisch	Legende

Abgeleitet von TCustomDBGrid

OnColEnter

OnColExit

OnColumnMoved

OnDrawColumnCell

OnDrawDataCell

OnEditButtonClick

Abgeleitet von TWinControl

OnEnter

OnExit

OnKeyDown

OnKeyPress

OnKeyUp

Abgeleitet von TControl

OnDblClick

OnDragDrop

OnDragOver

OnEndDrag

OnStartDrag


Ereignisse von TDBGrid

TDBGrid	Nach Objekten	Legende

OnColEnter

OnColExit

OnColumnMoved

OnDblClick

OnDragDrop

OnDragOver

OnDrawColumnCell

OnDrawDataCell

OnEditButtonClick

OnEndDrag

OnEnter

OnExit

OnKeyDown

OnKeyPress

OnKeyUp

OnStartDrag


Methoden von TDBGrid

TDBGrid	Alphabetisch

In TDBGrid

~TDBGrid

TDBGrid

Abgeleitet von TCustomDBGrid

DefaultDrawColumnCell

DefaultDrawDataCell

ValidFieldIndex

Abgeleitet von TWinControl

Broadcast

CanFocus

ContainsControl

ControlAtPos

DisableAlign

EnableAlign

Focused

GetTabOrderList

HandleAllocated

HandleNeeded

InsertControl

Invalidate

PaintTo

Realign

RemoveControl

Repaint

ScaleBy

ScrollBy

SetBounds

SetFocus

Update

UpdateControlState

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

GetTextLen

Hide

Perform

Refresh

ScreenToClient

SendToBack

SetTextBuf

Show

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TDBGrid

TDBGrid	Nach Objekten

~TDBGrid

Assign

BeginDrag

BringToFront

Broadcast

CanFocus

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

ClientToScreen

ContainsControl

ControlAtPos

DefaultDrawColumnCell

DefaultDrawDataCell

DefaultHandler

DestroyComponents

Destroying

DisableAlign

Dispatch

DragDrop

Dragging

EnableAlign

EndDrag

FieldAddress

FindComponent

Focused

FreeInstance

FreeNotification

Free

GetParentComponent

GetTabOrderList

GetTextBuf

GetTextLen

HandleAllocated

HandleNeeded

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InsertControl

InstanceSize

Invalidate

MethodAddress

MethodName

NewInstance

PaintTo

Perform

Realign

Refresh

RemoveComponent

RemoveControl

Repaint

ScaleBy

ScreenToClient

ScrollBy

SendToBack

SetBounds

SetFocus

SetTextBuf

Show

TDBGrid

UpdateControlState

Update

ValidFieldIndex


TDBGrid::~TDBGrid

TDBGrid

Der Destruktor ~TDBGrid gibt den Speicher frei, der für das TDBGrid-Objekt reserviert war. Rufen Sie ~TDBGrid nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TDBGrid automatisch aufgerufen wird.

__fastcall virtual ~TDBGrid(void);


TDBGrid::TDBGrid

TDBGrid

Der Konstruktor TDBGrid erzeugt ein neues TDBGrid-Objekt.

__fastcall virtual TDBGrid(Classes::TComponent* AOwner);


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TControl

TWinControl

TCustomControl

TCustomGrid

TCustomDBGrid


TDBGrid Beispiel

TDBGrid


 TDBImage

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/dbctrls.hpp

Das Steuerelement TDBImage zeigt eine BLOB-Grafik an, die in einem Feld des aktuellen Datensatzes einer Datenmenge gespeichert ist. Wenn die Eigenschaft ReadOnly False ist, kann die Grafik bearbeitet werden.

Beschreibung

Sie können das TDBImage-Objekt mit einer Datenmenge verknüpfen, indem Sie die entsprechende Datenquelle (TDataSource) der Eigenschaft DataSource zuweisen. Das Feld der Datenmenge, auf das Sie zugreifen wollen, geben Sie in der Eigenschaft DataField an.

Mit der Eigenschaft AutoDisplay können Sie die Anzeige der Grafik im Objekt beeinflussen.

Mit der Eigenschaft Stretch können Sie die Größe ändern, in der das BLOB angezeigt wird.

Sie können in einem TDBImage-Objekt Grafiken ausschneiden, kopieren und einfügen. Zur Laufzeit können Sie die Windows-Tastenkürzel für Ausschneiden, Kopieren und Einfügen (STRG+X, STRG+C und STRG+V) verwenden, wenn das Objekt den Eingabefokus hat. Sollten Sie während einer solchen Operation Ihre Meinung ändern, können Sie das Objekt in seinen ursprünglichen Zustand zurückversetzen, indem Sie zuerst die ESC-Taste drücken und anschließend einen anderen Datensatz auswählen.

Falls Ihre Anwendung die datensensitiven Möglichkeiten von TDBImage nicht benötigt, verwenden Sie statt dessen ein TImage-Objekt, um Systemressourcen zu sparen.


Eigenschaften von TDBImage

TDBImage	Alphabetisch	Legende

In TDBImage

AutoDisplay

BorderStyle

Center

DataField

DataSource

Field

Picture

QuickDraw

ReadOnly

Stretch

Abgeleitet von TWinControl

Brush

ClientOrigin

ClientRect

ControlCount

Controls

Ctl3D

Handle

HelpContext

ParentCtl3D

Showing

TabOrder

TabStop

Abgeleitet von TControl

Align

BoundsRect

ClientHeight

ClientWidth

Color

ControlState

ControlStyle

Cursor

DragCursor

DragMode

Enabled

Font

Height

Hint

Left

Name

Parent

ParentColor

ParentFont

ParentShowHint

PopupMenu

ShowHint

Top

Visible

Width

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TDBImage

TDBImage	Nach Objekten	Legende

Align

AutoDisplay

BorderStyle

BoundsRect

Brush

Center

ClientHeight

ClientOrigin

ClientRect

ClientWidth

Color

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlCount

ControlState

Controls

ControlStyle

Ctl3D

Cursor

DataField

DataSource

DesignInfo

DragCursor

DragMode

Enabled

Field

Font

Handle

Height

HelpContext

Hint

Left

Name

Owner

ParentColor

ParentCtl3D

ParentFont

ParentShowHint

Parent

Picture

PopupMenu

QuickDraw

ReadOnly

ShowHint

Showing

Stretch

TabOrder

TabStop

Tag

Top

Visible

Width


TDBImage::AutoDisplay

TDBImage	Siehe auch

Die Eigenschaft AutoDisplay legt fest, ob der Inhalt eines Memo- oder Grafik-BLOBs im TDBImage-Objekt automatisch angezeigt wird.

__property bool AutoDisplay;

Beschreibung

Wenn AutoDisplay True ist (Standardwert), wird automatisch die neue Grafik angezeigt, sobald sich das zugrundeliegende BLOB-Feld ändert (wenn der Benutzer beispielsweise zu einem anderen Datensatz wechselt).

Wenn AutoDisplay False ist, wird das Bild gelöscht, sobald sich das zugrundeliegende BLOB-Feld ändert. Um die Daten anzuzeigen, kann der Benutzer doppelt auf das Steuerelement klicken oder es markieren und die EINGABE-Taste drücken. Zusätzlich können Sie mit der Methode LoadMemo eines Datenbankmemos oder mit der Methode LoadPicture des TDBImage-Objekts sicherstellen, daß das Steuerelement Daten anzeigt.

Wenn das automatische Laden von BLOB-Feldern zu viel Zeit in Anspruch nimmt, setzen Sie AutoDisplay auf False.


TDBImage::BorderStyle

TDBImage	Siehe auch	Beispiel

Die Eigenschaft BorderStyle legt fest, ob das TDBImage-Objekt über einen Rahmen verfügt.

__property Forms::TBorderStyle BorderStyle;

Wert	Bedeutung

bsNone	Kein sichtbarer Rahmen

bsSingle	Einfacher Rahmen


TDBImage::Center

TDBImage 	Beispiel

Die Eigenschaft Center legt fest, ob die Grafik im Steuerelement zentriert wird.

__property bool Center;

Beschreibung

Wenn Center True ist, wird die Grafik zentriert. Andernfalls wird sie an der linken oberen Ecke des Steuerelements ausgerichtet. Der Standardwert für Center ist True.


TDBImage::DataField

TDBImage	Siehe auch

Die Eigenschaft DataField legt das Feld fest, dessen Daten im Steuerelement angezeigt werden.

__property System::AnsiString DataField;

Beschreibung

Die Datenmenge, zu der das Feld gehört, wird als Datenquellenkomponente (TDataSource) der Eigenschaft DataSource zugewiesen.


TDBImage::DataSource

TDBImage	Siehe auch

Die Eigenschaft DataSource legt fest, woher die Komponente die anzuzeigenden Daten bezieht.

__property Db::TDataSource* DataSource;

Beschreibung

Weisen Sie dieser Eigenschaft die Datenquelle zu, die die Daten enthält.


TDBImage::Field

TDBImage	Siehe auch

Die Eigenschaft Field gibt die TField-Komponente zurück, mit der das TDBImage-Objekt verbunden ist.

__property Db::TField* Field;

Beschreibung

Mit dieser Eigenschaft können Sie den Wert der Daten im Feld programmseitig ändern.


TDBImage::Picture

TDBImage	Siehe auch 	Beispiel

Die Eigenschaft Picture legt die Grafik fest, die im TDBImage-Objekt angezeigt wird.

__property Graphics::TPicture* Picture;

Beschreibung

Der Wert dieser Eigenschaft ist ein TPicture-Objekt, das ein Symbol, eine Metadatei, ein Bitmap oder eine benutzerdefinierte Grafik enthält.


TDBImage::QuickDraw

TDBImage	Siehe auch

Die Eigenschaft QuickDraw gibt an, ob die Grafik mit Hilfe einer Palette angezeigt wird.

__property bool QuickDraw;

Beschreibung

Wenn QuickDraw False ist, wird eine Palette verwendet, um die Grafik in der bestmöglichen Qualität, aber auf Kosten der Bearbeitungszeit darzustellen. Bei True wird keine spezielle Palette verwendet. Die Grafik wird dadurch schneller, jedoch in minderer Qualität angezeigt. Dies gilt besonders bei Bildern mit 256 Farben und den entsprechenden Bildschirmtreibern.


TDBImage::ReadOnly

TDBImage	Siehe auch

Die Eigenschaft ReadOnly legt fest, ob der Benutzer den Inhalt des TDBImage-Objekts ändern kann.

__property bool ReadOnly;

Beschreibung

Diese Eigenschaft legt fest, ob der Benutzer mit dem datensensitiven Steuerelement den Wert eines Feldes des aktuellen Datensatzes ändern kann oder ob die Daten nur angezeigt werden. Wenn ReadOnly False ist, kann der Feldwert geändert werden, solange sich die Datenmenge im Bearbeitungsmodus befindet.


TDBImage::Stretch

TDBImage	Siehe auch 	Beispiel

Die Eigenschaft Stretch legt fest, ob Bitmaps und Metadateien die Größe und die Form des TDBImage-Objekts annehmen.

__property bool Stretch;

Beschreibung

Wenn Stretch True ist, wird die Grafik vergrößert bzw. verkleinert, wenn sich die Größe des Steuerelements ändert. Mit Stretch können Sie eine Grafik auch in ein kleineres Steuerelement einpassen. Bei Symbolen hat diese Eigenschaft keine Wirkung.

Wenn das Steuerlement die ursprüngliche Größe der Grafik annehmen soll, setzen Sie die Eigenschaft AutoSize auf True.


Ereignisse von TDBImage

TDBImage	Alphabetisch	Legende

Abgeleitet von TWinControl

OnEnter

OnExit

OnKeyDown

OnKeyPress

OnKeyUp

Abgeleitet von TControl

OnClick

OnDblClick

OnDragDrop

OnDragOver

OnEndDrag

OnMouseDown

OnMouseMove

OnMouseUp

OnStartDrag


Ereignisse von TDBImage

TDBImage	Nach Objekten	Legende

OnClick

OnDblClick

OnDragDrop

OnDragOver

OnEndDrag

OnEnter

OnExit

OnKeyDown

OnKeyPress

OnKeyUp

OnMouseDown

OnMouseMove

OnMouseUp

OnStartDrag


Methoden von TDBImage

TDBImage	Alphabetisch

In TDBImage

~TDBImage

CopyToClipboard

CutToClipboard

LoadPicture

PasteFromClipboard

TDBImage

Abgeleitet von TWinControl

Broadcast

CanFocus

ContainsControl

ControlAtPos

DisableAlign

EnableAlign

Focused

GetTabOrderList

HandleAllocated

HandleNeeded

InsertControl

Invalidate

PaintTo

Realign

RemoveControl

Repaint

ScaleBy

ScrollBy

SetBounds

SetFocus

Update

UpdateControlState

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

GetTextLen

Hide

Perform

Refresh

ScreenToClient

SendToBack

SetTextBuf

Show

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TDBImage

TDBImage	Nach Objekten

~TDBImage

Assign

BeginDrag

BringToFront

Broadcast

CanFocus

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

ClientToScreen

ContainsControl

ControlAtPos

CopyToClipboard

CutToClipboard

DefaultHandler

DestroyComponents

Destroying

DisableAlign

Dispatch

DragDrop

Dragging

EnableAlign

EndDrag

FieldAddress

FindComponent

Focused

FreeInstance

FreeNotification

Free

GetParentComponent

GetTabOrderList

GetTextBuf

GetTextLen

HandleAllocated

HandleNeeded

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InsertControl

InstanceSize

Invalidate

LoadPicture

MethodAddress

MethodName

NewInstance

PaintTo

PasteFromClipboard

Perform

Realign

Refresh

RemoveComponent

RemoveControl

Repaint

ScaleBy

ScreenToClient

ScrollBy

SendToBack

SetBounds

SetFocus

SetTextBuf

Show

TDBImage

UpdateControlState

Update


TDBImage::~TDBImage

TDBImage	Siehe auch

Der Destruktor ~TDBImage gibt den Speicher frei, der für das TDBImage-Objekt reserviert war. Rufen Sie ~TDBImage nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TDBImage automatisch aufgerufen wird.

__fastcall virtual ~TDBImage(void);

Beschreibung

~TDBImage gibt vor dem Aufruf des Destruktors des übergeordneten Objekts die Hilfsobjekte des TDBImage-Objekts frei.


TDBImage::CopyToClipboard

TDBImage	Siehe auch	Beispiel

Mit der Methode CopyToClipboard können Sie die Grafik eines TDBImage-Objekts in die Zwischenablage kopieren.

void __fastcall CopyToClipboard(void);

Beschreibung

CopyToClipboard kopiert die Grafik eines TDBImage-Objekts in die Zwischenablage.


TDBImage::CutToClipboard

TDBImage	Siehe auch	Beispiel

Die Methode CutToClipboard löscht die Grafik aus dem Steuerelement und kopiert sie in die Zwischenablage. Der bisherige Inhalt der Zwischenablage wird gelöscht.

void __fastcall CutToClipboard(void);

Beschreibung

Mit CutToClipboard können Sie die Grafik des Steuerelements löschen und in die Zwischenablage kopieren.


TDBImage::LoadPicture

TDBImage	Siehe auch

Die Methode LoadPicture lädt die in der Eigenschaft Picture angegebene Grafik in das Steuerelement.

void __fastcall LoadPicture(void);

Beschreibung

Wenn AutoDisplay False ist, wird die Grafik nicht automatisch geladen. In diesem Fall können Sie die Grafik zur Laufzeit mit LoadPicture laden.


TDBImage::PasteFromClipboard

TDBImage	Siehe auch	Beispiel

Die Methode PasteFromClipboard fügt den Inhalt der Zwischenablage an der Cursorposition in das Steuerelement ein.

void __fastcall PasteFromClipboard(void);

Beschreibung

Mit PasteFromClipboard können Sie den Inhalt der Zwischenablage in das Steuerelement kopieren.


TDBImage::TDBImage

TDBImage	Siehe auch

TDBImage erzeugt eine Instanz von TDBImage.

__fastcall virtual TDBImage(Classes::TComponent* AOwner);

Beschreibung

Mit TDBImage können Sie zur Laufzeit ein TDBImage-Objekt erzeugen. Für TDBImage-Objekte, die Sie zur Entwurfszeit in Formulare oder Datenmodule einfügen, wird TDBImage automatisch aufgerufen.

Nach dem Aufruf des geerbten Konstruktors, der ein generisches Steuerelement initialisiert und ihm Speicher zuweist, führt die Methode folgende Aktionen durch:

•	Sie fügt der Eigenschaft ControlStyle die Flags csOpaque und cs Replicatable hinzu.

•	Sie setzt TabStop, AutoDisplay und Center auf True und BorderStyle auf bsSingle.

•	Sie erzeugt ein TPicture-Objekt und weist es der Eigenschaft Picture zu.

•	Sie initialisiert die Höhe und die Breite des Steuerelements.

•	Sie erzeugt und initialisiert die Hilfsobjekte, die für die Verbindung mit der Datenmenge benötigt werden.


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TControl

TWinControl

TCustomControl


TDBImage Beispiel

TDBImage


 TDBListBox

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/dbctrls.hpp

Ein TDBListBox-Objekt ist ein datensensitives Listenfeld, mit dem der Benutzer den Wert eines Feldes im aktuellen Datensatz ändern kann, indem er einen Eintrag aus der Liste auswählt. Dieser Eintrag wird der neue Wert des Feldes.

Beschreibung

Um das Datenbank-Listenfeld mit einer Datenmenge zu verknüpfen, weisen Sie der Eigenschaft DataSource die entsprechende Datenquelle (TDataSource) zu. Das Feld der Datenmenge, auf das Sie zugreifen wollen, wird in der Eigenschaft DataField festgelegt.

In der Eigenschaft Items geben Sie die Werte an, die dem Benutzer im Listenfeld angeboten werden. Soll der Benutzer beispielsweise aus fünf verschiedenen Werten wählen können, geben Sie in Items fünf Strings an. Wie bei einem normalen Listenfeld können Sie mit den Methoden Add, Delete und Insert des Items-Objekts (das vom Typ TStrings ist) Einträge anhängen, löschen und einfügen. Mit der folgenden Anweisung können Sie beispielsweise einen String an ein Datenbank-Listenfeld anhängen:

DBListBox1->Strings->Items->Add(„New item“);

Die Eigenschaft ItemIndex gibt an, welcher Eintrag im Listenfeld markiert ist. Indem Sie ReadOnly auf True setzen, können Sie verhindern, daß der Benutzer einen Eintrag aus dem Listenfeld auswählt.

Wenn Ihre Anwendung die datensensitiven Möglichkeiten von TDBListBox nicht benötigt, verwenden Sie statt dessen ein gewöhnliches Listenfeld (TListBox), um Systemressourcen zu sparen.

Hinweise für Komponentenentwickler

Wenn Sie benutzerdefinierte Listenfelder entwickeln wollen, verwenden Sie TCustomListBox als Basisklasse.


Eigenschaften von TDBListBox

TDBListBox	Alphabetisch	Legende

In TDBListBox

DataField

DataSource

Field

Items

ReadOnly

Abgeleitet von TCustomListBox

BorderStyle

Canvas

IntegralHeight

ItemHeight

ItemIndex

SelCount

Selected

Style

TopIndex

Abgeleitet von TWinControl

Brush

ClientOrigin

ClientRect

ControlCount

Controls

Ctl3D

Handle

HelpContext

ParentCtl3D

Showing

TabOrder

TabStop

Abgeleitet von TControl

Align

BoundsRect

ClientHeight

ClientWidth

Color

ControlState

ControlStyle

Cursor

DragCursor

DragMode

Enabled

Font

Height

Hint

Left

Name

Parent

ParentColor

ParentFont

ParentShowHint

PopupMenu

ShowHint

Top

Visible

Width

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TDBListBox

TDBListBox	Nach Objekten	Legende

Align

BorderStyle

BoundsRect

Brush

Canvas

ClientHeight

ClientOrigin

ClientRect

ClientWidth

Color

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlCount

ControlState

Controls

ControlStyle

Ctl3D

Cursor

DataField

DataSource

DesignInfo

DragCursor

DragMode

Enabled

Field

Font

Handle

Height

HelpContext

Hint

IntegralHeight

ItemHeight

ItemIndex

Items

Left

Name

Owner

ParentColor

ParentCtl3D

ParentFont

ParentShowHint

Parent

PopupMenu

ReadOnly

SelCount

Selected

ShowHint

Showing

Style

TabOrder

TabStop

Tag

TopIndex

Top

Visible

Width


TDBListBox::DataField

TDBListBox	Siehe auch

Die Eigenschaft DataField bezeichnet das Feld, dessen Daten im datensensitiven Steuerelement angezeigt werden.

__property System::AnsiString DataField;

Beschreibung

Die Datenmenge, zu der das Feld gehört, wird als Datenquelle (TDataSource) der Eigenschaft DataSource zugewiesen.

Wenn die Eigenschaft DataField eines datensensitiven Eingabefeldes (TDBEdit) auf ein Integer- oder Gleitkommafeld zeigt, können im Eingabefeld nur gültige Zeichen eingegeben werden. Ungültige Zeichen werden nicht akzeptiert.


TDBListBox::DataSource

TDBListBox	Siehe auch

Die Eigenschaft DataSource legt fest, woher die Komponente die anzuzeigenden Daten bezieht.

__property Db::TDataSource* DataSource;

Beschreibung

Weisen Sie dieser Eigenschaft die Datenquelle zu, die die entsprechende Datenmenge bezeichnet.


TDBListBox::Field

TDBListBox	Siehe auch

Die Eigenschaft Field gibt das TField-Objekt zurück, mit dem das datensensitive Steuerelement verknüpft ist.

__property Db::TField* Field;

Beschreibung

Mit dem TField-Objekt können Sie programmseitig auf die Daten des Feldes zugreifen.


TDBListBox::Items

TDBListBox	Siehe auch

Die Eigenschaft Items enthält die Strings, die im Listenfeld angezeigt werden.

__property Items;

Beschreibung

Da Items ein TStrings-Objekt ist, können Sie mit seinen Methoden Add, Delete, Insert, Exchange und Move Einträge anhängen, löschen, einfügen und verschieben.

Die Eigenschaft ItemIndex gibt an, welcher Eintrag markiert ist. Mit Selected können Sie ermitteln, ob ein bestimmter Eintrag in der Stringliste der Eigenschaft Items markiert ist.

Das folgende Beispiel verwendet in einem Formular ein Eingabefeld, ein Listenfeld und eine Schaltfläche. Sobald der Benutzer auf die Schaltfläche klickt, wird der Text des Eingabefeldes dem Listenfeld hinzugefügt:

Beispiel

void __fastcall TForm1::Button1Click(TObject* Sender);

{

  ListBox1->Items->Add(Edit1->Text);

}


TDBListBox::ReadOnly

TDBListBox	Siehe auch

Die Eigenschaft ReadOnly legt fest, ob der Benutzer den Inhalt des Steuerelements ändern kann.

__property bool ReadOnly;

Beschreibung

Wenn ReadOnly True ist, kann der Inhalt nicht geändert werden. Bei False (Standardwert) kann der Inhalt geändert werden.

Bei datensensitiven Steuerelementen legt die Eigenschaft ReadOnly fest, ob der Wert eines Feldes im aktuellen Datensatz geändert werden kann, oder ob die Daten lediglich angezeigt werden. Wenn ReadOnly False ist, kann der Benutzer den Feldwert ändern, solange sich die Datenmenge im Bearbeitungsmodus befindet.

Wenn die Eigenschaft ReadOnly eines Datengitters True ist, kann der Benutzer weder mit der Taste EINFG eine neue Zeile in das Gitter einfügen, noch mit der Taste AB eine neue Zeile an das Ende des Datengitters anhängen.


Ereignisse von TDBListBox

TDBListBox	Alphabetisch	Legende

Abgeleitet von TCustomListBox

OnDrawItem

OnMeasureItem

Abgeleitet von TWinControl

OnEnter

OnExit

OnKeyDown

OnKeyPress

OnKeyUp

Abgeleitet von TControl

OnClick

OnDblClick

OnDragDrop

OnDragOver

OnEndDrag

OnMouseDown

OnMouseMove

OnMouseUp

OnStartDrag


Ereignisse von TDBListBox

TDBListBox	Nach Objekten	Legende

OnClick

OnDblClick

OnDragDrop

OnDragOver

OnDrawItem

OnEndDrag

OnEnter

OnExit

OnKeyDown

OnKeyPress

OnKeyUp

OnMeasureItem

OnMouseDown

OnMouseMove

OnMouseUp

OnStartDrag


Methoden von TDBListBox

TDBListBox	Alphabetisch

In TDBListBox

~TDBListBox

TDBListBox

Abgeleitet von TCustomListBox

Clear

ItemAtPos

ItemRect

Abgeleitet von TWinControl

Broadcast

CanFocus

ContainsControl

ControlAtPos

DisableAlign

EnableAlign

Focused

GetTabOrderList

HandleAllocated

HandleNeeded

InsertControl

Invalidate

PaintTo

Realign

RemoveControl

Repaint

ScaleBy

ScrollBy

SetBounds

SetFocus

Update

UpdateControlState

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

GetTextLen

Hide

Perform

Refresh

ScreenToClient

SendToBack

SetTextBuf

Show

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TDBListBox

TDBListBox	Nach Objekten

~TDBListBox

Assign

BeginDrag

BringToFront

Broadcast

CanFocus

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

Clear

ClientToScreen

ContainsControl

ControlAtPos

DefaultHandler

DestroyComponents

Destroying

DisableAlign

Dispatch

DragDrop

Dragging

EnableAlign

EndDrag

FieldAddress

FindComponent

Focused

FreeInstance

FreeNotification

Free

GetParentComponent

GetTabOrderList

GetTextBuf

GetTextLen

HandleAllocated

HandleNeeded

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InsertControl

InstanceSize

Invalidate

ItemAtPos

ItemRect

MethodAddress

MethodName

NewInstance

PaintTo

Perform

Realign

Refresh

RemoveComponent

RemoveControl

Repaint

ScaleBy

ScreenToClient

ScrollBy

SendToBack

SetBounds

SetFocus

SetTextBuf

Show

TDBListBox

UpdateControlState

Update


TDBListBox::~TDBListBox

TDBListBox	Siehe auch

Der Destruktor ~TDBListBox gibt den Speicher frei, der für das TDBListBox-Objekt reserviert war. Rufen Sie ~TDBListBox nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TDBListBox automatisch aufgerufen wird.

__fastcall virtual ~TDBListBox(void);

Beschreibung

~TDBListBox gibt vor dem Aufruf des Destruktors seines übergeordneten Objekts die Hilfsobjekte des TDBListBox-Objekts frei.


TDBListBox::TDBListBox

TDBListBox	Siehe auch

TDBListBox erzeugt eine Instanz von TDBListBox.

__fastcall virtual TDBListBox(Classes::TComponent* AOwner);

Beschreibung

Mit TDBListBox können Sie zur Laufzeit ein TDBListBox-Objekt erzeugen. Für TDBListBox-Objekte, die Sie zur Entwurfszeit in ein Formular oder Datenmodul einfügen, wird TDBListBox automatisch aufgerufen.

Nach dem Aufruf des Konstruktors des übergeordneten Objekts, der ein generisches Listenfeld initialisiert und ihm Speicher zuweist, erzeugt und initialisiert TDBListBox die Hilfsobjekte, die für die Verbindung mit einer Datenmenge benötigt werden.


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TControl

TWinControl

TCustomListBox


TDBListBox Beispiel

TDBListBox


 TDBLookupComboBox

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/dbctrls.hpp

Mit TDBLookupComboBox können Sie eine komfortable Dropdown-Liste mit Lookup-Einträgen zur Verfügung stellen. Diese Einträge können in Felder übernommen werden, für die Daten aus einer anderen Datenmenge benötigt werden.

Beschreibung

Weisen Sie der Eigenschaft DataSource die Datenquelle zu, die die Auswahl des Benutzers empfängt. Setzen Sie DataField entweder auf das Feld, in dem die gewählte Option gespeichert werden soll, oder auf ein Lookup-Feld. Wenn Sie DataField ein Lookup-Feld zuweisen, müssen Sie keine weiteren Eigenschaften setzen. Die benötigten Einstellungen werden aus dem Lookup-Feld automatisch in das Objekt der Klasse TDBLookupComboBox übernommen.

Weisen Sie der Eigenschaft ListSource die Datenquelle der Tabelle zu, in der die Optionen gespeichert sind. Weisen Sie KeyField das Feld zu, das Sie in DataField kopieren wollen. Setzen Sie die Eigenschaft ListField, um im Kombinationsfeld ein anderes Feld als KeyField anzuzeigen.

Falls in Ihrer Anwendung die datensensitiven Merkmale von TDBLookupComboBox nicht erforderlich sind, verwenden Sie statt dessen ein Kombinationsfeld (TComboBox), um Systemressourcen zu sparen.


Eigenschaften von TDBLookupComboBox

TDBLookupComboBox	Alphabetisch	Legende

In TDBLookupComboBox

DropDownAlign

DropDownRows

DropDownWidth

ListVisible

ReadOnly

Text

Abgeleitet von TDBLookupControl

DataField

DataSource

KeyField

KeyValue

ListField

ListFieldIndex

ListSource

Abgeleitet von TWinControl

Brush

ClientOrigin

ClientRect

ControlCount

Controls

Ctl3D

Handle

HelpContext

ParentCtl3D

Showing

TabOrder

TabStop

Abgeleitet von TControl

Align

BoundsRect

ClientHeight

ClientWidth

Color

ControlState

ControlStyle

Cursor

DragCursor

DragMode

Enabled

Font

Height

Hint

Left

Name

Parent

ParentColor

ParentFont

ParentShowHint

PopupMenu

ShowHint

Top

Visible

Width

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TDBLookupComboBox

TDBLookupComboBox	Nach Objekten	Legende

Align

BoundsRect

Brush

ClientHeight

ClientOrigin

ClientRect

ClientWidth

Color

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlCount

ControlState

Controls

ControlStyle

Ctl3D

Cursor

DataField

DataSource

DesignInfo

DragCursor

DragMode

DropDownAlign

DropDownRows

DropDownWidth

Enabled

Font

Handle

Height

HelpContext

Hint

KeyField

KeyValue

Left

ListFieldIndex

ListField

ListSource

ListVisible

Name

Owner

ParentColor

ParentCtl3D

ParentFont

ParentShowHint

Parent

PopupMenu

ReadOnly

ShowHint

Showing

TabOrder

TabStop

Tag

Text

Top

Visible

Width


DataField

Die Eigenschaft DataField bezeichnet das Feld, dessen Daten im datensensitiven Steuerelement angezeigt werden.

__property DataField;

Beschreibung

Die Datenmenge, in der sich das Feld befindet, wird in einer Datenquellenkomponente (TDataSource) festgelegt. In der Eigenschaft DataSource des datensensitiven Steuerelements kann die Datenquelle angegeben werden.

Handelt es sich bei dem Wert der Eigenschaft DataField eines Datenbank-Lookup-Kombinationsfeldes (TDBLookupComboBox) um einen Integer oder eine Gleitkommazahl, können nur die für ein solches Feld gültigen Zeichen in das Eingabefeld eingegeben werden. Ungültige Zeichen werden nicht akzeptiert.


DataSource

Mit der Eigenschaft DataSource können Sie bestimmen, wo die Komponente die anzuzeigenden Daten abrufen kann.

__property DataSource;

Beschreibung

Legen Sie die Datenquelle fest, die die entsprechende Datenmenge mit den Daten bezeichnet.


TDBLookupComboBox::DropDownAlign

TDBLookupComboBox	Siehe auch

Mit der Eigenschaft DropDownAlign können Sie festlegen, wie die Dropdown-Liste relativ zum Eingabefeld ausgerichtet wird.

__property TDropDownAlign DropDownAlign;

Beschreibung

Die Dropdown-Liste kann links, rechts oder zentriert zum Eingabefeld ausgerichtet werden.


TDBLookupComboBox::DropDownRows

TDBLookupComboBox	Siehe auch

Mit der Eigenschaft DropDownRows können Sie die Anzahl der Textzeilen festlegen, die in der Dropdown-Liste des Lookup-Kombinationsfeldes angezeigt werden.

__property int DropDownRows;

Beschreibung

Mit der Eigenschaft DropDownRows können Sie festlegen, wie viele Zeilen in der Dropdown-Liste des Kombinationsfeldes angezeigt werden.


TDBLookupComboBox::DropDownWidth

TDBLookupComboBox	Siehe auch

Mit der Eigenschaft DropDownWidth können Sie die Breite der Dropdown-Liste eines Kombinationsfeldes in Pixeln festlegen.

__property int DropDownWidth;

Beschreibung

Der Standardwert ist 0. Dies bedeutet, daß die Dropdown-Liste dieselbe Breite wie das Kombinationsfeld besitzt.

Mit Hilfe der Eigenschaft DropDownWidth können Sie mehrere Felder und somit mehrere Spalten im Datenbank-Lookup-Kombinationsfeld anzeigen.


Field

Mit der Eigenschaft Field können Sie die Komponente der Klasse TField ermitteln, mit der das Datenbank-Lookup-Kombinationsfeld verbunden ist.

Beschreibung

Mit der Eigenschaft Field können Sie die Daten des Feldes im Programm ändern.


TDBLookupComboBox::ListVisible

TDBLookupComboBox	Siehe auch

Mit der Eigenschaft ListVisible können Sie bestimmen, ob das Datenbank-Lookup-Kombinationsfeld geöffnet ist.

__property bool ListVisible;

Beschreibung

Hat ListVisible den Wert True, ist das Kombinationsfeld geöffnet. Andernfalls hat die Eigenschaft den Wert False.


TDBLookupComboBox::ReadOnly

TDBLookupComboBox	Siehe auch

Mit der Eigenschaft ReadOnly können Sie bestimmen, ob der Inhalt eines Datenbank-Lookup-Kombinationsfeldes geändert werden kann.

__property ReadOnly;

Beschreibung

Hat ReadOnly den Wert True, kann der Inhalt nicht geändert werden. Andernfalls kann der Inhalt geändert werden. Der Standardwert ist False.

Mit der Eigenschaft ReadOnly können Sie bestimmen, ob der Wert eines Feldes im aktuellen Datensatz mit dem Datenbank-Lookup-Kombinationsfeld geändert werden kann oder die Daten nur angezeigt werden können. Hat ReadOnly den Wert False, kann der Feldwert geändert werden, während sich die Datenmenge im Bearbeitungsmodus befindet.


TDBLookupComboBox::Text

TDBLookupComboBox	Siehe auch	Beispiel

Die Eigenschaft Text bezeichnet den Wert eines Feldes im aktuellen Datensatz.

__property System::AnsiString Text;

Beschreibung

Der Wert der Eigenschaft Text ist der erste Eintrag, der während der Ausführung der Anwendung im Kombinationsfeld angezeigt wird. Sie können den Wert von Text durch Eingabe eines neuen Wertes ändern, falls ReadOnly den Wert False hat und sich die Datenmenge im Bearbeitungsmodus befindet.


Ereignisse von TDBLookupComboBox

TDBLookupComboBox	Alphabetisch	Legende

In TDBLookupComboBox

OnCloseUp

OnDropDown

Abgeleitet von TWinControl

OnEnter

OnExit

OnKeyDown

OnKeyPress

OnKeyUp

Abgeleitet von TControl

OnClick

OnDragDrop

OnDragOver

OnEndDrag

OnMouseDown

OnMouseMove

OnMouseUp

OnStartDrag


Ereignisse von TDBLookupComboBox

TDBLookupComboBox	Nach Objekten	Legende

OnClick

OnCloseUp

OnDragDrop

OnDragOver

OnDropDown

OnEndDrag

OnEnter

OnExit

OnKeyDown

OnKeyPress

OnKeyUp

OnMouseDown

OnMouseMove

OnMouseUp

OnStartDrag


TDBLookupComboBox::OnCloseUp

TDBLookupComboBox	Siehe auch

Das Ereignis OnCloseUp wird ausgelöst, wenn die geöffnete DBLookupComboBox-Komponente geschlossen wird.

typedef void __fastcall (__closure *TNotifyEvent)(System::TObject* Sender);

__property Classes::TNotifyEvent OnCloseUp;

Beschreibung

Die Liste kann vom Benutzer oder mit der Methode CloseUp geschlossen werden.


TDBLookupComboBox::OnDropDown

TDBLookupComboBox	Siehe auch

Das Ereignis OnDropDown wird ausgelöst, wenn das Kombinationsfeld geöffnet wird.

__property Classes::TNotifyEvent OnDropDown;

Beschreibung

Die Liste kann vom Benutzer oder mit der Methode DropDown geöffnet werden.


Methoden von TDBLookupComboBox

TDBLookupComboBox	Alphabetisch

In TDBLookupComboBox

~TDBLookupComboBox

CloseUp

DropDown

TDBLookupComboBox

Abgeleitet von TWinControl

Broadcast

CanFocus

ContainsControl

ControlAtPos

DisableAlign

EnableAlign

Focused

GetTabOrderList

HandleAllocated

HandleNeeded

InsertControl

Invalidate

PaintTo

Realign

RemoveControl

Repaint

ScaleBy

ScrollBy

SetBounds

SetFocus

Update

UpdateControlState

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

GetTextLen

Hide

Perform

Refresh

ScreenToClient

SendToBack

SetTextBuf

Show

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TDBLookupComboBox

TDBLookupComboBox	Nach Objekten

~TDBLookupComboBox

Assign

BeginDrag

BringToFront

Broadcast

CanFocus

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

ClientToScreen

CloseUp

ContainsControl

ControlAtPos

DefaultHandler

DestroyComponents

Destroying

DisableAlign

Dispatch

DragDrop

Dragging

DropDown

EnableAlign

EndDrag

FieldAddress

FindComponent

Focused

FreeInstance

FreeNotification

Free

GetParentComponent

GetTabOrderList

GetTextBuf

GetTextLen

HandleAllocated

HandleNeeded

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InsertControl

InstanceSize

Invalidate

MethodAddress

MethodName

NewInstance

PaintTo

Perform

Realign

Refresh

RemoveComponent

RemoveControl

Repaint

ScaleBy

ScreenToClient

ScrollBy

SendToBack

SetBounds

SetFocus

SetTextBuf

Show

TDBLookupComboBox

UpdateControlState

Update


TDBLookupComboBox::~TDBLookupComboBox

TDBLookupComboBox	Siehe auch

Der Destruktor ~TDBLookupComboBox gibt den Speicher frei, der für das TDBLookupComboBox-Objekt reserviert war. Rufen Sie ~TDBLookupComboBox nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TDBLookupComboBox automatisch aufgerufen wird.

__fastcall virtual ~TDBLookupComboBox(void);

Beschreibung

~TDBLookupComboBox gibt die Hilfsobjekte des TDBLookupComboBox-Objekts frei, bevor der Destruktor seines übergeordneten Objekts aufgerufen wird.


TDBLookupComboBox::CloseUp

TDBLookupComboBox	Siehe auch

Mit der Methode CloseUp können Sie ein geöffnetes Datenbank-Lookup-Kombinationsfeld schließen.

void __fastcall CloseUp(bool Accept);

Beschreibung

Mit dem Parameter Accept können Sie bestimmen, ob der Wert von DataField durch den im Kombinationsfeld ausgewählten Wert ersetzt werden soll.

Beschreibung

Rufen Sie Destroy in einer Anwendung nicht direkt auf. Rufen Sie statt dessen Free auf. Mit Free wird überprüft, ob das Objekt der Klasse TDBLookupComboBox bereits freigegeben wurde. Nur wenn dies nicht der Fall ist, wird Destroy aufgerufen.

Bevor der geerbte Destruktor aufgerufen wird, können Sie mit Destroy die Hilfsobjekte der TDBLookupComboBox-Komponente freigeben.


TDBLookupComboBox::DropDown

TDBLookupComboBox	Siehe auch

Mit der Methode DropDown können Sie das Datenbank-Lookup-Kombinationsfeld öffnen, damit der Benutzer Werte in einer Liste auswählen kann.

void __fastcall DropDown(void);

Beschreibung

Sobald die Liste geöffnet wird, wird das Ereignis OnDropDown ausgelöst.


TDBLookupComboBox::TDBLookupComboBox

TDBLookupComboBox	Siehe auch

Der Konstruktor TDBLookupComboBox erzeugt ein neues TDBLookupComboBox-Objekt.

__fastcall virtual TDBLookupComboBox(Classes::TComponent* AOwner);

Beschreibung

Mit TDBLookupComboBox wird zur Laufzeit ein TDBLookupComboBox-Objekt instantiiert. Für alle Objekte dieses Typs, die während des Entwurfs in Formularen oder Datenmodulen plaziert wurden, wird TDBLookupComboBox automatisch aufgerufen.

Zuerst wird der Konstruktor des übergeordneten Objekts aufgerufen, um ein generisches Listenfeld zu initialisieren und mit Speicher zu versehen. TDBLookupComboBox erzeugt dann ein TPopupDataList-Objekt sowie initialisierte Hilfsobjekte, mit denen die Verknüpfung zu einer Datenmenge hergestellt wird.


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TControl

TWinControl

TCustomControl

TDBLookupControl


TDBLookupComboBox Beispiel

TDBLookupComboBox


TDBLookupControl

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/dbctrls.hpp

TDBLookupControl ist eine abstrakte Klasse. Aus ihr werden Objekte abgeleitet, die dem Benutzer komfortable Listen mit Lookup-Einträgen zur Verfügung stellen. Mit diesen Einträgen können Felder ausgefüllt werden, die Daten aus einer anderen Datenmenge benötigen.

Beschreibung

TDBLookupComboBox- und TDBLookupListBox-Steuerelemente werden aus TDBLookupControl abgeleitet und bieten dem Benutzer die automatischen Lookup-Möglichkeiten, die in der Klasse TDBLookupControl implementiert sind. Normalerweise werden neue Steuerelemente aus TDBLookupControl abgeleitet und keine Instanzen der Klasse erstellt.


Eigenschaften von TDBLookupControl

TDBLookupControl	Alphabetisch	Legende

In TDBLookupControl

DataField

DataSource

Field

KeyField

KeyValue

ListField

ListFieldIndex

ListSource

ReadOnly

Abgeleitet von TWinControl

Brush

ClientOrigin

ClientRect

ControlCount

Controls

Handle

HelpContext

ParentWindow

Showing

TabOrder

TabStop

Abgeleitet von TControl

Align

BoundsRect

ClientHeight

ClientWidth

ControlState

ControlStyle

Cursor

Enabled

Height

Hint

Left

Name

Parent

ParentColor

ShowHint

Top

Visible

Width

WindowProc

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TDBLookupControl

TDBLookupControl	Nach Objekten	Legende

Align

BoundsRect

Brush

ClientHeight

ClientOrigin

ClientRect

ClientWidth

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlCount

ControlState

Controls

ControlStyle

Cursor

DataField

DataSource

DesignInfo

Enabled

Field

Handle

Height

HelpContext

Hint

KeyField

KeyValue

Left

ListFieldIndex

ListField

ListSource

Name

Owner

ParentColor

Parent

ParentWindow

ReadOnly

ShowHint

Showing

TabOrder

TabStop

Tag

Top

Visible

Width

WindowProc


TDBLookupControl::DataField

TDBLookupControl	Siehe auch

Die Eigenschaft DataField bezeichnet das Feld, dessen Daten im datensensitiven Steuerelement angezeigt werden.

__property System::AnsiString DataField;

Beschreibung

Die Datenmenge, in der sich das Feld befindet, wird in einer Datenquelle (TDataSource) festgelegt. In der Eigenschaft DataSource des datensensitiven Steuerelements kann die Datenquelle angegeben werden.

Handelt es sich bei dem Wert von DataField in einem abgeleiteten Datenbank-Lookup-Steuerelement um einen Integer oder eine Gleitkommazahl, können nur die für ein solches Feld gültigen Zeichen in das Eingabefeld eingegeben werden. Ungültige Zeichen werden nicht akzeptiert.


TDBLookupControl::DataSource

TDBLookupControl	Siehe auch

Mit der Eigenschaft DataSource können Sie bestimmen, wo die Komponente die anzuzeigenden Daten abruft.

__property Db::TDataSource* DataSource;

Beschreibung

Geben Sie die Datenquellenkomponente an, die die Datenmenge mit den Daten bezeichnet.


TDBLookupControl::Field

TDBLookupControl	Siehe auch

Mit der Eigenschaft Field können Sie das Objekt der Klasse TField ermitteln, mit dem das datensensitive Steuerelement verbunden ist.

void __fastcall DataLinkRecordChanged(Db::TField* Field);

Beschreibung

Mit der Eigenschaft Field können Sie die Daten des Feldes im Programm ändern.


TDBLookupControl::KeyField

TDBLookupControl	Siehe auch

Die Eigenschaft KeyField bezeichnet das Feld der Datenmenge ListSource, das mit dem Feld von DataField übereinstimmt.

__property System::AnsiString KeyField;

Beschreibung

Nachdem Sie einen Eintrag im Steuerelement ausgewählt haben, wird der Wert des KeyField-Feldes abgerufen, das dem ausgewählten Eintrag entspricht. Handelt es sich beim DataField-Feld um ein Lookup-Feld, müssen Sie für KeyField keinen Wert angeben. Das Steuerelement verwendet automatisch das LookupKeyFields-Feld des Lookup-Feldes für KeyField.


TDBLookupControl::KeyValue

TDBLookupControl	Siehe auch

Die Eigenschaft KeyValue enthält den Wert des KeyField-Feldes.

__property System::Variant KeyValue;

Beschreibung

Mit dieser Eigenschaft können Sie in der Datenmenge von ListSource einen übereinstimmenden Datensatz suchen und anzeigen.


TDBLookupControl::ListField

TDBLookupControl	Siehe auch

Die Eigenschaft ListField bezeichnet das Feld oder die Felder (durch Semikolons getrennt), deren Werte in den Steuerelementen angezeigt werden.

__property System::AnsiString ListField;

Beschreibung

Wenn Sie ListField nicht setzen, werden in den Steuerelementen standardmäßig die Werte der KeyField-Felder angezeigt. Handelt es sich beim DataField-Feld um ein Lookup-Feld, müssen Sie für ListField keinen Wert angeben. In den Steuerelementen wird für ListField automatisch die Eigenschaft LookupResultField des Lookup-Feldes verwendet.


TDBLookupControl::ListFieldIndex

TDBLookupControl	Siehe auch

Die Eigenschaft ListFieldIndex gibt an, welches Feld in der Eigenschaft ListField für die inkrementelle Suche verwendet wird.

__property int ListFieldIndex;

Beschreibung

Für die Komponente DBLookupComboBox kann mit ListFieldIndex auch festgelegt werden, welches Feld im Eingabefeld des Kombinationsfeldes angezeigt wird.


TDBLookupControl::ListSource

TDBLookupControl	Siehe auch

Die Eigenschaft ListSource bezeichnet eine Datenquelle für die Daten, die in den Steuerelementen angezeigt werden.

__property Db::TDataSource* ListSource;

Beschreibung

Handelt es sich bei dem DataField-Feld um ein Lookup-Feld, müssen Sie für ListSource keinen Wert angeben. In den Steuerelementen wird eine Datenquelle automatisch mit der Eigenschaft LookupDataSet des Lookup-Feldes erstellt.


TDBLookupControl::ReadOnly

TDBLookupControl	Siehe auch

Mit der Eigenschaft ReadOnly können Sie bestimmen, ob der Inhalt des Steuerelements geändert werden kann.

__property bool ReadOnly;

Beschreibung

Hat ReadOnly den Wert True, kann der Inhalt nicht geändert werden. Andernfalls kann der Inhalt geändert werden. Der Standardwert ist False.

Bei datensensitiven Steuerelementen können Sie mit der Eigenschaft ReadOnly bestimmen, ob der Wert eines Feldes des aktuellen Datensatzes geändert werden kann oder die Daten nur angezeigt werden können. Hat ReadOnly den Wert False, kann der Feldwert geändert werden, während sich die Datenmenge im Bearbeitungsmodus befindet.

Hat die Eigenschaft ReadOnly eines Datengitters den Wert True, können Sie weder mit der Taste EINFG eine nue Zeile in das Gitter einfügen noch mit der Taste AB eine neue Zeile am Ende des Datengitters anfügen.


Methoden von TDBLookupControl

TDBLookupControl	Alphabetisch

In TDBLookupControl

~TDBLookupControl

TDBLookupControl

Abgeleitet von TWinControl

Broadcast

CanFocus

ContainsControl

ControlAtPos

DisableAlign

EnableAlign

Focused

GetTabOrderList

HandleAllocated

HandleNeeded

InsertControl

Invalidate

PaintTo

Realign

RemoveControl

Repaint

ScaleBy

ScrollBy

SetBounds

SetFocus

Update

UpdateControlState

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

GetTextLen

Hide

Perform

Refresh

ScreenToClient

SendToBack

SetTextBuf

Show

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TDBLookupControl

TDBLookupControl	Nach Objekten

~TDBLookupControl

Assign

BeginDrag

BringToFront

Broadcast

CanFocus

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

ClientToScreen

ContainsControl

ControlAtPos

DefaultHandler

DestroyComponents

Destroying

DisableAlign

Dispatch

DragDrop

Dragging

EnableAlign

EndDrag

FieldAddress

FindComponent

Focused

FreeInstance

FreeNotification

Free

GetParentComponent

GetTabOrderList

GetTextBuf

GetTextLen

HandleAllocated

HandleNeeded

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InsertControl

InstanceSize

Invalidate

MethodAddress

MethodName

NewInstance

PaintTo

Perform

Realign

Refresh

RemoveComponent

RemoveControl

Repaint

ScaleBy

ScreenToClient

ScrollBy

SendToBack

SetBounds

SetFocus

SetTextBuf

Show

TDBLookupControl

UpdateControlState

Update


TDBLookupControl::~TDBLookupControl

TDBLookupControl	Siehe auch

Der Destruktor ~TDBLookupControl gibt den Speicher frei, der für das TDBLookupControl-Objekt reserviert war. Rufen Sie ~TDBLookupControl nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TDBLookupControl automatisch aufgerufen wird.

__fastcall virtual ~TDBLookupControl(void);

Beschreibung

Bevor der Destruktor des übergeordneten Objekts aufgerufen wird, gibt ~TDBLookupControl die Hilfsobjekte des TDBLookupControl-Objekts frei.


TDBLookupControl::TDBLookupControl

TDBLookupControl	Siehe auch

Der Konstruktor TDBLookupControl erzeugt ein neues TDBLookupControl-Objekt.

__fastcall virtual TDBLookupControl(Classes::TComponent* AOwner);

Beschreibung

Mit TDBLookupControl können Sie zur Laufzeit ein TDBLookupControl-Objekt erzeugen. Für TDBLookupControl-Objekte, die Sie zur Entwurfszeit in ein Formular oder Datenmodul einfügen, wird TDBLookupControl automatisch aufgerufen.

Nach dem Aufruf des Konstruktors des übergeordneten Objekts, der ein generisches Objekt erzeugt und ihm Speicher zuweist, erzeugt und initialisiert TDBLookupControl die Hilfsobjekte, die für die Verknüpfung mit einer Datenmenge benötigt werden.


Gültigkeitsbereich

Protected

Published

Zugriff

Read-only


Hierarchie

TObject

TPersistent

TComponent

TControl

TWinControl

TCustomControl


TDBLookupControl Beispiel

TDBLookupControl


 TDBLookupListBox

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/dbctrls.hpp

Ein TDBLookupListBox-Objekt stellt dem Benutzer eine Liste mit Einträgen zur Verfügung, mit denen er Felder ausfüllen kann, die Daten aus einer anderen Datenmenge benötigen.

Beschreibung

Setzen Sie die Eigenschaft DataSource auf die Datenquelle, die als Ziel für die vom Benutzer ausgewählten Daten dient. Weisen Sie DataField entweder das Feld zu, das die Daten empfangen soll, oder ein Lookup-Feld. Im letzteren Fall brauchen Sie keine anderen Eigenschaften zu setzen, da das TDBLookupListBox-Objekt die benötigten Einstellungen vom Lookup-Feld übernimmt.

Weisen Sie der Eigenschaft ListSource die Datenquelle der Tabelle zu, die die Lookup-Elemente enthält. Setzen Sie KeyField auf das Feld, dessen Daten in das Feld der Eigenschaft DataField kopiert werden sollen. Wenn im Listenfeld nicht das Feld der Eigenschaft KeyField, sondern ein anderes Feld angezeigt werden soll, weisen Sie dieses der Eigenschaft ListField zu.


Eigenschaften von TDBLookupListBox

TDBLookupListBox	Alphabetisch	Legende

In TDBLookupListBox

BorderStyle

ReadOnly

RowCount

Abgeleitet von TDBLookupControl

DataField

DataSource

KeyField

KeyValue

ListField

ListFieldIndex

ListSource

Abgeleitet von TWinControl

Brush

ClientOrigin

ClientRect

ControlCount

Controls

Ctl3D

Handle

HelpContext

ParentCtl3D

Showing

TabOrder

TabStop

Abgeleitet von TControl

Align

BoundsRect

ClientHeight

ClientWidth

Color

ControlState

ControlStyle

Cursor

DragCursor

DragMode

Enabled

Font

Height

Hint

Left

Name

Parent

ParentColor

ParentFont

ParentShowHint

PopupMenu

ShowHint

Top

Visible

Width

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TDBLookupListBox

TDBLookupListBox	Nach Objekten	Legende

Align

BorderStyle

BoundsRect

Brush

ClientHeight

ClientOrigin

ClientRect

ClientWidth

Color

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlCount

ControlState

Controls

ControlStyle

Ctl3D

Cursor

DataField

DataSource

DesignInfo

DragCursor

DragMode

Enabled

Font

Handle

Height

HelpContext

Hint

KeyField

KeyValue

Left

ListFieldIndex

ListField

ListSource

Name

Owner

ParentColor

ParentCtl3D

ParentFont

ParentShowHint

Parent

PopupMenu

ReadOnly

RowCount

ShowHint

Showing

TabOrder

TabStop

Tag

Top

Visible

Width


TDBLookupListBox::BorderStyle

TDBLookupListBox	Siehe auch	Beispiel

Die Eigenschaft BorderStyle gibt an, ob das Lookup-Listenfeld über einen Rahmen verfügt.

__property Forms::TBorderStyle BorderStyle;

Beschreibung

Die möglichen Werte für diese Eigenschaft sind:

Wert	Bedeutung

bsNone	Kein sichtbarer Rahmen

bsSingle	Einfacher Rahmen


TDBLookupListBox::ReadOnly

TDBLookupListBox	Siehe auch

Die Eigenschaft ReadOnly legt fest, ob der Benutzer den Inhalt des Lookup-Listenfeldes ändern kann.

__property ReadOnly;

Beschreibung

Wenn ReadOnly den Wert True hat, kann der Benutzer den Inhalt nicht ändern. Wenn ReadOnly False ist, kann der Benutzer den Inhalt ändern. Der Standardwert ist False.

ReadOnly legt fest, ob der Benutzer das Lookup-Listenfeld dazu verwenden kann, den Wert des Feldes im aktuellen Datensatz zu ändern, oder ob der Wert nur angezeigt wird. Wenn ReadOnly False ist, kann der Benutzer den Wert des Feldes ändern, solange sich die Datenmenge im Bearbeitungsmodus befindet.


TDBLookupListBox::RowCount

TDBLookupListBox	Siehe auch

Die Eigenschaft RowCount legt fest, wieviele Zeilen im Listenfeld sichtbar sind.

__property int RowCount;

Beschreibung

Wenn Sie dieser Eigenschaft einen Wert zuweisen, paßt sich die Größe des Listenfeldes der angegebenen Zeilenanzahl an. Analog dazu wird bei jeder €nderung der Größe des Listenfeldes (beispielsweise durch Zuweisung eines neuen Wertes an die Eigenschaft Height) die Eigenschaft RowCount an die neue Höhe angepaßt.


Ereignisse von TDBLookupListBox

TDBLookupListBox	Alphabetisch	Legende

Abgeleitet von TWinControl

OnEnter

OnExit

OnKeyDown

OnKeyPress

OnKeyUp

Abgeleitet von TControl

OnClick

OnDblClick

OnDragDrop

OnDragOver

OnEndDrag

OnMouseDown

OnMouseMove

OnMouseUp

OnStartDrag


Ereignisse von TDBLookupListBox

TDBLookupListBox	Nach Objekten	Legende

OnClick

OnDblClick

OnDragDrop

OnDragOver

OnEndDrag

OnEnter

OnExit

OnKeyDown

OnKeyPress

OnKeyUp

OnMouseDown

OnMouseMove

OnMouseUp

OnStartDrag


Methoden von TDBLookupListBox

TDBLookupListBox	Alphabetisch

In TDBLookupListBox

~TDBLookupListBox

TDBLookupListBox

Abgeleitet von TWinControl

Broadcast

CanFocus

ContainsControl

ControlAtPos

DisableAlign

EnableAlign

Focused

GetTabOrderList

HandleAllocated

HandleNeeded

InsertControl

Invalidate

PaintTo

Realign

RemoveControl

Repaint

ScaleBy

ScrollBy

SetBounds

SetFocus

Update

UpdateControlState

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

GetTextLen

Hide

Perform

Refresh

ScreenToClient

SendToBack

SetTextBuf

Show

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TDBLookupListBox

TDBLookupListBox	Nach Objekten

~TDBLookupListBox

Assign

BeginDrag

BringToFront

Broadcast

CanFocus

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

ClientToScreen

ContainsControl

ControlAtPos

DefaultHandler

DestroyComponents

Destroying

DisableAlign

Dispatch

DragDrop

Dragging

EnableAlign

EndDrag

FieldAddress

FindComponent

Focused

FreeInstance

FreeNotification

Free

GetParentComponent

GetTabOrderList

GetTextBuf

GetTextLen

HandleAllocated

HandleNeeded

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InsertControl

InstanceSize

Invalidate

MethodAddress

MethodName

NewInstance

PaintTo

Perform

Realign

Refresh

RemoveComponent

RemoveControl

Repaint

ScaleBy

ScreenToClient

ScrollBy

SendToBack

SetBounds

SetFocus

SetTextBuf

Show

TDBLookupListBox

UpdateControlState

Update


TDBLookupListBox::~TDBLookupListBox

TDBLookupListBox

Der Destruktor ~TDBLookupListBox gibt den Speicher frei, der für das TDBLookupListBox-Objekt reserviert war. Rufen Sie ~TDBLookupListBox nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TDBLookupListBox automatisch aufgerufen wird.

__fastcall virtual ~TDBLookupListBox(void);


TDBLookupListBox::TDBLookupListBox

TDBLookupListBox	Siehe auch

Die Methode erzeugt eine Instanz von TDBLookupListBox.

__fastcall virtual TDBLookupListBox(Classes::TComponent* AOwner);

Beschreibung

Mit dieser Methode können Sie zur Laufzeit ein TDBLookupListBox-Objekt erzeugen. Für TDBLookupListBox-Objekte, die zur Entwurfszeit in Formulare oder Datenmodule eingefügt werden, wird Create automatisch aufgerufen.

Nach dem Aufruf des geerbten Konstruktors, der ein generisches Lookup-Element erzeugt und ihm Speicher zuweist, erzeugt und initialisiert TDBLookupListBox die für die Verknüpfung mit einer Datenmenge benötigten Hilfsobjekte.


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TControl

TWinControl

TCustomControl

TDBLookupControl


TDBLookupListBox Beispiel

TDBLookupListBox


TLoginDialog

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/dblogdlg.hpp

TLoginDialog ist ein Login-Dialogfeld, das innerhalb der Anwendung sicherstellt, daß sich Benutzer ordnungsgemäß anmelden.

Beschreibung

Mit TLoginDialog können Sie für Anmeldesicherheit innerhalb einer Anwendung sorgen. Ein TLoginDialog-Objekt wird normalerweise durch einen Aufruf der Funktion LoginDialogEx erzeugt und dient dazu, den Zugriff auf lokale Datenbanktabellen abzusichern. Sie können TLoginDialog jedoch auch als Basisobjekt für andere Arten von Login-Dialogfeldern verwenden.


Eigenschaften von TLoginDialog

TLoginDialog	Alphabetisch	Legende

Abgeleitet von TForm

Active

ActiveControl

ActiveMDIChild

ActiveOleControl

BorderIcons

BorderStyle

Canvas

ClientHandle

ClientHeight

ClientWidth

Designer

DropTarget

FormStyle

Icon

KeyPreview

MDIChildCount

MDIChildren

Menu

ModalResult

ObjectMenuItem

OleFormObject

PixelsPerInch

Position

PrintScale

Scaled

TileMode

Visible

WindowMenu

WindowState

Abgeleitet von TScrollingWinControl

AutoScroll

HorzScrollBar

VertScrollBar

Abgeleitet von TWinControl

Brush

ClientOrigin

ControlCount

Controls

Ctl3D

Handle

HelpContext

Showing

TabOrder

TabStop

Abgeleitet von TControl

Align

BoundsRect

Caption

ClientRect

Color

ControlState

ControlStyle

Cursor

Enabled

Font

Height

Hint

Left

Name

PopupMenu

ShowHint

Top

Width

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TLoginDialog

TLoginDialog	Nach Objekten	Legende

ActiveControl

ActiveMDIChild

ActiveOleControl

Active

Align

AutoScroll

BorderIcons

BorderStyle

BoundsRect

Brush

Canvas

Caption

ClientHandle

ClientHeight

ClientOrigin

ClientRect

ClientWidth

Color

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlCount

ControlState

Controls

ControlStyle

Ctl3D

Cursor

Designer

DesignInfo

DropTarget

Enabled

Font

FormStyle

Handle

Height

HelpContext

Hint

HorzScrollBar

Icon

KeyPreview

Left

MDIChildCount

MDIChildren

Menu

ModalResult

Name

ObjectMenuItem

OleFormObject

Owner

PixelsPerInch

PopupMenu

Position

PrintScale

Scaled

ShowHint

Showing

TabOrder

TabStop

Tag

TileMode

Top

VertScrollBar

Visible

Width

WindowMenu

WindowState


Ereignisse von TLoginDialog

TLoginDialog	Alphabetisch	Legende

Abgeleitet von TForm

OnActivate

OnClose

OnCloseQuery

OnCreate

OnDeactivate

OnDestroy

OnHide

OnPaint

OnResize

OnShow

Abgeleitet von TWinControl

OnKeyDown

OnKeyPress

OnKeyUp

Abgeleitet von TControl

OnClick

OnDblClick

OnDragDrop

OnDragOver

OnMouseDown

OnMouseMove

OnMouseUp


Ereignisse von TLoginDialog

TLoginDialog	Nach Objekten	Legende

OnActivate

OnClick

OnCloseQuery

OnClose

OnCreate

OnDblClick

OnDeactivate

OnDestroy

OnDragDrop

OnDragOver

OnHide

OnKeyDown

OnKeyPress

OnKeyUp

OnMouseDown

OnMouseMove

OnMouseUp

OnPaint

OnResize

OnShow


Methoden von TLoginDialog

TLoginDialog	Alphabetisch

In TLoginDialog

~TLoginDialog

TLoginDialog

Abgeleitet von TForm

ArrangeIcons

Cascade

Close

CloseQuery

DefocusControl

FocusControl

GetFormImage

Hide

Next

Previous

Print

Release

SendCancelMode

SetFocus

SetFocusedControl

Show

ShowModal

Tile

Abgeleitet von TScrollingWinControl

ScrollInView

Abgeleitet von TWinControl

Broadcast

CanFocus

ContainsControl

ControlAtPos

DisableAlign

EnableAlign

Focused

GetTabOrderList

HandleAllocated

HandleNeeded

InsertControl

Invalidate

PaintTo

Realign

RemoveControl

Repaint

ScaleBy

ScrollBy

SetBounds

Update

UpdateControlState

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

GetTextLen

Perform

Refresh

ScreenToClient

SendToBack

SetTextBuf

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TLoginDialog

TLoginDialog	Nach Objekten

~TLoginDialog

ArrangeIcons

Assign

BeginDrag

BringToFront

Broadcast

CanFocus

Cascade

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

ClientToScreen

CloseQuery

Close

ContainsControl

ControlAtPos

DefaultHandler

DefocusControl

DestroyComponents

Destroying

DisableAlign

Dispatch

DragDrop

Dragging

EnableAlign

EndDrag

FieldAddress

FindComponent

FocusControl

Focused

FreeInstance

FreeNotification

Free

GetFormImage

GetParentComponent

GetTabOrderList

GetTextBuf

GetTextLen

HandleAllocated

HandleNeeded

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InsertControl

InstanceSize

Invalidate

MethodAddress

MethodName

NewInstance

Next

PaintTo

Perform

Previous

Print

Realign

Refresh

Release

RemoveComponent

RemoveControl

Repaint

ScaleBy

ScreenToClient

ScrollBy

ScrollInView

SendCancelMode

SendToBack

SetBounds

SetFocusedControl

SetFocus

SetTextBuf

ShowModal

Show

Tile

TLoginDialog

UpdateControlState

Update


TLoginDialog::~TLoginDialog

TLoginDialog

Der Destruktor ~TLoginDialog gibt den Speicher frei, der für das TLoginDialog-Objekt reserviert war. Rufen Sie ~TLoginDialog nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TLoginDialog automatisch aufgerufen wird.

__fastcall virtual ~TLoginDialog(void);


TLoginDialog::TLoginDialog

TLoginDialog

Der Konstruktor TLoginDialog erzeugt ein neues TLoginDialog-Objekt.

__fastcall virtual TLoginDialog(Classes::TComponent* AOwner);


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TControl

TWinControl

TScrollingWinControl

TForm


TLoginDialog Beispiel

TLoginDialog


 TDBMemo

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/dbctrls.hpp

Ein TDBMemo-Objekt ist ein mehrzeiliges Eingabefeld, in dem ein Feld einer Datenmenge angezeigt und bearbeitet werden kann.

Beschreibung

Mit diesem Objekt können Sie den Benutzer ein Feld bearbeiten lassen, das umfangreichen Text enthält, oder einfach nur den Feldinhalt anzeigen. Die Eigenschaft Text des TDBMemo-Objekts repräsentiert den Inhalt des Feldes.

TDBMemo unterstützt mehrzeilige Texte. Daher eignet sich dieses Objekt für lange alphanumerische Felder oder Text-BLOBs. Für kurze alphanumerische Felder bietet sich die Verwendung einer TDBEdit-Komponente an.

Wenn die datensensitiven Eigenschaften einer TDBMemo-Komponente nicht benötigt werden, verwenden Sie statt dessen ein Memo-Eingabefeld (TMemo), um Systemressourcen zu sparen.


Eigenschaften von TDBMemo

TDBMemo	Alphabetisch	Legende

In TDBMemo

AutoDisplay

DataField

DataSource

Field

ReadOnly

Abgeleitet von TCustomMemo

Alignment

Lines

ScrollBars

WantTabs

WordWrap

Abgeleitet von TCustomEdit

BorderStyle

MaxLength

Modified

SelLength

SelStart

SelText

Abgeleitet von TWinControl

Brush

ClientOrigin

ClientRect

ControlCount

Controls

Ctl3D

Handle

HelpContext

ParentCtl3D

Showing

TabOrder

TabStop

Abgeleitet von TControl

Align

BoundsRect

ClientHeight

ClientWidth

Color

ControlState

ControlStyle

Cursor

DragCursor

DragMode

Enabled

Font

Height

Hint

Left

Name

Parent

ParentColor

ParentFont

ParentShowHint

PopupMenu

ShowHint

Text

Top

Visible

Width

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TDBMemo

TDBMemo	Nach Objekten	Legende

Alignment

Align

AutoDisplay

BorderStyle

BoundsRect

Brush

ClientHeight

ClientOrigin

ClientRect

ClientWidth

Color

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlCount

ControlState

Controls

ControlStyle

Ctl3D

Cursor

DataField

DataSource

DesignInfo

DragCursor

DragMode

Enabled

Field

Font

Handle

Height

HelpContext

Hint

Left

Lines

MaxLength

Modified

Name

Owner

ParentColor

ParentCtl3D

ParentFont

ParentShowHint

Parent

PopupMenu

ReadOnly

ScrollBars

SelLength

SelStart

SelText

ShowHint

Showing

TabOrder

TabStop

Tag

Text

Top

Visible

WantTabs

Width

WordWrap


TDBMemo::AutoDisplay

TDBMemo	Siehe auch

Die Eigenschaft AutoDisplay legt fest, ob der Inhalt eines Memofeldes oder graphischen BLOBs in einem Datenbank-Memofeld automatisch angezeigt wird.

__property bool AutoDisplay;

Beschreibung

Wenn AutoDisplay den Wert True hat, zeigt das Steuerelement bei €nderungen am zugrundeliegenden BLOB-Feld (wenn beispielsweise ein anderer Datensatz angezeigt wird) automatisch die neuen Daten an.

Ist AutoDisplay dagegen False, wird bei €nderungen am BLOB-Feld nur der Feldname angezeigt. Um sich die Daten anzeigen zu lassen, kann der Benutzer entweder auf das Eingabefeld doppelklicken oder es markieren und EINGABE drücken.

Die Auswirkungen von AutoDisplay sind nicht nur kosmetischer Natur. Die von TDBMemo angezeigten Daten entsprechen dem Wert der Eigenschaft Text. Wenn AutoDisplay bei €nderungen an den Daten den Wert False hat, nimmt diese Eigenschaft den Namen des Feldes an. In diesem Fall sollte die Eigenschaft Text also nur mit Vorsicht dazu verwendet werden, den Wert des zugrundeliegenden Feldes zu ermitteln.

Der Aufruf der Methode LoadMemo bewirkt, daß die Eigenschaft Text mit dem aktuellen Wert des BLOB-Feldes aktualisiert wird. Diese €nderung beeinflußt auch auf die Darstellung des Eingabefeldes auf dem Bildschirm.

Weisen Sie AutoDisplay den Wert False zu, wenn das automatische Laden des BLOB-Feldes zuviel Zeit in Anspruch nimmt.

Hinweis

AutoDisplay wirkt sich nur bei BLOB-Feldern aus. Wenn das Eingabefeld mit einem anderen Textfeldtyp verknüpft ist, zeigt AutoDisplay keine Wirkung.


TDBMemo::DataField

TDBMemo	Siehe auch

Die Eigenschaft DataField gibt den Namen des Feldes an, dessen Daten anzeigt werden.

__property System::AnsiString DataField;

Beschreibung

Mit DataField können Sie das Memo-Eingabefeld mit einem Feld der Datenmenge verknüpfen. Die Zuweisung eines Wertes an diese Eigenschaft bewirkt allerdings für sich noch keine Verknüpfung mit einem Datenbankfeld. Damit diese zustandekommt, muß zusätzlich in der Eigenschaft DataSource die Datenmenge angegeben werden, die das Feld enthält.


TDBMemo::DataSource

TDBMemo	Siehe auch

Über die Eigenschaft DataSource wird das Memofeld mit der Datenmenge verknüpft, die das Feld mit den darzustellenden Daten enthält.

__property Db::TDataSource* DataSource;

Beschreibung

Indem Sie dieser Eigenschaft eine Datenquelle zuweisen, wird das Memo-Eingabefeld mit der gewünschten Datenmenge verknüpft. In der Eigenschaft DataField geben Sie an, welches Feld der Datenmenge die Memodaten enthält.


TDBMemo::Field

TDBMemo	Siehe auch

Die Eigenschaft Field gibt die TField-Komponente an, mit der das Datenbankmemo verknüpft ist.

__property Db::TField* Field;

Beschreibung

Mit einem Lesezugriff auf diese Eigenschaft können Sie direkt auf den Inhalt und die Eigenschaften des Datenbankfeldes zugreifen, ohne das Bearbeitungsfenster zu aktivieren. Über die Eigenschaft Field können Sie den Inhalt des Datenbankfeldes aus der Anwendung heraus ändern.

Mit der Eigenschaft Text können Sie statt dessen den Inhalt des Memo-Eingabefeldes ändern, ohne die €nderungen sofort in den Datensatz der Datenmenge zu übernehmen. €nderungen an dieser Eigenschaft ermöglichen es dem Benutzer, die €nderungen zu verwerfen.


TDBMemo::ReadOnly

TDBMemo	Siehe auch

Die Eigenschaft ReadOnly legt fest, ob der Inhalt des Datenbankmemos vom Benutzer geändert werden kann.

__property bool ReadOnly;

Beschreibung

Wenn ReadOnly den Wert True hat, kann der Benutzer den Inhalt nicht ändern. Wenn ReadOnly den Wert False hat, kann der Benutzer den Inhalt ändern.

Die Eigenschaft legt fest, ob der Benutzer das DBMemo-Objekt dazu verwenden kann, den Wert des Feldes im aktuellen Datensatz zu ändern, oder ob der Wert nur angezeigt wird. Wenn ReadOnly False ist, kann der Benutzer den Wert des Feldes ändern, solange sich die Datenmenge im Bearbeitungsmodus befindet.


Ereignisse von TDBMemo

TDBMemo	Alphabetisch	Legende

Abgeleitet von TCustomEdit

OnChange

Abgeleitet von TWinControl

OnEnter

OnExit

OnKeyDown

OnKeyPress

OnKeyUp

Abgeleitet von TControl

OnClick

OnDblClick

OnDragDrop

OnDragOver

OnEndDrag

OnMouseDown

OnMouseMove

OnMouseUp

OnStartDrag


Ereignisse von TDBMemo

TDBMemo	Nach Objekten	Legende

OnChange

OnClick

OnDblClick

OnDragDrop

OnDragOver

OnEndDrag

OnEnter

OnExit

OnKeyDown

OnKeyPress

OnKeyUp

OnMouseDown

OnMouseMove

OnMouseUp

OnStartDrag


Methoden von TDBMemo

TDBMemo	Alphabetisch	Legende

In TDBMemo

~TDBMemo

Change

KeyDown

KeyPress

LoadMemo

Notification

TDBMemo

WndProc

Abgeleitet von TCustomEdit

Clear

ClearSelection

CopyToClipboard

CutToClipboard

GetSelTextBuf

PasteFromClipboard

SelectAll

SetSelTextBuf

Abgeleitet von TWinControl

Broadcast

CanFocus

ContainsControl

ControlAtPos

DisableAlign

EnableAlign

Focused

GetTabOrderList

HandleAllocated

HandleNeeded

InsertControl

Invalidate

PaintTo

Realign

RemoveControl

Repaint

ScaleBy

ScrollBy

SetBounds

SetFocus

Update

UpdateControlState

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

GetTextLen

Hide

Perform

Refresh

ScreenToClient

SendToBack

SetTextBuf

Show

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TDBMemo

TDBMemo	Nach Objekten	Legende

~TDBMemo

Assign

BeginDrag

BringToFront

Broadcast

CanFocus

Change

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

ClearSelection

Clear

ClientToScreen

ContainsControl

ControlAtPos

CopyToClipboard

CutToClipboard

DefaultHandler

DestroyComponents

Destroying

DisableAlign

Dispatch

DragDrop

Dragging

EnableAlign

EndDrag

FieldAddress

FindComponent

Focused

FreeInstance

FreeNotification

Free

GetParentComponent

GetSelTextBuf

GetTabOrderList

GetTextBuf

GetTextLen

HandleAllocated

HandleNeeded

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InsertControl

InstanceSize

Invalidate

KeyDown

KeyPress

LoadMemo

MethodAddress

MethodName

NewInstance

Notification

PaintTo

PasteFromClipboard

Perform

Realign

Refresh

RemoveComponent

RemoveControl

Repaint

ScaleBy

ScreenToClient

ScrollBy

SelectAll

SendToBack

SetBounds

SetFocus

SetSelTextBuf

SetTextBuf

Show

TDBMemo

UpdateControlState

Update

WndProc


TDBMemo::Change

TDBMemo	Siehe auch

Die Methode Change informiert die Datenquelle über €nderungen am Text, bevor die Ereignisbehandlungsroutine für OnChange aufgerufen wird.

virtual void __fastcall Change(void);

Beschreibung

Diese Methode wird von Anwendungen nicht direkt aufgerufen. Sie wird durch Windows-Ereignisse automatisch ausgelöst. Change kann von abgeleiteten Klassen überschrieben werden, um auf €nderungen der Eigenschaft Text mit zusätzlichen Aktionen zu reagieren. Jede Klasse, die Change überschreibt, sollte auch die geerbte Methode aufrufen.


TDBMemo::~TDBMemo

TDBMemo	Siehe auch

Die Methode ~TDBMemo löst eine Instanz eines TDBMemo-Objekts auf.

__fastcall virtual ~TDBMemo(void);

Beschreibung

Rufen Sie ~TDBMemo in einer Anwendung nicht direkt auf. Verwenden Sie statt dessen Free. Free überprüft, ob das TDBMemo-Objekt nicht bereits freigegeben wurde, und ruft nur dann ~TDBMemo auf.

Bevor ~TDBMemo den geerbten Destruktor aufruft, gibt die Methode den für die Bearbeitung der Daten benötigten Speicher frei, der im Konstruktor zugewiesen wurde.


TDBMemo::TDBMemo

TDBMemo	Siehe auch

Die Methode TDBMemo erzeugt eine Instanz von TDBMemo.

__fastcall virtual TDBMemo(Classes::TComponent* AOwner);

Beschreibung

Mit TDBMemo können Sie eine Instanz von TDBMemo erzeugen und initialisieren. TDBMemo überschreibt den geerbten Konstruktor, um diejenigen Eigenschaften des TDBMemo-Objekts zu initialisieren, die mit dem Zugriff auf die Daten zu tun haben.


TDBMemo::KeyDown

TDBMemo	Siehe auch

Die Methode KeyDown überschreibt die geerbte Methode, um die Datenmenge in einen Bearbeitungsmodus zu versetzen, wenn der Benutzer ENTF oder STRG+EINFG drückt.

virtual void __fastcall KeyDown(unsigned short &Key,  Classes::TShiftState Shift);

Beschreibung

KeyDown ruft zuerst die geerbte Methode auf, die ihrerseits die Ereignisbehandlungsroutine für OnKeyDown aufruft. Als nächstes versucht KeyDown, die Datenmenge in einen Bearbeitungsmodus zu versetzen, wenn der Benutzer ENTF oder STRG+EINFG drückt. Wenn das Memo-Eingabefeld nicht mit einer Datenmenge verknüpft ist, ignoriert KeyDown den Tastendruck. Diese Methode kann von abgeleiteten Klassen überschrieben werden, um weitere Tastenkombinationen abzufangen. Die geerbte Methode sollte jedoch immer aufgerufen werden.


TDBMemo::KeyPress

TDBMemo	Siehe auch

Die Methode KeyPress überschreibt die geerbte Methode, um sämtliche Tastatureingaben abzufangen, die den Status des Eingabefeldes verändern.

virtual void __fastcall KeyPress(char &Key);

Beschreibung

KeyPress ruft zuerst die geerbte Methode auf, die ihrerseits die Ereignisbehandlungsroutine für OnKeyPress aufruft. Als nächstes überprüft KeyPress, welche Taste gedrückt wurde. Wenn es sich nicht um ein für den vorliegenden Feldtyp gültiges Zeichen handelt oder wenn keine Verknüpfung zu einem Datenbankfeld besteht, wird die Eingabe verworfen. Ist die Eingabe gültig, versucht KeyPress, die Datenmenge in den Bearbeitungsmodus zu versetzen.

Wenn es sich beim zugrundeliegenden Datenbankfeld um ein Text-BLOB handelt, bewirkt das Drücken von PAUSE, daß KeyPress die Methode LoadMemo aufruft. Das Drücken von ESCAPE hat zur Folge, daß KeyPress nicht gespeicherte €nderungen verwirft.


TDBMemo::LoadMemo

TDBMemo	Siehe auch

Die Methode LoadMemo lädt das Text-BLOB aus dem Datenbankfeld in das Memo-Eingabefeld.

void __fastcall LoadMemo(void);

Beschreibung

Mit Hilfe von LoadMemo kann eine Anwendung die Anzeige des aktuellen Inhalts eines Text-BLOB-Feldes in einem Memo-Eingabefeld steuern. Die Methode aktualisiert das Memo-Eingabefeld mit dem Wert des Feldes im aktuellen Datensatz. LoadMemo funktioniert nur bei Text-ΒLOBs. Die Eigenschaft AutoDisplay muß den Wert False haben, damit der Feldinhalt nicht automatisch geladen wird.


TDBMemo::Notification

TDBMemo	Siehe auch

Die Methode Notification überschreibt die geerbte Methode, um auf opRemove-Botschaften zu reagieren, die das DataSource-Objekt betreffen.

virtual void __fastcall Notification(Classes::TComponent* AComponent, Classes::TOperation Operation );

Beschreibung

Notification überprüft nach dem Aufruf der geerbten Methode, ob aus der Botschaft hervorgeht, daß das DataSource-Objekt entfernt wurde. In diesem Fall wird die Eigenschaft DataSource auf NIL gesetzt.

Notification kann von abgeleiteten Klassen überschrieben werden, um weitere Botschaften zu verarbeiten. Die geerbte Methode sollte jedoch immer aufgerufen werden.


TDBMemo::WndProc

TDBMemo	Siehe auch

Die Methode WndProc ermöglicht dem Memo-Eingabefeld spezifische Reaktionen auf Botschaften.

virtual void __fastcall WndProc(Messages::TMessage &Message);

Beschreibung

WndProc überschreibt die Methode WndProc von TwinControl, um Botschaften zu verarbeiten, die die Darstellung eines TDBMemo-Eingabefeldes betreffen. Alle anderen Botschaften werden an die geerbte Methode WinProc weitergegeben.

Abgeleitete Klassen, die WndProc überschreiben, um spezifische Reaktionen auf Botschaften zu ermöglichen, sollten am Ende die geerbte Methode WndProc aufrufen, damit alle übrigen Botschaften verteilt werden.


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Protected


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TControl

TWinControl

TCustomEdit

TCustomMemo


TDBMemo Beispiel

TDBMemo


 TDBNavigator

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/dbctrls.hpp

Mit einer TDBNavigator-Komponente können Sie zu den verschiedenen Datensätzen in einer Datenmenge gelangen und Operationen wie das Einfügen eines neuen Datensatzes oder das Eintragen des aktuellen Datensatzes durchführen.

Beschreibung

Verwenden Sie die Komponente TDBNavigator in Formularen, die datensensitive Steuerelemente wie TDBGrid oder TDBEdit enthalten. TDBNavigator ermöglicht dem Benutzer beim Bearbeiten oder Anzeigen der Daten die Steuerung der Datenmenge.

Sobald der Benutzer einen Steuerungsschalter wählt, wird die entsprechende Aktion in der verbundenen Datenmenge durchgeführt. So wird beispielsweise durch Anklicken des Schalters Einfügen ein leerer Datensatz in die Datenmenge eingefügt.

Die folgenden Schalter können in der Komponente TDBNavigator angezeigt werden:

Schalter	Beschreibung

Erster	Wechselt zum ersten Datensatz in der Datenmenge, deaktiviert die Schalter Erster und Vorheriger und aktiviert die Schalter Nächster und Letzter, falls diese deaktiviert sind.

Vorheriger	Wechselt zum vorherigen Datensatz und aktiviert die Schalter Nächster und Letzter, falls diese deaktiviert sind.

Nächster	Wechselt zum nächsten Datensatz und aktiviert die Schalter Erster und Vorheriger, falls diese deaktiviert sind.

Letzter	Wechselt zum letzten Datensatz in der Datenmenge, deaktiviert die Schalter Nächster und Letzter und aktiviert die Schalter Erster und Vorheriger, falls diese deaktiviert sind.

Einfügen	Fügt einen neuen Datensatz vor dem aktuellen Datensatz ein und ändert den Modus der Datenmenge in dsInsert und dsEdit.

Löschen	Löscht den aktuellen Datensatz und macht die nächste Zeile zum aktuellen Datensatz.

Bearbeiten	Versetzt die Datenmenge in den Bearbeitungsmodus, so daß der aktuelle Datensatz geändert werden kann.

Eintragen	Schreibt die Änderungen des aktuellen Datensatzes in die Datenbank.

Abbrechen	Bricht die Änderungen des aktuellen Datensatzes ab, setzt die Anzeige des Datensatzes auf den Zustand vor der Änderung zurück und deaktiviert die Modi dsInsert und dsEdit, falls diese aktiv sind.

Aktualisieren	Aktualisiert die gepufferten Daten in der verbundenen Datenmenge. Bei TQuery-Komponenten ist dieser Schalter nur aktiviert, wenn die Eigenschaft RequestLive den Wert True hat.


Eigenschaften von TDBNavigator

TDBNavigator	Alphabetisch	Legende

In TDBNavigator

ConfirmDelete

DataSource

Hints

Visible

VisibleButtons

Abgeleitet von TWinControl

Brush

ClientOrigin

ClientRect

ControlCount

Controls

Ctl3D

Handle

HelpContext

ParentCtl3D

Showing

TabOrder

TabStop

Abgeleitet von TControl

Align

BoundsRect

ClientHeight

ClientWidth

ControlState

ControlStyle

Cursor

DragCursor

DragMode

Enabled

Height

Hint

Left

Name

Parent

ParentShowHint

PopupMenu

ShowHint

Top

Width

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TDBNavigator

TDBNavigator	Nach Objekten	Legende

Align

BoundsRect

Brush

ClientHeight

ClientOrigin

ClientRect

ClientWidth

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ConfirmDelete

ControlCount

ControlState

Controls

ControlStyle

Ctl3D

Cursor

DataSource

DesignInfo

DragCursor

DragMode

Enabled

Handle

Height

HelpContext

Hints

Hint

Left

Name

Owner

ParentCtl3D

ParentShowHint

Parent

PopupMenu

ShowHint

Showing

TabOrder

TabStop

Tag

Top

VisibleButtons

Visible

Width


TDBNavigator::ConfirmDelete

TDBNavigator	Siehe auch

Die Eigenschaft ConfirmDelete bestimmt, ob der Benutzer in einem Meldungsfenster das Löschen des aktuellen Datensatzes bestätigen muß, nachdem er auf den entsprechenden Schalter auf der Navigatorkomponente geklickt hat.

__property bool ConfirmDelete;

Beschreibung

Mit der Eigenschaft ConfirmDelete kann verhindert werden, daß ein Datensatz versehentlich gelöscht wird.

Hat ConfirmDelete den Wert True, wird nach dem Anklicken des Schalters Löschen ein Meldungsfenster angezeigt, in dem der Benutzer die Operation mit OK bestätigen muß. Ist ConfirmDelete auf False gesetzt, wird der Datensatz ohne vorherige Sicherheitsabfrage gelöscht.


TDBNavigator::DataSource

TDBNavigator	Siehe auch

Die Eigenschaft DataSource gibt die Datenquelle für den Navigator an.

__property Db::TDataSource* DataSource;

Beschreibung

Mit der Eigenschaft DataSource können Sie den Datenbanknavigator mit einer Datenmenge verbinden. Geben Sie den Namen der Datenquellenkomponente an, die der Datenmenge mit den gewünschten Daten zugeordnet ist.


TDBNavigator::Hints

TDBNavigator	Siehe auch

Die Eigenschaft Hints ermöglicht das Definieren von Tool-Tips zu den verschiedenen Schaltern in der Navigatorkomponente.

__property Classes::TStrings* Hints;

Beschreibung

Mit der Eigenschaft Hints können Sie Tool-Tips zu den einzelnen Schaltern in der Navigatorkomponente definieren. Für jeden Schalter wird ein Standardhinweis angezeigt. Mit Hilfe von Hints können Sie einige oder alle dieser Standardhinweise durch eigene Hilfstexte ersetzen.

Hints enthält eine Liste mit einem String pro Hinweis. Der erste String wird als Hinweis für den ersten Schalter (Erster), der zweite String für den zweiten Schalter usw. verwendet.

Wird Hints zur Laufzeit festgelegt, geben Sie einen leeren String ('') für jeden Hinweis an, der seinen Standardwert behalten soll. Während des Entwurfs lassen Sie im Stringlisten-Editor für die Eigenschaft Hints einfach die betreffende Zeile leer.

Note

Sollen die Hinweise zur Laufzeit angezeigt werden, setzen Sie die Eigenschaft ShowHint auf True.


TDBNavigator::Visible

TDBNavigator	Siehe auch	Beispiel

Die Eigenschaft Visible bestimmt, ob die Navigatorkomponente auf dem Bildschirm angezeigt wird.

Beschreibung

Mit der Eigenschaft Visible können Sie steuern, wann die Komponente angezeigt wird. Hat Visible den Wert True, wird der Navigator angezeigt. Wird Visible auf False gesetzt, ist das Steuerelement nicht sichtbar. Mit der Methode Show können die Eigenschaft Visible auf True gesetzt und weitere Aktionen durchgeführt werden, um sicherzustellen, daß der Benutzer die Komponente sehen kann.


TDBNavigator::VisibleButtons

TDBNavigator	Siehe auch

Die Eigenschaft VisibleButtons bestimmt, welche Schalter in der Navigatorkomponente angezeigt werden.

__property TButtonSet VisibleButtons;

Beschreibung

Mit der Eigenschaft VisibleButtons können Sie festlegen, welche Schalter im Navigator angezeigt werden. Soll ein Schalter nicht angezeigt und dadurch verhindert werden, daß der Benutzer die betreffende Operation ausführen kann, entfernen Sie den entsprechenden Schalter aus der Menge. Soll beispielsweise nur das Anzeigen der Datensätze in der Datenmenge zugelassen werden, sollte VisibleButtons nur die Elemente nbFirst, nbPrior, nbNext und nbLast enthalten.

Die folgenden Schalter sind für VisibleButtons verfügbar:

Schalter	Wert	Aktion

Erster	nbFirst	Zum ersten Datensatz wechseln.

Vorheriger	nbPrior	Zum vorherigen Datensatz wechseln.

Nächster	nbNext	Zum nächsten Datensatz wechseln.

Letzter	nbLast	Zum letzten Datensatz wechseln.

Einfügen	nbInsert	Leeren Datensatz einfügen.

Löschen	nbDelete	Aktuellen Datensatz löschen.

Bearbeiten	nbEdit	Bearbeiten des aktuellen Datensatzes ermöglichen.

Eintragen	nbPost	Aktuellen Datensatz eintragen.

Abbrechen	nbCancel	Änderungen des aktuellen Datensatzes abbrechen.

Aktualisieren	nbRefresh	Daten in der Datenmenge aktualisieren.


Ereignisse von TDBNavigator

TDBNavigator	Alphabetisch	Legende

In TDBNavigator

OnClick

Abgeleitet von TCustomPanel

OnResize

Abgeleitet von TWinControl

OnEnter

OnExit

Abgeleitet von TControl

OnDblClick

OnDragDrop

OnDragOver

OnEndDrag

OnStartDrag


Ereignisse von TDBNavigator

TDBNavigator	Nach Objekten	Legende

OnClick

OnDblClick

OnDragDrop

OnDragOver

OnEndDrag

OnEnter

OnExit

OnResize

OnStartDrag


TDBNavigator::OnClick

TDBNavigator	Siehe auch	Beispiel

Das Ereignis OnClick wird ausgelöst, wenn die Navigatorkomponente angeklickt wird.

__property ENavClick OnClick;

Mit einer Ereignisbehandlungsroutine für OnClick können Sie auf Klickereignisse reagieren. Sie müssen diese Ereignisbehandlungsroutine jedoch nicht definieren, da den Schaltern in der Navigatorkomponente Standardaktionen zugeordnet sind.

Das Ereignis OnClick wird in den folgenden Situationen ausgelöst:

•	Die Schalter in der Komponente werden mit der Maus angeklickt.

•	Die Leertaste wird gedrückt, während der Navigator den Fokus besitzt.

•	Die Methode BtnClick wird aufgerufen.

Hinweis

Das Ereignis OnClick wird nach der Standardaktion für den angeklickten Schalter ausgelöst.


Methoden von TDBNavigator

TDBNavigator	Alphabetisch

In TDBNavigator

~TDBNavigator

BtnClick

SetBounds

TDBNavigator

Abgeleitet von TWinControl

Broadcast

CanFocus

ContainsControl

ControlAtPos

DisableAlign

EnableAlign

Focused

GetTabOrderList

HandleAllocated

HandleNeeded

InsertControl

Invalidate

PaintTo

Realign

RemoveControl

Repaint

ScaleBy

ScrollBy

SetFocus

Update

UpdateControlState

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

GetTextLen

Hide

Perform

Refresh

ScreenToClient

SendToBack

SetTextBuf

Show

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TDBNavigator

TDBNavigator	Nach Objekten

~TDBNavigator

Assign

BeginDrag

BringToFront

Broadcast

BtnClick

CanFocus

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

ClientToScreen

ContainsControl

ControlAtPos

DefaultHandler

DestroyComponents

Destroying

DisableAlign

Dispatch

DragDrop

Dragging

EnableAlign

EndDrag

FieldAddress

FindComponent

Focused

FreeInstance

FreeNotification

Free

GetParentComponent

GetTabOrderList

GetTextBuf

GetTextLen

HandleAllocated

HandleNeeded

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InsertControl

InstanceSize

Invalidate

MethodAddress

MethodName

NewInstance

PaintTo

Perform

Realign

Refresh

RemoveComponent

RemoveControl

Repaint

ScaleBy

ScreenToClient

ScrollBy

SendToBack

SetBounds

SetFocus

SetTextBuf

Show

TDBNavigator

UpdateControlState

Update


TDBNavigator::~TDBNavigator

TDBNavigator	Siehe auch

Der Destruktor ~TDBNavigator gibt den Speicher frei, der für das TDBNavigator-Objekt reserviert war. Rufen Sie ~TDBNavigator nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TDBNavigator automatisch aufgerufen wird.

__fastcall virtual ~TDBNavigator(void);

Beschreibung

~TDBNavigator gibt vor dem Aufruf des Destruktors seines übergeordneten Objekts die Hilfsobjekte frei, die von der Methode TDBNavigator instantiiert wurden.


TDBNavigator::BtnClick

TDBNavigator	Siehe auch

Mit der Methode BtnClick können Sie das Anklicken eines Schalters in der Navigatorkomponente simulieren und dadurch die betreffende Aktion ausführen.

void __fastcall BtnClick(TNavigateBtn Index);

Beschreibung

Verwenden Sie die Methode BtnClick, wenn die Anwendung und nicht der Benutzer den Datenbanknavigator steuern soll. Geben Sie beim Aufruf der Methode einen Wert vom Typ TNavigateBtn im Parameter Index an, um die entsprechende Operation auszuführen.

Durch den Aufruf von BtnClick wird das Ereignis OnClick des Navigators nach der Standardaktion des Schalters ausgelöst.


TDBNavigator::SetBounds

TDBNavigator	Siehe auch	Beispiel

Die Methode SetBounds setzt alle Eigenschaften, mit denen das Begrenzungsrechteck der Navigatorkomponente festgelegt wird.

virtual void __fastcall SetBounds(int ALeft, int ATop, int AWidth, int AHeight);

Beschreibung

Verwenden Sie SetBounds, wenn Sie mehrere Begrenzungseigenschaften gleichzeitig setzen wollen. Den Eigenschaften Left, Top, Width und Height werden die in den Parametern ALeft, ATop, AWidth und AHeight übergebenen Werte zugewiesen. Die Position und Größe der Schalter wird dabei an das neue Begrenzungsrechteck angepaßt.

Sie können die Werte zwar auch einzeln ändern, jedoch können Sie mit SetBounds mehrere Änderungen zugleich vornehmen, ohne jedesmal die Schalter anpassen zu müssen.


TDBNavigator::TDBNavigator

TDBNavigator	Siehe auch

Der Konstruktor TDBNavigator erzeugt ein neues TDBNavigator-Objekt.

__fastcall virtual TDBNavigator(Classes::TComponent* AOwner);

Beschreibung

Mit TDBNavigator können Sie zur Laufzeit ein TDBNavigator-Objekt instantiieren. Für TDBNavigator-Objekte, die Sie zur Entwurfszeit in ein Formular oder Datenmodul einfügen, wird TDBNavigator automatisch aufgerufen.

Nach dem Aufruf des Konstruktors seines übergeordneten Objekts erzeugt TDBNavigator die Hilfsobjekte, mit denen TDBNavigator seine Schaltflächen und die Verbindung zur Datenmenge verwaltet, und initialisiert einige Eigenschaften, die das Aussehen des Navigators beeinflussen.


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TControl

TWinControl

TCustomControl

TCustomPanel


TDBNavigator Beispiel

TDBNavigator


 TDBRadioGroup

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/dbctrls.hpp

TDBRadioGroup repräsentiert eine Gruppe von Optionsfeldern, die mit einer Datenbank verbunden sind.

Beschreibung

Ein TDBRadioGroup-Objekt ist ein spezielles Gruppenfeld für die Anzeige datensensitiver Optionsfelder. Optionsfelder, die sich in derselben Steuerelementkomponente befinden, sind „gruppiert“. Sobald ein Optionsfeld aktiviert wird, werden die anderen Felder in der Gruppe automatisch deaktiviert. Mit diesen Steuerelementen kann auf einfache Weise sichergestellt werden, daß der Benutzer einen der zulässigen Werte für ein Feld eingibt. Sie sind auch für das Anzeigen von Feldern mit wenigen möglichen Werten geeignet.

Ein TDBRadioGroup-Objekt wird wie die anderen datensensitiven Steuerelemente mit einer Datenbank verbunden. Setzen Sie zuerst seine Eigenschaft DataSource auf den Namen eines TDataSource-Objekts, das auf die betreffende Datenmenge zeigt. Geben Sie anschließend mit der Eigenschaft DataField das gewünschte Feld der Datenmenge an.

Sie können jederzeit im Objektinspektor mit der Eigenschaft Items weitere Optionsfelder zu einer TDBRadioGroup-Komponente hinzufügen. Für jeden String in Items wird ein Optionsfeld im Gruppenfeld mit dem String als Titel angezeigt. Die Eigenschaft ItemIndex gibt an, welches Optionsfeld aktuell ausgewählt ist.

Sobald der Benutzer ein Optionsfeld auswählt, wird der Wert des Feldes in das entsprechende Tabellenfeld des aktuellen Datensatzes übernommen. Die Werte für die Optionsfelder können im Objektinspektor mit der Eigenschaft Values angegeben werden. Dabei entspricht der erste String in Values dem ersten String in Items usw. Werden mit Values keine Werte festgelegt, wird der Titel des Optionsfeldes als Wert verwendet.

Mit der Eigenschaft Columns können Sie steuern, in wie vielen Spalten die Optionsfelder angezeigt werden.


Eigenschaften von TDBRadioGroup

TDBRadioGroup	Alphabetisch	Legende

In TDBRadioGroup

DataField

DataSource

Field

Items

ReadOnly

Value

Values

Abgeleitet von TCustomRadioGroup

Columns

ItemIndex

Abgeleitet von TWinControl

Brush

ClientOrigin

ClientRect

ControlCount

Controls

Ctl3D

Handle

HelpContext

ParentCtl3D

Showing

TabOrder

TabStop

Abgeleitet von TControl

Align

BoundsRect

Caption

ClientHeight

ClientWidth

Color

ControlState

ControlStyle

Cursor

DragCursor

DragMode

Enabled

Font

Height

Hint

Left

Name

Parent

ParentColor

ParentFont

ParentShowHint

PopupMenu

ShowHint

Top

Visible

Width

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TDBRadioGroup

TDBRadioGroup	Nach Objekten	Legende

Align

BoundsRect

Brush

Caption

ClientHeight

ClientOrigin

ClientRect

ClientWidth

Color

Columns

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlCount

ControlState

Controls

ControlStyle

Ctl3D

Cursor

DataField

DataSource

DesignInfo

DragCursor

DragMode

Enabled

Field

Font

Handle

Height

HelpContext

Hint

ItemIndex

Items

Left

Name

Owner

ParentColor

ParentCtl3D

ParentFont

ParentShowHint

Parent

PopupMenu

ReadOnly

ShowHint

Showing

TabOrder

TabStop

Tag

Top

Values

Value

Visible

Width


TDBRadioGroup::DataField

TDBRadioGroup	Siehe auch

Die Eigenschaft DataField gibt das Feld an, dessen Daten als Optionsfeldgruppe angezeigt werden.

__property System::AnsiString DataField;

Beschreibung

Mit DataField können Sie das Datenbankfeld festlegen, dessen Daten als Optionsfeldgruppe angezeigt werden.


TDBRadioGroup::DataSource

TDBRadioGroup	Siehe auch

Die Eigenschaft DataSource bestimmt, woher die Optionsfeldgruppe die anzuzeigenden Daten bezieht.

__property Db::TDataSource* DataSource;

Beschreibung

Mit DataSource können Sie ein TDataSource-Objekt angeben, das auf eine Datenmengenkomponente (z. B. eine Tabelle) zeigt. Die Datenmenge sollte mit der Datenbank verbunden sein, auf deren Daten zugegriffen werden soll.


TDBRadioGroup::Field

TDBRadioGroup	Siehe auch

Die Eigenschaft Field gibt die TField-Komponente an, mit der die Optionsfeldgruppe verbunden ist.

__property Db::TField* Field;

Beschreibung

Field enthält das TField-Objekt, das in der verbundenen Datenmengenkomponente für den Zugriff auf die Datenbank erstellt wird.


TDBRadioGroup::Items

TDBRadioGroup	Siehe auch

Die Eigenschaft Items enthält eine Liste der Optionsfelder in der Gruppe.

__property Items;

Beschreibung

Items enthält ein TStrings-Objekt mit den Titeln der Optionsfelder in der Gruppe (die Liste kann jederzeit im Objektinspektor bearbeitet werden, um Optionsfelder hinzuzufügen oder zu entfernen). Werden mit der Eigenschaft Values nicht explizit Werte festgelegt, wird statt dessen dieser Titel verwendet. Sobald der Benutzer ein Optionsfeld auswählt, wird der Wert in das verbundene Feld des aktuellen Datensatzes in der Datenbank geschrieben.


TDBRadioGroup::ReadOnly

TDBRadioGroup	Siehe auch

Die Eigenschaft ReadOnly bestimmt, ob der Benutzer ein anderes Optionsfeld in der Gruppe auswählen und somit die Daten des Feldes ändern kann.

__property bool ReadOnly;

Beschreibung

Hat ReadOnly den Wert True, werden in der Optionsfeldgruppe die Daten des aktuellen Datensatzes nur angezeigt und können nicht geändert werden. Die Standardeinstellung ist False.


TDBRadioGroup::Value

TDBRadioGroup

Die Eigenschaft Value enthält den Inhalt des verbundenen Feldes im aktuellen Datensatz.

__property System::AnsiString Value;

Beschreibung

Value enthält den Inhalt des verbundenen Feldes im aktuellen Datensatz. Wählt der Benutzer ein anderes Optionsfeld, ändert sich der Wert von Value.


TDBRadioGroup::Values

TDBRadioGroup	Siehe auch

Die Eigenschaft Values legt die Werte der Optionsfelder in der Gruppe fest.

__property Classes::TStrings* Values;

Beschreibung

Wählt der Benutzer ein Optionsfeld aus, wird dessen Wert in das verbundene Feld in der Datenbank geschrieben. Standardmäßig wird als Wert eines Optionsfeldes der neben ihm auf dem Bildschirm angezeigte, mit der Eigenschaft Items angegebene Titel verwendet.

Manchmal sollen sich jedoch die Werte der Optionsfelder von ihren Titeln unterscheiden. Werden beispielsweise Optionsfelder für ein Datenbankfeld verwendet, in das die Werte „J“ und „N“ eingegeben werden können, können als Titel „Ja“ und „Nein“ angezeigt werden. In diesem Fall müssen „Ja“ und „Nein“ in die Liste Items sowie die Werte „J“ und „N“ in die Liste Values eingegeben werden.

Die Liste Values kann im Objektinspektor wie die Liste Items bearbeitet werden. Sollen die Titel der Optionsfelder als Werte verwendet werden, weisen Sie der Eigenschaft Values keine Werte zu.


Ereignisse von TDBRadioGroup

TDBRadioGroup	Alphabetisch	Legende

In TDBRadioGroup

OnChange

Abgeleitet von TWinControl

OnEnter

OnExit

Abgeleitet von TControl

OnClick

OnDragDrop

OnDragOver

OnEndDrag

OnStartDrag


Ereignisse von TDBRadioGroup

TDBRadioGroup	Nach Objekten	Legende

OnChange

OnClick

OnDragDrop

OnDragOver

OnEndDrag

OnEnter

OnExit

OnStartDrag


TDBRadioGroup::OnChange

TDBRadioGroup	Siehe auch

Das Ereignis OnChange wird ausgelöst, sobald die Daten im verbundenen Feld geändert werden.

__property Classes::TNotifyEvent OnChange;

Beschreibung

Das Ereignis OnChange wird ausgelöst, wenn der Inhalt des Datenbankfeldes geändert wird, auf das mit der Optionsfeldgruppe zugegriffen wird. Mit einer Ereignisbehandlungsroutine für OnChange können Sie spezielle Verarbeitungen implementieren, die beim Aktualisieren der Gruppe ausgeführt werden sollen.


Methoden von TDBRadioGroup

TDBRadioGroup	Alphabetisch	Legende

In TDBRadioGroup

~TDBRadioGroup

CanModify

TDBRadioGroup

Abgeleitet von TWinControl

Broadcast

CanFocus

ContainsControl

ControlAtPos

DisableAlign

EnableAlign

Focused

GetTabOrderList

HandleAllocated

HandleNeeded

InsertControl

Invalidate

PaintTo

Realign

RemoveControl

Repaint

ScaleBy

ScrollBy

SetBounds

SetFocus

Update

UpdateControlState

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

GetTextLen

Hide

Perform

Refresh

ScreenToClient

SendToBack

SetTextBuf

Show

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TDBRadioGroup

TDBRadioGroup	Nach Objekten	Legende

~TDBRadioGroup

Assign

BeginDrag

BringToFront

Broadcast

CanFocus

CanModify

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

ClientToScreen

ContainsControl

ControlAtPos

DefaultHandler

DestroyComponents

Destroying

DisableAlign

Dispatch

DragDrop

Dragging

EnableAlign

EndDrag

FieldAddress

FindComponent

Focused

FreeInstance

FreeNotification

Free

GetParentComponent

GetTabOrderList

GetTextBuf

GetTextLen

HandleAllocated

HandleNeeded

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InsertControl

InstanceSize

Invalidate

MethodAddress

MethodName

NewInstance

PaintTo

Perform

Realign

Refresh

RemoveComponent

RemoveControl

Repaint

ScaleBy

ScreenToClient

ScrollBy

SendToBack

SetBounds

SetFocus

SetTextBuf

Show

TDBRadioGroup

UpdateControlState

Update


TDBRadioGroup::~TDBRadioGroup

TDBRadioGroup

Der Destruktor ~TDBRadioGroup gibt den Speicher frei, der für das TDBRadioGroup-Objekt reserviert war. Rufen Sie ~TDBRadioGroup nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TDBRadioGroup automatisch aufgerufen wird.

__fastcall virtual ~TDBRadioGroup(void);

Beschreibung

~TDBRadioGroup gibt intern erzeugte Objekte frei, die den Datenzugriff steuern, und ruft dann den Destruktor des übergeordneten Objekts auf.


TDBRadioGroup::CanModify

TDBRadioGroup	Siehe auch

Die Methode CanModify ermittelt, ob der Benutzer ein anderes Optionsfeld in der Gruppe auswählen kann.

virtual bool __fastcall CanModify(void);

Beschreibung

CanModify gibt True zurück, wenn die Optionsfeldgruppe mit einer Datenquelle verbunden ist, die bearbeitet werden kann, und die Eigenschaft ReadOnly auf False gesetzt ist.


TDBRadioGroup::TDBRadioGroup

TDBRadioGroup

TDBRadioGroup erstellt und initialisiert eine Instanz der Klasse TDBRadioGroup.

__fastcall virtual TDBRadioGroup(Classes::TComponent* AOwner);

Beschreibung

TDBRadioGroup ruft zuerst den geerbten Konstruktor auf und initialisiert dann die internen Objekte und Variablen, die für den Datenzugriff benötigt werden.


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Protected


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TControl

TWinControl

TCustomControl

TCustomGroupBox

TCustomRadioGroup


TDBRadioGroup Beispiel

TDBRadioGroup


 TDBText

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/dbctrls.hpp

Die Komponente TDBText ist ein datensensitives Steuerelement, das in einem Formular Text anzeigt.

Beschreibung

Ihre Anwendung kann den Inhalt eines Feldes des aktuellen Datensatzes in einem Datenbank-Textobjekt anzeigen, in dem der Anwender den Feldinhalt nicht bearbeiten kann.

Indem Sie in der Eigenschaft DataSource die Datenquelle (TDataSource) angeben, die die Datenmenge bezeichnet, können Sie das Textobjekt mit einer Datenmenge verknüpfen. Der Eigenschaft DataField weisen Sie das Feld der Datenmenge zu, das dargestellt werden soll.

Mit der Eigenschaft Alignment wird festgelegt, wie der Text innerhalb des Objekts ausgerichtet wird. Damit sich die Größe des Objekts automatisch an die unterschiedlichen Texte anpaßt, setzen Sie die Eigenschaft AutoSize auf True. Wenn der Text umbrochen werden soll, setzen Sie WordWrap auf True.

Um ein Datenbank-Textobjekt transparent über eine Grafik zu legen (so daß die Grafik nicht teilweise verdeckt wird), setzen Sie Transparent auf True.

Wenn die datensensitiven Eigenschaften von TDBText nicht benötigt werden, verwenden Sie statt dessen ein Beschriftungsobjekt (TLabel), um Systemressourcen zu sparen.


Eigenschaften von TDBText

TDBText	Alphabetisch	Legende

In TDBText

AutoSize

DataField

DataSource

Field

Abgeleitet von TCustomLabel

Alignment

Transparent

WordWrap

Abgeleitet von TGraphicControl

Canvas

Abgeleitet von TControl

Align

BoundsRect

ClientHeight

ClientOrigin

ClientRect

ClientWidth

Color

ControlState

ControlStyle

Cursor

DragCursor

DragMode

Enabled

Font

Height

Hint

Left

Name

Parent

ParentColor

ParentFont

ParentShowHint

PopupMenu

ShowHint

Top

Visible

Width

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TDBText

TDBText	Nach Objekten	Legende

Alignment

Align

AutoSize

BoundsRect

Canvas

ClientHeight

ClientOrigin

ClientRect

ClientWidth

Color

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlState

ControlStyle

Cursor

DataField

DataSource

DesignInfo

DragCursor

DragMode

Enabled

Field

Font

Height

Hint

Left

Name

Owner

ParentColor

ParentFont

ParentShowHint

Parent

PopupMenu

ShowHint

Tag

Top

Transparent

Visible

Width

WordWrap


TDBText::AutoSize

TDBText	Siehe auch	Beispiel

Die Eigenschaft AutoSize legt fest, ob sich das Textobjekt automatisch an die Breite und Länge des aktuellen Strings anpaßt.

__property AutoSize;

Beschreibung

Wenn AutoSize True ist, paßt sich das Textobjekt automatisch an die Breite und Länge des in der Eigenschaft Caption gespeicherten Strings an. Bei dieser Einstellung vergrößert sich das Steuerelement mit jedem eingegebenen Zeichen. €ndern Sie den Schriftgrad, paßt sich auch das Steuerelement an den neuen Schriftgrad an. Wenn AutoSize False ist, hat die Länge des aktuellen Strings keinen Einfluß auf die Größe des Textobjekts.


TDBText::DataField

TDBText	Siehe auch

Die Eigenschaft DataField bezeichnet das Feld, dessen Daten vom Steuerelement angezeigt werden.

__property System::AnsiString DataField;

Beschreibung

Die Datenmenge, der das Feld angehört, wird in Form einer Datenquellenkomponente (TDataSouce) in der Eigenschaft DataSource angegeben.


TDBText::DataSource

TDBText	Siehe auch

Die Eigenschaft DataSource legt fest, woher die Daten stammen, die vom Textobjekt angezeigt werden.

__property Db::TDataSource* DataSource;

Beschreibung

Weisen Sie dieser Eigenschaft die Datenmengenkomponente zu, die die Datenmenge mit den darzustellenden Daten repräsentiert.


TDBText::Field

TDBText	Siehe auch

Die Eigenschaft Field gibt die TField-Komponente zurück, mit der das Textobjekt verknüpft ist.

__property Db::TField* Field;

Beschreibung

Mit dieser Eigenschaft können Sie den Wert der angezeigten Daten programmseitig ändern.


Ereignisse von TDBText

TDBText	Alphabetisch	Legende

Abgeleitet von TControl

OnClick

OnDblClick

OnDragDrop

OnDragOver

OnEndDrag

OnMouseDown

OnMouseMove

OnMouseUp

OnStartDrag


Ereignisse von TDBText

TDBText	Nach Objekten	Legende

OnClick

OnDblClick

OnDragDrop

OnDragOver

OnEndDrag

OnMouseDown

OnMouseMove

OnMouseUp

OnStartDrag


Methoden von TDBText

TDBText	Alphabetisch

In TDBText

~TDBText

TDBText

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

GetTextLen

Hide

Invalidate

Perform

Refresh

Repaint

ScreenToClient

SendToBack

SetBounds

SetTextBuf

Show

Update

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TDBText

TDBText	Nach Objekten

~TDBText

Assign

BeginDrag

BringToFront

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

ClientToScreen

DefaultHandler

DestroyComponents

Destroying

Dispatch

DragDrop

Dragging

EndDrag

FieldAddress

FindComponent

FreeInstance

FreeNotification

Free

GetParentComponent

GetTextBuf

GetTextLen

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InstanceSize

Invalidate

MethodAddress

MethodName

NewInstance

Perform

Refresh

RemoveComponent

Repaint

ScreenToClient

SendToBack

SetBounds

SetTextBuf

Show

TDBText

Update


TDBText::~TDBText

TDBText	Siehe auch

Der Destruktor ~TDBText gibt den Speicher frei, der für das TDBText-Objekt reserviert war. Rufen Sie ~TDBText nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TDBText automatisch aufgerufen wird.

__fastcall virtual ~TDBText(void);

Beschreibung

~TDBText gibt die Hilfsobjekte von TDBText frei und ruft dann den Destruktor des übergeordneten Objekts auf.


TDBText::TDBText

TDBText	Siehe auch

Der Konstruktor TDBText erzeugt ein neues TDBText-Objekt.

__fastcall virtual TDBText(Classes::TComponent* AOwner);

Beschreibung

Mit TDBText können Sie zur Laufzeit ein TDBText-Objekt erzeugen. Für TDBText-Objekte, die zur Entwurfszeit in Formularen oder Datenmodulen plaziert werden, wird TDBText automatisch aufgerufen.

Nach dem Aufruf des geerbten Konstruktors, der ein generisches Label-Objekt initialisiert und ihm Speicher zuweist, führt TDBText folgende Aktionen durch:

•	Der Eigenschaft ControlStyle wird das Flag csReplicatable hinzugefügt.

•	AutoSize wird auf False gesetzt.

•	Die für die Verknüpfung mit einer Datenmenge benötigten Hilfsobjekte werden erzeugt und initialisiert.


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TControl

TGraphicControl

TCustomLabel


TDBText Beispiel

TDBText


 TDdeClientConv

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/ddeman.hpp

Eine TDdeClientConv-Komponente richtet eine DDE-Konversation mit einer DDE-Server-Anwendung ein.

Beschreibung

TDdeClientConv kann zusammen mit einem TDdeClientItem-Objekt verwendet werden, um eine Anwendung als DDE-Client einzurichten. TDdeClientConv verfügt über eine Reihe von Eigenschaften, Ereignisse und Methoden, mit denen folgende Aufgaben durchgeführt werden können:

•	Eine Verbindung zu einem DDE-Server mit dem angegebenen DDE-Thema errichten.

•	Nach dem Einrichten der Verbindung Daten oder Makrobefehle an den DDE-Server senden.

•	Ein Format für die Daten festlegen, die an den DDE-Server gesendet werden.

•	Mit einer Ereignisbehandlungsroutine auf das öffnen oder Schließen der DDE-Verbindung reagieren.

Ein TDdeClientItem-Objekt wird mit einer TDdeClientConv-Komponente verbunden, indem seine Eigenschaft DdeConv entsprechend gesetzt wird.


Eigenschaften von TDdeClientConv

TDdeClientConv	Alphabetisch	Legende

In TDdeClientConv

ConnectMode

Conv

DataMode

DdeFmt

DdeService

DdeTopic

FormatChars

ServiceApplication

WaitStat

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Name

Owner

Tag


Eigenschaften von TDdeClientConv

TDdeClientConv	Nach Objekten	Legende

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ConnectMode

Conv

DataMode

DdeFmt

DdeService

DdeTopic

DesignInfo

FormatChars

Name

Owner

ServiceApplication

Tag

WaitStat


TDdeClientConv::ConnectMode

TDdeClientConv	Siehe auch

Die Eigenschaft ConnectMode bestimmt, ob die Verbindung mit dem DDE-Server beim öffnen des Formulars automatisch hergestellt wird.

__property TDataMode ConnectMode;

Beschreibung

Mit ConnectMode können Sie festlegen, wie die DDE-Konversation eingerichtet wird. Hat ConnectMode den Wert ddeAutomatic, wird die Verbindung hergestellt, sobald sie durch SetLink definiert wird. Hat ConnectMode den Wert ddeManual, muß die DDE-Konversation explizit durch einen Aufruf von OpenLink oder PasteLink eingerichtet werden.


TDdeClientConv::Conv

TDdeClientConv	Siehe auch

Die Eigenschaft Conv ist das Handle der aktuellen DDE-Konversation.

__property long Conv;

Beschreibung

Conv können Sie das Handle der DDE-Konversation entnehmen, wenn diese für einen Windows API-Aufruf benötigt werden. Conv ist verfügbar, nachdem die DDE-Konversation mit OpenLink oder PasteLink eingerichtet worden ist.


TDdeClientConv::DataMode

TDdeClientConv	Siehe auch

Die Eigenschaft DataMode liefert eine Schnittstelle für eine Eigenschaft, die bestimmt, ob Teile der DDE-Konversation automatisch ausgeführt werden.

__property TDataMode DataMode;

Beschreibung

DataMode ist für TDdeClientConv nicht implementiert. Abgeleitete Objekte können mit dieser Eigenschaft Teile einer DDE-Konversation (z.B. RequestData- oder PokeData-Aufrufe) automatisch ausführen.

Hinweis

Um zu bestimmen, wie die Konversation eingerichtet wurde, verwenden Sie ConnectMode.


TDdeClientConv::DdeFmt

TDdeClientConv	Siehe auch

Die Eigenschaft DdeFmt ist ein Integer, der das Standard-Zwischenablageformat für Datenelemente angibt.

__property int DdeFmt;

Beschreibung

Mit DdeFmt können Sie das Format der DDE-Datenelemente angeben, sofern es nicht vom Server festgelegt wurde.


TDdeClientConv::DdeService

TDdeClientConv	Siehe auch

Die Eigenschaft DdeService gibt den DDE-Server an, mit dem der DDE-Client verbunden werden soll.

__property System::AnsiString DdeService;

Beschreibung

Mit DdeService können Sie die Server-Anwendung für die Verbindung festlegen. Normalerweise wird hier der Dateiname (gegebenenfalls mit Pfad) der ausführbaren Datei des DDE-Servers ohne die Erweiterung .EXE angegeben. Ist der DDE-Server eine Borland C++Builder-Anwendung, verwenden Sie den Projektnamen ohne die Erweiterung .DPR oder .EXE. Um beispielsweise eine Verbindung mit der Komponente TDdeServerConv in der Projektdatei PROJ1.DPR herzustellen, setzen Sie DDEService auf PROJ1.

Während des Entwurfs kann der Name des gewünschten DDE-Servers im Objektinspektor eingegeben oder mit der Option Verbindung einfügen im Dialogfeld DDE-Info gewählt werden. Um eine Verbindung zur Laufzeit einzurichten, geben Sie Dienst und Thema mit der Methode SetLink an.

Hinweis

Die für DdeService benötigten Werte sind von der jeweiligen Server-Anwendung abhängig. Entsprechende Informationen finden Sie in der Dokumentation zum DDE-Server.


TDdeClientConv::DdeTopic

TDdeClientConv	Siehe auch

Die Eigenschaft DdeTopic gibt das Thema einer DDE-Konversation an.

__property System::AnsiString DdeTopic;

Beschreibung

Mit der Eigenschaft DdeTopic können Sie das vom Server definierte Thema der DDE-Konversation angeben. Normalerweise ist DdeTopic ein Dateiname (gegebenenfalls mit Pfad), der von der Server-Anwendung verwendet wird. Handelt es sich bei dem DDE-Server um eine Borland C++Builder-Anwendung, enthält DdeTopic standardmäßig den Titel des Formulars mit der verbundenen Komponente. Ist der DDE-Client mit einer TDdeServerConv-Komponente verbunden, enthält DdeTopic nicht den Formulartitel, sondern den Namen der Server-Konversationskomponente.

Während des Entwurfs kann das Thema direkt im Objektinspektor oder mit der Option Verbindung einfügen im Dialogfeld DDE-Info angegeben werden. Um eine Verbindung zur Laufzeit einzurichten, geben Sie Dienst und Thema mit der Methode SetLink an.

Hinweis

Die für eine DDE-Konversation verfügbaren Themen werden von der Server-Anwendung definiert. Entsprechende Informationen finden Sie in der Dokumentation zu Ihrem DDE-Server.


TDdeClientConv::FormatChars

TDdeClientConv	Siehe auch

Die Eigenschaft FormatChars legt fest, ob bestimmte Zeichen aus den von einem DDE-Server übertragenen Textdaten gefiltert werden sollen.

__property bool FormatChars;

Beschreibung

Verwenden Sie FormatChars bei Server-Anwendungen, die zusammen mit den Textdaten auch Rückschritt-, Zeilenvorschub-, Wagenrücklauf- und Tabulatorzeichen übertragen. Diese Formatierungszeichen können in den vom DDE-Client empfangenen Daten zu falschen Zeichen, Abständen und Zeilenumbrüchen führen. Sie können diese Probleme vermeiden, indem Sie FormatChars auf False setzen. Sollen die Formatierungszeichen übertragen werden, setzen Sie FormatChars auf True.


TDdeClientConv::ServiceApplication

TDdeClientConv	Siehe auch

Die Eigenschaft ServiceApplication gibt die ausführbare Datei (gegebenenfalls mit Pfad) eines DDE-Servers ohne die Dateinamenerweiterung .EXE an.

__property System::AnsiString ServiceApplication;

Beschreibung

Geben Sie mit ServiceApplication den Namen der Server-Anwendung an. Normalerweise ist dieser Wert mit der Eigenschaft DdeService identisch. In manchen Fällen hat DDEService jedoch einen anderen Wert als den Namen der ausführbaren Datei des DDE-Servers.

Wird die Server-Anwendung nicht ausgeführt, während TDdeClientConv eine DDE-Konversation einrichtet, verwendet OpenLink die Eigenschaft ServiceApplication, um den Server zu starten.


TDdeClientConv::WaitStat

TDdeClientConv	Siehe auch

Die Eigenschaft WaitStat gibt an, ob der Server gerade ein DDE-Makro verarbeitet, das keine asynchronen DDE-Transaktionen zuläßt.

__property bool WaitStat;

Beschreibung

Mit WaitStat können Sie feststellen, ob eine DDE-Transaktion gestartet werden kann. Hat WaitStat den Wert True, bearbeitet der Server das letzte Makro. Jeder Versuch, ein Makro auszuführen, Daten anzufordern oder zu senden, schlägt fehl. Ist WaitStat False, kann der Server die nächste Transaktion der DDE-Konversation ausführen.


Ereignisse von TDdeClientConv

TDdeClientConv	Alphabetisch	Legende

In TDdeClientConv

OnClose

OnOpen


Ereignisse von TDdeClientConv

TDdeClientConv	Nach Objekten	Legende

OnClose

OnOpen


TDdeClientConv::OnClose

TDdeClientConv	Siehe auch

Das Ereignis OnClose wird beim Beenden einer DDE-Konversation ausgelöst.

__property Classes::TNotifyEvent OnClose;

Beschreibung

Mit einer Ereignisbehandlungsroutine für OnClose können spezielle Aktionen beim Beenden einer DDE-Konversation durchgeführt werden. Eine DDE-Konversation wird beendet, indem der Server die Konversation abbricht, die Verbindung geschlossen oder geändert oder das TDdeClientConv-Objekt freigegeben wird.


TDdeClientConv::OnOpen

TDdeClientConv	Siehe auch

Das Ereignis OnOpen wird ausgelöst, nachdem die DDE-Verbindung mit dem Server eingerichtet wurde.

__property Classes::TNotifyEvent OnOpen;

Beschreibung

Mit einer Ereignisbehandlungsroutine für OnOpen können Sie Aktionen durchführen, sobald eine Verbindung mit dem DDE-Server eingerichtet wurde. DDE-Verbindungen werden mit der Methode OnOpen oder PasteLink eingerichtet. Sie können auch SetLink verwenden, wenn ConnectMode den Wert ddeAutomatic hat. Kann die Verbindung nicht hergestellt werden (weil beispielsweise der Server nicht gestartet werden kann), wird OnOpen nicht aufgerufen.


Methoden von TDdeClientConv

TDdeClientConv	Alphabetisch

In TDdeClientConv

~TDdeClientConv

CloseLink

ExecuteMacro

ExecuteMacroLines

OpenLink

PasteLink

PokeData

PokeDataLines

RequestData

SetLink

StartAdvise

TDdeClientConv

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TDdeClientConv

TDdeClientConv	Nach Objekten

~TDdeClientConv

Assign

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

CloseLink

DefaultHandler

DestroyComponents

Destroying

Dispatch

ExecuteMacroLines

ExecuteMacro

FieldAddress

FindComponent

FreeInstance

FreeNotification

Free

GetParentComponent

HasParent

InheritsFrom

InitInstance

InsertComponent

InstanceSize

MethodAddress

MethodName

NewInstance

OpenLink

PasteLink

PokeDataLines

PokeData

RemoveComponent

RequestData

SetLink

StartAdvise

TDdeClientConv


TDdeClientConv::~TDdeClientConv

TDdeClientConv	Siehe auch

Der Destruktor ~TDdeClientConv gibt den Speicher frei, der für das TDdeClientConv-Objekt reserviert war. Rufen Sie ~TDdeClientConv nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TDdeClientConv automatisch aufgerufen wird.

__fastcall virtual ~TDdeClientConv(void);

Beschreibung

~TDdeClientConv schließt vor dem Aufruf des Destruktors des übergeordneten Objekts die Verbindung zum Server und gibt alle Hilfsobjekte frei.


TDdeClientConv::CloseLink

TDdeClientConv	Siehe auch

Die Methode CloseLink beendet eine DDE-Konversation.

void __fastcall CloseLink(void);

Beschreibung

Verwenden Sie CloseLink, wenn die gesamte Kommunikation mit dem DDE-Server beendet werden soll. Nachdem eine Verbindung geschlossen wurde, kann keine DDE-Kommunikation zwischen dem DDE-Client und dem Server stattfinden, bis eine andere Verbindung geöffnet wird.


TDdeClientConv::ExecuteMacro

TDdeClientConv	Siehe auch

Die Methode ExecuteMacro sendet einen String mit einem Makrobefehl an den DDE-Server.

bool __fastcall ExecuteMacro(char * Cmd, bool waitFlg);

Beschreibung

Mit ExecuteMacro können Sie einen einzelnen Makrobefehl an die Server-Anwendung senden. Um mehrere Makrobefehle zu senden, verwenden Sie ExecuteMacroLines. ExecuteMacro gibt bei Erfolg True zurück, und False, wenn der String nicht gesendet werden kann.

Cmd ist ein nullterminierter String, der den von der Server-Anwendung auszuführenden Makrobefehl enthält. Der tatsächliche Wert von Cmd ist vom DDE-Server abhängig. Die zulässigen Befehle finden Sie in der Dokumentation zum DDE-Server.

WaitFlg legt fest, ob der DDE-Client vor dem Senden weiterer DDE-Transaktionen warten soll, bis der Server das Makro verarbeitet hat. Hat WaitFlg den Wert True, können nachfolgende Aufrufe von ExecuteMacro, ExecuteMacroLines, PokeData, PokeDataLines und RequestData erst ausgeführt werden, nachdem der DDE-Server das Makro vollständig verarbeitet hat.

Jeder Versuch, ein Makro auszuführen oder Daten zu senden, bevor der DDE-Server die Ausführung des aktuellen Makros abgeschlossen hat, kann zum Fehlschlagen des aktuellen Makros oder zu unvorhersehbaren Ergebnissen führen. Weitere Informationen hierzu finden Sie in der Dokumentation des DDE-Servers.

Hinweis

Kann der Makrobefehl erfolgreich an den DDE-Server gesendet werden, gibt ExecuteMacro True zurück. Dieser Rückgabewert bedeutet aber nicht, daß der Makrobefehl auf dem Server erfolgreich ausgeführt werden kann.


TDdeClientConv::ExecuteMacroLines

TDdeClientConv	Siehe auch

Die Methode ExecuteMacroLines sendet eine Liste mit mehreren Makrobefehlen an einen DDE-Server.

bool __fastcall ExecuteMacroLines(Classes::TStrings* Cmd, bool waitFlg);

Beschreibung

Mit ExecuteMacroLines können Sie mehrere Makrobefehle an die Server-Anwendung senden. Um einen einzelnen Befehl zu übertragen, verwenden Sie ExecuteMacro. Bei Erfolg gibt ExecuteMacroLines True zurück. Kann die Befehlsliste nicht an den Server gesendet werden, wird False zurückgegeben.

Cmd enthält die Makros, die von der Server-Anwendung ausgeführt werden sollen. WaitFlg legt fest, ob der DDE-Client vor dem Senden weiterer DDE-Transaktionen warten soll, bis der Server das Ausführen der Makros abgeschlossen hat. Hat WaitFlg den Wert True, können nachfolgende Aufrufe von ExecuteMacro, ExecuteMacroLines, PokeData, PokeDataLines und RequestData erst ausgeführt werden, nachdem der DDE-Server alle Makros verarbeitet hat.


TDdeClientConv::OpenLink

TDdeClientConv	Siehe auch

Die Methode OpenLink richtet eine neue DDE-Konversation ein.

bool __fastcall OpenLink(void);

Beschreibung

Mit OpenLink können Sie eine neue DDE-Konversation mit dem in DdeService angegebenen Server einrichten. Wird der Server nicht ausgeführt, startet OpenLink die Anwendung automatisch. Nachdem die Konversation geöffnet worden ist, wird ein OnOpen-Ereignis ausgelöst und True zurückgegeben. Kann die Konversation nicht geöffnet werden, gibt OpenLink den Wert False zurück.

Hinweis

Hat ConnectMode den Wert ddeAutomatic, wird OpenLink automatisch aufgerufen, wenn DdeTopic und DdeService mit SetLink angegeben werden.


TDdeClientConv::PasteLink

TDdeClientConv	Siehe auch

Die Methode PasteLink öffnet eine DDE-Konversation mit dem aktuellen Zwischenablageobjekt.

bool __fastcall PasteLink(void);

Beschreibung

Mit PasteLink können Sie eine DDE-Verbindung zu einem Objekt in der Zwischenablage herstellen. Dabei werden für die Eigenschaften DdeTopic und DdeService die Werte der Zwischenablage verwendet. Kann die Verbindung erfolgreich eingerichtet werden, gibt PasteLink True zurück.


TDdeClientConv::PokeData

TDdeClientConv	Siehe auch

Die Methode PokeData sendet Daten an einen DDE-Server.

bool __fastcall PokeData(const System::AnsiString Item, char * Data);

Beschreibung

Mit PokeData können Sie Textdaten an einen DDE-Server senden. Item gibt dabei den verknüpften Eintrag im DDE-Server an. Data ist ein nullterminierter String, der die Textdaten enthält.

Der Wert von Item ist von der Server-Anwendung abhängig. Normalerweise handelt es sich um einen auswählbaren Textabschnitt wie beispielsweise eine Zelle in einem Arbeitsblatt oder ein Datenbankfeld in einem Eingabefeld. Ist der Server eine Borland C++Builder-Anwendung, gibt Item den Namen der DDE-Server-Komponente an.

Normalerweise verläuft der Datenfluß vom DDE-Server zum DDE-Client. Manche DDE-Server akzeptieren jedoch keine Poke-Daten. Bei Erfolg gibt PokeData den Wert True zurück. Können die Daten nicht gesendet werden, wird False zurückgegeben.

Soll eine Stringliste anstelle eines einzelnen Strings gesendet werden, verwenden Sie die Methode PokeDataLines.

Hinweis

Wird die Methode ExecuteMacro oder ExecuteMacroLines mit auf True gesetztem Parameter WaitFlg aufgerufen, schlägt PokeData automatisch fehl, wenn der Server die Ausführung des aktuellen Makros noch nicht abgeschlossen hat. Die Eigenschaft WaitStat gibt an, wann PokeData versucht, Daten an den Server zu senden.


TDdeClientConv::PokeDataLines

TDdeClientConv	Siehe auch

Die Methode PokeDataLines sendet mehrere Datenzeilen an einen DDE-Server.

bool __fastcall PokeDataLines(const System::AnsiString Item, Classes::TStrings* Data);

Beschreibung

Mit PokeDataLines können Sie mehrere Zeilen mit Textdaten an einen DDE-Server senden, der dies unterstützt. Item gibt den verknüpften Eintrag im DDE-Server an. Data ist eine Stringmenge mit den Textdaten.

Der Wert von Item ist von der Server-Anwendung abhängig. Normalerweise handelt es sich um einen auswählbaren Textabschnitt wie beispielsweise eine Zelle in einem Arbeitsblatt oder ein Datenbankfeld in einem Eingabefeld. Ist der Server eine Borland C++Builder-Anwendung, gibt Item den Namen der DDE-Server-Komponente an.

Normalerweise verläuft der Datenfluß vom DDE-Server zum DDE-Client. Manche DDE-Server akzeptieren jedoch keine Poke-Daten. Bei Erfolg gibt PokeData den Wert True zurück. Können die Daten nicht gesendet werden, wird False zurückgegeben.

Soll ein einzelner String anstelle einer Stringliste gesendet werden, verwenden Sie die Methode PokeData.

Hinweis

Wird die Methode ExecuteMacro oder ExecuteMacroLines mit auf True gesetztem Parameter WaitFlg aufgerufen, schlägt PokeDataLines automatisch fehl, wenn der Server die Ausführung des aktuellen Makros noch nicht abgeschlossen hat. Die Eigenschaft WaitStat gibt an, wann PokeDataLines versucht, Daten an den Server zu senden.


TDdeClientConv::RequestData

TDdeClientConv	Siehe auch

Die Methode RequestData fordert Daten von einem DDE-Server an.

char * __fastcall RequestData(const System::AnsiString Item);

Beschreibung

Mit RequestData können Sie eine Anforderung nach den mit Item angegebenen Daten an einen DDE-Server senden. Die Methode gibt den Wert des angeforderten DDE-Server-Elements zurück. RequestData reserviert zwar automatisch Speicher für die zurückzugebenden Daten, jedoch muß der PChar-String nach der Verarbeitung explizit mit der Funktion StrDispose freigegeben werden.

Enthält der DDE-Server Elemente, die ständig aktualisiert werden können, kann durch Erstellen von TDdeClientItem-Objekten für diese Elemente ein automatisches Empfangen und Aktualisieren der Daten durchgeführt werden.

Der Wert von Item ist von der Server-Anwendung abhängig. Normalerweise handelt es sich um einen auswählbaren Textabschnitt wie beispielsweise eine Zelle in einem Arbeitsblatt oder ein Datenbankfeld in einem Eingabefeld. Ist der Server eine Borland C++Builder-Anwendung, gibt Item den Namen der DDE-Server-Komponente an.

Hinweis

Genaue Informationen über das Festlegen eines DDE-Elements finden Sie in der Dokumentation des DDE-Servers.


TDdeClientConv::SetLink

TDdeClientConv	Siehe auch

Die Methode SetLink gibt den Server und das Thema einer DDE-Konversation an und versucht die Verbindung zu öffnen, wenn ConnectMode den Wert ddeAutomatic hat.

bool __fastcall SetLink(const System::AnsiString Service, const System::AnsiString Topic);

Beschreibung

Mit SetLink können Sie eine DDE-Konversation vollständig definieren. Hat ConnectMode den Wert ddeManual, entspricht SetLink dem Setzen der Eigenschaften DdeTopic und DdeService sowie dem Löschen aller Daten aus den zugehörigen TDdeClientItem-Objekten. Ist ConnectMode auf ddeAutomatic gesetzt, öffnet SetLink auch die Verbindung zu dem DDE-Server.

Die Parameter Service und Topic legen die Werte der Eigenschaften DdeTopic und DdeService fest.


TDdeClientConv::StartAdvise

TDdeClientConv	Siehe auch

Die Methode StartAdvise startet eine Anweisungsschleife für alle TDdeClientItem-Objekte der aktuellen DDE-Konversation.

bool __fastcall StartAdvise(void);

Beschreibung

Mit StartAdvise können Sie eine Anweisungsschleife für alle TDdeClientItem-Objekte der aktuellen DDE-Konversation starten. Kann die Schleife erfolgreich gestartet werden, gibt StartAdvise den Wert True zurück.


TDdeClientConv::TDdeClientConv

TDdeClientConv	Siehe auch

Der Konstruktor TDdeClientConv erzeugt ein neues TDdeClientConv-Objekt.

__fastcall virtual TDdeClientConv(Classes::TComponent* AOwner);

Beschreibung

Mit TDdeClientConv können Sie eine Instanz von TDdeClientConv erzeugen. Nach dem Aufruf des Konstruktors seines übergeordneten Objekts erzeugt TDdeClientConv die erforderlichen Hilfsobjekte.


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent


TDdeClientConv Beispiel

TDdeClientConv


 TDdeClientItem

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/ddeman.hpp

TDdeClientItem definiert ein Element einer DDE-Konversation.

Beschreibung

Mit TDdeClientItem und TDdeClientConv kann eine Anwendungen als DDE-Client fungieren. Ein TDdeClientItem-Objekt ist ein einzelnes Element, das von einem DDE-Server unterstützt wird. Jedes TDdeClientConv-Objekt kann mit mehreren TDdeClientItem-Objekten verknüpft sein. Wenn ein TDdeClientConv-Objekt eine Verbindung zu einem DDE-Server eingerichtet hat, werden alle TDdeClientItem-Objekte vom Server automatisch aktualisiert, bis die Konversation beendet wird.


Eigenschaften von TDdeClientItem

TDdeClientItem	Alphabetisch	Legende

In TDdeClientItem

DdeConv

DdeItem

Lines

Text

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Name

Owner

Tag


Eigenschaften von TDdeClientItem

TDdeClientItem	Nach Objekten	Legende

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

DdeConv

DdeItem

DesignInfo

Lines

Name

Owner

Tag

Text


TDdeClientItem::DDEConv

TDdeClientItem	Siehe auch

Die Eigenschaft DDEConv gibt das DdeClientConv-Objekt an, dem das TDdeClientItem-Objekt zugeordnet werden soll.

__property TDdeClientConv* DdeConv;

Beschreibung

Mit dieser Eigenschaft können Sie das TDdeClientItem-Objekt einem DdeClientConv-Objekt zuordnen, das die DDE-Konversation steuert. DDEConv richtet die Verbindung zum Server ein, der die Eigenschaft Text für das TDdeClientItem-Objekt liefert.


TDdeClientItem::DDEItem

TDdeClientItem	Siehe auch

Die Eigenschaft DDEItem gibt ein Element einer DDE-Konversation an.

__property System::AnsiString DdeItem;

Beschreibung

Weisen Sie der Eigenschaft DDEItem den Namen eines vom DDE-Server unterstützen DDE-Elements zu. Der Wert von DDEItem hängt von der DDE-Server-Anwendung ab. Normalerweise handelt es sich dabei um einen markierten Textteil, z.B. um eine Zelle eines Arbeitsblattes oder um ein Datenbankfeld, das in einem Eingabefeld dargestellt wird. Wenn der DDE-Server eine Borland C++Builder-Anwendung ist, enthält DDEItem den Namen des entsprechenden TDdeServerItem-Objekts.

Zur Entwurfszeit wird DDEItem in Form eines Strings im Objektinspektor angegeben. Alternativ dazu können Sie DDEItem im Dialogfeld DDE-Info festlegen. Das Dialogfeld wird mit der Ellipsen-Schaltfläche (É) von DdeService oder DdeTopic im Objektinspektor aufgerufen. Klicken Sie in diesem Dialogfeld auf Inhalte einfügen. Wenn sich die Verbindungsinformationen in der Zwischenablage befinden, wählen Sie im Objektinspektor das Element aus der Liste der für DDEItem verfügbaren Einträge aus.

Hinweis

Weitere Informationen über DDE-Elemente finden Sie in der Dokumentation der DDE-Server-Anwendung.


TDdeClientItem::Lines

TDdeClientItem	Siehe auch

Lines enthält die Textdaten, die in einer DDE-Konversation ausgetauscht werden sollen.

__property Classes::TStrings* Lines;

Beschreibung

Mit einem Lesezugriff auf Lines können Sie den durch die DDE-Server-Anwendung aktualisierten Text abrufen. Lines wird automatisch vom DDE-Server aktualisiert. Wenn der Server diese Eigenschaft ändert, tritt das Ereignis OnChange ein.

Indem Sie Lines einen Wert zuweisen, können Sie Daten zum DDE-Server senden.

Lines korrespondiert mit der Eigenschaft Text. Wenn sich der Wert von Lines oder Text ändert, wird der Wert der jeweils anderen Eigenschaft aktualisiert, so daß die erste Zeile von Lines immer den Wert von Text enthält.

Hinweis

Auch mit der Methode PokeDataLines des TDdeClientConv-Objekts können Datenzeilen zum DDE-Server gesendet werden.


TDdeClientItem::Text

TDdeClientItem	Siehe auch	Beispiel

Die Eigenschaft Text enthält die Textdaten, die in einer DDE-Konversation ausgetauscht werden.

__property System::AnsiString Text;

Mit einem Lesezugriff auf Text können Sie den durch die DDE-Server-Anwendung aktualisierten Text abrufen. Text wird automatisch vom DDE-Server aktualisiert. Wenn der Server diese Eigenschaft ändert, tritt das Ereignis OnChange ein.

Indem Sie Text einen Wert zuweisen, können Sie Daten zum DDE-Server senden.

Text korrespondiert mit der Eigenschaft Lines. Wenn sich der Wert von Lines oder Text ändert, wird der Wert der jeweils anderen Eigenschaft aktualisiert, so daß die erste Zeile von Lines immer den Wert von Text enthält.

Hinweis

Auch mit der Methode PokeData des TDdeClientConv-Objekts können Daten zum DDE-Server übermittelt werden.


Ereignisse von TDdeClientItem

TDdeClientItem	Alphabetisch	Legende

In TDdeClientItem

OnChange


Ereignisse von TDdeClientItem

TDdeClientItem	Nach Objekten	Legende

OnChange


TDdeClientItem::OnChange

TDdeClientItem	Siehe auch

Das Ereignis OnChange tritt sofort nach der Aktualisierung der Eigenschaft Lines durch den DDE-Server ein.

__property Classes::TNotifyEvent OnChange;

Beschreibung

Mit einer Ereignisbehandlungsroutine für OnChange können Sie bestimmte Aktionen durchführen, wenn der DDE-Server den Text des TDdeClientItem-Objekts aktualisiert. Der neue Wert kann durch einen Lesezugriff auf eine der Eigenschaften Lines oder Text ermittelt werden.


Methoden von TDdeClientItem

TDdeClientItem	Alphabetisch

In TDdeClientItem

~TDdeClientItem

TDdeClientItem

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TDdeClientItem

TDdeClientItem	Nach Objekten

~TDdeClientItem

Assign

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

DestroyComponents

Destroying

Dispatch

FieldAddress

FindComponent

FreeInstance

FreeNotification

Free

GetParentComponent

HasParent

InheritsFrom

InitInstance

InsertComponent

InstanceSize

MethodAddress

MethodName

NewInstance

RemoveComponent

TDdeClientItem


TDdeClientItem::~TDdeClientItem

TDdeClientItem	Siehe auch

Der Destruktor ~TDdeClientItem gibt den Speicher frei, der für das TDdeClientItem-Objekt reserviert war. Rufen Sie ~TDdeClientItem nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TDdeClientItem automatisch aufgerufen wird.

__fastcall virtual ~TDdeClientItem(void);

~TDdeClientItem gibt vor dem Aufruf des Destruktors des übergeordneten Objekts den Speicher frei, der für die Eigenschaft Lines reserviert war.


TDdeClientItem::TDdeClientItem

TDdeClientItem	Siehe auch

Der Konstruktor TDdeClientItem erzeugt ein neues TDdeClientItem-Objekt.

__fastcall virtual TDdeClientItem(Classes::TComponent* AOwner);

Mit TDdeClientItem können Sie zur Laufzeit ein TDdeClientItem-Objekt instantiieren. Nach dem Aufruf des Konstruktors des übergeordneten Objekts erzeugt TDdeClientItem ein Hilfsobjekt, das die Eigenschaft Lines verwaltet.


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent


TDdeClientItem Beispiel

TDdeClientItem


 TDdeServerItem

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/ddeman.hpp

TDdeServerItem definiert das Element einer DDE-Konversation.

Beschreibung

Mit TDdeServerItem (eventuell in Verbindung mit einem TDdeServerConv-Objekt) kann eine Anwendung als DDE-Server fungieren. DDE-Clients stellen die Verbindung zu einem bestimmten TDdeServerItem-Objekt über die Eigenschaft Name her. Sobald die Verbindung zu einem DDE-Client eingerichtet ist, kann das TDdeServerItem-Objekt den Client aktualisieren oder Daten empfangen, die der Client ihm sendet.


Eigenschaften von TDdeServerItem

TDdeServerItem	Alphabetisch	Legende

In TDdeServerItem

Fmt

Lines

ServerConv

Text

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Name

Owner

Tag


Eigenschaften von TDdeServerItem

TDdeServerItem	Nach Objekten	Legende

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

DesignInfo

Fmt

Lines

Name

Owner

ServerConv

Tag

Text


TDdeServerItem::Fmt

TDdeServerItem	Siehe auch

Die Eigenschaft Fmt ist das Format, das vom DDE-Server verwendet wird, wenn er Daten an den DDE-Client übergibt.

__property int Fmt;

Beschreibung

Indem Sie dieser Eigenschaft in einer Ereignisbehandlungsroutine für OnChange einen Wert zuweisen, können Sie ein Format für die an den DDE-Client übergebenen Daten festlegen, wenn es sich dabei nicht um Text handelt. Die an den DDE-Client übermittelten DDE-Daten enthalten diese Formatinformationen, so daß die Daten vom Client richtig interpretiert werden können. Mit einem Lesezugriff auf Fmt können Sie das Format ermitteln, wenn der Client Daten an den DDE-Server sendet.


TDdeServerItem::Lines

TDdeServerItem	Siehe auch

Die Eigenschaft Lines enthält die Daten, die in einer DDE-Konversation ausgetauscht werden sollen.

__property Classes::TStrings* Lines;

Beschreibung

Weisen Sie Lines die Daten zu, die der DDE-Server an den DDE-Client sendet. Sobald sich die Eigenschaft Lines ändert, tritt das Ereignis OnChange ein, und der neue Wert wird an den DDE-Client gesendet. Wenn der DDE-Server die gesendeten Daten akzeptiert, werden sie in Lines abgelegt, sobald sie vom DDE-Client übernommen wurden. Wenn ein DDE-Client, der Daten sendet, diese Eigenschaft ändert, tritt nach dem Ereignis OnChange das Ereignis OnPokeData ein.

Normalerweise enthält Lines Text. Das Zuweisen eines Wertes an Lines bewirkt, daß die Eigenschaft Fmt auf CF_TEXT gesetzt wird. In Borland C++Builder können Strings jedoch auch Daten enthalten, die kein Text sind. In diesem Fall muß Fmt in der Ereignisbehandlungsroutine für OnChange auf das korrekte Datenformat gesetzt werden.

Lines korrespondiert mit der Eigenschaft Text. Wenn sich der Wert von Lines oder Text ändert, wird der Wert der jeweils anderen Eigenschaft aktualisiert, so daß die erste Zeile von Lines immer den Wert von Text enthält.


TDdeServerItem::ServerConv

TDdeServerItem	Siehe auch

Die Eigenschaft ServerConv gibt das TDdeServerConv-Objekt an, mit dem das TDdeServerItem-Objekt verbunden werden soll.

__property TDdeServerConv* ServerConv;

Beschreibung

Weisen Sie ServerConv einen Wert zu, um das TDdeServerItem-Objekt mit dem DDE-Thema zu verknüpfen, das vom DdeServerConv-Objekt repräsentiert wird. Wenn ServerConv keinen Wert enthält, wird der Wert der Eigenschaft Caption des Formulars, das die TDdeServerItem-Komponente enthält, als DDE-Thema verwendet.


TDdeServerItem::Text

TDdeServerItem	Siehe auch	Beispiel

Die Eigenschaft Text enthält die Daten, die in einer DDE-Konversation ausgetauscht werden.

__property System::AnsiString Text;

Beschreibung

Weisen Sie Text die Daten zu, die der DDE-Server an den DDE-Client sendet. Sobald sich die Eigenschaft Text ändert, tritt das Ereignis OnChange ein, und der neue Wert wird an den DDE-Client übermittelt. Wenn das TDdeServerItem-Objekt gesendete Daten akzeptiert, werden sie in Text abgelegt, sobald sie vom DDE-Client übernommen wurden. Wenn ein DDE-Client, der Daten sendet, diese Eigenschaft ändert, tritt nach dem Ereignis OnChange das Ereignis OnPokeData ein.

Normalerweise enthält diese Eigenschaft nur Text. Das Zuweisen eines Wertes an Text bewirkt, daß die Eigenschaft Fmt auf CF_TEXT gesetzt wird. In Borland C++Builder können Strings jedoch auch Daten enthalten, die kein Text sind. In diesem Fall muß Fmt in der Ereignisbehandlungsroutine für OnChange auf das korrekte Datenformat gesetzt werden.

Text korrespondiert mit der Eigenschaft Lines. Wenn sich der Wert von Lines oder Text ändert, wird der Wert der jeweils anderen Eigenschaft aktualisiert, so daß die erste Zeile von Lines immer den Wert von Text enthält.

Wenn Daten ausgetauscht werden, die mehr als 255 Zeichen umfassen, verwenden Sie die Eigenschaft Lines.


Ereignisse von TDdeServerItem

TDdeServerItem	Alphabetisch	Legende

In TDdeServerItem

OnChange

OnPokeData


Ereignisse von TDdeServerItem

TDdeServerItem	Nach Objekten	Legende

OnChange

OnPokeData


TDdeServerItem::OnChange

TDdeServerItem	Siehe auch

Das Ereignis OnChange tritt ein, bevor Änderungen an der Eigenschaft Lines an den DDE-Client gesendet werden.

__property Classes::TNotifyEvent OnChange;

Beschreibung

Mit einer Ereignisbehandlungsroutine für OnChange können Sie bestimmte Aktionen durchführen, bevor der DDE-Server den DDE-Client aktualisiert. Der neue Wert des TDdeClientItem-Objekts kann durch einen Lesezugriff auf die Eigenschaften Lines oder Text ermittelt werden.

Wenn Lines keine Textdaten enthält, muß der Wert von Fmt in einer Ereignisbehandlungsroutine für OnChange geändert werden. OnChange tritt ein, nachdem Fmt auf CF_TEXT gesetzt wurde (durch eine Zuweisung an Lines), aber bevor die Daten an den Client gesendet werden.


TDdeServerItem::OnPokeData

TDdeServerItem	Siehe auch

Das Ereignis OnPokeData tritt ein, nachdem ein DDE-Client den Wert der Eigenschaft Lines geändert hat.

__property Classes::TNotifyEvent OnPokeData;

Beschreibung

Mit einer Ereignisbehandlungsroutine für OnPokeData können Sie bestimmte Aktionen durchführen, bevor der DDE-Client Daten an den DDE-Server sendet. Der neue Wert des Elements kann durch einen Lesezugriff auf die Eigenschaften Lines oder Text ermittelt werden.

Wenn ein DDE-Client Daten an ein TDdeServerItem-Objekt sendet, wird die Methode PokeData aufgerufen. PokeData löst folgende Aktionen aus:

1	Der Eigenschaft Lines bzw. Text wird der neue Wert zugewiesen.

2	Das Ereignis OnChange tritt ein.

3	Der neue Wert wird zurück an den DDE-Client gesendet.

4	Das Ereignis OnPokeData tritt ein.


Methoden von TDdeServerItem

TDdeServerItem	Alphabetisch

In TDdeServerItem

~TDdeServerItem

Change

CopyToClipboard

PokeData

TDdeServerItem

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TDdeServerItem

TDdeServerItem	Nach Objekten

~TDdeServerItem

Assign

Change

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

CopyToClipboard

DefaultHandler

DestroyComponents

Destroying

Dispatch

FieldAddress

FindComponent

FreeInstance

FreeNotification

Free

GetParentComponent

HasParent

InheritsFrom

InitInstance

InsertComponent

InstanceSize

MethodAddress

MethodName

NewInstance

PokeData

RemoveComponent

TDdeServerItem


TDdeServerItem::~TDdeServerItem

TDdeServerItem	Siehe auch

Der Destruktor ~TDdeServerItem gibt den Speicher frei, der für das TDdeServerItem-Objekt reserviert war. Rufen Sie ~TDdeServerItem nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TDdeServerItem automatisch aufgerufen wird.

__fastcall virtual ~TDdeServerItem(void);

~TDdeServerItem gibt vor dem Aufruf des Destruktors des übergeordneten Objekts den Speicher frei, der für die Eigenschaft Lines reserviert war.


TDdeServerItem::Change

TDdeServerItem	Siehe auch

Die Methode Change löst das Ereignis OnChange aus.

virtual void __fastcall Change(void);

Beschreibung

Mit Change können Sie das Ereignis OnChange auslösen, ohne die Eigenschaften Lines oder Text zu ändern. Verwenden Sie Change in Verbindung mit dem Ereignis OnChange, wenn das TDdeServerItem-Objekt Daten austauschen soll, die zu den von den Eigenschaften Lines und Text verwendeten Strings nicht kompatibel sind.


TDdeServerItem::CopyToClipboard

TDdeServerItem	Siehe auch	Beispiel

Die Methode CopyToClipboard kopiert die Daten der Eigenschaften Text oder Lines zusammen mit den DDE-Verbindungsinformationen in die Zwischenablage.

void __fastcall CopyToClipboard(void);

Beschreibung

Mit CopyToClipboard können DDE-Clients Daten zum DDE-Server übertragen, indem Sie den Befehl Bearbeiten|Inhalte einfügen oder den entsprechenden Befehl der DDE-Client-Anwendung ausführen.

CopyToClipboard funktioniert nur zur Laufzeit. Um zur Entwurfszeit eine DDE-Verbindung herzustellen, markieren Sie das TDdeServerItem-Objekt und wählen Bearbeiten|Kopieren. Anschließend aktivieren Sie die DDE-Client-Anwendung und fügen die Inhalte ihren Regeln entsprechend ein. Weitere Informationen zum Einfügen von Inhalten finden Sie in der Dokumentation der DDE-Client-Anwendung.


TDdeServerItem::PokeData

TDdeServerItem	Siehe auch

Die Methode PokeData verarbeitet Daten, die von einem DDE-Client an einen DDE-Server gesendet wurden.

long __fastcall PokeData(long Data);

Beschreibung

Mit PokeData können Sie dem TDdeServerItem-Objekt mitteilen, daß die DDE-Konversation Daten bereithält, die von einem DDE-Client gesendet wurden. Der Parameter Data ist das DDE-Handle für diese Daten.

Die Methode führt folgende Aktionen aus.

1	Sie ruft mit Hilfe des Handles die gesendeten Daten ab.

2	Sie weist der Eigenschaft Lines die neuen Daten zu.

3	Sie löst das Ereignis OnChange aus.

4	Sie sendet die neuen Daten zurück zum DDE-Client.

5	Sie löst das Ereignis OnPokeData aus.


TDdeServerItem::TDdeServerItem

TDdeServerItem	Siehe auch

Der Konstruktor TDdeServerItem erzeugt ein neues TDdeServerItem-Objekt.

__fastcall virtual TDdeServerItem(Classes::TComponent* AOwner);

Beschreibung

Mit TDdeServerItem können Sie zur Laufzeit ein TDdeServerItem-Objekt instantiieren. Für TDdeServerItem-Objekte, die Sie zur Entwurfszeit in ein Formular einfügen, wird TDdeServerItem automatisch aufgerufen.

Nach dem Aufruf des Konstruktors des übergeordneten Objekts initialisiert TDdeServerItem die Eigenschaft Fmt mit CF_TEXT und erzeugt ein Hilfsobjekt, das die Eigenschaft Lines verwaltet.


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent


TDdeServerItem Beispiel

TDdeServerItem


 TDdeServerConv

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/ddeman.hpp

Das Objekt TDdeServerConv repräsentiert das Thema einer DDE-Konversation mit einem DDE-Client.

Beschreibung

Mit TDdeServerConv wird ein DDE-Thema für die Konversation mit einem DDE-Client eingerichtet. Einzelne Elemente unter diesem DDE-Thema werden von TDdeServerItem-Objekten repräsentiert. Diese Elemente werden mit dem DDE-Server über ihre Eigenschaft ServerConv verbunden.

Die Verwendung einer TDDEServerConv-Komponente ist optional. Auch ohne ein TDDEServerConv-Objekt kann der Client eine DDE-Konversation aufnehmen und Aktualisierungen direkt von einem TDDEServerItem-Objekt empfangen. Allerdings ist eine DDE-Server-Konversation für die Behandlung von Makros erforderlich, die vom DDE-Client stammen.

Die Eigenschaft Name der DDE-Server-Konversation bezeichnet das Thema, das von DDE-Clients für das Einrichten der Verbindung zur DDE-Server-Konversation verwendet wird. DDE-Server-Elemente, die keiner DDE-Server-Konversation zugeordnet sind, ermitteln den Themennamen aus der Eigenschaft Caption des Formulars. Durch ein TDDEServerConv-Objekt können mehrere DDE-Themen in einem einzigen Formular eingerichtet werden. Außerdem ist ein solches Objekt nützlich, wenn die Eigenschaft Caption des Formulars nicht eindeutig ist oder sich zur Laufzeit ändert.


Eigenschaften von TDdeServerConv

TDdeServerConv	Alphabetisch	Legende

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Name

Owner

Tag


Eigenschaften von TDdeServerConv

TDdeServerConv	Nach Objekten	Legende

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

DesignInfo

Name

Owner

Tag


Ereignisse von TDdeServerConv

TDdeServerConv	Alphabetisch	Legende

In TDdeServerConv

OnClose

OnExecuteMacro

OnOpen


Ereignisse von TDdeServerConv

TDdeServerConv	Nach Objekten	Legende

OnClose

OnExecuteMacro

OnOpen


TDdeServerConv::OnClose

TDdeServerConv	Siehe auch

OnClose wird ausgelöst, wenn der DDE-Client die DDE-Konversation beendet.

__property Classes::TNotifyEvent OnClose;

Beschreibung

In einer Ereignisbehandlungsroutine für OnClose können Sie festlegen, welche Aktion bei Beendigung der DDE-Konversation stattfinden soll. Dies tritt dann ein, wenn der Client die Konversation beendet, aber nicht, wenn das TDdeServerConv-Objekt freigegeben wird. In diesem Fall löschen sich die DDE-Server-Einträge einfach selbsttätig aus der DDE-Server-Konversation. Die Verknüpfung zum DDE-Client bleibt aber bestehen.

Der Parameter Sender bezeichnet die DDE-Server-Konversation, nicht den DDE-Client.???????????


TDdeServerConv::OnExecuteMacro

TDdeServerConv	Siehe auch

Das Ereignis OnExecuteMacro wird ausgelöst, wenn der DDE-Client ein Makro an die DDE-Server-Konversation sendet.

typedef void __fastcall (__closure *TMacroEvent)(System::TObject* Sender, Classes::TStrings* Msg);

__property TMacroEvent OnExecuteMacro;

Beschreibung

In einer Ereignisbehandlungsroutine für OnExecuteMacro implementieren Sie eine Reaktion auf die vom DDE-Client gesendeten Makros. Der Parameter Sender bezeichnet die DDE-Server-Konversation. Der Parameter Msg enthält den Makro-String, der ausgeführt werden soll.


TDdeServerConv::OnOpen

TDdeServerConv	Siehe auch

Das Ereignis OnOpen tritt sofort ein, nachdem die DDE-Verbindung zum Client hergestellt wurde.

typedef void __fastcall (__closure *TNotifyEvent)(System::TObject* Sender);

__property Classes::TNotifyEvent OnOpen;

Beschreibung

In einer Ereignisbehandlungsroutine für OnOpen legen Sie eine bestimmte Aktion fest, die stattfinden soll, sobald eine Verbindung zum DDE-Client besteht. Der Parameter Sender bezeichnet die DDE-Server-Konversation, und nicht den DDE-Client.


Methoden von TDdeServerConv

TDdeServerConv	Alphabetisch

In TDdeServerConv

~TDdeServerConv

ExecuteMacro

TDdeServerConv

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TDdeServerConv

TDdeServerConv	Nach Objekten

~TDdeServerConv

Assign

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

DestroyComponents

Destroying

Dispatch

ExecuteMacro

FieldAddress

FindComponent

FreeInstance

FreeNotification

Free

GetParentComponent

HasParent

InheritsFrom

InitInstance

InsertComponent

InstanceSize

MethodAddress

MethodName

NewInstance

RemoveComponent

TDdeServerConv


TDdeServerConv::~TDdeServerConv

TDdeServerConv	Siehe auch

Der Destruktor ~TDdeServerConv gibt den Speicher frei, der für das TDdeServerConv-Objekt reserviert war. Rufen Sie ~TDdeServerConv nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TDdeServerConv automatisch aufgerufen wird.

__fastcall virtual ~TDdeServerConv(void);


TDdeServerConv::ExecuteMacro

TDdeServerConv	Siehe auch

Die Methode ExecuteMacro antwortet auf Makros, die vom DDE-Client gesendet wurden.

long __fastcall ExecuteMacro(long Data);

Beschreibung

Für eine Borland C++Builder-Anwendung ist ExecuteMacro der einzige Weg, auf Makros zu reagieren, die von DDE-Clients gesendet wurden. ExecuteMacro wird aufgerufen, wenn der DDE-Client ein Makro über die DDE-Verbindung sendet. Der Parameter Data bezeichnet das Handle zu den DDE-Daten, die das Makro enthalten.

ExecuteMacro ermittelt aus Data die Strings des Makros und ruft die Ereignisbehandlungsroutine für OnExecuteMacro auf. Wenn es keine solche gibt, wird das Makro ignoriert. Unabhängig vom Vorhandensein einer Behandlungsroutine für OnExecuteMacro empfängt der DDE-Client immer eine Benachrichtigung, ob das Makro erfolgreich übertragen wurde, außer wenn Data kein Makro enthält.


TDdeServerConv::TDdeServerConv

TDdeServerConv	Siehe auch

Der Konstruktor TDdeServerConv erzeugt ein neues TDdeServerConv-Objekt.

__fastcall virtual TDdeServerConv(Classes::TComponent* AOwner);

Beschreibung

Mit TDdeServerConv wird zur Laufzeit eine Instanz von TDdeServerConv erzeugt. Für alle Objekte dieser Klasse, die zur Entwurfszeit im Formular plaziert werden, wird TDdeServerConv automatisch aufgerufen.


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent


TDdeServerConv Beispiel

TDdeServerConv


TDesigner

Hierarchie	Eigenschaften	Methoden

Header

vcl/forms.hpp

TDesigner ist ein abstrakter Typ, der direkt von TObject abgeleitet ist. TObject bildet die Grundlage für alle Formular-Designer in der Borland C++Builder-Umgebung.

Beschreibung

Das abstrakte Designer-Objekt stellt zwei Eigenschaften zur Verfügung, die von allen Designer-Objekten verwendet werden, und fünf abstrakte Methoden, die abgeleitete Designer-Objekte überschreiben müssen.


Eigenschaften von TDesigner

TDesigner	Alphabetisch

In TDesigner

Form

IsControl


Eigenschaften von TDesigner

TDesigner	Nach Objekten

Form

IsControl


TDesigner::Form

TDesigner

Die Eigenschaft Form verweist auf das Formular, das gegenwärtig entworfen wird.

__property TForm* Form;


TDesigner::IsControl

TDesigner

Die Eigenschaft IsControl gibt an, ob das Formular ein Formular oder ein Steuerelement darstellt.

__property bool IsControl;


Methoden von TDesigner

TDesigner	Alphabetisch

In TDesigner

~TDesigner

IsDesignMsg

Modified

Notification

PaintGrid

TDesigner

ValidateRename

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TDesigner

TDesigner	Nach Objekten

~TDesigner

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

IsDesignMsg

MethodAddress

MethodName

Modified

NewInstance

Notification

PaintGrid

TDesigner

ValidateRename


TDesigner::~TDesigner

TDesigner

Der Destruktor ~TDesigner gibt den Speicher frei, der für das TDesigner-Objekt reserviert war. Rufen Sie ~TDesigner nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TDesigner automatisch aufgerufen wird.

__fastcall virtual ~TDesigner(void);


TDesigner::IsDesignMsg

TDesigner

Die Methode IsDesignMsg legt fest, ob eine Botschaft vom Designer verarbeitet werden soll.

virtual bool __fastcall IsDesignMsg(Controls::TControl* Sender, Messages::TMessage &Message);

Beschreibung

IsDesignMsd wird für jede Botschaft aufgerufen, die an eine Komponente im Designer gesendet wird. Die Methode gibt True zurück, wenn der Designer die Botschaft für die Komponente verarbeiten soll.


TDesigner::Modified

TDesigner	Beispiel

Die Methode Modified informiert Eigenschafts- und Komponenten-Editoren, wenn eine Komponente geändert wurde.

virtual void __fastcall Modified(void);

Beschreibung

Die Eigenschafts- und Komponenten-Editoren rufen diese Methode bei jeder Änderung an einer Komponente auf, so daß der Designer darauf reagieren kann.


TDesigner::Notification

TDesigner

Die Methode Notification erlaubt dem Designer zu reagieren, wenn eine Benachrichtigung an ein Formular gesendet wird.

virtual void __fastcall Notification(Classes::TComponent* AComponent, Classes::TOperation Operation );

Beschreibung

Erhält ein Formular eine Benachrichtigung, ruft es die Methode Notification des Designers auf. So kann dieser auf alle Benachrichtigungen reagieren, die das Formular erhält.


TDesigner::PaintGrid

TDesigner

Die Methode PaintGrid zeichnet das Ausrichtungsgitter auf der Zeichenfläche des Formular.

virtual void __fastcall PaintGrid(void);


TDesigner::TDesigner

TDesigner

Der Konstruktor TDesigner erzeugt ein neues TDesigner-Objekt.

__fastcall TDesigner(void);


TDesigner::ValidateRename

TDesigner

Diese Methode, die normalerweise von der Methode ValidateRename der Formulars aufgerufen wird, schränkt die Möglichkeiten zum Umbenennen ein, so daß beispielsweise reservierte Wörter nicht verwendet werden können.

virtual void __fastcall ValidateRename(Classes::TComponent* AComponent, const System::AnsiString CurName, const System::AnsiString NewName);


Hierarchie

TObject


TDesigner Beispiel

TDesigner


 TDirectoryListBox

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/filectrl.hpp

TDirectoryListBox kapselt das unter Windows übliche Listenfeld, in dem die Verzeichnisstruktur des aktuellen Laufwerks abgebildet wird.

Beschreibung

TDirectoryListBox implementiert das in TCustomListbox eingeführte generische Verhalten.Die Klasse deklariert viele der von TCustomListBox geerbten Eigenschaften als published und fügt neue Funktionen hinzu, mit denen der Benutzer das Verzeichnis oder das Laufwerk wechseln kann.

Eine Verzeichnisliste kann mit einer Dateiliste synchronisiert werden. Das heißt wenn der Benutzer das Verzeichnis wechselt, enthält die Dateiliste immer die entsprechenden Dateien. Hier eine Ereignisbehandlungsroutine für eine Verzeichnisliste:

void __fastcall TForm1::DirectoryListBox1Change(TObject *Sender)

{

  FileListBox1->Directory = DirectoryListBox1->Directory;

}

Andere von TCustomListBox abgeleitete Klassen stellen ebenfalls spezialisierte Listenfelder zur Verfügung. Sie können solche Listenfelder aber auch selbst von TCustomListBox ableiten.


Eigenschaften von TDirectoryListBox

TDirectoryListBox	Alphabetisch	Legende

In TDirectoryListBox

CaseSensitive

Directory

DirLabel

Drive

FileList

PreserveCase

Abgeleitet von TCustomListBox

Canvas

Columns

IntegralHeight

ItemHeight

ItemIndex

Items

SelCount

Selected

TopIndex

Abgeleitet von TWinControl

Brush

ClientOrigin

ClientRect

ControlCount

Controls

Ctl3D

Handle

HelpContext

ParentCtl3D

Showing

TabOrder

TabStop

Abgeleitet von TControl

Align

BoundsRect

ClientHeight

ClientWidth

Color

ControlState

ControlStyle

Cursor

DragCursor

DragMode

Enabled

Font

Height

Hint

Left

Name

Parent

ParentColor

ParentFont

ParentShowHint

PopupMenu

ShowHint

Top

Visible

Width

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TDirectoryListBox

TDirectoryListBox	Nach Objekten	Legende

Align

BoundsRect

Brush

Canvas

CaseSensitive

ClientHeight

ClientOrigin

ClientRect

ClientWidth

Color

Columns

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlCount

ControlState

Controls

ControlStyle

Ctl3D

Cursor

DesignInfo

Directory

DirLabel

DragCursor

DragMode

Drive

Enabled

FileList

Font

Handle

Height

HelpContext

Hint

IntegralHeight

ItemHeight

ItemIndex

Items

Left

Name

Owner

ParentColor

ParentCtl3D

ParentFont

ParentShowHint

Parent

PopupMenu

PreserveCase

SelCount

Selected

ShowHint

Showing

TabOrder

TabStop

Tag

TopIndex

Top

Visible

Width


TDirectoryListBox::CaseSensitive

TDirectoryListBox	Siehe auch

Die Eigenschaft CaseSensitive gibt an, ob das Dateisystem Groß-/Kleinschreibung von Verzeichnisinformationen unterstützt.

__property bool CaseSensitive;

Beschreibung

Mit CaseSensitive können Sie herausfinden, ob das aktuelle Dateisystem die Groß-/Kleinschreibung von Dateinamen unterstützt. Wenn dies der Fall ist, gibt CaseSensitive True, ansonsten False zurück.


TDirectoryListBox::Directory

TDirectoryListBox	Siehe auch

Die Eigenschaft Directory legt für die Verzeichnisliste das aktuelle Verzeichnis fest.

__property System::AnsiString Directory;

Beschreibung

Die Verzeichnisliste zeigt den Wert der Eigenschaft Directory als aktuelles Verzeichnis an. Das folgende Beispiel zeigt, wie eine Verzeichnisliste und eine Dateiliste über ihre Eigenschaft Directory zusammenarbeiten.

Beispiel

Der folgende Code reagiert auf Änderungen am aktuellen Verzeichnis und zeigt in der Dateiliste die Dateien des neuen Verzeichnisses an, wenn der Benutzer in der Verzeichnisliste das Verzeichnis wechselt:

void __fastcall TForm1::DirectoryListBox1Change(TObject* Sender)

{

  FileListBox1->Directory = DirectoryListBox1->Directory;

}


TDirectoryListBox::DirLabel

TDirectoryListBox	Siehe auch

Die Eigenschaft DirLabel stellt eine einfache Möglichkeit dar, das aktuelle Verzeichnis in einem TLabel-Objekt als Beschriftung anzuzeigen.

__property Stdctrls::TLabel* DirLabel;

Beschreibung

Weisen Sie DirLabel das TLabel-Objekt zu, das mit dem aktuellen Verzeichnis aktualisiert werden soll. Wenn sich das aktuelle Verzeichnis in der Verzeichnisliste ändert, wird die Änderung sofort in der Beschriftung angezeigt.


TDirectoryListBox::Drive

TDirectoryListBox	Siehe auch

Die Eigenschaft Drive legt das Laufwerk fest, dessen Verzeichnisstruktur im Listenfeld angezeigt wird.

__property char Drive;

Beschreibung

Wenn sich der Wert von Drive ändert, wird der Eigenschaft Directory das aktuelle Verzeichnis im angegebenen Laufwerk zugewiesen.

Beispiel

Dieses Beispiel geht davon aus, daß ein Formular ein Kombinationsfeld, eine Dateiliste und eine Verzeichnisliste enthält. Der Code reagiert auf Änderungen an dem Kombinationsfeld, in dem die Laufwerke angezeigt werden. Er zeigt in der Verzeichnisliste das aktuelle Verzeichnis des neuen Laufwerks und in der Dateiliste die Dateien dieses Verzeichnisses an, wenn der Benutzer im Kombinationsfeld das Laufwerk wechselt.

void __fastcall  TForm1->DriveComboBox1Change(TObject* Sender)

{

  DirectoryListBox1->Drive = DriveComboBox1->Drive;

  FileListBox1->Directory = DirectoryListBox1->Directory;

}


TDirectoryListBox::FileList

TDirectoryListBox	Siehe auch

Mit der Eigenschaft FileList läßt sich eine Verzeichnisliste auf einfache Weise mit einer Dateiliste verknüpfen.

__property TFileListBox* FileList;

Beschreibung

Weisen Sie FileList die Dateiliste zu, in der die Dateien des aktuellen Verzeichnisses angezeigt werden sollen.

Setzen Sie auch die Eigenschaft Directory der Verzeichnisliste.

Beispiel

Im folgenden Beispiel enthält ein Formular eine Schaltfläche, ein Eingabefeld, eine Beschriftung, ein Kombinationsfeld, das Laufwerke anzeigt, eine Verzeichnisliste, eine Dateiliste und ein Kombinationsfeld, das Filter anzeigt. Wenn der Benutzer auf die Schaltfläche klickt, arbeiten die anderen Steuerelemente des Formulars auf die gleiche Weise zusammen, wie Sie es von den üblichen Dialogen zum öffnen oder Speichern von Dateien gewohnt sind.

void  __fastcall TForm1::Button1Click(TObject* Sender)

{

  DriveComboBox1->DirList = DirectoryListBox1;

  DirectoryListBox1->FileList = FileListBox1;

  DirectoryListBox1->DirLabel = Label1;

  FileListBox1->FileEdit = Edit1;

  FilterComboBox1->FileList = FileListBox1;

}


TDirectoryListBox::PreserveCase

TDirectoryListBox	Siehe auch

Die Eigenschaft PreserveCase gibt an, ob das Dateisystem beim Speichern von Dateien die Groß-/Kleinschreibung der Dateinamen beibehält.

__property bool PreserveCase;

Beschreibung

Mit PreserveCase können Sie herausfinden, ob das aktuelle Dateisystem die Groß-/Kleinschreibung von Dateinamen beibehält. Wenn das der Fall ist, liefert PreserveCase True zurück, ansonsten False.


Ereignisse von TDirectoryListBox

TDirectoryListBox	Alphabetisch	Legende

In TDirectoryListBox

OnChange

Abgeleitet von TWinControl

OnEnter

OnExit

OnKeyDown

OnKeyPress

OnKeyUp

Abgeleitet von TControl

OnClick

OnDblClick

OnDragDrop

OnDragOver

OnEndDrag

OnMouseDown

OnMouseMove

OnMouseUp

OnStartDrag


Ereignisse von TDirectoryListBox

TDirectoryListBox	Nach Objekten	Legende

OnChange

OnClick

OnDblClick

OnDragDrop

OnDragOver

OnEndDrag

OnEnter

OnExit

OnKeyDown

OnKeyPress

OnKeyUp

OnMouseDown

OnMouseMove

OnMouseUp

OnStartDrag


TDirectoryListBox::OnChange

TDirectoryListBox	Siehe auch

Das Ereignis OnChange tritt ein, wenn der Benutzer mit Hilfe der Maus oder der Tastatur ein neues Verzeichnis auswählt (indem er z.B. den Markierungsbalken bewegt und die EINGABE-Taste drückt).

typedef void __fastcall (__closure *TNotifyEvent)(System::TObject* Sender);

__property Classes::TNotifyEvent OnChange;

Beschreibung

Mit einer Ereignisbehandlungsroutine für OnChange können Sie bestimmte Aktionen durchführen, wenn der Benutzer ein neues Verzeichnis auswählt.

Beispiel

In einer Ereignisbehandlungsroutine für OnChange können Sie die Verzeichnisliste mit einer Dateiliste (TFileListBox) synchronisieren. Sobald der Benutzer mit Hilfe der Verzeichnisliste das Verzeichnis wechselt, zeigt die Dateiliste die Dateien des neuen Verzeichnisses an. Diese Behandlungsroutine könnte etwa so aussehen:

void __fastcall TForm1::DirectoryListBox1Change(TObject* Sender);

{

  FileListBox1->Directory := DirectoryListBox1->Directory;

}


Methoden von TDirectoryListBox

TDirectoryListBox	Alphabetisch

In TDirectoryListBox

~TDirectoryListBox

DisplayCase

FileCompareText

GetItemPath

OpenCurrent

TDirectoryListBox

Update

Abgeleitet von TCustomListBox

Clear

ItemAtPos

ItemRect

Abgeleitet von TWinControl

Broadcast

CanFocus

ContainsControl

ControlAtPos

DisableAlign

EnableAlign

Focused

GetTabOrderList

HandleAllocated

HandleNeeded

InsertControl

Invalidate

PaintTo

Realign

RemoveControl

Repaint

ScaleBy

ScrollBy

SetBounds

SetFocus

UpdateControlState

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

GetTextLen

Hide

Perform

Refresh

ScreenToClient

SendToBack

SetTextBuf

Show

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TDirectoryListBox

TDirectoryListBox	Nach Objekten

~TDirectoryListBox

Assign

BeginDrag

BringToFront

Broadcast

CanFocus

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

Clear

ClientToScreen

ContainsControl

ControlAtPos

DefaultHandler

DestroyComponents

Destroying

DisableAlign

Dispatch

DisplayCase

DragDrop

Dragging

EnableAlign

EndDrag

FieldAddress

FileCompareText

FindComponent

Focused

FreeInstance

FreeNotification

Free

GetItemPath

GetParentComponent

GetTabOrderList

GetTextBuf

GetTextLen

HandleAllocated

HandleNeeded

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InsertControl

InstanceSize

Invalidate

ItemAtPos

ItemRect

MethodAddress

MethodName

NewInstance

OpenCurrent

PaintTo

Perform

Realign

Refresh

RemoveComponent

RemoveControl

Repaint

ScaleBy

ScreenToClient

ScrollBy

SendToBack

SetBounds

SetFocus

SetTextBuf

Show

TDirectoryListBox

UpdateControlState

Update


TDirectoryListBox::~TDirectoryListBox

TDirectoryListBox	Siehe auch

Der Destruktor ~TDirectoryListBox gibt den Speicher frei, der für das TDirectoryListBox-Objekt reserviert war. Rufen Sie ~TDirectoryListBox nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TDirectoryListBox automatisch aufgerufen wird.

__fastcall virtual ~TDirectoryListBox(void);

Beschreibung

~TDirectoryListBox gibt die Bitmaps der Ordnersymbole frei und ruft dann den Destruktor des übergeordneten Objekts auf.


TDirectoryListBox::DisplayCase

TDirectoryListBox	Siehe auch

Die Methode DisplayCase wandelt den übergebenen String entweder in Kleinbuchstaben um oder gibt ihn unverändert zurück.

System::AnsiString __fastcall DisplayCase(const System::AnsiString S);

Beschreibung

DisplayCase konvertiert den String S unter Verwendung des gegenwärtig installierten Sprachtreibers in Kleinbuchstaben, wenn weder PreserveCase noch CaseSensitive True ist. Andernfalls wird S unverändert zurückgegeben.


TDirectoryListBox::FileCompareText

TDirectoryListBox	Siehe auch

Die Methode FileCompareText vergleicht zwei Strings unter Berücksichtigung der Groß-/Kleinschreibung des Dateisystems.

int __fastcall FileCompareText(const System::AnsiString A, const System::AnsiString B);

Beschreibung

FileCompareText vergleicht die in A und B übergebenen Strings, wenn CaseSensitive False ist. Andernfalls wird der Vergleich mit Hilfe von AnsiCompareStr durchgeführt.


TDirectoryListBox::GetItemPath

TDirectoryListBox	Siehe auch

Die Methode GetItemPath gibt den Pfad eines Verzeichnisses in der Verzeichnisliste zurück.

System::AnsiString __fastcall GetItemPath(int Index);

Beschreibung

Mit GetItemPath können sie den Pfad des im Parameter Index angegebenen Verzeichnisses ermitteln. Das erste Verzeichnis in der Liste hat den Index 0.

Beispiel

Das folgende Beispiel verwendet ein Formular mit einer Verzeichnisliste, einer Schaltfläche und einer Beschriftung. Wenn der Benutzer ein Verzeichnis auswählt und auf die Schaltfläche klickt, wird das Verzeichnis geöffnet und der Pfad des zweiten Verzeichnisses im Listenfeld als Beschriftung eingeblendet.

void  __fastcall TForm1::Button1Click(TObject* Sender);

{

  DirectoryListBox1->OpenCurrent();

  Label1->Caption = DirectoryListBox1->GetItemPath(1);

}


TDirectoryListBox::OpenCurrent

TDirectoryListBox

Die Methode OpenCurrent öffnet das ausgewählte Verzeichnis.

void __fastcall OpenCurrent(void);

Beschreibung

OpenCurrent öffnet das in der Verzeichnisliste ausgewählte Verzeichnis, als ob der Benutzer doppelt auf das Verzeichnis geklickt hätte.

Beispiel

Dieses Beispiel verwendet ein Formular mit einer Verzeichnisliste, einer Schaltfläche und einer Beschriftung. Wenn der Benutzer ein Verzeichnis in der Liste markiert und auf die Schaltfläche klickt, wird das Verzeichnis geöffnet und der Pfad des zweiten Verzeichnisses in der Liste als Beschriftung angezeigt.

void __fastcall  TForm1::Button1Click(TObject* Sender)

{

  DirectoryListBox1->OpenCurrent();

  Label1->Caption = DirectoryListBox1->GetItemPath(1);

}


TDirectoryListBox::TDirectoryListBox

TDirectoryListBox	Siehe auch

Der Konstruktor TDirectoryListBox erzeugt ein neues TDirectoryListBox-Objekt.

__fastcall virtual TDirectoryListBox(Classes::TComponent* AOwner);

Beschreibung

Mit TDirectoryListBox wird zur Laufzeit eine Verzeichnisliste instantiiert. Für alle Komponenten dieser Art, die zur Entwurfszeit erzeugt wurden, wird TDirectoryListBox automatisch aufgerufen.

TDirectoryListBox reserviert Speicher für die Verzeichnisliste und ruft den Konstruktor seines übergeordneten Objekts auf. Dann werden folgende Initialisierungen vorgenommen:

•	Width wird auf 145 gesetzt.

•	Style wird auf lbOwnerDrawFixed gesetzt.

•	Sorted wird auf False gesetzt.

Zuletzt werden die Bitmaps für die Ordner Open, Close und Current erzeugt und geladen. Als Verzeichnis wird das aktuelle Verzeichnis auf dem aktuellen Laufwerk eingestellt.


TDirectoryListBox::Update

TDirectoryListBox	Beispiel

Die Methode Update aktualisiert die Verzeichnisliste.

void __fastcall Update(void);

Beschreibung

Update aktualisiert die Verzeichnisliste mit den aktuellen Einstellungen.

Beispiel

Das folgende Beispiel weist der Eigenschaft Directory von DirectoryListBox1 den Wert C:\TEMP zu. Wenn der Benutzer auf Button1 klickt, wird in C:\TEMP ein Unterverzeichnis namens MYDIR angelegt. Beachten Sie, daß die Aktualisierung in DirectoryListBox1 erst durchgeführt wird, wenn Button2 angeklickt und dadurch Update aufgerufen wird.

void __fastcall  TForm1::Button1Click(TObject* Sender)

{

  ::CreateDirectory("c:\temp\mydir",NULL);

}

void  __fastcall TForm1::FormCreate(TObject* Sender);

{

  DirectoryListBox1->Directory = "c:\temp";

}

void __fastcall  TForm1::Button2Click(TObject* Sender);

{

  DirectoryListBox1->Update();

}


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TControl

TWinControl

TCustomListBox


TDirectoryListBox Beispiel

TDirectoryListBox


TDragObject

Hierarchie	Methoden	Siehe auch

Header

vcl/controls.hpp

TDragObject ist die Basisklasse für Drag-and-Drop-Operationen in Borland C++Builder.

Beschreibung

Mit TDragObject können Drag-and-Drop-Operationen für die Daten eines Objekts implementiert werden, anstatt für das Objekts selbst, das die Daten enthält. Hierzu wird ein Objekt von TDragObject abgeleitet, und dessen virtuelle Methoden werden nach Bedarf überschrieben. Erzeugen Sie das benutzerdefinierte Drag-Objekt in einem OnStartDrag-Ereignis. Um eine Drag-and-Drop-Operation an einem bestimmten Ziel zu akzeptieren, wird im Ereignis OnDragOver des Ziels die als public deklarierte Funktion IsDragObject verwendet.

TDragObject kann Drag-and-Drop-Operationen sehr flexibel verarbeiten. Normalerweise bezeichnet der Parameter Source der Ereignisse OnDragOver und OnDragDrop das Steuerelement, das die Drag-Operation einleitet. Wenn mehrere Steuerelemente unterschiedlichen Typs einen Drag-Vorgang für gleichartige Daten starten müssen (z.B. Dateinamen, Texte, Geldbeträge usw.), müßte die Quelle jeden dieser Steuerelement-Typen unterstützen. Bei einem Drag-Objekt benötigt das Ziel nur Informationen darüber, wie das Drag-Objekt als Quelle bearbeitet werden muß, da alle Quell-Steuerelemente in ihren OnStartDrag-Ereignissen denselben Typ von Drag-Objekt erzeugen können. Die Ereignisse OnDragOver und OnDragDrop signalisieren über einen Aufruf von IsDragObject, ob es sich bei der Quelle um ein Drag-Objekt handelt.

Drag-Objekte können sowohl innerhalb der Haupt-EXE-Datei als auch zwischen DLLs verschoben werden.


Methoden von TDragObject

TDragObject	Alphabetisch	Legende

In TDragObject

~TDragObject

Finished

GetDragCursor

GetDragImages

GetName

HideDragImage

Instance

ShowDragImage

TDragObject

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TDragObject

TDragObject	Nach Objekten	Legende

~TDragObject

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Finished

FreeInstance

Free

GetDragCursor

GetDragImages

GetName

HideDragImage

InheritsFrom

InitInstance

InstanceSize

Instance

MethodAddress

MethodName

NewInstance

ShowDragImage

TDragObject


TDragObject::~TDragObject

TDragObject

Der Destruktor ~TDragObject gibt den Speicher frei, der für das TDragObject-Objekt reserviert war. Rufen Sie ~TDragObject nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TDragObject automatisch aufgerufen wird.

__fastcall virtual ~TDragObject(void);


TDragObject::Finished

TDragObject	Siehe auch

Die Methode Finished wird aufgerufen, wenn zur Beendigung der Drag-Operation die Maustaste losgelassen wird.

virtual void __fastcall Finished(System::TObject* Target, int X, int Y, bool Accepted);

Beschreibung

Die Methode Finished führt standardmäßig keine Aktion aus. Sie kann aber geeignet überschrieben werden. Der Parameter Target ist das Objekt, das den Drag-Vorgang zugelassen hat. Target kann NULL sein. Die Eigenschaft Accepted hat den Wert True, wenn das Zielobjekt (Target) den Vorgang akzeptiert. In TDragControlObject ist Finished implementiert und wird dort überschrieben.


TDragObject::GetDragCursor

TDragObject	Siehe auch

Die Methode GetDragCursor wird aufgerufen, um das Cursorsymbol zu ermitteln, das während einer Mausbewegung angezeigt werden soll.

virtual TCursor __fastcall GetDragCursor(bool Accepted, int X, int Y);

Beschreibung

Wenn das Ziel-Steuerelement an der in Pixel angegebenen X/Y-Position das Ziehen zuläßt (Accepted hat den Wert True), setzt das Drag-Objekt den Cursor auf crDrag. Per Voreinstellung wird das Symbol crNoDrop angezeigt.


TDragObject::GetDragImages

TDragObject	Siehe auch

Die Methode GetDragImages wird zu Beginn einer Drag-and-Drop-Operation aufgerufen und gibt die Bilderliste des Steuerelements zurück. In dieser Liste befindet sich das Bild, das während des Ziehens angezeigt werden soll.

virtual TCustomImageList* __fastcall GetDragImages(void);

Beschreibung

Die Bilderliste enthält normalerweise nur ein einziges Element. Die VCL übernimmt die automatische Erzeugung und Verwaltung dieser Liste. Wenn die Liste mit NULL referenziert ist, wird allein das Cursor-Symbol verwendet.


TDragObject::GetName

TDragObject	Siehe auch

GetName liefert den Namens-String zurück, der die Drag-Operation bezeichnet.

virtual System::AnsiString __fastcall GetName(void);

Beschreibung

Per Voreinstellung liefert GetName den Klassennamen. Dies kann aber durch Überschreiben in einen aussagefähigeren String geändert werden.


TDragObject::HideDragImage

TDragObject	Siehe auch

HideDragImage ist eine virtuelle Methode, die keine Funktionalität implementiert.

virtual void __fastcall HideDragImage(void);

Beschreibung

HideDragImage ist eine virtuelle Methode und kann deshalb in einer von TDragObject abgeleiteten Klasse überschrieben werden. HideDragImage wird in der abgeleiteten Klasse TDragControlObject überschrieben.


TDragObject::Instance

TDragObject	Siehe auch

Die Methode Instance gibt das Instanzen-Handle (Modul-Handle) der EXE- oder DLL-Datei zurück, in der das Drag-Objekt erzeugt wurde.

virtual int __fastcall Instance(void);


TDragObject::ShowDragImage

TDragObject	Siehe auch

ShowDragImage ist eine virtuelle Methode, die keine Funktionalität implementiert.

virtual void __fastcall ShowDragImage(void);

Beschreibung

ShowDragImage ist eine virtuelle Methode, die in einer von TDragObject abgeleiteten Klasse überschrieben werden kann. ShowDragImage wird in der abgeleiteten Klasse TDragControlObject überschrieben.


TDragObject::TDragObject

TDragObject

Der Konstruktor TDragObject erzeugt ein neues TDragObject-Objekt.

__fastcall TDragObject(void);


Gültigkeitsbereich

Protected


Hierarchie

TObject


TDragObject Beispiel

TDragObject


 TDrawGrid

Hierarchie	Eigenschaften	Methoden	Ereignisse

Header

vcl/grids.hpp

TDrawGrid ist ein Gitter, mit dessen Hilfe eine bestehende Datenstruktur in Spalten und Zeilen angezeigt werden kann. TDrawGrid ist ein indirekter Nachkomme von TWinControl.


Eigenschaften von TDrawGrid

TDrawGrid	Alphabetisch	Legende

Abgeleitet von TCustomGrid

BorderStyle

Col

ColCount

ColWidths

DefaultColWidth

DefaultDrawing

DefaultRowHeight

EditorMode

FixedColor

FixedCols

FixedRows

GridHeight

GridLineWidth

GridWidth

LeftCol

Options

Row

RowCount

RowHeights

ScrollBars

Selection

TabStops

TopRow

VisibleColCount

VisibleRowCount

Abgeleitet von TCustomControl

Canvas

Abgeleitet von TWinControl

Brush

ClientOrigin

ClientRect

ControlCount

Controls

Ctl3D

Handle

HelpContext

ParentCtl3D

Showing

TabOrder

TabStop

Abgeleitet von TControl

Align

BoundsRect

ClientHeight

ClientWidth

Color

ControlState

ControlStyle

Cursor

DragCursor

DragMode

Enabled

Font

Height

Hint

Left

Name

Parent

ParentColor

ParentFont

ParentShowHint

PopupMenu

ShowHint

Top

Visible

Width

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TDrawGrid

TDrawGrid	Nach Objekten	Legende

Align

BorderStyle

BoundsRect

Brush

Canvas

ClientHeight

ClientOrigin

ClientRect

ClientWidth

ColCount

Color

Col

ColWidths

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlCount

ControlState

Controls

ControlStyle

Ctl3D

Cursor

DefaultColWidth

DefaultDrawing

DefaultRowHeight

DesignInfo

DragCursor

DragMode

EditorMode

Enabled

FixedColor

FixedCols

FixedRows

Font

GridHeight

GridLineWidth

GridWidth

Handle

Height

HelpContext

Hint

LeftCol

Left

Name

Options

Owner

ParentColor

ParentCtl3D

ParentFont

ParentShowHint

Parent

PopupMenu

RowCount

RowHeights

Row

ScrollBars

Selection

ShowHint

Showing

TabOrder

TabStops

TabStop

Tag

TopRow

Top

VisibleColCount

VisibleRowCount

Visible

Width


Ereignisse von TDrawGrid

TDrawGrid	Alphabetisch	Legende

In TDrawGrid

OnColumnMoved

OnDrawCell

OnGetEditMask

OnGetEditText

OnRowMoved

OnSelectCell

OnSetEditText

OnTopLeftChanged

Abgeleitet von TWinControl

OnEnter

OnExit

OnKeyDown

OnKeyPress

OnKeyUp

Abgeleitet von TControl

OnClick

OnDblClick

OnDragDrop

OnDragOver

OnEndDrag

OnMouseDown

OnMouseMove

OnMouseUp

OnStartDrag


Ereignisse von TDrawGrid

TDrawGrid	Nach Objekten	Legende

OnClick

OnColumnMoved

OnDblClick

OnDragDrop

OnDragOver

OnDrawCell

OnEndDrag

OnEnter

OnExit

OnGetEditMask

OnGetEditText

OnKeyDown

OnKeyPress

OnKeyUp

OnMouseDown

OnMouseMove

OnMouseUp

OnRowMoved

OnSelectCell

OnSetEditText

OnStartDrag

OnTopLeftChanged


TDrawGrid::OnColumnMoved

TDrawGrid

Das Ereignis OnColumnMoved tritt ein, wenn der Anwender eine Spalte im Gitter verschiebt.

__property TMovedEvent OnColumnMoved;

Beschreibung

Mit OnColumnMoved können Sie bestimmte Aktionen durchführen, wenn der Anwender eine Spalte im Gitter verschiebt. Dieses Ereignis tritt nur ein, wenn die Option goColMoving (Eigenschaft Options) gesetzt ist.


TDrawGrid::OnDrawCell

TDrawGrid	Siehe auch

Das Ereignis OnDrawCell tritt ein, wenn die Zellen des Gitters gezeichnet werden müssen.

typedef void __fastcall (__closure *TDrawCellEvent)(System::TObject* Sender, long Col, long Row, const Windows::TRect &Rect, TGridDrawState State);

__property TDrawCellEvent OnDrawCell;

Beschreibung

Wenn die Eigenschaft DefaultDrawing False ist, werden die Zellen von der Ereignisbehandlungsroutine für OnDrawCell gezeichnet. Ist DefaultDrawing True, wird der Inhalt der Zellen automatisch mit dem voreingestellten Hintergrund und der Zeichenfläche des Gitters gezeichnet und so initialisiert, daß die Hintergrundfarbe der Farbe des Pinsels und die Schriftfarbe der voreingestellten Schriftfarbe entspricht. Gehört die Zelle zu einem markierten Bereich, wird der Hintergrundfarbe die Markierungsfarbe und der Stiftfarbe die Farbe für markierten Text zugewiesen.

Der übergebene Status zeigt an, ob die Zelle fixiert, markiert oder fokussiert ist.


TDrawGrid::OnGetEditMask

TDrawGrid	Siehe auch

Das Ereignis OnGetEditMask tritt ein, wenn die Eingabemaske für das Inplace-Eingabefeld abgerufen werden muß.

typedef void __fastcall (__closure *TGetEditEvent)(System::TObject* Sender, long ACol, long ARow,  System::AnsiString & Value);

__property TGetEditEvent OnGetEditMask;

Beschreibung

Mit OnGetEditMask können Sie bestimmte Aktionen durchführen, wenn die Maske für das Inplace-Eingabefeld abgerufen werden muß. Dieses Ereignis tritt nur ein, wenn die Option goEditing (Eigenschaft Options) gesetzt ist.


TDrawGrid::OnGetEditText

TDrawGrid	Siehe auch

Das Ereignis OnGetEditText tritt ein, wenn Text aus dem Gitter abgerufen werden muß.

typedef void __fastcall (__closure *TGetEditEvent)(System::TObject* Sender, long ACol, long ARow,  System::AnsiString & Value);

__property TGetEditEvent OnGetEditText;

Beschreibung

Mit OnGetEditText können Sie bestimmte Aktionen durchführen, wenn Text aus dem Gitter abgerufen werden muß. Dieses Ereignis tritt nur ein, wenn die Option goEditing (Eigenschaft Options) gesetzt ist.


TDrawGrid::OnRowMoved

TDrawGrid

Das Ereignis OnRowMoved tritt ein, wenn der Anwender eine Reihe des Gitters verschiebt.

typedef void __fastcall (__closure *TMovedEvent)(System::TObject* Sender, long FromIndex, long ToIndex);

__property TMovedEvent OnRowMoved;

Beschreibung

Mit OnRowMoved können Sie bestimmte Aktionen durchführen, wenn der Anwender eine Reihe des Gitters verschiebt. Dieses Ereignis tritt nur ein, wenn die Option goRowMoving (Eigenschaft Options) gesetzt ist.


TDrawGrid::OnSelectCell

TDrawGrid

Das Ereignis OnSelectCell tritt ein, wenn eine Zelle im Gitter ausgewählt wird

typedef void __fastcall (__closure *TSelectCellEvent)(System::TObject* Sender, long Col, long Row, bool &CanSelect);

__property TSelectCellEvent OnSelectCell;

Beschreibung

Mit OnSelectCell können Sie bestimmte Aktionen durchführen, wenn eine Zelle des Gitters ausgewählt wurde.


TDrawGrid::OnSetEditText

TDrawGrid	Siehe auch

Das Ereignis OnSetEditText tritt ein, wenn der Text des Inplace-Eingabefeldes im Gitter angezeigt werden muß.

__property TSetEditEvent OnSetEditText;

Beschreibung

Mit OnSetEditText können Sie bestimmte Aktionen durchführen, wenn der Text des Inplace-Eingabefeldes im Gitter angezeigt werden muß. Dieses Ereignis tritt nur ein, wenn die Option goEditing (Eigenschaft Options) gesetzt ist.


TDrawGrid::OnTopLeftChanged

TDrawGrid	Siehe auch

Das Ereignis OnTopLeftChanged tritt ein, wenn sich eine der Eigenschaften TopRow oder LeftCol ändert.

__property Classes::TNotifyEvent OnTopLeftChanged;

Beschreibung

Mit OnTopLeftChanged können Sie bestimmte Aktionen durchführen, wenn sich eine der Eigenschaften TopRow oder LeftCol ändert.


Methoden von TDrawGrid

TDrawGrid	Alphabetisch

In TDrawGrid

CellRect

MouseToCell

Abgeleitet von TCustomGrid

~TCustomGrid

TCustomGrid

Abgeleitet von TWinControl

Broadcast

CanFocus

ContainsControl

ControlAtPos

DisableAlign

EnableAlign

Focused

GetTabOrderList

HandleAllocated

HandleNeeded

InsertControl

Invalidate

PaintTo

Realign

RemoveControl

Repaint

ScaleBy

ScrollBy

SetBounds

SetFocus

Update

UpdateControlState

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

GetTextLen

Hide

Perform

Refresh

ScreenToClient

SendToBack

SetTextBuf

Show

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TDrawGrid

TDrawGrid	Nach Objekten

~TCustomGrid

Assign

BeginDrag

BringToFront

Broadcast

CanFocus

CellRect

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

ClientToScreen

ContainsControl

ControlAtPos

DefaultHandler

DestroyComponents

Destroying

DisableAlign

Dispatch

DragDrop

Dragging

EnableAlign

EndDrag

FieldAddress

FindComponent

Focused

FreeInstance

FreeNotification

Free

GetParentComponent

GetTabOrderList

GetTextBuf

GetTextLen

HandleAllocated

HandleNeeded

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InsertControl

InstanceSize

Invalidate

MethodAddress

MethodName

MouseToCell

NewInstance

PaintTo

Perform

Realign

Refresh

RemoveComponent

RemoveControl

Repaint

ScaleBy

ScreenToClient

ScrollBy

SendToBack

SetBounds

SetFocus

SetTextBuf

Show

TCustomGrid

UpdateControlState

Update


~TDrawGrid

Der Destruktor ~TDrawGrid gibt den Speicher frei, der für das TDrawGrid-Objekt reserviert war. Rufen Sie ~TDrawGrid nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TDrawGrid automatisch aufgerufen wird.

__fastcall virtual ~TDrawGrid(void);


TDrawGrid::CellRect

TDrawGrid	Siehe auch 	Example

Die Methode CellRect erzeugt für die durch ACol und ARow bezeichnete Zelle ein Rechteck vom Typ TRect.

Windows::TRect __fastcall CellRect(long ACol, long ARow);

Beschreibung

Wenn die durch ACol und ARow bezeichnete Zelle nicht sichtbar ist, gibt CellRect ein leeres Rechteck zurück.


TDrawGrid::MouseToCell

TDrawGrid

Die Methode MouseToCell gibt die Spalte und die Zeile der Zelle zurück, über der sich der Mauszeiger befindet.

void __fastcall MouseToCell(int X, int Y, long &ACol, long &ARow);

Beschreibung

Die Parameter X und Y sind die Bildschirmkoordinaten des Mauszeigers. Der Parameter ACol ist die Nummer der Spalte und ARow die Nummer der Zeile, über der sich der Mauszeiger befindet.

Diese Methode wird normalerweise in einer Behandlungsroutine für Mausereignisse verwendet, die die Koordinaten für den Aufruf bereitstellt.


TDrawGrid

Der Konstruktor TDrawGrid erzeugt ein neues TDrawGrid-Objekt.

__fastcall virtual TDrawGrid(Classes::TComponent* AOwner);


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TControl

TWinControl

TCustomControl

TCustomGrid


TDrawGrid Beispiel

TDrawGrid


TDragControlObject

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/controls.hpp

Mit einem Objekt der Klasse TDragControlObject wird der Ablauf einer normalen Drag-and-Drop-Operation gesteuert (Drag and Drop = Ziehen und Ablegen).

Beschreibung

Mit TDragControlObject werden gewöhnliche Drag-and-Drop-Operationen in Borland C++Builder durchgeführt. Für die Ereignisse OnDragOver und OnDragDrop fungiert das aktuell gezogene Steuerelement als Auslöser, und nicht das Drag-Objekt selbst.


Eigenschaften von TDragControlObject

TDragControlObject	Alphabetisch	Legende

In TDragControlObject

Control


Eigenschaften von TDragControlObject

TDragControlObject	Nach Objekten	Legende

Control


TDragControlObject::Control

TDragControlObject	Siehe auch

Die Eigenschaft Control gibt das Steuerelement zurück, das bei der letzten Drag-and-Drop-Operation verschoben (gezogen) wurde.

__property TControl* Control;

Beschreibung

Die Eigenschaft eignet sich dafür, das Steuerelement zu ermitteln, das aktuell gezogen wird.


Methoden von TDragControlObject

TDragControlObject	Alphabetisch

In TDragControlObject

~TDragControlObject

Finished

GetDragCursor

GetDragImages

HideDragImage

ShowDragImage

TDragControlObject

Abgeleitet von TDragObject

GetName

Instance

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TDragControlObject

TDragControlObject	Nach Objekten

~TDragControlObject

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Finished

FreeInstance

Free

GetDragCursor

GetDragImages

GetName

HideDragImage

InheritsFrom

InitInstance

InstanceSize

Instance

MethodAddress

MethodName

NewInstance

ShowDragImage

TDragControlObject


TDragControlObject::~TDragControlObject

TDragControlObject

Der Destruktor ~TDragControlObject gibt den Speicher frei, der für das TDragControlObject-Objekt reserviert war. Rufen Sie ~TDragControlObject nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TDragControlObject automatisch aufgerufen wird.

__fastcall virtual ~TDragControlObject(void);


TDragControlObject::Finished

TDragControlObject	Siehe auch

Mit Finished wird eine Drag-and-Drop-Operation beendet und die Ereignisbehandlungsroutine für OnEndDrag aufgerufen.

virtual void __fastcall Finished(System::TObject* Target, int X, int Y, bool Accepted);

Beschreibung

Der Wert von Accepted zeigt an, ob das mit Target bezeichnete Steuerelement an der X/Y-Position abgelegt werden kann. Wenn das Steuerelement die Drag-and-Drop-Operation nicht zuläßt, wird dessen Methode DragCanceled vor der Ereignisbehandlungsroutine für OnEndDrag aufgerufen.


TDragControlObject::GetDragCursor

TDragControlObject	Siehe auch

GetDragCursor gibt den Drag-Cursor zurück, der während einer Drag-and-Drop-Operation an der X/Y-Position angezeigt werden soll.

virtual TCursor __fastcall GetDragCursor(bool Accepted, int X, int Y);

Beschreibung

Wenn das Steuerelement an der X/Y-Position das Ziehen akzeptiert (in einer Ereignisbehandlungsroutine für OnDragOver), setzt das Drag-Objekt den Drag-Cursor entsprechend der Eigenschaft DragCursor des Steuerelements. Andernfalls wird der in crNoDrop festgelegte Cursor angezeigt.


TDragControlObject::GetDragImages

TDragControlObject	Siehe auch

GetDragImages gibt die Bilderliste des Steuerelements zurück, in der das Bild enthalten ist, das während des Ziehens angezeigt werden soll.

virtual TCustomImageList* __fastcall GetDragImages(void);

Beschreibung

GetDragImages ruft die gleichnamige Methode eines Steuerelements auf. Eine Bilderliste enthält normalerweise nur einen einzigen Eintrag. Die VCL erstellt und verwaltet die Bilderliste automatisch. GetDragImages gibt für die meisten Steuerelemente in der VCL einen NULL-Zeiger zurück, wenn die Methode nicht entsprechend überschrieben wurde.


TDragControlObject::HideDragImage

TDragControlObject	Siehe auch

Die Methode blendet das Bild aus, das als Drag-Cursor verwendet wird.

virtual void __fastcall HideDragImage(void);

Beschreibung

Wenn das Steuerelement, das gerade gezogen wird, eine Bilderliste besitzt und diese Liste ein Bild enthält, das für eine Ziehen-Operation vorgesehen ist, wird dieses ausgeblendet. Mit dieser Methode läßt sich die Anzeige des Drag-Cursors steuern.


TDragControlObject::ShowDragImage

TDragControlObject	Siehe auch

Die Methode ShowDragImage zeigt das Bild an, das als Drag-Cursor verwendet werden soll.

virtual void __fastcall ShowDragImage(void);

Beschreibung

Wenn das Steuerelement, das gerade gezogen wird, eine Bilderliste besitzt und diese Liste ein Bild enthält, das für eine Ziehen-Operation vorgesehen ist, wird dieses angezeigt. Mit dieser Methode läßt sich die Anzeige des Drag-Cursors steuern.


TDragControlObject::TDragControlObject

TDragControlObject

Der Konstruktor TDragControlObject erzeugt ein neues TDragControlObject-Objekt.

__fastcall TDragControlObject(TControl* AControl);


Zugriff

Read-only


Hierarchie

TObject

TDragObject


TDragControlObject Beispiel

TDragControlObject


 TDriveComboBox

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/filectrl.hpp

TDriveComboBox ist ein spezielles Kombinationsfeld, das alle während der Ausführung der Anwendung verfügbaren Laufwerke anzeigt.

Beschreibung

Mit TDriveComboBox kann der Benutzer ein Laufwerk auswählen. Zusammen mit TFilterComboBox, TDirectoryListBox und TFileListBox stellt TDriveComboBox in einem Formular umfassende Funktionen zur Dateiauswahl bereit.

Mit TOpenDialog oder TSaveDialog können Sie Ihrer Anwendung einen der in Windows 95 üblichen Standarddialoge zum öffnen oder Speichern von Dateien hinzufügen.


Eigenschaften von TDriveComboBox

TDriveComboBox	Alphabetisch	Legende

In TDriveComboBox

DirList

Drive

TextCase

Abgeleitet von TCustomComboBox

Canvas

DroppedDown

ItemIndex

Items

SelLength

SelStart

SelText

Abgeleitet von TWinControl

Brush

ClientOrigin

ClientRect

ControlCount

Controls

Ctl3D

Handle

HelpContext

ParentCtl3D

Showing

TabOrder

TabStop

Abgeleitet von TControl

Align

BoundsRect

ClientHeight

ClientWidth

Color

ControlState

ControlStyle

Cursor

DragCursor

DragMode

Enabled

Font

Height

Hint

Left

Name

Parent

ParentColor

ParentFont

ParentShowHint

PopupMenu

ShowHint

Text

Top

Visible

Width

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TDriveComboBox

TDriveComboBox	Nach Objekten	Legende

Align

BoundsRect

Brush

Canvas

ClientHeight

ClientOrigin

ClientRect

ClientWidth

Color

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlCount

ControlState

Controls

ControlStyle

Ctl3D

Cursor

DesignInfo

DirList

DragCursor

DragMode

Drive

DroppedDown

Enabled

Font

Handle

Height

HelpContext

Hint

ItemIndex

Items

Left

Name

Owner

ParentColor

ParentCtl3D

ParentFont

ParentShowHint

Parent

PopupMenu

SelLength

SelStart

SelText

ShowHint

Showing

TabOrder

TabStop

Tag

TextCase

Text

Top

Visible

Width


TDriveComboBox::DirList

TDriveComboBox	Siehe auch

Die Eigenschaft DirList verknüpft das Kombinationsfeld mit einem Verzeichnis-Listenfeld.

__property TDirectoryListBox* DirList;

Beschreibung

Weisen Sie DirList ein Verzeichnis-Listenfeld zu, das aktualisiert werden soll, wenn der Benutzer das Laufwerk wechselt. Wenn der Benutzer im Kombinationsfeld ein neues Laufwerk auswählt, wird die Verzeichnisstruktur und das aktuelle Verzeichnis im angegebenen Listenfeld aktualisiert.

Hinweis

Enthält das Formular auch ein Listenfeld für Dateien, kann dieses mit Hilfe der Eigenschaft FileList des Verzeichnis-Listenfeldes automatisch aktualisiert werden.


TDriveComboBox::Drive

TDriveComboBox	Siehe auch

Die Eigenschaft Drive repräsentiert das aktuell ausgewählte Laufwerk, das im Eingabefeld des Kombinationsfeldes angezeigt wird.

__property char Drive;

Beschreibung

Mit dieser Eigenschaft können Sie das Kombinationsfeld mit einem bestimmten Laufwerk initialisieren. Ein Lesezugriff auf Drive gibt das Laufwerk zurück, das der Benutzer ausgewählt hat.

Wählt der Anwender im Kombinationsfeld ein neues Laufwerk aus, wird dieses der Eigenschaft Drive zugewiesen. Mit jeder €nderung der Eigenschaft Drive wird auch der Eigenschaft Text das neue Laufwerk zugewiesen.


TDriveComboBox::TextCase

TDriveComboBox	Siehe auch

Die Eigenschaft TextCase legt fest, ob der Name des Laufwerks in der Eigenschaft Text in Groß- oder Kleinbuchstaben angezeigt wird.

__property TTextCase TextCase;

Beschreibung

Weisen Sie TextCase den Wert zu, der der gewünschten Schreibweise des Laufwerksbuchstaben entspricht. Die möglichen Werte für diese Eigenschaft sind:

Wert	Bedeutung

tcLowerCase	Der in der Eigenschaft Text angegebene Laufwerksname wird in Kleinbuchstaben angezeigt.

tcUpperCase	Der in der Eigenschaft Text angegebene Laufwerksname wird in Großbuchstaben angezeigt.

Hinweis

€nderungen, die zur Entwurfszeit an der Eigenschaft TextCase vorgenommen werden, treten erst in Kraft, wenn die Anwendung ausgeführt wird.


Ereignisse von TDriveComboBox

TDriveComboBox	Alphabetisch	Legende

In TDriveComboBox

OnChange

Abgeleitet von TCustomComboBox

OnDropDown

Abgeleitet von TWinControl

OnEnter

OnExit

OnKeyDown

OnKeyPress

OnKeyUp

Abgeleitet von TControl

OnClick

OnDblClick

OnDragDrop

OnDragOver

OnEndDrag

OnStartDrag


Ereignisse von TDriveComboBox

TDriveComboBox	Nach Objekten	Legende

OnChange

OnClick

OnDblClick

OnDragDrop

OnDragOver

OnDropDown

OnEndDrag

OnEnter

OnExit

OnKeyDown

OnKeyPress

OnKeyUp

OnStartDrag


TDriveComboBox::OnChange

TDriveComboBox

Das Ereignis OnChange tritt ein, unmittelbar nachdem der Anwender mit Hilfe des Kombinationsfeldes ein neues Laufwerk auswählt.

typedef void __fastcall (__closure *TNotifyEvent)(System::TObject* Sender);

__property Classes::TNotifyEvent OnChange;

Beschreibung

Mit einer Ereignisbehandlungsroutine für OnChange können Sie bestimmte Aktionen durchführen, wenn sich die Eigenschaft Drive ändert. Wenn der Eigenschaft DirList ein Wert zugewiesen wurde, wird das Verzeichnis-Listenfeld aktualisiert.


Methoden von TDriveComboBox

TDriveComboBox	Alphabetisch

In TDriveComboBox

~TDriveComboBox

TDriveComboBox

Abgeleitet von TCustomComboBox

Clear

SelectAll

Abgeleitet von TWinControl

Broadcast

CanFocus

ContainsControl

ControlAtPos

DisableAlign

EnableAlign

Focused

GetTabOrderList

HandleAllocated

HandleNeeded

InsertControl

Invalidate

PaintTo

Realign

RemoveControl

Repaint

ScaleBy

ScrollBy

SetBounds

SetFocus

Update

UpdateControlState

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

GetTextLen

Hide

Perform

Refresh

ScreenToClient

SendToBack

SetTextBuf

Show

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TDriveComboBox

TDriveComboBox	Nach Objekten

~TDriveComboBox

Assign

BeginDrag

BringToFront

Broadcast

CanFocus

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

Clear

ClientToScreen

ContainsControl

ControlAtPos

DefaultHandler

DestroyComponents

Destroying

DisableAlign

Dispatch

DragDrop

Dragging

EnableAlign

EndDrag

FieldAddress

FindComponent

Focused

FreeInstance

FreeNotification

Free

GetParentComponent

GetTabOrderList

GetTextBuf

GetTextLen

HandleAllocated

HandleNeeded

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InsertControl

InstanceSize

Invalidate

MethodAddress

MethodName

NewInstance

PaintTo

Perform

Realign

Refresh

RemoveComponent

RemoveControl

Repaint

ScaleBy

ScreenToClient

ScrollBy

SelectAll

SendToBack

SetBounds

SetFocus

SetTextBuf

Show

TDriveComboBox

UpdateControlState

Update


TDriveComboBox::~TDriveComboBox

TDriveComboBox	Siehe auch

Der Destruktor ~TDriveComboBox gibt den Speicher frei, der für das TDriveComboBox-Objekt reserviert war. Rufen Sie ~TDriveComboBox nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TDriveComboBox automatisch aufgerufen wird.

__fastcall virtual ~TDriveComboBox(void);


TDriveComboBox::TDriveComboBox

TDriveComboBox	Siehe auch

Die Methode TDriveComboBox erzeugt und initialisiert eine Instanz von TDriveComboBox.

__fastcall virtual TDriveComboBox(Classes::TComponent* AOwner);

Beschreibung

Mit TDriveComboBox können Sie zur Laufzeit ein TDriveComboBox-Objekt erzeugen. Kombinationsfelder, die Sie zur Entwurfszeit in einem Formular plazieren, werden automatisch erzeugt.

Nachdem TDriveComboBox dem Kombinationsfeld Speicher zugewiesen hat, trägt die Methode alle im System verfügbaren Laufwerke ein und weist der Eigenschaft Drive das aktuelle Laufwerk zu.


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TControl

TWinControl

TCustomComboBox


TDriveComboBox Beispiel

TDriveComboBox


EAbort

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/sysutils.hpp

EAbort ist die Exception-Klasse für Fehler, bei denen kein Dialogfeld mit einer Fehlermeldung angezeigt werden soll.

Beschreibung

Mit EAbort läßt sich eine Exception auslösen, ohne daß eine Fehlermeldung in einem Dialogfeld angezeigt wird. Bei Anwendungen, die solche „stillen“ Exceptions nicht abfangen, wird die EAbort-Exception an TApplication.HandleException übergeben.

Die einfachste Möglichkeit, eine EAbort-Exception auszulösen, besteht darin, die Prozedur Abort aufzurufen.


Eigenschaften von EAbort

EAbort	Alphabetisch

Abgeleitet von Exception

HelpContext

Message


Eigenschaften von EAbort

EAbort	Nach Objekten

HelpContext

Message


Methoden von EAbort

EAbort	Alphabetisch

In EAbort

~EAbort

EAbort

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von EAbort

EAbort	Nach Objekten

~EAbort

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

EAbort

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


EAbort::EAbort

EAbort	Siehe auch

Der Konstruktor EAbort erzeugt ein neues EAbort-Objekt.

__fastcall EAbort(const System::AnsiString Msg);

__fastcall EAbort(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size);

__fastcall EAbort(int Ident);

__fastcall EAbort(int Ident, const System::TVarRec *Args, const int Args_Size);

__fastcall EAbort(const System::AnsiString Msg, int AHelpContext);

__fastcall EAbort(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size, int AHelpContext);

__fastcall EAbort(int Ident, int AHelpContext);

__fastcall EAbort(int Ident, const System::TVarRec *Args, const int Args_Size, int AHelpContext)

Beschreibung

Die Methode Eabort erzeugt eine Exception mit einer einfachen Meldung.

Beschreibung der Parameter finden Sie unter dem Thema Exception.


EAbort::~EAbort

EAbort

Der Destruktor ~EAbort gibt den Speicher frei, der für das EAbort-Objekt reserviert war. Rufen Sie ~EAbort nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~EAbort automatisch aufgerufen wird.

__fastcall virtual ~EAbort(void);


Hierarchie

TObject

Exception


EAbort Beispiel

EAbort


EAccessViolation

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/sysutils.hpp

EAccessViolation ist die Exception-Klasse für Fehler, die durch ungültige Speicherzugriffe ausgelöst werden.

Beschreibung

EAccessViolation wird ausgelöst, wenn eine Anwendung

•	einen Null-Zeiger dereferenziert,

•	in eine Code-Page schreibt oder

•	versucht, auf eine Speicheradresse zuzugreifen, für die der Anwendung kein virtueller Speicher zugewiesen wurde.

Hinweis

Eine Anwendung sollte EAccessViolation nicht direkt aufrufen, sondern sich darauf verlassen, daß diese Exception von der Laufzeitbibliothek aufgerufen wird.


Eigenschaften von EAccessViolation

EAccessViolation	Alphabetisch

Abgeleitet von Exception

HelpContext

Message


Eigenschaften von EAccessViolation

EAccessViolation	Nach Objekten

HelpContext

Message


Methoden von EAccessViolation

EAccessViolation	Alphabetisch

In EAccessViolation

~EAccessViolation

EAccessViolation

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von EAccessViolation

EAccessViolation	Nach Objekten

~EAccessViolation

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

EAccessViolation

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


EAccessViolation::~EAccessViolation

EAccessViolation

Der Destruktor ~EAccessViolation gibt den Speicher frei, der für das EAccessViolation-Objekt reserviert war. Rufen Sie ~EAccessViolation nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~EAccessViolation automatisch aufgerufen wird.

__fastcall virtual ~EAccessViolation(void);


EAccessViolation::EAccessViolation

EAccessViolation	Siehe auch

Der Konstruktor EAccessViolation erzeugt ein neues EAccessViolation-Objekt.

__fastcall EAccessViolation(const System::AnsiString Msg);

__fastcall EAccessViolation(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size);

__fastcall EAccessViolation(int Ident);

__fastcall EAccessViolation(int Ident, const System::TVarRec *Args, const int Args_Size);

__fastcall EAccessViolation(const System::AnsiString Msg, int AHelpContext);

__fastcall EAccessViolation(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size, int AHelpContext);

__fastcall EAccessViolation(int Ident, int AHelpContext);

__fastcall EAccessViolation(int Ident, const System::TVarRec *Args, const int Args_Size, int AHelpContext)

Beschreibung

Die Methode EAccessViolation erzeugt eine Exception mit einer einfachen Meldung.

Beschreibung der Parameter finden Sie unter dem Thema Exception.


Hierarchie

TObject

Exception


EAccessViolation Beispiel

EAccessViolation


EBitsError

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/classes.hpp

EBitsError ist die Exceptions-Klasse für ungültige Zugriffsversuche auf ein Array mit booleschen Werten.

Beschreibung

EBitsError wird aufgerufen, wenn eine Anwendung versucht, auf ein Array mit booleschen Werten zuzugreifen (also auf eine Instanz der Klasse TBits) und dabei einen Indexwert verwendet, der zu groß oder zu klein ist. Dies kann der Fall sein, wenn der Wert des Parameters Index der Eigenschaft Bits eine der folgenden Bedingungen erfüllt:

•	Er ist kleiner als Null.

•	Er ist gleich oder größer als der Wert der Eigenschaft Size.


Eigenschaften von EBitsError

EBitsError	Alphabetisch

Abgeleitet von Exception

HelpContext

Message


Eigenschaften von EBitsError

EBitsError	Nach Objekten

HelpContext

Message


Methoden von EBitsError

EBitsError	Alphabetisch

In EBitsError

~EBitsError

EBitsError

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von EBitsError

EBitsError	Nach Objekten

~EBitsError

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

EBitsError

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


EBitsError::~EBitsError

EBitsError	Siehe auch

Der Destruktor ~EBitsError gibt den Speicher frei, der für das EBitsError-Objekt reserviert war. Rufen Sie ~EBitsError nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~EBitsError automatisch aufgerufen wird.

__fastcall virtual ~EBitsError(void);


EBitsError::EBitsError

EBitsError	Siehe auch

Der Konstruktor EBitsError erzeugt ein neues EBitsError-Objekt.

Beschreibung

Die Methode EBitsError erzeugt eine Exception mit einer einfachen Meldung.

Beschreibung der Parameter finden Sie unter dem Thema Exception.


Hierarchie

TObject

Exception


EBitsError Beispiel

EBitsError


EClassNotFound

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/classes.hpp

EClassNotFound ist die Exceptions-Klasse für Fehler, die auftreten, wenn beim Lesen aus einem Stream eine angegebene Komponente nicht gefunden werden kann.

Beschreibung

EClassNotFound wird aufgerufen, wenn beim Lesen einer Komponente aus einem Stream ein Klassenname angetroffen wird, der nicht mit der aktuellen Anwendung verknüpft ist. Dies kann geschehen, wenn eine Komponente zwar in einem Formular existiert, aber aus der Typdeklaration entfernt wurde.


Eigenschaften von EClassNotFound

EClassNotFound	Alphabetisch

Abgeleitet von Exception

HelpContext

Message


Eigenschaften von EClassNotFound

EClassNotFound	Nach Objekten

HelpContext

Message


Methoden von EClassNotFound

EClassNotFound	Alphabetisch

In EClassNotFound

~EClassNotFound

EClassNotFound

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von EClassNotFound

EClassNotFound	Nach Objekten

~EClassNotFound

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

EClassNotFound

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


EClassNotFound::~EClassNotFound

EClassNotFound	Siehe auch

Der Destruktor ~EClassNotFound gibt den Speicher frei, der für das EClassNotFound-Objekt reserviert war. Rufen Sie ~EClassNotFound nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~EClassNotFound automatisch aufgerufen wird.

__fastcall virtual ~EClassNotFound(void);


EClassNotFound::EClassNotFound

EClassNotFound	Siehe auch

EClassNotFound erzeugt ein neues EClassNotFound-Objekt.

__fastcall EClassNotFound(const System::AnsiString Msg);

__fastcall EClassNotFound(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size);

__fastcall EClassNotFound(int Ident);

__fastcall EClassNotFound(int Ident, const System::TVarRec *Args, const int Args_Size);

__fastcall EClassNotFound(const System::AnsiString Msg, int AHelpContext);

__fastcall EClassNotFound(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size, int AHelpContext);

__fastcall EClassNotFound(int Ident, int AHelpContext);

__fastcall EClassNotFound(int Ident, const System::TVarRec *Args, const int Args_Size, int AHelpContext)

Beschreibung

Die Methode EClassNotFound erzeugt eine Exception mit einer einfachen Meldung.

Beschreibung der Parameter finden Sie unter dem Thema Exception.


Hierarchie

TObject

Exception

EStreamError

EFilerError


EClassNotFound Beispiel

EClassNotFound


EConvertError

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/sysutils.hpp

EConvertError ist die Exception-Klasse für Fehler, die bei der Konvertierung von Strings und Objekten auftreten.

Beschreibung

EConvertError wird ausgelöst, wenn

•	eine Anwendung ohne Erfolg versucht, eine Ganzzahl, eine Gleitkommazahl, ein Datum oder eine Zeitangabe in einen String zu konvertieren oder umgekehrt.

•	eine Anwendung einer Formatierungsroutine ein ungültiges Argument übergibt.

•	eine Anwendung versucht, eine von TPersistent abgeleitete Komponente einer anderen von TPersistent abgeleiteten Komponente zuzuweisen, wenn eine solche Zuweisung nicht möglich ist. Beispielsweise löst der Versuch, einem Steuerelement vom Typ TEdit ein Steuerelement vom Typ TButton zuzuweisen, EConvertError aus.


Eigenschaften von EConvertError

EConvertError	Alphabetisch

Abgeleitet von Exception

HelpContext

Message


Eigenschaften von EConvertError

EConvertError	Nach Objekten

HelpContext

Message


Methoden von EConvertError

EConvertError	Alphabetisch

In EConvertError

~EConvertError

EConvertError

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von EConvertError

EConvertError	Nach Objekten

~EConvertError

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

EConvertError

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


EConvertError::~EConvertError

EConvertError

Der Destruktor ~EConvertError gibt den Speicher frei, der für das EConvertError-Objekt reserviert war. Rufen Sie ~EConvertError nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~EConvertError automatisch aufgerufen wird.

__fastcall virtual ~EConvertError(void);


EConvertError::EConvertError

EConvertError	Siehe auch

Der Konstruktor EConvertError erzeugt ein neues EConvertError-Objekt.

__fastcall EConvertError(const System::AnsiString Msg);

__fastcall EConvertError(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size);

__fastcall EConvertError(int Ident);

__fastcall EConvertError(int Ident, const System::TVarRec *Args, const int Args_Size);

__fastcall EConvertError(const System::AnsiString Msg, int AHelpContext);

__fastcall EConvertError(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size, int AHelpContext);

__fastcall EConvertError(int Ident, int AHelpContext);

__fastcall EConvertError(int Ident, const System::TVarRec *Args, const int Args_Size, int AHelpContext)

Beschreibung

Die Methode EConvertError erzeugt eine Exception mit einer einfachen Meldung.

Beschreibung der Parameter finden Sie unter dem Thema Exception.


Hierarchie

TObject

Exception


EConvertError Beispiel

EConvertError


EComponentError

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/classes.hpp

EComponentError ist die Exception-Klasse für Fehler, die beim Registrieren und Umbenennen von Komponenten auftreten.

Beschreibung

EComponentError wird ausgelöst, wenn eine der folgenden Bedingungen zutrifft:

•	Borland C++Builder kann eine Komponente nicht registrieren.

•	Eine Anwendung kann eine Komponente nicht umbenennen.

•	Es wurde versucht, die COM-Schnittstelle einer Komponente zu ermitteln, die COM nicht unterstützt.

Eine Komponente wird folgendermaßen registriert: Schreiben Sie in der Unit der Komponente im Interface-Abschnitt eine Prozedur namens “Register“. Diese Prozedur muß für jede Komponente, die registriert werden soll, RegisterComponents aufrufen

Fehler beim Umbenennen einer Komponente treten dann auf, wenn eine Anwendung versucht, die Komponente zur Laufzeit umzubenennen und der neue Name mit einem vorhandenen identisch ist oder kein gültiger C++ Bezeichner ist.


Eigenschaften von EComponentError

EComponentError	Alphabetisch

Abgeleitet von Exception

HelpContext

Message


Eigenschaften von EComponentError

EComponentError	Nach Objekten

HelpContext

Message


Methoden von EComponentError

EComponentError	Alphabetisch

In EComponentError

~EComponentError

EComponentError

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von EComponentError

EComponentError	Nach Objekten

~EComponentError

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

EComponentError

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


EComponentError::~EComponentError

EComponentError	Siehe auch

Der Destruktor ~EComponentError gibt den Speicher frei, der für das EComponentError-Objekt reserviert war. Rufen Sie ~EComponentError nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~EComponentError automatisch aufgerufen wird.

__fastcall virtual ~EComponentError(void);


EComponentError::EComponentError

EComponentError	Siehe auch

EComponentError erzeugt ein neues EComponentError-Objekt.

__fastcall EComponentError(const System::AnsiString Msg);

__fastcall EComponentError(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size);

__fastcall EComponentError(int Ident);

__fastcall EComponentError(int Ident, const System::TVarRec *Args, const int Args_Size);

__fastcall EComponentError(const System::AnsiString Msg, int AHelpContext);

__fastcall EComponentError(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size, int AHelpContext);

__fastcall EComponentError(int Ident, int AHelpContext);

__fastcall EComponentError(int Ident, const System::TVarRec *Args, const int Args_Size, int AHelpContext)

Beschreibung

Die Methode EComponentError erzeugt eine Exception mit einer einfachen Meldung.

Beschreibung der Parameter finden Sie unter dem Thema Exception.


Hierarchie

TObject

Exception


EComponentError Beispiel

EComponentError


EControlC

Hierarchie	Eigenschaften	Methoden

Header

vcl/sysutils.hpp

EControlC ist die Exception-Klasse für das Drücken der Tastenkombination STRG+C in Konsolenanwendungen.

Beschreibung

EControlC wird ausgelöst, wenn ein Benutzer STRG+C drückt, um eine Konsolenanwendung zu beenden.


Eigenschaften von EControlC

EControlC	Alphabetisch

Abgeleitet von Exception

HelpContext

Message


Eigenschaften von EControlC

EControlC	Nach Objekten

HelpContext

Message


Methoden von EControlC

EControlC	Alphabetisch

In EControlC

~EControlC

EControlC

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von EControlC

EControlC	Nach Objekten

~EControlC

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

EControlC

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


EControlC::~EControlC

EControlC

Der Destruktor ~EControlC gibt den Speicher frei, der für das EControlC-Objekt reserviert war. Rufen Sie ~EControlC nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~EControlC automatisch aufgerufen wird.

__fastcall virtual ~EControlC(void);


EControlC::EControlC

EControlC	Siehe auch

Der Konstruktor EControlC erzeugt ein neues EControlC-Objekt.

__fastcall EControlC(const System::AnsiString Msg);

__fastcall EControlC(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size);

__fastcall EControlC(int Ident);

__fastcall EControlC(int Ident, const System::TVarRec *Args, const int Args_Size);

__fastcall EControlC(const System::AnsiString Msg, int AHelpContext);

__fastcall EControlC(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size, int AHelpContext);

__fastcall EControlC(int Ident, int AHelpContext);

__fastcall EControlC(int Ident, const System::TVarRec *Args, const int Args_Size, int AHelpContext)

Beschreibung

Die Methode EControlC erzeugt eine Exception mit einer einfachen Meldung.

Beschreibung der Parameter finden Sie unter dem Thema Exception.


Hierarchie

TObject

Exception


EControlC Beispiel

EControlC


EDatabaseError

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/db.hpp

EDatabaseError ist die Exception-Klasse für Datenbankfehler.

Beschreibung

EDatabaseError wird ausgelöst, wenn eine Komponente einen Datenbankfehler verzeichnet. Sie können diese Exception in einem Exception-Behandlungsblock verwenden oder damit eine Datenbank-Exception erzeugen.


Eigenschaften von EDatabaseError

EDatabaseError	Alphabetisch

Abgeleitet von Exception

HelpContext

Message


Eigenschaften von EDatabaseError

EDatabaseError	Nach Objekten

HelpContext

Message


Methoden von EDatabaseError

EDatabaseError	Alphabetisch

In EDatabaseError

~EDatabaseError

EDatabaseError

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von EDatabaseError

EDatabaseError	Nach Objekten

~EDatabaseError

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

EDatabaseError

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


EDatabaseError::~EDatabaseError

EDatabaseError

Der Destruktor ~EDatabaseError gibt den Speicher frei, der für das EDatabaseError-Objekt reserviert war. Rufen Sie ~EDatabaseError nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~EDatabaseError automatisch aufgerufen wird.

__fastcall virtual ~EDatabaseError(void);


EDatabaseError::EDatabaseError

EDatabaseError

Der Konstruktor EDatabaseError erzeugt ein neues EDatabaseError-Objekt.

__fastcall EDatabaseError(const System::AnsiString Msg);


Hierarchie

TObject

Exception


EDatabaseError Beispiel

EDatabaseError


EDBEditError

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/mask.hpp

EDBEditError ist die Exception-Klasse für Fehler, die auftreten, wenn Daten zu einer bestimmten Maske nicht kompatibel sind.

Beschreibung

EDBEditError wird ausgelöst, wenn eine Anwendung versucht, Daten zu verwenden, die zu einem Feld der angegebenen Maske nicht kompatibel sind.

Eine Maske schränkt die Daten ein, die ein Feld aufnehmen kann. Die Definition einer Maske erfolgt über die Eigenschaft EditMask.


Eigenschaften von EDBEditError

EDBEditError	Alphabetisch

Abgeleitet von Exception

HelpContext

Message


Eigenschaften von EDBEditError

EDBEditError	Nach Objekten

HelpContext

Message


Methoden von EDBEditError

EDBEditError	Alphabetisch

In EDBEditError

~EDBEditError

EDBEditError

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von EDBEditError

EDBEditError	Nach Objekten

~EDBEditError

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

EDBEditError

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


EDBEditError::~EDBEditError

EDBEditError

Der Destruktor ~EDBEditError gibt den Speicher frei, der für das EDBEditError-Objekt reserviert war. Rufen Sie ~EDBEditError nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~EDBEditError automatisch aufgerufen wird.

__fastcall virtual ~EDBEditError(void);


EDBEditError::EDBEditError

EDBEditError

Der Konstruktor EDBEditError erzeugt ein neues EDBEditError-Objekt.

__fastcall EDBEditError(const System::AnsiString Msg);

__fastcall EDBEditError(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size);

__fastcall EDBEditError(int Ident);

__fastcall EDBEditError(int Ident, const System::TVarRec *Args, const int Args_Size);

__fastcall EDBEditError(const System::AnsiString Msg, int AHelpContext);

__fastcall EDBEditError(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size, int AHelpContext);

__fastcall EDBEditError(int Ident, int AHelpContext);

__fastcall EDBEditError(int Ident, const System::TVarRec *Args, const int Args_Size, int AHelpContext)

Beschreibung

Die Methode EDBEditError erzeugt eine Exception mit einer einfachen Meldung.

Beschreibung der Parameter finden Sie unter dem Thema Exception.


Hierarchie

TObject

Exception


EDBEditError Beispiel

EDBEditError


EDBEngineError

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/db.hpp

EDBEngineError ist die Exception-Klasse für Fehler, die im Zusammenhang mit der Borland Database Engine auftreten.

Beschreibung

EDBEngineError wird immer dann ausgelöst, wenn ein BDE-Fehler auftritt. Ihre Eigenschaft Errors enthält TDBError-Objekte.


Eigenschaften von EDBEngineError

EDBEngineError	Alphabetisch	Legende

In EDBEngineError

read-only	ErrorCount

read-only	Errors

Abgeleitet von Exception

HelpContext

Message


Eigenschaften von EDBEngineError

EDBEngineError	Nach Objekten 	Legende

read-only	ErrorCount

read-only	Errors

HelpContext

Message


EDBEngineError::ErrorCount

EDBEngineError

Die Gesamtzahl von Fehlern in der Eigenschaft Errors.

__property int ErrorCount;


EDBEngineError::Errors

EDBEngineError	Siehe auch

Eine vollständige Liste des Fehler-Stacks der Borland Database Engine.

__property TDBError* Errors[int Index];

Beschreibung

Errors ist ein Index auf TDBError-Objekte. Der erste Fehler hat den Indexwert 0 (Null).


Methoden von EDBEngineError

EDBEngineError	Alphabetisch

In EDBEngineError

~EDBEngineError

EDBEngineError

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von EDBEngineError

EDBEngineError	Nach Objekten

~EDBEngineError

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

EDBEngineError

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


EDBEngineError::~EDBEngineError

EDBEngineError	Siehe auch

Der Destruktor ~EDBEngineError gibt den Speicher frei, der für das EDBEngineError-Objekt reserviert war. Rufen Sie ~EDBEngineError nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~EDBEngineError automatisch aufgerufen wird.

__fastcall virtual ~EDBEngineError(void);

Beschreibung

~EDBEngineError gibt zuerst alle Instanzen von TDBError frei, die in der Eigenschaft Errors referenziert sind, und ruft dann den geerbten Destruktor auf, um die Instanz von EDBEngineError selbst freizugeben.


EDBEngineError::EDBEngineError

EDBEngineError

Der Konstruktor EDBEngineError erzeugt ein neues EDBEngineError-Objekt mit dem angegebenen BDE-Fehlercode.

__fastcall EDBEngineError(const System::AnsiString Msg);

__fastcall EDBEngineError(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size);

__fastcall EDBEngineError(int Ident);

__fastcall EDBEngineError(int Ident, const System::TVarRec *Args, const int Args_Size);

__fastcall EDBEngineError(const System::AnsiString Msg, int AHelpContext);

__fastcall EDBEngineError(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size, int AHelpContext);

__fastcall EDBEngineError(int Ident, int AHelpContext);

__fastcall EDBEngineError(int Ident, const System::TVarRec *Args, const int Args_Size, int AHelpContext)

Beschreibung

EDBEngineError ruft Exception::Exception mit einem leeren String auf und erzeugt damit eine initialisierte Instanz von EDBEngineError. Dann wird für jeden Fehler im BDE-Fehler-Stack eine Instanz von TDBError erzeugt sowie ein einzelner String, der alle Fehlermeldungen enthält. Wenn die BDE beim Aufruf von EDBEngineError nicht initialisiert ist, erzeugt die Methode nur eine generische Fehlermeldung und eine einzige Instanz von TDBError.


Zugriff

Read-only


Hierarchie

TObject

Exception

EDatabaseError


EDBEngineError Beispiel

EDBEngineError


 TEdit

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/stdctrls.hpp

TEdit kapselt die einzeiligen Eingabefelder von Windows.

Beschreibung

Mit einem TEdit-Objekt können Sie eines der unter Windows üblichen Standard-Eingabefelder in ein Formular einfügen. Eingabefelder dienen dazu, von Benutzern eingegebenen Text zu erfassen. Außerdem kann mit ihnen Text für den Benutzer angezeigt werden.

Wenn Sie Text lediglich anzeigen wollen, hat der Benutzer bei einem Eingabefeld die Möglichkeit, den Text zu markieren und in die Zwischenablage zu kopieren. Wenn diese Bearbeitungsmöglichkeiten nicht benötigt werden, verwenden Sie ein Label-Objekt.

TEdit implementiert das allgemeine Verhalten von TCustomEdit. Die Klasse deklariert viele der von TCustomEdit geerbten Eigenschaften als published, führt jedoch kein neues Verhalten ein. Für spezielle Eingabefelder können Sie andere von TCustomEdit abgeleitete Klassen verwenden oder selbst welche ableiten.


Eigenschaften von TEdit

TEdit	Alphabetisch	Legende

In TEdit

ReadOnly

Abgeleitet von TCustomEdit

AutoSelect

AutoSize

BorderStyle

CharCase

HideSelection

MaxLength

Modified

OEMConvert

PasswordChar

SelLength

SelStart

SelText

Abgeleitet von TWinControl

Brush

ClientOrigin

ClientRect

ControlCount

Controls

Ctl3D

Handle

HelpContext

ParentCtl3D

Showing

TabOrder

TabStop

Abgeleitet von TControl

Align

BoundsRect

ClientHeight

ClientWidth

Color

ControlState

ControlStyle

Cursor

DragCursor

DragMode

Enabled

Font

Height

Hint

Left

Name

Parent

ParentColor

ParentFont

ParentShowHint

PopupMenu

ShowHint

Text

Top

Visible

Width

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TEdit

TEdit	Nach Objekten	Legende

Align

AutoSelect

AutoSize

BorderStyle

BoundsRect

Brush

CharCase

ClientHeight

ClientOrigin

ClientRect

ClientWidth

Color

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlCount

ControlState

Controls

ControlStyle

Ctl3D

Cursor

DesignInfo

DragCursor

DragMode

Enabled

Font

Handle

Height

HelpContext

HideSelection

Hint

Left

MaxLength

Modified

Name

OEMConvert

Owner

ParentColor

ParentCtl3D

ParentFont

ParentShowHint

Parent

PasswordChar

PopupMenu

ReadOnly

SelLength

SelStart

SelText

ShowHint

Showing

TabOrder

TabStop

Tag

Text

Top

Visible

Width


Ereignisse von TEdit

TEdit	Alphabetisch	Legende

Abgeleitet von TCustomEdit

OnChange

Abgeleitet von TWinControl

OnEnter

OnExit

OnKeyDown

OnKeyPress

OnKeyUp

Abgeleitet von TControl

OnClick

OnDblClick

OnDragDrop

OnDragOver

OnEndDrag

OnMouseDown

OnMouseMove

OnMouseUp

OnStartDrag


Ereignisse von TEdit

TEdit	Nach Objekten	Legende

OnChange

OnClick

OnDblClick

OnDragDrop

OnDragOver

OnEndDrag

OnEnter

OnExit

OnKeyDown

OnKeyPress

OnKeyUp

OnMouseDown

OnMouseMove

OnMouseUp

OnStartDrag


Methoden von TEdit

TEdit	Alphabetisch

In TEdit

~TEdit

TEdit

Abgeleitet von TCustomEdit

Clear

ClearSelection

CopyToClipboard

CutToClipboard

GetSelTextBuf

PasteFromClipboard

SelectAll

SetSelTextBuf

Abgeleitet von TWinControl

Broadcast

CanFocus

ContainsControl

ControlAtPos

DisableAlign

EnableAlign

Focused

GetTabOrderList

HandleAllocated

HandleNeeded

InsertControl

Invalidate

PaintTo

Realign

RemoveControl

Repaint

ScaleBy

ScrollBy

SetBounds

SetFocus

Update

UpdateControlState

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

GetTextLen

Hide

Perform

Refresh

ScreenToClient

SendToBack

SetTextBuf

Show

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TEdit

TEdit	Nach Objekten

~TEdit

Assign

BeginDrag

BringToFront

Broadcast

CanFocus

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

ClearSelection

Clear

ClientToScreen

ContainsControl

ControlAtPos

CopyToClipboard

CutToClipboard

DefaultHandler

DestroyComponents

Destroying

DisableAlign

Dispatch

DragDrop

Dragging

EnableAlign

EndDrag

FieldAddress

FindComponent

Focused

FreeInstance

FreeNotification

Free

GetParentComponent

GetSelTextBuf

GetTabOrderList

GetTextBuf

GetTextLen

HandleAllocated

HandleNeeded

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InsertControl

InstanceSize

Invalidate

MethodAddress

MethodName

NewInstance

PaintTo

PasteFromClipboard

Perform

Realign

Refresh

RemoveComponent

RemoveControl

Repaint

ScaleBy

ScreenToClient

ScrollBy

SelectAll

SendToBack

SetBounds

SetFocus

SetSelTextBuf

SetTextBuf

Show

TEdit

UpdateControlState

Update


TEdit::~TEdit

TEdit

Der Destruktor ~TEdit gibt den Speicher frei, der für das TEdit-Objekt reserviert war. Rufen Sie ~TEdit nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TEdit automatisch aufgerufen wird.

__fastcall virtual ~TEdit(void);


TEdit::TEdit

TEdit

Der Konstruktor TEdit erzeugt ein neues TEdit-Objekt.

__fastcall virtual TEdit(Classes::TComponent* AOwner);


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TControl

TWinControl

TCustomEdit


TEdit Beispiel

TEdit


EDivByZero

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/sysutils.hpp

EDivByZero ist die Exception-Klasse für Fehler, die aus der Division einer Ganzzahl durch Null resultieren.

Beschreibung

EDivByZero wird ausgelöst, wenn eine Anwendung versucht, eine Ganzzahl durch Null zu dividieren. In der Praxis ist dieser Fehler in einem try...catch-Block leicht abzufangen und zu korrigieren.

Hinweis

Fehler, die aus der Division einer Gleitkommazahl durch Null resultieren, lösen eine EZeroDivide-Exception aus.


Eigenschaften von EDivByZero

EDivByZero	Alphabetisch

Abgeleitet von Exception

HelpContext

Message


Eigenschaften von EDivByZero

EDivByZero	Nach Objekten

HelpContext

Message


Methoden von EDivByZero

EDivByZero	Alphabetisch

In EDivByZero

~EDivByZero

EDivByZero

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von EDivByZero

EDivByZero	Nach Objekten

~EDivByZero

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

EDivByZero

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


EDivByZero::~EDivByZero

EDivByZero

Der Destruktor ~EDivByZero gibt den Speicher frei, der für das EDivByZero-Objekt reserviert war. Rufen Sie ~EDivByZero nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~EDivByZero automatisch aufgerufen wird.

__fastcall virtual ~EDivByZero(void);


EDivByZero::EDivByZero

EDivByZero

Der Konstruktor EDivByZero erzeugt ein neues EDivByZero-Objekt.

__fastcall EDivByZero(const System::AnsiString Msg);


Hierarchie

TObject

Exception

EIntError


EDivByZero Beispiel

EDivByZero


EExternalException

Hierarchie	Eigenschaften	Methoden

Header

vcl/sysutils.hpp

EExternalException ist die Exception-Klasse für ungültige Exception-Codes.

Beschreibung

EExternalException wird ausgelöst, wenn Borland C++Builder auf einen nicht identifizierbaren Exception-Code stößt. Folgende Exception-Codes werden von Borland C++Builder erkannt:

•	STATUS_INTEGER_DIVIDE_BY_ZERO

•	STATUS_ARRAY_BOUNDS_EXCEEDED

•	STATUS_FLOAT_OVERFLOW

•	STATUS_FLOAT_INEXACT_RESULT

•	STATUS_FLOAT_INVALID_OPERATION

•	STATUS_FLOAT_STACK_CHECK

•	STATUS_FLOAT_DIVIDE_BY_ZERO

•	STATUS_INTEGER_OVERFLOW

•	STATUS_FLOAT_UNDERFLOW

•	STATUS_FLOAT_DENORMAL_OPERAND

•	STATUS_ACCESS_VIOLATION

•	STATUS_PRIVILEGED_INSTRUCTION

•	STATUS_CONTROL_C_EXIT

•	STATUS_STACK_OVERFLOW

Jeder andere Exception-Code löst eine EExternalException aus.


Eigenschaften von EExternalException

EExternalException	Alphabetisch

Abgeleitet von Exception

HelpContext

Message


Eigenschaften von EExternalException

EExternalException	Nach Objekten

HelpContext

Message


Methoden von EExternalException

EExternalException	Alphabetisch

In EExternalException

~EExternalException

EExternalException

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von EExternalException

EExternalException	Nach Objekten

~EExternalException

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

EExternalException

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


EExternalException::~EExternalException

EExternalException

Der Destruktor ~EExternalException gibt den Speicher frei, der für das EExternalException-Objekt reserviert war. Rufen Sie ~EExternalException nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~EExternalException automatisch aufgerufen wird.

__fastcall virtual ~EExternalException(void);


EExternalException::EExternalException

EExternalException	Siehe auch

Der Konstruktor EExternalException erzeugt ein neues EExternalException-Objekt.

__fastcall EExternalException(const System::AnsiString Msg);

__fastcall EExternalException(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size);

__fastcall EExternalException(int Ident);

__fastcall EExternalException(int Ident, const System::TVarRec *Args, const int Args_Size);

__fastcall EExternalException(const System::AnsiString Msg, int AHelpContext);

__fastcall EExternalException(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size, int AHelpContext);

__fastcall EExternalException(int Ident, int AHelpContext);

__fastcall EExternalException(int Ident, const System::TVarRec *Args, const int Args_Size, int AHelpContext)

Beschreibung

Die Methode EExternalException erzeugt eine Exception mit einer einfachen Meldung.

Beschreibung der Parameter finden Sie unter dem Thema Exception.


Hierarchie

TObject

Exception


EExternalException Beispiel

EExternalException


EFCreateError

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/classes.hpp

EFCreateError ist die Exceptions-Klasse für Fehler, die beim Anlegen von Dateien auftreten.

Beschreibung

EFCreateError wird ausgelöst, wenn eine Anwendung erfolglos versucht, eine Datei anzulegen. Dies kann beispielsweise der Fall sein, wenn der Benutzer einen ungültigen Dateinamen oder einen bereits vorhandenen Dateinamen angibt, der nicht überschrieben werden kann, oder wenn der Benutzer nicht die erforderliche Zugriffsberechtigung besitzt.


Eigenschaften von EFCreateError

EFCreateError	Alphabetisch

Abgeleitet von Exception

HelpContext

Message


Eigenschaften von EFCreateError

EFCreateError	Nach Objekten

HelpContext

Message


Methoden von EFCreateError

EFCreateError	Alphabetisch

In EFCreateError

~EFCreateError

EFCreateError

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von EFCreateError

EFCreateError	Nach Objekten

~EFCreateError

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

EFCreateError

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


EFCreateError::~EFCreateError

EFCreateError	Siehe auch

Der Destruktor ~EFCreateError gibt den Speicher frei, der für das EFCreateError-Objekt reserviert war. Rufen Sie ~EFCreateError nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~EFCreateError automatisch aufgerufen wird.

__fastcall virtual ~EFCreateError(void);


EFCreateError::EFCreateError

EFCreateError	Siehe auch

Der Konstruktor EFCreateError erzeugt ein neues EFCreateError-Objekt.

__fastcall EFCreateError(const System::AnsiString Msg);

__fastcall EFCreateError(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size);

__fastcall EFCreateError(int Ident);

__fastcall EFCreateError(int Ident, const System::TVarRec *Args, const int Args_Size);

__fastcall EFCreateError(const System::AnsiString Msg, int AHelpContext);

__fastcall EFCreateError(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size, int AHelpContext);

__fastcall EFCreateError(int Ident, int AHelpContext);

__fastcall EFCreateError(int Ident, const System::TVarRec *Args, const int Args_Size, int AHelpContext)

Beschreibung

Die Methode EFCreateError erzeugt eine Exception mit einer einfachen Meldung.

Beschreibung der Parameter finden Sie unter dem Thema Exception.


Hierarchie

TObject

Exception

EStreamError


EFCreateError Beispiel

EFCreateError


EFilerError

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/classes.hpp

EFilerError ist die Exception-Klasse für Datei-Stream-Fehler.

Beschreibung

EFilerError wird ausgelöst, wenn versucht wird, dieselbe Klasse zweimal zu registrieren.

EFilerError ist außerdem der direkte Vorfahr der folgenden Exceptions, die beim Lesen oder Schreiben von Streams auftreten:

Exception	Beschreibung

EReadError	Die angegebene Zahl von Bytes kann nicht gelesen werden.

EWriteError	Die angegeben Zahl von Bytes kann nicht geschrieben werden.

EClassNotFound	Komponente ist nicht mit der Anwendung verknüpft.

EInvalidImage	Die Ressourcendatei kann nicht gelesen werden.

EMethodNotFound	Die Implementierung einer Methode kann nicht gefunden werden.


Eigenschaften von EFilerError

EFilerError	Alphabetisch

Abgeleitet von Exception

HelpContext

Message


Eigenschaften von EFilerError

EFilerError	Nach Objekten

HelpContext

Message


Methoden von EFilerError

EFilerError	Alphabetisch

In EFilerError

~EFilerError

EFilerError

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von EFilerError

EFilerError	Nach Objekten

~EFilerError

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

EFilerError

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


EFilerError::~EFilerError

EFilerError	Siehe auch

Der Destruktor ~EFilerError gibt den Speicher frei, der für das EFilerError-Objekt reserviert war. Rufen Sie ~EFilerError nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~EFilerError automatisch aufgerufen wird.

__fastcall virtual ~EFilerError(void);


EFilerError::EFilerError

EFilerError	Siehe auch

Der Konstruktor EFilerError erzeugt ein neues EFilerError-Objekt.

__fastcall EFilerError(const System::AnsiString Msg);

__fastcall EFilerError(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size);

__fastcall EFilerError(int Ident);

__fastcall EFilerError(int Ident, const System::TVarRec *Args, const int Args_Size);

__fastcall EFilerError(const System::AnsiString Msg, int AHelpContext);

__fastcall EFilerError(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size, int AHelpContext);

__fastcall EFilerError(int Ident, int AHelpContext);

__fastcall EFilerError(int Ident, const System::TVarRec *Args, const int Args_Size, int AHelpContext)

Beschreibung

Die Methode EFilerError erzeugt eine Exception mit einer einfachen Meldung.

Beschreibung der Parameter finden Sie unter dem Thema Exception.


Hierarchie

TObject

Exception

EStreamError


EFilerError Beispiel

EFilerError


EFOpenError

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/classes.hpp

Die Klasse EFOpenError ist die Exception-Klasse für Fehler, die während des Streamens beim öffnen von Dateien auftreten.

Beschreibung

EFOpenError wird ausgelöst, wenn eine Anwendung die bezeichnete Datei nicht öffnen kann. Dazu kann es beispielsweise kommen, wenn die Datei nicht im aktuellen Verzeichnis oder überhaupt nicht vorhanden ist.


Eigenschaften von EFOpenError

EFOpenError	Alphabetisch

Abgeleitet von Exception

HelpContext

Message


Eigenschaften von EFOpenError

EFOpenError	Nach Objekten

HelpContext

Message


Methoden von EFOpenError

EFOpenError	Alphabetisch

In EFOpenError

~EFOpenError

EFOpenError

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von EFOpenError

EFOpenError	Nach Objekten

~EFOpenError

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

EFOpenError

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


EFOpenError::~EFOpenError

EFOpenError	Siehe auch

Der Destruktor ~EFOpenError gibt den Speicher frei, der für das EFOpenError-Objekt reserviert war. Rufen Sie ~EFOpenError nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~EFOpenError automatisch aufgerufen wird.

__fastcall virtual ~EFOpenError(void);


EFOpenError::EFOpenError

EFOpenError	Siehe auch

Der Konstruktor EFOpenError erzeugt ein neues EFOpenError-Objekt.

__fastcall EFOpenError(const System::AnsiString Msg);

__fastcall EFOpenError(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size);

__fastcall EFOpenError(int Ident);

__fastcall EFOpenError(int Ident, const System::TVarRec *Args, const int Args_Size);

__fastcall EFOpenError(const System::AnsiString Msg, int AHelpContext);

__fastcall EFOpenError(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size, int AHelpContext);

__fastcall EFOpenError(int Ident, int AHelpContext);

__fastcall EFOpenError(int Ident, const System::TVarRec *Args, const int Args_Size, int AHelpContext)

Beschreibung

Die Methode EFOpenError erzeugt eine Exception mit einer einfachen Meldung.

Beschreibung der Parameter finden Sie unter dem Thema Exception.


Hierarchie

TObject

Exception

EStreamError


EFOpenError Beispiel

EFOpenError


EInOutError

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/sysutils.hpp

EInOutError ist die Exception-Klasse für Fehler bei der Dateieingabe/-ausgabe.

Beschreibung

EInOutError wird ausgelöst, wenn das Betriebssystem einen Fehler bei der Dateieingabe/-ausgabe meldet, jedoch nur unter der Voraussetzung, daß die Direktive $I+ gesetzt ist. Der resultierende Fehlercode wird in der lokalen Variable ErrorCode zurückgegeben, die folgende Werte annehmen kann:

Fehlercode	Bedeutung

2	Datei nicht gefunden

3	Ungültiger Dateiname

4	Zu viele offene Dateien

5	Zugriff verweigert

100	EOF

101	Platte voll

106	Ungültige Eingabe

Hinweis

Wenn ein E/A-Fehler auftritt, während die Direktive $I- gesetzt ist, muß die Anwendung die Funktion IOResult aufrufen, um den Fehler zu bereinigen.


Eigenschaften von EInOutError

EInOutError	Alphabetisch

Abgeleitet von Exception

HelpContext

Message


Eigenschaften von EInOutError

EInOutError	Nach Objekten

HelpContext

Message


Methoden von EInOutError

EInOutError	Alphabetisch

In EInOutError

~EInOutError

EInOutError

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von EInOutError

EInOutError	Nach Objekten

~EInOutError

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

EInOutError

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


EInOutError::~EInOutError

EInOutError

Der Destruktor ~EInOutError gibt den Speicher frei, der für das EInOutError-Objekt reserviert war. Rufen Sie ~EInOutError nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~EInOutError automatisch aufgerufen wird.

__fastcall virtual ~EInOutError(void);


EInOutError::EInOutError

EInOutError	Siehe auch

Der Konstruktor EInOutError erzeugt ein neues EInOutError-Objekt.

__fastcall EInOutError(const System::AnsiString Msg);

__fastcall EInOutError(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size);

__fastcall EInOutError(int Ident);

__fastcall EInOutError(int Ident, const System::TVarRec *Args, const int Args_Size);

__fastcall EInOutError(const System::AnsiString Msg, int AHelpContext);

__fastcall EInOutError(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size, int AHelpContext);

__fastcall EInOutError(int Ident, int AHelpContext);

__fastcall EInOutError(int Ident, const System::TVarRec *Args, const int Args_Size, int AHelpContext)

Beschreibung

Die Methode EInOutError erzeugt eine Exception mit einer einfachen Meldung.

Beschreibung der Parameter finden Sie unter dem Thema Exception.


Hierarchie

TObject

Exception


EInOutError Beispiel

EInOutError


EIntError

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/sysutils.hpp

EIntError ist die Basisklasse für Exceptions, die durch Fehler bei Berechnungen mit Ganzzahlen ausgelöst werden.

Beschreibung

EIntError ist eine allgemeine Exception für Berechnungen mit Ganzzahlen. Obwohl sie in der Laufzeitbibliothek nie selbst ausgelöst wird, stellt sie die Basis dar, von der andere derartige Exceptions abstammen. Es gibt folgende Exceptions für Berechnungen mit Ganzzahlen:

Exception	Bedeutung

EDivByZero	Versuch einer Division durch Null

ERangeError	Zahl oder Ausdruck außerhalb des gültigen Bereichs

EIntOverflow	Überlauf bei Ganzzahloperation


Eigenschaften von EIntError

EIntError	Alphabetisch

Abgeleitet von Exception

HelpContext

Message


Eigenschaften von EIntError

EIntError	Nach Objekten

HelpContext

Message


Methoden von EIntError

EIntError	Alphabetisch

In EIntError

~EIntError

EIntError

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von EIntError

EIntError	Nach Objekten

~EIntError

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

EIntError

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


EIntError::~EIntError

EIntError

Der Destruktor ~EIntError gibt den Speicher frei, der für das EIntError-Objekt reserviert war. Rufen Sie ~EIntError nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~EIntError automatisch aufgerufen wird.

__fastcall virtual ~EIntError(void);


EIntError::EIntError

EIntError

Der Konstruktor EIntError erzeugt ein neues EIntError-Objekt.

__fastcall EIntError(const System::AnsiString Msg);


Hierarchie

TObject

Exception


EIntError Beispiel

EIntError


EIntOverflow

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/sysutils.hpp

EIntOverflow ist die Exception-Klasse für Ganzzahlberechnungen, deren Ergebnisse zu groß sind, um in das zugewiesene Register zu passen.

Beschreibung

EIntOverflow ist eine Exception für Ganzzahlberechnungen. Sie tritt auf, wenn ein berechnetes Ergebnis für das zugewiesene Register zu groß ist und deshalb Daten verlorengehen.

EIntOverflow wird nur ausgelöst, wenn die Überlaufprüfung aktiviert ist. Setzen Sie zu diesem Zweck im Projektquellcode die Direktive $Q+ oder wählen Sie unter Projekt/Optionen das Register Compiler und aktivieren Sie im Dialogfeld die Option Überlaufprüfung.

Hinweis

Ein Überlauf ist von der Größe der Register des Computers abhängig und wirkt sich in der 16- und 32-Bit-Version von Borland C++Builder unterschiedlich aus. Eine Berechnung, die in einem 16-Bit-Programm einen Überlauf hervorrufen würde, führt in einem 32-Bit-Programm möglicherweise zu einer Bereichsprüfungs-Exception. Wenn der Überlauf vor der Zuweisung auftritt, wird eine EIntOverflow-Exception ausgelöst; wird der Fehler dagegen zum Zeitpunkt der Zuweisung abgefangen, wird ERangeError ausgelöst.

Der Überlauf eines Gleitkommaregisters löst eine EOverflow-Exception aus.


Eigenschaften von EIntOverflow

EIntOverflow	Alphabetisch

Abgeleitet von Exception

HelpContext

Message


Eigenschaften von EIntOverflow

EIntOverflow	Nach Objekten

HelpContext

Message


Methoden von EIntOverflow

EIntOverflow	Alphabetisch

In EIntOverflow

~EIntOverflow

EIntOverflow

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von EIntOverflow

EIntOverflow	Nach Objekten

~EIntOverflow

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

EIntOverflow

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


EIntOverflow::~EIntOverflow

EIntOverflow

Der Destruktor ~EIntOverflow gibt den Speicher frei, der für das EIntOverflow-Objekt reserviert war. Rufen Sie ~EIntOverflow nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~EIntOverflow automatisch aufgerufen wird.

__fastcall virtual ~EIntOverflow(void);


EIntOverflow::EIntOverflow

EIntOverflow

Der Konstruktor EIntOverflow erzeugt ein neues EIntOverflow-Objekt.

__fastcall EIntOverflow(const System::AnsiString Msg);


Hierarchie

TObject

Exception

EIntError


EIntOverflow Beispiel

EIntOverflow


EInvalidOp

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/sysutils.hpp

EInvalidOp ist die Exception-Klasse für nicht definierte Gleitkommaoperationen.

Beschreibung

EInvalidOp wird ausgelöst, wenn der Prozessor eine nicht definierte Anweisung, eine unzulässige Operation oder einen Stack-Überlauf des Gleitkomma-Prozessors feststellt.

Hinweis

Verwechseln Sie dieses Objekt nicht mit EInvalidOperation.


Eigenschaften von EInvalidOp

EInvalidOp	Alphabetisch

Abgeleitet von Exception

HelpContext

Message


Eigenschaften von EInvalidOp

EInvalidOp	Nach Objekten

HelpContext

Message


Methoden von EInvalidOp

EInvalidOp	Alphabetisch

In EInvalidOp

~EInvalidOp

EInvalidOp

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von EInvalidOp

EInvalidOp	Nach Objekten

~EInvalidOp

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

EInvalidOp

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


EInvalidOp::EInvalidOp

EInvalidOp

Der Konstruktor EInvalidOp erzeugt ein neues EInvalidOp-Objekt.

__fastcall EInvalidOp(const System::AnsiString Msg);


EInvalidOp::~EInvalidOp

EInvalidOp

Der Destruktor ~EInvalidOp gibt den Speicher frei, der für das EInvalidOp-Objekt reserviert war. Rufen Sie ~EInvalidOp nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~EInvalidOp automatisch aufgerufen wird.

__fastcall virtual ~EInvalidOp(void);


Hierarchie

TObject

Exception

EMathError


EInvalidOp Beispiel

EInvalidOp


EInvalidCast

Hierarchie	Eigenschaften	Methoden

Header

vcl/sysutils.hpp

EInvalidCast ist die Exception-Klasse für Fehler bei der Typumwandlung.

Beschreibung

EInvalidCast wird ausgelöst, wenn eine Anwendung unerlaubterweise versucht, ein Objekt mit Hilfe des Operators as in einen anderen Typ zu konvertieren.


Eigenschaften von EInvalidCast

EInvalidCast	Alphabetisch

Abgeleitet von Exception

HelpContext

Message


Eigenschaften von EInvalidCast

EInvalidCast	Nach Objekten

HelpContext

Message


Methoden von EInvalidCast

EInvalidCast	Alphabetisch

In EInvalidCast

~EInvalidCast

EInvalidCast

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von EInvalidCast

EInvalidCast	Nach Objekten

~EInvalidCast

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

EInvalidCast

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


EInvalidCast::~EInvalidCast

EInvalidCast

Der Destruktor ~EInvalidCast gibt den Speicher frei, der für das EInvalidCast-Objekt reserviert war. Rufen Sie ~EInvalidCast nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~EInvalidCast automatisch aufgerufen wird.

__fastcall virtual ~EInvalidCast(void);


EInvalidCast::EInvalidCast

EInvalidCast

Der Konstruktor EInvalidCast erzeugt ein neues EInvalidCast-Objekt.

__fastcall EInvalidCast(const System::AnsiString Msg);

__fastcall EInvalidCast(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size);

__fastcall EInvalidCast(int Ident);

__fastcall EInvalidCast(int Ident, const System::TVarRec *Args, const int Args_Size);

__fastcall EInvalidCast(const System::AnsiString Msg, int AHelpContext);

__fastcall EInvalidCast(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size, int AHelpContext);

__fastcall EInvalidCast(int Ident, int AHelpContext);

__fastcall EInvalidCast(int Ident, const System::TVarRec *Args, const int Args_Size, int AHelpContext)

Beschreibung

Die Methode EInvalidCast erzeugt eine Exception mit einer einfachen Meldung.

Beschreibung der Parameter finden Sie unter dem Thema Exception.


Hierarchie

TObject

Exception


EInvalidCast Beispiel

EInvalidCast


EInvalidGridOperation

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/grids.hpp

EInvalidGridOperation ist die Exception-Klasse für unerlaubte Gitteroperationen.

Beschreibung

EInvalidGridOperation wird ausgelöst, wenn eine Anwendung versucht, eine ungültige Operation mit einem Gitter durchzuführen. Ein Beispiel hierfür wäre ein Zugriffsversuch auf eine Zelle oder Spalte, die im Gitter nicht existiert.


Eigenschaften von EInvalidGridOperation

EInvalidGridOperation	Alphabetisch

Abgeleitet von Exception

HelpContext

Message


Eigenschaften von EInvalidGridOperation

EInvalidGridOperation	Nach Objekten

HelpContext

Message


Methoden von EInvalidGridOperation

EInvalidGridOperation	Alphabetisch

In EInvalidGridOperation

~EInvalidGridOperation

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von EInvalidGridOperation

EInvalidGridOperation	Nach Objekten

~EInvalidGridOperation

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


EInvalidGridOperation::~EInvalidGridOperation

EInvalidGridOperation

Der Destruktor ~EInvalidGridOperation gibt den Speicher frei, der für das EInvalidGridOperation-Objekt reserviert war. Rufen Sie ~EInvalidGridOperation nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~EInvalidGridOperation automatisch aufgerufen wird.

__fastcall virtual ~EInvalidGridOperation(void);


EInvalidGridOperation

Der Konstruktor EInvalidGridOperation erzeugt ein neues EInvalidGridOperation-Objekt.

__fastcall EInvalidGridOperation(const System::AnsiString Msg);


Hierarchie

TObject

Exception


EInvalidGridOperation Beispiel

EInvalidGridOperation


EInvalidGraphicOperation

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/graphics.hpp

EInvalidGraphicOperation ist die Exception-Klasse für unerlaubte Operationen mit Grafiken.

Beschreibung

EInvalidGraphicOperation wird ausgelöst, wenn versucht wird, mit einer Grafik eine unerlaubte Operation auszuführen. Ein Beispiel wäre der Versuch, ein Symbol in der Größe zu verändern oder es in die Zwischenablage zu kopieren.


Eigenschaften von EInvalidGraphicOperation

EInvalidGraphicOperation	Alphabetisch

Abgeleitet von Exception

HelpContext

Message


Eigenschaften von EInvalidGraphicOperation

EInvalidGraphicOperation	Nach Objekten

HelpContext

Message


Methoden von EInvalidGraphicOperation

EInvalidGraphicOperation	Alphabetisch

In EInvalidGraphicOperation

~EInvalidGraphicOperation

EInvalidGraphicOperation

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von EInvalidGraphicOperation

EInvalidGraphicOperation	Nach Objekten

~EInvalidGraphicOperation

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

EInvalidGraphicOperation

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


EInvalidGraphicOperation::~EInvalidGraphicOperation

EInvalidGraphicOperation

Der Destruktor ~EInvalidGraphicOperation gibt den Speicher frei, der für das EInvalidGraphicOperation-Objekt reserviert war. Rufen Sie ~EInvalidGraphicOperation nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~EInvalidGraphicOperation automatisch aufgerufen wird.

__fastcall virtual ~EInvalidGraphicOperation(void);


EInvalidGraphicOperation::EInvalidGraphicOperation

EInvalidGraphicOperation

Der Konstruktor EInvalidGraphicOperation erzeugt ein neues EInvalidGraphicOperation-Objekt.

__fastcall EInvalidGraphicOperation(const System::AnsiString Msg);

__fastcall EInvalidGraphicOperation(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size);

__fastcall EInvalidGraphicOperation(int Ident);

__fastcall EInvalidGraphicOperation(int Ident, const System::TVarRec *Args, const int Args_Size);

__fastcall EInvalidGraphicOperation(const System::AnsiString Msg, int AHelpContext);

__fastcall EInvalidGraphicOperation(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size, int AHelpContext);

__fastcall EInvalidGraphicOperation(int Ident, int AHelpContext);

__fastcall EInvalidGraphicOperation(int Ident, const System::TVarRec *Args, const int Args_Size, int AHelpContext)

Beschreibung

Die Methode EInvalidGraphicOperation erzeugt eine Exception mit einer einfachen Meldung.

Beschreibung der Parameter finden Sie unter dem Thema Exception.


Hierarchie

TObject

Exception


EInvalidGraphicOperation Beispiel

EInvalidGraphicOperation


EInvalidGraphic

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/graphics.hpp

EInvalidGraphic ist die Exception-Klasse für nicht identifizierbare Grafikdateien.

Beschreibung

EInvalidGraphic wird in folgende Fällen aufgerufen:

•	Eine Anwendung versucht eine Datei in ein Bild zu laden, die nicht einen der gültigen Typen Bitmap, Symbol oder Metadatei besitzt und auch kein benutzerdefiniertes Format hat.

•	Eine Anwendung versucht eine Datei zu laden, deren Namenserweiterung nicht interpretiert werden kann.

•	Ein Bild hat nicht das Format, das im Aufruf von LoadFromClipboardFormat oder SaveToClipboardFormat angegeben wurde.


Eigenschaften von EInvalidGraphic

EInvalidGraphic	Alphabetisch

Abgeleitet von Exception

HelpContext

Message


Eigenschaften von EInvalidGraphic

EInvalidGraphic	Nach Objekten

HelpContext

Message


Methoden von EInvalidGraphic

EInvalidGraphic	Alphabetisch

In EInvalidGraphic

~EInvalidGraphic

EInvalidGraphic

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von EInvalidGraphic

EInvalidGraphic	Nach Objekten

~EInvalidGraphic

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

EInvalidGraphic

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


EInvalidGraphic::~EInvalidGraphic

EInvalidGraphic

Der Destruktor ~EInvalidGraphic gibt den Speicher frei, der für das EInvalidGraphic-Objekt reserviert war. Rufen Sie ~EInvalidGraphic nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~EInvalidGraphic automatisch aufgerufen wird.

__fastcall virtual ~EInvalidGraphic(void);


EInvalidGraphic::EInvalidGraphic

EInvalidGraphic	Siehe auch

Der Konstruktor EInvalidGraphic erzeugt ein neues EInvalidGraphic-Objekt.

__fastcall EInvalidGraphic(const System::AnsiString Msg);

__fastcall EInvalidGraphic(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size);

__fastcall EInvalidGraphic(int Ident);

__fastcall EInvalidGraphic(int Ident, const System::TVarRec *Args, const int Args_Size);

__fastcall EInvalidGraphic(const System::AnsiString Msg, int AHelpContext);

__fastcall EInvalidGraphic(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size, int AHelpContext);

__fastcall EInvalidGraphic(int Ident, int AHelpContext);

__fastcall EInvalidGraphic(int Ident, const System::TVarRec *Args, const int Args_Size, int AHelpContext)

Beschreibung

Die Methode EComponentError erzeugt eine Exception mit einer einfachen Meldung.

Beschreibung der Parameter finden Sie unter dem Thema Exception.


Hierarchie

TObject

Exception


EInvalidGraphic Beispiel

EInvalidGraphic


EInvalidArgument

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/math.hpp

EInvalidArgument ist die Exception-Klasse für außerhalb eines zulässigen Bereichs liegende Parameter in speziellen arithmetischen und bilanzmathematischen Funktionen.

Beschreibung

EInvalidArgument wird von einigen Funktionen in der Unit Math ausgelöst (zumeist von solchen, die finanzbezogene Berechnungen durchführen), wenn einer der Parameter außerhalb des gültigen Bereichs liegt oder die Berechnung unmöglich macht.


Eigenschaften von EInvalidArgument

EInvalidArgument	Alphabetisch

Abgeleitet von Exception

HelpContext

Message


Eigenschaften von EInvalidArgument

EInvalidArgument	Nach Objekten

HelpContext

Message


Methoden von EInvalidArgument

EInvalidArgument	Alphabetisch

In EInvalidArgument

~EInvalidArgument

EInvalidArgument

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von EInvalidArgument

EInvalidArgument	Nach Objekten

~EInvalidArgument

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

EInvalidArgument

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


EInvalidArgument::~EInvalidArgument

EInvalidArgument

Der Destruktor ~EInvalidArgument gibt den Speicher frei, der für das EInvalidArgument-Objekt reserviert war. Rufen Sie ~EInvalidArgument nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~EInvalidArgument automatisch aufgerufen wird.

__fastcall virtual ~EInvalidArgument(void);


EInvalidArgument::EInvalidArgument

EInvalidArgument	Siehe auch

Der Konstruktor EInvalidArgument erzeugt ein neues EInvalidArgument-Objekt.

__fastcall EInvalidArgument(const System::AnsiString Msg);

__fastcall EInvalidArgument(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size);

__fastcall EInvalidArgument(int Ident);

__fastcall EInvalidArgument(int Ident, const System::TVarRec *Args, const int Args_Size);

__fastcall EInvalidArgument(const System::AnsiString Msg, int AHelpContext);

__fastcall EInvalidArgument(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size, int AHelpContext);

__fastcall EInvalidArgument(int Ident, int AHelpContext);

__fastcall EInvalidArgument(int Ident, const System::TVarRec *Args, const int Args_Size, int AHelpContext)

Beschreibung

Die Methode EInvalidArgument erzeugt eine Exception mit einer einfachen Meldung.

Beschreibung der Parameter finden Sie unter dem Thema Exception.


Hierarchie

TObject

Exception

EMathError


EInvalidArgument Beispiel

EInvalidArgument


EInvalidImage

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/classes.hpp

EInvalidImage ist die Exception-Klasse für Fehler, die auftreten, wenn eine Ressourcendatei nicht gelesen werden kann.

Beschreibung

EInvalidImage wird ausgelöst, wenn eine Anwendung eine Ressourcendatei nicht lesen kann. Der häufigste Grund dafür liegt darin, daß die angegebenene Datei gar keine Ressourcendatei ist.

Dieser Fehler kann auftreten, wenn die Methoden des TStream-Objekts zum Lesen und Schreiben nicht konsistent verwendet werden. Für Komponenten, die mit WriteComponentRes geschrieben wurden, sollte stets ReadComponentRes zum Lesen verwendet werden. Analog gilt dies für ReadComponent und WriteComponent. Andernfalls kann es zu EInvalidImage-Exceptions kommen.


Eigenschaften von EInvalidImage

EInvalidImage	Alphabetisch

Abgeleitet von Exception

HelpContext

Message


Eigenschaften von EInvalidImage

EInvalidImage	Nach Objekten

HelpContext

Message


Methoden von EInvalidImage

EInvalidImage	Alphabetisch

In EInvalidImage

~EInvalidImage

EInvalidImage

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von EInvalidImage

EInvalidImage	Nach Objekten

~EInvalidImage

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

EInvalidImage

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


EInvalidImage::~EInvalidImage

EInvalidImage	Siehe auch

Der Destruktor ~EInvalidImage gibt den Speicher frei, der für das EInvalidImage-Objekt reserviert war. Rufen Sie ~EInvalidImage nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~EInvalidImage automatisch aufgerufen wird.

__fastcall virtual ~EInvalidImage(void);


EInvalidImage::EInvalidImage

EInvalidImage	Siehe auch

Der Konstruktor EInvalidImage erzeugt ein neues EInvalidImage-Objekt.

__fastcall EInvalidImage(const System::AnsiString Msg);

__fastcall EInvalidImage(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size);

__fastcall EInvalidImage(int Ident);

__fastcall EInvalidImage(int Ident, const System::TVarRec *Args, const int Args_Size);

__fastcall EInvalidImage(const System::AnsiString Msg, int AHelpContext);

__fastcall EInvalidImage(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size, int AHelpContext);

__fastcall EInvalidImage(int Ident, int AHelpContext);

__fastcall EInvalidImage(int Ident, const System::TVarRec *Args, const int Args_Size, int AHelpContext)

Beschreibung

Die Methode EComponentError erzeugt eine Exception mit einer einfachen Meldung.

Beschreibung der Parameter finden Sie unter dem Thema Exception.


Hierarchie

TObject

Exception

EStreamError

EFilerError


EInvalidImage Beispiel

EInvalidImage


EInvalidOperation

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/controls.hpp

EInvalidOperation ist die Exception-Klasse für unerlaubte Operationen mit einer Komponente.

Beschreibung

EInvalidOperation wird ausgelöst, wenn eine Anwendung eine Operation versucht, für die ein Fenster-Handle auf eine Komponente notwendig ist, die kein übergeordnetes Objekt besitzt (Parent = NULL). Diese Exception kann auch dann auftreten, wenn eine Drag-and-Drop-Operation von einem Formular aus versucht wird (z.B. Form1->BeginDrag).

Hinweis

Verwechseln Sie dieses Objekt nicht mit EInvalidOp.


Eigenschaften von EInvalidOperation

EInvalidOperation	Alphabetisch

Abgeleitet von Exception

HelpContext

Message


Eigenschaften von EInvalidOperation

EInvalidOperation	Nach Objekten

HelpContext

Message


Methoden von EInvalidOperation

EInvalidOperation	Alphabetisch

In EInvalidOperation

~EInvalidOperation

EInvalidOperation

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von EInvalidOperation

EInvalidOperation	Nach Objekten

~EInvalidOperation

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

EInvalidOperation

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


EInvalidOperation::~EInvalidOperation

EInvalidOperation	Siehe auch

Der Destruktor ~EInvalidOperation gibt den Speicher frei, der für das EInvalidOperation-Objekt reserviert war. Rufen Sie ~EInvalidOperation nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~EInvalidOperation automatisch aufgerufen wird.

__fastcall virtual ~EInvalidOperation(void);


EInvalidOperation::EInvalidOperation

EInvalidOperation	Siehe auch

Der Konstruktor EInvalidOperation erzeugt ein neues EInvalidOperation-Objekt.

__fastcall EInvalidOperation(const System::AnsiString Msg);

__fastcall EInvalidOperation(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size);

__fastcall EInvalidOperation(int Ident);

__fastcall EInvalidOperation(int Ident, const System::TVarRec *Args, const int Args_Size);

__fastcall EInvalidOperation(const System::AnsiString Msg, int AHelpContext);

__fastcall EInvalidOperation(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size, int AHelpContext);

__fastcall EInvalidOperation(int Ident, int AHelpContext);

__fastcall EInvalidOperation(int Ident, const System::TVarRec *Args, const int Args_Size, int AHelpContext)

Beschreibung

Die Methode EInvalidOperation erzeugt eine Exception mit einer einfachen Meldung.

Beschreibung der Parameter finden Sie unter dem Thema Exception.


Hierarchie

TObject

Exception


EInvalidOperation Beispiel

EInvalidOperation


EInvalidPointer

Hierarchie	Eigenschaften	Methoden

Header

vcl/sysutils.hpp

EInvalidPointer ist die Exception-Klasse für ungültige Zeigeroperationen.

Beschreibung

EInvalidPointer wird ausgelöst, wenn eine Anwendung versucht, eine ungültige Zeigeroperation durchzuführen, indem sie beispielsweise einen Zeiger ein zweites Mal freigibt oder sich auf einen Zeiger bezieht, der bereits freigegeben wurde.


Eigenschaften von EInvalidPointer

EInvalidPointer	Alphabetisch

Abgeleitet von Exception

HelpContext

Message


Eigenschaften von EInvalidPointer

EInvalidPointer	Nach Objekten

HelpContext

Message


Methoden von EInvalidPointer

EInvalidPointer	Alphabetisch

In EInvalidPointer

~EInvalidPointer

EInvalidPointer

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von EInvalidPointer

EInvalidPointer	Nach Objekten

~EInvalidPointer

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

EInvalidPointer

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


EInvalidPointer::~EInvalidPointer

EInvalidPointer

Der Destruktor ~EInvalidPointer gibt den Speicher frei, der für das EInvalidPointer-Objekt reserviert war. Rufen Sie ~EInvalidPointer nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~EInvalidPointer automatisch aufgerufen wird.

__fastcall virtual ~EInvalidPointer(void);


EInvalidPointer::EInvalidPointer

EInvalidPointer

Der Konstruktor EInvalidPointer erzeugt ein neues EInvalidPointer-Objekt.

__fastcall EInvalidPointer(const System::AnsiString Msg);

__fastcall EInvalidPointer(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size);

__fastcall EInvalidPointer(int Ident);

__fastcall EInvalidPointer(int Ident, const System::TVarRec *Args, const int Args_Size);

__fastcall EInvalidPointer(const System::AnsiString Msg, int AHelpContext);

__fastcall EInvalidPointer(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size, int AHelpContext);

__fastcall EInvalidPointer(int Ident, int AHelpContext);

__fastcall EInvalidPointer(int Ident, const System::TVarRec *Args, const int Args_Size, int AHelpContext)

Beschreibung

Die Methode EInvalidPointer erzeugt eine Exception mit einer einfachen Meldung.

Beschreibung der Parameter finden Sie unter dem Thema Exception.


Hierarchie

TObject

Exception


EInvalidPointer Beispiel

EInvalidPointer


EListError

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/classes.hpp

EListError ist die Exception-Klasse für Fehler, die in Verbindung mit Strings und Listen auftreten.

Beschreibung

EListError wird ausgelöst, wenn ein Fehler in einem Listen-, String- oder TStringList-Objekt auftritt. Die häufigste Ursache ist, daß die Anwendung auf einen Eintrag verweist, der außerhalb des Listenbereichs liegt.

EListError wird außerdem ausgelöst, wenn eine Anwendung versucht, das Duplikat eines Strings zu einem TStringList-Objekt hinzuzufügen, während die Eigenschaft Duplicates den Wert dupError hat.

Eine weitere Ursache für eine EListError-Exception ist der Versuch, einen String an bestimmter Position in eine sortierte Liste einzufügen, wodurch die Sortierreihenfolge unterbrochen werden könnte.


Eigenschaften von EListError

EListError	Alphabetisch

Abgeleitet von Exception

HelpContext

Message


Eigenschaften von EListError

EListError	Nach Objekten

HelpContext

Message


Methoden von EListError

EListError	Alphabetisch

In EListError

~EListError

EListError

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von EListError

EListError	Nach Objekten

~EListError

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

EListError

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


EListError::~EListError

EListError	Siehe auch

Der Destruktor ~EListError gibt den Speicher frei, der für das EListError-Objekt reserviert war. Rufen Sie ~EListError nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~EListError automatisch aufgerufen wird.

__fastcall virtual ~EListError(void);


EListError::EListError

EListError

Der Konstruktor EListError erzeugt ein neues EListError-Objekt.

__fastcall EListError(const System::AnsiString Msg);

__fastcall EListError(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size);

__fastcall EListError(int Ident);

__fastcall EListError(int Ident, const System::TVarRec *Args, const int Args_Size);

__fastcall EListError(const System::AnsiString Msg, int AHelpContext);

__fastcall EListError(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size, int AHelpContext);

__fastcall EListError(int Ident, int AHelpContext);

__fastcall EListError(int Ident, const System::TVarRec *Args, const int Args_Size, int AHelpContext)


Hierarchie

TObject

Exception


EListError Beispiel

EListError


EMathError

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/sysutils.hpp

EMathError ist die Exception-Klasse für Fehler bei Berechnungen mit Gleitkommazahlen.

Beschreibung

EMathError ist die Basisklasse, von der alle spezifischen Gleitkomma-Exceptions abstammen. Sie wird nie selbst ausgelöst.

Folgende Exceptions stammen von EMathError ab:

Exception	Bedeutung

EInvalidArgument	Parameter außerhalb des zulässigen Wertebereichs

EInvalidOp	Prozessor hat nicht definierte Anweisung festgestellt

EOverflow	Überlauf bei Gleitkommaoperation

EUnderflow	Unterlauf bei Gleitkommaoperation

EZeroDivide	Versuch der Division durch Null


Eigenschaften von EMathError

EMathError	Alphabetisch

Abgeleitet von Exception

HelpContext

Message


Eigenschaften von EMathError

EMathError	Nach Objekten

HelpContext

Message


Methoden von EMathError

EMathError	Alphabetisch

In EMathError

~EMathError

EMathError

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von EMathError

EMathError	Nach Objekten

~EMathError

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

EMathError

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


EMathError::~EMathError

EMathError

Der Destruktor ~EMathError gibt den Speicher frei, der für das EMathError-Objekt reserviert war. Rufen Sie ~EMathError nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~EMathError automatisch aufgerufen wird.

__fastcall virtual ~EMathError(void);


EMathError::EMathError

EMathError	Siehe auch

Der Konstruktor EMathError erzeugt ein neues EMathError-Objekt.

__fastcall EMathError(const System::AnsiString Msg);

__fastcall EMathError(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size);

__fastcall EMathError(int Ident);

__fastcall EMathError(int Ident, const System::TVarRec *Args, const int Args_Size);

__fastcall EMathError(const System::AnsiString Msg, int AHelpContext);

__fastcall EMathError(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size, int AHelpContext);

__fastcall EMathError(int Ident, int AHelpContext);

__fastcall EMathError(int Ident, const System::TVarRec *Args, const int Args_Size, int AHelpContext)

Beschreibung

Die Methode EMathError erzeugt eine Exception mit einer einfachen Meldung.

Beschreibung der Parameter finden Sie unter dem Thema Exception.


Hierarchie

TObject

Exception


EMathError Beispiel

EMathError


EMCIDeviceError

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/mplayer.hpp

EMCIDeviceError ist die Exception-Klasse für Geräte, die über einen Treiber für ein Media Control Interface (MCI) verfügen.

Beschreibung

EMCIDeviceError wird ausgelöst, wenn ein Fehler beim Zugriff auf ein Multimedia-Gerät auftritt. Die häufigste Ursache ist, daß der Zugriffsversuch erfolgt, bevor das Gerät mit der Methode TMediaPlayer::Open geöffnet wurde.


Eigenschaften von EMCIDeviceError

EMCIDeviceError	Alphabetisch

Abgeleitet von Exception

HelpContext

Message


Eigenschaften von EMCIDeviceError

EMCIDeviceError	Nach Objekten

HelpContext

Message


Methoden von EMCIDeviceError

EMCIDeviceError	Alphabetisch

In EMCIDeviceError

~EMCIDeviceError

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von EMCIDeviceError

EMCIDeviceError	Nach Objekten

~EMCIDeviceError

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


EMCIDeviceError::~EMCIDeviceError

EMCIDeviceError

Der Destruktor ~EMCIDeviceError gibt den Speicher frei, der für das EMCIDeviceError-Objekt reserviert war. Rufen Sie ~EMCIDeviceError nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~EMCIDeviceError automatisch aufgerufen wird.

__fastcall virtual ~EMCIDeviceError(void);


EMCIDeviceError

Der Konstruktor EMCIDeviceError erzeugt ein neues EMCIDeviceError-Objekt.

__fastcall EMCIDeviceError(const System::AnsiString Msg);

__fastcall EMCIDeviceError(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size);

__fastcall EMCIDeviceError(int Ident);

__fastcall EMCIDeviceError(int Ident, const System::TVarRec *Args, const int Args_Size);

__fastcall EMCIDeviceError(const System::AnsiString Msg, int AHelpContext);

__fastcall EMCIDeviceError(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size, int AHelpContext);

__fastcall EMCIDeviceError(int Ident, int AHelpContext);

__fastcall EMCIDeviceError(int Ident, const System::TVarRec *Args, const int Args_Size, int AHelpContext)

Beschreibung

Die Methode EMCIDeviceError erzeugt eine Exception mit einer einfachen Meldung.

Beschreibung der Parameter finden Sie unter dem Thema Exception.


Hierarchie

TObject

Exception


EMCIDeviceError Beispiel

EMCIDeviceError


EMenuError

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/menus.hpp

EMenuError ist die Exception-Klasse für Fehler im Zusammenhang mit Menüeinträgen.

Beschreibung

EMenuError wird ausgelöst, wenn ein Fehler bei der Bearbeitung von Menüs auftritt. Beispielsweise wird eine EMenuError-Exception ausgelöst, wenn eine Anwendung versucht, einen nicht vorhandenen Menüeintrag zu löschen.


Eigenschaften von EMenuError

EMenuError	Alphabetisch

Abgeleitet von Exception

HelpContext

Message


Eigenschaften von EMenuError

EMenuError	Nach Objekten

HelpContext

Message


Methoden von EMenuError

EMenuError	Alphabetisch

In EMenuError

~EMenuError

EMenuError

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von EMenuError

EMenuError	Nach Objekten

~EMenuError

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

EMenuError

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


EMenuError::~EMenuError

EMenuError

Der Destruktor ~EMenuError gibt den Speicher frei, der für das EMenuError-Objekt reserviert war. Rufen Sie ~EMenuError nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~EMenuError automatisch aufgerufen wird.

__fastcall virtual ~EMenuError(void);


EMenuError::EMenuError

EMenuError

Der Konstruktor EMenuError erzeugt ein neues EMenuError-Objekt.

__fastcall EMenuError(const System::AnsiString Msg);


Hierarchie

TObject

Exception


EMenuError Beispiel

EMenuError


EMethodNotFound

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/classes.hpp

EMethodNotFound ist die Exception-Klasse für fehlgeschlagene Versuche, eine bestimmte Methode beim Lesen aus einem Stream zu finden.

Beschreibung

EMethodNotFound wird ausgelöst, wenn eine Methode von einer Anwendung benutzt wird, aber die Implementierung der Methode nicht gefunden werden kann.

Hinweis

Diese Exception wird nur während des Entwurfs ausgelöst.


Eigenschaften von EMethodNotFound

EMethodNotFound	Alphabetisch

Abgeleitet von Exception

HelpContext

Message


Eigenschaften von EMethodNotFound

EMethodNotFound	Nach Objekten

HelpContext

Message


Methoden von EMethodNotFound

EMethodNotFound	Alphabetisch

In EMethodNotFound

~EMethodNotFound

EMethodNotFound

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von EMethodNotFound

EMethodNotFound	Nach Objekten

~EMethodNotFound

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

EMethodNotFound

EMethodNotFound

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


EMethodNotFound::~EMethodNotFound

EMethodNotFound	Siehe auch

Der Destruktor ~EMethodNotFound gibt den Speicher frei, der für das EMethodNotFound-Objekt reserviert war. Rufen Sie ~EMethodNotFound nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~EMethodNotFound automatisch aufgerufen wird.

__fastcall virtual ~EMethodNotFound(void)


EMethodNotFound::EMethodNotFound

EMethodNotFound	Siehe auch

Der Konstruktor EMethodNotFound erzeugt ein neues EMethodNotFound-Objekt.

__fastcall EMethodNotFound(const System::AnsiString Msg);

__fastcall EMethodNotFound(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size);

__fastcall EMethodNotFound(int Ident);

__fastcall EMethodNotFound(int Ident, const System::TVarRec *Args, const int Args_Size);

__fastcall EMethodNotFound(const System::AnsiString Msg, int AHelpContext);

__fastcall EMethodNotFound(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size, int AHelpContext);

__fastcall EMethodNotFound(int Ident, int AHelpContext);

__fastcall EMethodNotFound(int Ident, const System::TVarRec *Args, const int Args_Size, int AHelpContext)


Hierarchie

TObject

Exception

EStreamError

EFilerError


EMethodNotFound Beispiel

EMethodNotFound


TEnumPropDesc

Hierarchie	Methoden	Siehe auch

Header

vcl/olectrls.hpp

TEnumPropDesc stellt die Zuordnung zwischen Strings, die die Werte einer Eigenschaft in einem OLE-Steuerelement repräsentieren, und den Werten selbst her.

Beschreibung

Mit TEnumPropDesc können Sie die Strings auswerten, die von einem OLE-Steuerelement für die Werte seiner Eigenschaften verwendet werden. TEnumPropDesc kann einer Callback-Funktion eine Liste der möglichen Werte zur Verfügung stellen oder die Strings der Eigenschaftswerte direkt den Werten zuordnen. Der Zugriff auf TEnumPropDesc-Objekte erfolgt über die Methode GetEnumPropDesc eines OLE-Steuerelements.


Methoden von TEnumPropDesc

TEnumPropDesc	Alphabetisch

In TEnumPropDesc

~TEnumPropDesc

GetStrings

StringToValue

TEnumPropDesc

ValueToString

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TEnumPropDesc

TEnumPropDesc	Nach Objekten

~TEnumPropDesc

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

FreeInstance

Free

GetStrings

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance

StringToValue

TEnumPropDesc

ValueToString


TEnumPropDesc::~TEnumPropDesc

TEnumPropDesc	Siehe auch

Der Destruktor ~TEnumPropDesc gibt den Speicher frei, der für das TEnumPropDesc-Objekt reserviert war. Rufen Sie ~TEnumPropDesc nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TEnumPropDesc automatisch aufgerufen wird.

__fastcall virtual ~TEnumPropDesc(void);

Beschreibung

Rufen Sie Destroy in einer Anwendung nicht direkt auf.  Das TOleControl-Objekt, das dem TEnumPropDesc-Objekt übergeordnet ist, löst es automatisch auf.

TEnumPropDesc gibt die interne Liste frei, in der die Strings den Eigenschaftswerten zugeordnet werden.


TEnumPropDesc::GetStrings

TEnumPropDesc	Siehe auch

Die Methode GetStrings ruft für jeden String der Eigenschaft die Callback-Funktion Proc auf.

void __fastcall GetStrings(Classes::TGetStrProc Proc);

Beschreibung

Mit GetStrings können Sie für jeden String des TEnumPropDesc-Objekts Code ausführen. Die Callback-Funktion Proc wird für jeden Wert aufgerufen, wobei im Parameter S ein String übergeben wird, der aus einem Integerwert gefolgt von der String-Darstellung dieses Wertes besteht.

Nehmen wir an, ein TEnumPropDesc-Objekt repräsentiert eine Farbeigenschaft, deren Werte vom Typ TColor sind. In diesem Fall würde Proc für jede Farbe mit einem String der Form „255 - clRed“ aufgerufen.


TEnumPropDesc::StringToValue

TEnumPropDesc	Siehe auch

Die Methode StringToValue ordnet die String-Darstellung eines Eigenschaftswertes einem Integerwert zu.

int __fastcall StringToValue(const System::AnsiString S);

Beschreibung

Mit StringToValue können Sie die String-Darstellung eines Eigenschaftswertes, die von einem OLE-Steuerelement verwendet wird, einem Integerwert zuordnen, der dem Wert der Eigenschaft entspricht. Wenn der Wert der Eigenschaft kein Integer ist, kann der dem String zugeordnete Integer ein Zeiger auf den Wert sein.


TEnumPropDesc::TEnumPropDesc

TEnumPropDesc	Siehe auch

Der Konstruktor TEnumPropDesc erzeugt ein neues TEnumPropDesc-Objekt.

__fastcall TEnumPropDesc(int DispID, int ValueCount, Ole2::ITypeInfo* TypeInfo);

Beschreibung

TEnumPropDesc wird von einem OLE-Steuerelement aufgerufen, um die Werte eine seiner Eigenschaften zu repräsentieren. In Anwendungen muß TEnumPropDesc nicht instantiiert werden.

Der Parameter DispID bezeichnet die Eigenschaft des OLE-Objekts. ValueCount ist die Anzahl der möglichen Werte der Eigenschaft. TypeInfo ist ein ITypeInfo-Objekt, über das der Konstruktor die Werte und deren Strings ermitteln kann.


TEnumPropDesc::ValueToString

TEnumPropDesc	Siehe auch

Mit ValueToString können Sie einen Integer, der den Wert einer Eigenschaft bezeichnet, der String-Darstellung des Wertes zuordnen, die von einem OLE-Steuerelement verwendet wird.

System::AnsiString __fastcall ValueToString(int V);

Beschreibung

Mit ValueToString können Sie den Integerwert einer Eigenschaft der von einem OLE-Steuerelement verwendeten String-Darstellung zuordnen. Wenn der Wert der Eigenschaft kein Integer ist, kann der dem String zugeordnete Integer ein Zeiger auf den Wert sein.


Hierarchie

TObject


TEnumPropDesc Beispiel

TEnumPropDesc


EOleCtrlError

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/olectrls.hpp

EOleCtrlError ist die Exception-Klasse für ActiveX-Steuerelemente.

Beschreibung

EOleCtrlError wird ausgelöst, wenn eine Anwendung keine Verknüpfung zu einem ActiveX-Steuerelement herstellen kann.


Eigenschaften von EOleCtrlError

EOleCtrlError	Alphabetisch

Abgeleitet von Exception

HelpContext

Message


Eigenschaften von EOleCtrlError

EOleCtrlError	Nach Objekten

HelpContext

Message


Methoden von EOleCtrlError

EOleCtrlError	Alphabetisch

In EOleCtrlError

~EOleCtrlError

EOleCtrlError

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von EOleCtrlError

EOleCtrlError	Nach Objekten

~EOleCtrlError

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

DefaultHandler

Dispatch

EOleCtrlError

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


EOleCtrlError::~EOleCtrlError

EOleCtrlError

Der Destruktor ~EOleCtrlError gibt den Speicher frei, der für das EOleCtrlError-Objekt reserviert war. Rufen Sie ~EOleCtrlError nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~EOleCtrlError automatisch aufgerufen wird.

__fastcall virtual ~EOleCtrlError(void);


EOleCtrlError::EOleCtrlError

EOleCtrlError	Siehe auch

Der Konstruktor EOleCtrlError erzeugt ein neues EOleCtrlError-Objekt.

__fastcall EOleCtrlError(const System::AnsiString Msg);

__fastcall EOleCtrlError(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size);

__fastcall EOleCtrlError(int Ident);

__fastcall EOleCtrlError(int Ident, const System::TVarRec *Args, const int Args_Size);

__fastcall EOleCtrlError(const System::AnsiString Msg, int AHelpContext);

__fastcall EOleCtrlError(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size, int AHelpContext);

__fastcall EOleCtrlError(int Ident, int AHelpContext);

__fastcall EOleCtrlError(int Ident, const System::TVarRec *Args, const int Args_Size, int AHelpContext)


Hierarchie

TObject

Exception


EOleCtrlError Beispiel

EOleCtrlError


EOleError

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/oleauto.hpp

EOleError ist die Exception Klasse für Fehler bei der OLE-Automatisierung.

Beschreibung

EOleError wird ausgelöst, wenn eine Anwendung auf ein bestimmtes OLE-Automatisierungsobjekt nicht zugreifen kann.


Eigenschaften von EOleError

EOleError	Alphabetisch

Abgeleitet von Exception

HelpContext

Message


Eigenschaften von EOleError

EOleError	Nach Objekten

HelpContext

Message


Methoden von EOleError

EOleError	Alphabetisch

In EOleError

~EOleError

EOleError

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von EOleError

EOleError	Nach Objekten

~EOleError

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

EOleError

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


EOleError::~EOleError

EOleError

Der Destruktor ~EOleError gibt den Speicher frei, der für das EOleError-Objekt reserviert war. Rufen Sie ~EOleError nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~EOleError automatisch aufgerufen wird.

__fastcall virtual ~EOleError(void);


EOleError::EOleError

EOleError	Siehe auch

Der Konstruktor EOleError erzeugt ein neues EOleError-Objekt.

__fastcall EOleError(const System::AnsiString Msg);

__fastcall EOleError(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size);

__fastcall EOleError(int Ident);

__fastcall EOleError(int Ident, const System::TVarRec *Args, const int Args_Size);

__fastcall EOleError(const System::AnsiString Msg, int AHelpContext);

__fastcall EOleError(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size, int AHelpContext);

__fastcall EOleError(int Ident, int AHelpContext);

__fastcall EOleError(int Ident, const System::TVarRec *Args, const int Args_Size, int AHelpContext)


Hierarchie

TObject

Exception


EOleError Beispiel

EOleError


EOleException

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/oleauto.hpp

EOleException kapselt Exceptions, die von OLE-Automatisierungs-Servern ausgelöst werden.

Beschreibung

EOleException wird ausgelöst, wenn ein OLE-Automatisierungs-Server zur Laufzeit eine Exception generiert. Das Objekt erfaßt wesentliche Informationen über die Exception, unter anderem die Fehlerquelle, den Fehlercode, eine Beschreibung, die Hilfedatei und die ID für die kontextsensitiven Hilfe. Die Fehlerbeschreibung und die ID (falls vorhanden) werden einer von CreateHelp generierten Meldung hinzugefügt, die restlichen Informationen werden in den Eigenschaften Source, ErrorCode und HelpFile von EOleException gespeichert.


Eigenschaften von EOleException

EOleException	Alphabetisch	Legende

In EOleException

ErrorCode

HelpFile

Source

Abgeleitet von Exception

HelpContext

Message


Eigenschaften von EOleException

EOleException	Nach Objekten	Legende

ErrorCode

HelpContext

HelpFile

Message

Source


EOleException::ErrorCode

EOleException

Die Eigenschaft ErrorCode enthält den Fehlercode, der vom Verursacher der Exception übergeben wird.

__property int ErrorCode;

Beschreibung

ErrorCode enthält den numerischen Fehlercode, der von der Anwendung übergeben wird, die die Exception ausgelöst hat.


EOleException::HelpFile

EOleException

Die Eigenschaft HelpFile enthält den Namen und das Verzeichnis der Hilfedatei, die Informationen über den aufgetretenen Fehler enthält.

__property System::AnsiString HelpFile;

Beschreibung

HelpFile enthält den Namen und den vollständigen Verzeichnispfad der Hilfedatei, die Informationen über den Fehler enthält.


EOleException::Source

EOleException

Die Eigenschaft Source enthält den Verursacher der Exception.

__property System::AnsiString Source;

Beschreibung

Source gibt den Verursacher der Exception an. Üblicherweise handelt es sich dabei um den Namen eines Anwendungsprogramms.


Methoden von EOleException

EOleException	Alphabetisch

In EOleException

~EOleException

EOleException

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von EOleException

EOleException	Nach Objekten

~EOleException

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

EOleException

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


EOleException::~EOleException

EOleException

Der Destruktor ~EOleException gibt den Speicher frei, der für das EOleException-Objekt reserviert war. Rufen Sie ~EOleException nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~EOleException automatisch aufgerufen wird.

__fastcall virtual ~EOleException(void);


EOleException::EOleException

EOleException	Siehe auch

EOleException erzeugt und initialisiert eine Instanz von EOleException.

__fastcall EOleException(const System::AnsiString Msg);

__fastcall EOleException(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size);

__fastcall EOleException(int Ident);

__fastcall EOleException(int Ident, const System::TVarRec *Args, const int Args_Size);

__fastcall EOleException(const System::AnsiString Msg, int AHelpContext);

__fastcall EOleException(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size, int AHelpContext);

__fastcall EOleException(int Ident, int AHelpContext);

__fastcall EOleException(int Ident, const System::TVarRec *Args, const int Args_Size, int AHelpContext)

Beschreibung

EOleException initialisiert die Eigenschaften ErrorCode, HelpFile und Source mit Werten, die in der OLE-Struktur ExcepInfo übergeben werden. Ein Aufruf der geerbten Methode CreateHelp zeigt die Fehlerbeschreibung und die ID aus ExcepInfo an.


Zugriff

Read-only


Hierarchie

TObject

Exception

EOleError


EOleException Beispiel

EOleException


EOleSysError

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/oleauto.hpp

EOleSysError ist die Exception-Klasse für OLE-API-Fehler.

Beschreibung

EOleSysError wird ausgelöst, wenn die OLE-API zur Laufzeit einen Fehler zurückgibt.


Eigenschaften von EOleSysError

EOleSysError	Alphabetisch	Legende

In EOleSysError

ErrorCode

Abgeleitet von Exception

HelpContext

Message


Eigenschaften von EOleSysError

EOleSysError	Nach Objekten	Legende

ErrorCode

HelpContext

Message


EOleSysError::ErrorCode

EOleSysError

Die Eigenschaft ErrorCode enthält den numerischen Fehlercode, der von der API zurückgegeben wird.

__property int ErrorCode;

Beschreibung

ErrorCode ist der numerische Fehlercode, der von der OLE-API zurückgegeben wird.


Methoden von EOleSysError

EOleSysError	Alphabetisch

In EOleSysError

~EOleSysError

EOleSysError

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von EOleSysError

EOleSysError	Nach Objekten

~EOleSysError

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

EOleSysError

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


EOleSysError::~EOleSysError

EOleSysError

Der Destruktor ~EOleSysError gibt den Speicher frei, der für das EOleSysError-Objekt reserviert war. Rufen Sie ~EOleSysError nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~EOleSysError automatisch aufgerufen wird.

__fastcall virtual ~EOleSysError(void);


EOleSysError::EOleSysError

EOleSysError	Siehe auch

Die Methode EOleSysError erzeugt eine Instanz von EOleSysError.

__fastcall EOleSysError(const System::AnsiString Msg);

__fastcall EOleSysError(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size);

__fastcall EOleSysError(int Ident);

__fastcall EOleSysError(int Ident, const System::TVarRec *Args, const int Args_Size);

__fastcall EOleSysError(const System::AnsiString Msg, int AHelpContext);

__fastcall EOleSysError(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size, int AHelpContext);

__fastcall EOleSysError(int Ident, int AHelpContext);

__fastcall EOleSysError(int Ident, const System::TVarRec *Args, const int Args_Size, int AHelpContext)

Beschreibung

EOleSysError ruft SysErrorMessage auf. Diese Methode wandelt den OLE-Fehlercode in einen String um, der die Fehlermeldung wiedergibt. Der String wird anschließend dem Konstruktor des übergeordneten Objekts übergeben.


Zugriff

Read-only


Hierarchie

TObject

Exception

EOleError


EOleSysError Beispiel

EOleSysError


EOutlineError

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/outline.hpp

EOutlineError ist die Exception-Klasse für Gliederungsdiagramme.

Beschreibung

EOutlineError wird ausgelöst, wenn ein Fehler auftritt, während eine Anwendung mit einem Gliederungsdiagramm arbeitet. Einige Beispiele für Situationen, die zu einer EOutlineError-Exception führen:

•	Eine Anwendung versucht, auf ein Gliederungsdiagramm mit einem ungültigen Knotenindex zuzugreifen.

•	Eine Anwendung versucht, einen Knoten zu erweitern, dessen übergeordneter Knoten nicht erweitert ist.

•	Eine Anwendung versucht, mit einer ungültigen Namenserweiterung Elemente aus einer Datei zu laden.


Eigenschaften von EOutlineError

EOutlineError	Alphabetisch

Abgeleitet von Exception

HelpContext

Message


Eigenschaften von EOutlineError

EOutlineError	Nach Objekten

HelpContext

Message


Methoden von EOutlineError

EOutlineError	Alphabetisch

In EOutlineError

~EOutlineError

EOutlineError

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von EOutlineError

EOutlineError	Nach Objekten

~EOutlineError

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

EOutlineError

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


EOutlineError::~EOutlineError

EOutlineError

Der Destruktor ~EOutlineError gibt den Speicher frei, der für das EOutlineError-Objekt reserviert war. Rufen Sie ~EOutlineError nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~EOutlineError automatisch aufgerufen wird.

__fastcall virtual ~EOutlineError(void);


EOutlineError::EOutlineError

EOutlineError	Siehe auch

Der Konstruktor EOutlineError erzeugt ein neues EOutlineError-Objekt.

__fastcall EOutlineError(const System::AnsiString Msg);

__fastcall EOutlineError(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size);

__fastcall EOutlineError(int Ident);

__fastcall EOutlineError(int Ident, const System::TVarRec *Args, const int Args_Size);

__fastcall EOutlineError(const System::AnsiString Msg, int AHelpContext);

__fastcall EOutlineError(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size, int AHelpContext);

__fastcall EOutlineError(int Ident, int AHelpContext);

__fastcall EOutlineError(int Ident, const System::TVarRec *Args, const int Args_Size, int AHelpContext)


Hierarchie

TObject

Exception


EOutlineError Beispiel

EOutlineError


EOutOfMemory

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/sysutils.hpp

EOutOfMemory ist die Exception-Klasse für fehlgeschlagene Versuche, Speicher zuzuweisen.

Beschreibung

EOutOfMemory wird ausgelöst, wenn eine Anwendung versucht, dynamischen Speicher zuzuweisen, im System jedoch nicht genügend freier Speicher für diese Zuweisung zur Verfügung steht.

Der Speicher für die EOutOfMemory-Exception selbst wird beim Start einer jeden Borland C++Builder-Anwendung im Voraus belegt und bleibt reserviert, solange die Anwendung läuft.

Hinweis

Lösen Sie EOutOfMemory niemals direkt aus. Verwenden Sie statt dessen die Prozedur OutOfMemoryError.


Eigenschaften von EOutOfMemory

EOutOfMemory	Alphabetisch

Abgeleitet von Exception

HelpContext

Message


Eigenschaften von EOutOfMemory

EOutOfMemory	Nach Objekten

HelpContext

Message


Methoden von EOutOfMemory

EOutOfMemory	Alphabetisch

In EOutOfMemory

~EOutOfMemory

EOutOfMemory

FreeInstance

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von EOutOfMemory

EOutOfMemory	Nach Objekten

~EOutOfMemory

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

EOutOfMemory

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


EOutOfMemory::~EOutOfMemory

EOutOfMemory

Der Speicher für diese Exception wird beim Start der Anwendung im Voraus belegt und bleibt reserviert, solange die Anwendung läuft. Aus diesem Grund hat ~EOutOfMemory keinen Effekt.

__fastcall virtual ~EOutOfMemory(void);


EOutOfMemory::EOutOfMemory

EOutOfMemory	Siehe auch

Der Konstruktor EOutOfMemory erzeugt ein neues EOutOfMemory-Objekt.

__fastcall EOutOfMemory(const System::AnsiString Msg);

__fastcall EOutOfMemory(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size);

__fastcall EOutOfMemory(int Ident);

__fastcall EOutOfMemory(int Ident, const System::TVarRec *Args, const int Args_Size);

__fastcall EOutOfMemory(const System::AnsiString Msg, int AHelpContext);

__fastcall EOutOfMemory(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size, int AHelpContext);

__fastcall EOutOfMemory(int Ident, int AHelpContext);

__fastcall EOutOfMemory(int Ident, const System::TVarRec *Args, const int Args_Size, int AHelpContext)


EOutOfMemory::FreeInstance

EOutOfMemory

Die Methode FreeInstance ist für EOutOfMemory unwirksam.

virtual void __fastcall FreeInstance(void);

Beschreibung

EOutOfMemory überschreibt die die geerbte Methode FreeInstance. Der Speicher für diese Exception wird beim Start der Anwendung im Voraus belegt und bleibt reserviert, solange die Anwendung läuft. Aus diesem Grund ist die Methode FreeInstance deaktiviert; ihr Aufruf hat keinerlei Auswirkung auf ein EOutOfMemory-Objekt.


Hierarchie

TObject

Exception


EOutOfMemory Beispiel

EOutOfMemory


EOutOfResources

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/controls.hpp

EOutOfResources ist die Exception-Klasse für fehlgeschlagene Versuche, ein Windows-Handle zuzuweisen.

Beschreibung

EOutOfResources wird ausgelöst, wenn eine Anwendung versucht, ein Windows-Handle zu erzeugen, während Windows keine Handles mehr verfügbar hat.


Eigenschaften von EOutOfResources

EOutOfResources	Alphabetisch

Abgeleitet von Exception

HelpContext

Message


Eigenschaften von EOutOfResources

EOutOfResources	Nach Objekten

HelpContext

Message


Methoden von EOutOfResources

EOutOfResources	Alphabetisch

In EOutOfResources

~EOutOfResources

EOutOfResources

Abgeleitet von EOutOfMemory

FreeInstance

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von EOutOfResources

EOutOfResources	Nach Objekten

~EOutOfResources

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

EOutOfResources

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


EOutOfResources::~EOutOfResources

EOutOfResources	Siehe auch

Der Destruktor ~EOutOfResources gibt den Speicher frei, der für das EOutOfResources-Objekt reserviert war. Rufen Sie ~EOutOfResources nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~EOutOfResources automatisch aufgerufen wird.

__fastcall virtual ~EOutOfResources(void);


EOutOfResources::EOutOfResources

EOutOfResources	Siehe auch

Der Konstruktor EOutOfResources erzeugt ein neues EOutOfResources-Objekt.

__fastcall EOutOfResources(const System::AnsiString Msg);

__fastcall EOutOfResources(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size);

__fastcall EOutOfResources(int Ident);

__fastcall EOutOfResources(int Ident, const System::TVarRec *Args, const int Args_Size);

__fastcall EOutOfResources(const System::AnsiString Msg, int AHelpContext);

__fastcall EOutOfResources(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size, int AHelpContext);

__fastcall EOutOfResources(int Ident, int AHelpContext);

__fastcall EOutOfResources(int Ident, const System::TVarRec *Args, const int Args_Size, int AHelpContext)


Hierarchie

TObject

Exception

EOutOfMemory


EOutOfResources Beispiel

EOutOfResources


EOverflow

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/sysutils.hpp

EOverflow ist die Exception-Klasse für Überläufe des Gleitkommaregisters.

Beschreibung

EOverflow wird ausgelöst, wenn das Ergebnis einer Berechnung zu groß für das zugewiesene Gleitkommaregister ist und deshalb Daten verlorengehen.

Hinweis

Der Überlauf eines Ganzzahlregisters löst eine EIntOverflow-Exception aus.


Eigenschaften von EOverflow

EOverflow	Alphabetisch

Abgeleitet von Exception

HelpContext

Message


Eigenschaften von EOverflow

EOverflow	Nach Objekten

HelpContext

Message


Methoden von EOverflow

EOverflow	Alphabetisch

In EOverflow

~EOverflow

EOverflow

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von EOverflow

EOverflow	Nach Objekten

~EOverflow

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

EOverflow

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


EOverflow::~EOverflow

EOverflow

Der Destruktor ~EOverflow gibt den Speicher frei, der für das EOverflow-Objekt reserviert war. Rufen Sie ~EOverflow nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~EOverflow automatisch aufgerufen wird.

__fastcall virtual ~EOverflow(void);


EOverflow::EOverflow

EOverflow

Der Konstruktor EOverflow erzeugt ein neues EOverflow-Objekt.

__fastcall EOverflow(const System::AnsiString Msg);

__fastcall EOverflow(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size);

__fastcall EOverflow(int Ident);

__fastcall EOverflow(int Ident, const System::TVarRec *Args, const int Args_Size);

__fastcall EOverflow(const System::AnsiString Msg, int AHelpContext);

__fastcall EOverflow(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size, int AHelpContext);

__fastcall EOverflow(int Ident, int AHelpContext);

__fastcall EOverflow(int Ident, const System::TVarRec *Args, const int Args_Size, int AHelpContext)


Hierarchie

TObject

Exception

EMathError


EOverflow Beispiel

EOverflow


EParserError

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/classes.hpp

EParserError ist die Exception-Klasse für Fehler bei der Stream-Konvertierung vom Textformat ins Binärformat.

Beschreibung

EParserError wird ausgelöst, wenn während der Konvertierung vom Text- in das Binärformat ein Fehler auftritt, normalerweise aufgrund eines Syntaxfehlers im Quelltext.


Eigenschaften von EParserError

EParserError	Alphabetisch

Abgeleitet von Exception

HelpContext

Message


Eigenschaften von EParserError

EParserError	Nach Objekten

HelpContext

Message


Methoden von EParserError

EParserError	Alphabetisch

In EParserError

~EParserError

EParserError

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von EParserError

EParserError	Nach Objekten

~EParserError

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

EParserError

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


EParserError::~EParserError

EParserError	Siehe auch

Der Destruktor ~EParserError gibt den Speicher frei, der für das EParserError-Objekt reserviert war. Rufen Sie ~EParserError nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~EParserError automatisch aufgerufen wird.

__fastcall virtual ~EParserError(void);


EParserError::EParserError

EParserError	Siehe auch

Der Konstruktor EParserError erzeugt ein neues EParserError-Objekt.

__fastcall EParserError(const System::AnsiString Msg);

__fastcall EParserError(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size);

__fastcall EParserError(int Ident);

__fastcall EParserError(int Ident, const System::TVarRec *Args, const int Args_Size);

__fastcall EParserError(const System::AnsiString Msg, int AHelpContext);

__fastcall EParserError(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size, int AHelpContext);

__fastcall EParserError(int Ident, int AHelpContext);

__fastcall EParserError(int Ident, const System::TVarRec *Args, const int Args_Size, int AHelpContext)


Hierarchie

TObject

Exception


EParserError Beispiel

EParserError


EPrinter

Hierarchie	Eigenschaften	Methoden

Header

vcl/printers.hpp

EPrinter ist die Exception-Klasse für Fehler beim Drucken.

Beschreibung

EPrinter wird ausgelöst, wenn ein Fehler beim Drucken auftritt. Wenn eine Anwendung beispielsweise versucht, einen nicht vorhandenen Drucker anzusprechen oder wenn ein Druckauftrag aus anderen Gründen den Drukker nicht erreicht, wird eine EPrinter-Exception ausgelöst.


Eigenschaften von EPrinter

EPrinter	Alphabetisch

Abgeleitet von Exception

HelpContext

Message


Eigenschaften von EPrinter

EPrinter	Nach Objekten

HelpContext

Message


Methoden von EPrinter

EPrinter	Alphabetisch

In EPrinter

~EPrinter

EPrinter

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von EPrinter

EPrinter	Nach Objekten

~EPrinter

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

EPrinter

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


EPrinter::~EPrinter

EPrinter

Der Destruktor ~EPrinter gibt den Speicher frei, der für das EPrinter-Objekt reserviert war. Rufen Sie ~EPrinter nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~EPrinter automatisch aufgerufen wird.

__fastcall virtual ~EPrinter(void);


EPrinter::EPrinter

EPrinter	Siehe auch

Der Konstruktor EPrinter erzeugt ein neues EPrinter-Objekt.

__fastcall EPrinter(const System::AnsiString Msg);

__fastcall EPrinter(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size);

__fastcall EPrinter(int Ident);

__fastcall EPrinter(int Ident, const System::TVarRec *Args, const int Args_Size);

__fastcall EPrinter(const System::AnsiString Msg, int AHelpContext);

__fastcall EPrinter(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size, int AHelpContext);

__fastcall EPrinter(int Ident, int AHelpContext);

__fastcall EPrinter(int Ident, const System::TVarRec *Args, const int Args_Size, int AHelpContext)


Hierarchie

TObject

Exception


EPrinter Beispiel

EPrinter


EPrivilege

Hierarchie	Eigenschaften	Methoden

Header

vcl/sysutils.hpp

EPrivilege ist die Exception-Klasse für Verletzungen der Prozessor-Vorrangstufe.

Beschreibung

EPrivilege wird ausgelöst, wenn eine Anwendung versucht, eine Prozessoranweisung auszuführen, die in der gegenwärtigen Prozessor-Vorrangstufe nicht zulässig ist.


Eigenschaften von EPrivilege

EPrivilege	Alphabetisch

Abgeleitet von Exception

HelpContext

Message


Eigenschaften von EPrivilege

EPrivilege	Nach Objekten

HelpContext

Message


Methoden von EPrivilege

EPrivilege	Alphabetisch

In EPrivilege

~EPrivilege

EPrivilege

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von EPrivilege

EPrivilege	Nach Objekten

~EPrivilege

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

EPrivilege

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


EPrivilege::~EPrivilege

EPrivilege

Der Destruktor ~EPrivilege gibt den Speicher frei, der für das EPrivilege-Objekt reserviert war. Rufen Sie ~EPrivilege nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~EPrivilege automatisch aufgerufen wird.

__fastcall virtual ~EPrivilege(void);


EPrivilege::EPrivilege

EPrivilege	Siehe auch

Der Konstruktor EPrivilege erzeugt ein neues EPrivilege-Objekt.

__fastcall EPrivilege(const System::AnsiString Msg);

__fastcall EPrivilege(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size);

__fastcall EPrivilege(int Ident);

__fastcall EPrivilege(int Ident, const System::TVarRec *Args, const int Args_Size);

__fastcall EPrivilege(const System::AnsiString Msg, int AHelpContext);

__fastcall EPrivilege(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size, int AHelpContext);

__fastcall EPrivilege(int Ident, int AHelpContext);

__fastcall EPrivilege(int Ident, const System::TVarRec *Args, const int Args_Size, int AHelpContext)


Hierarchie

TObject

Exception


EPrivilege Beispiel

EPrivilege


EPropertyError

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header: dsgnintf.hpp

Header

vcl/dsgnintf.hpp

EPropertyError ist die Exception-Klasse für fehlgeschlagene Versuche, den Wert einer Eigenschaft zu setzen.

Beschreibung

EPropertyError wird von den Methoden SetValue (oder Edit) solcher Objekte ausgelöst, mit denen Eigenschaftswerte bearbeitet werden können, wenn die gewünschte Wertzuweisung nicht möglich ist. Normalerweise ist der Grund dafür, daß der Wert außerhalb des zulässigen Bereichs liegt oder einen ungültigen Datentyp besitzt.


Eigenschaften von EPropertyError

EPropertyError	Alphabetisch

Abgeleitet von Exception

HelpContext

Message


Eigenschaften von EPropertyError

EPropertyError	Nach Objekten

HelpContext

Message


Methoden von EPropertyError

EPropertyError	Alphabetisch

In EPropertyError

~EPropertyError

EPropertyError

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von EPropertyError

EPropertyError	Nach Objekten

~EPropertyError

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

EPropertyError

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


EPropertyError::~EPropertyError

EPropertyError

Der Destruktor ~EPropertyError gibt den Speicher frei, der für das EPropertyError-Objekt reserviert war. Rufen Sie ~EPropertyError nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~EPropertyError automatisch aufgerufen wird.

__fastcall virtual ~EPropertyError(void);


EPropertyError::EPropertyError

EPropertyError	Siehe auch

Der Konstruktor EPropertyError erzeugt ein neues EPropertyError-Objekt.

__fastcall EPropertyError(const System::AnsiString Msg);

__fastcall EPropertyError(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size);

__fastcall EPropertyError(int Ident);

__fastcall EPropertyError(int Ident, const System::TVarRec *Args, const int Args_Size);

__fastcall EPropertyError(const System::AnsiString Msg, int AHelpContext);

__fastcall EPropertyError(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size, int AHelpContext);

__fastcall EPropertyError(int Ident, int AHelpContext);

__fastcall EPropertyError(int Ident, const System::TVarRec *Args, const int Args_Size, int AHelpContext)


Hierarchie

TObject

Exception


EPropertyError Beispiel

EPropertyError


EPropReadOnly

Hierarchie	Eigenschaften	Methoden

Header

vcl/sysutils.hpp

EPropReadOnly ist die Exception-Klasse für unzulässige Versuche, mittels OLE-Automation den Wert einer Eigenschaft zu ändern.

Beschreibung

EPropReadOnly wird ausgelöst, wenn eine Anwendung versucht, mittels OLE-Automation den Wert einer Nur-Lesen-Eigenschaft zu ändern.


Eigenschaften von EPropReadOnly

EPropReadOnly	Alphabetisch

Abgeleitet von Exception

HelpContext

Message


Eigenschaften von EPropReadOnly

EPropReadOnly	Nach Objekten

HelpContext

Message


Methoden von EPropReadOnly

EPropReadOnly	Alphabetisch

In EPropReadOnly

~EPropReadOnly

EPropReadOnly

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von EPropReadOnly

EPropReadOnly	Nach Objekten

~EPropReadOnly

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

EPropReadOnly

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


EPropReadOnly::~EPropReadOnly

EPropReadOnly

Der Destruktor ~EPropReadOnly gibt den Speicher frei, der für das EPropReadOnly-Objekt reserviert war. Rufen Sie ~EPropReadOnly nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~EPropReadOnly automatisch aufgerufen wird.

__fastcall virtual ~EPropReadOnly(void);


EPropReadOnly::EPropReadOnly

EPropReadOnly	Siehe auch

Der Konstruktor EPropReadOnly erzeugt ein neues EPropReadOnly-Objekt.

__fastcall EPropReadOnly(const System::AnsiString Msg);

__fastcall EPropReadOnly(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size);

__fastcall EPropReadOnly(int Ident);

__fastcall EPropReadOnly(int Ident, const System::TVarRec *Args, const int Args_Size);

__fastcall EPropReadOnly(const System::AnsiString Msg, int AHelpContext);

__fastcall EPropReadOnly(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size, int AHelpContext);

__fastcall EPropReadOnly(int Ident, int AHelpContext);

__fastcall EPropReadOnly(int Ident, const System::TVarRec *Args, const int Args_Size, int AHelpContext)


Hierarchie

TObject

Exception


EPropReadOnly Beispiel

EPropReadOnly


EPropWriteOnly

Hierarchie	Eigenschaften	Methoden

Header

vcl/sysutils.hpp

EPropWriteOnly ist die Exception-Klasse für unzulässige Versuche, mittels OLE-Automation den Wert einer Eigenschaft zu lesen.

Beschreibung

EPropWriteOnly wird ausgelöst, wenn eine Anwendung versucht, mittels OLE-Automation den Wert einer Nur-Schreiben-Eigenschaft zu lesen.


Eigenschaften von EPropWriteOnly

EPropWriteOnly	Alphabetisch

Abgeleitet von Exception

HelpContext

Message


Eigenschaften von EPropWriteOnly

EPropWriteOnly	Nach Objekten

HelpContext

Message


Methoden von EPropWriteOnly

EPropWriteOnly	Alphabetisch

In EPropWriteOnly

~EPropWriteOnly

EPropWriteOnly

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von EPropWriteOnly

EPropWriteOnly	Nach Objekten

~EPropWriteOnly

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

EPropWriteOnly

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


EPropWriteOnly::~EPropWriteOnly

EPropWriteOnly

Der Destruktor ~EPropWriteOnly gibt den Speicher frei, der für das EPropWriteOnly-Objekt reserviert war. Rufen Sie ~EPropWriteOnly nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~EPropWriteOnly automatisch aufgerufen wird.

__fastcall virtual ~EPropWriteOnly(void);


EPropWriteOnly::EPropWriteOnly

EPropWriteOnly	Siehe auch

Der Konstruktor EPropWriteOnly erzeugt ein neues EPropWriteOnly-Objekt.

__fastcall EPropWriteOnly(const System::AnsiString Msg);

__fastcall EPropWriteOnly(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size);

__fastcall EPropWriteOnly(int Ident);

__fastcall EPropWriteOnly(int Ident, const System::TVarRec *Args, const int Args_Size);

__fastcall EPropWriteOnly(const System::AnsiString Msg, int AHelpContext);

__fastcall EPropWriteOnly(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size, int AHelpContext);

__fastcall EPropWriteOnly(int Ident, int AHelpContext);

__fastcall EPropWriteOnly(int Ident, const System::TVarRec *Args, const int Args_Size, int AHelpContext)


Hierarchie

TObject

Exception


EPropWriteOnly Beispiel

EPropWriteOnly


ERangeError

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/sysutils.hpp

ERangeError ist die Exception-Klasse für ganzzahlige Werte, die für den Typ, dem sie zugewiesen werden, zu groß sind.

Beschreibung

ERangeError ist eine Exception für Berechnungen mit Ganzzahlen. Sie wird ausgelöst, wenn

•	der Wert eines ganzzahligen Ausdrucks die Bereichsgrenzen des ganzzahligen Typs überschreitet, dem er zugewiesen wird.

•	im Quellcode versucht wird, auf ein Arrayelement mit Hilfe eines Indexwertes zuzugreifen, der außerhalb der definierten Arraygrenzen liegt.

ERangeError wird nur ausgelöst, wenn die Bereichsprüfung aktiviert ist. Nehmen Sie zu diesem Zweck die Direktive $R+ in den Quellcode des Projekts auf oder wählen Sie unter Projekt|Optionen das Register Compiler und aktivieren Sie im Dialogfeld die Option Bereichsprüfung.


Eigenschaften von ERangeError

ERangeError	Alphabetisch

Abgeleitet von Exception

HelpContext

Message


Eigenschaften von ERangeError

ERangeError	Nach Objekten

HelpContext

Message


Methoden von ERangeError

ERangeError	Alphabetisch

In ERangeError

~ERangeError

ERangeError

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von ERangeError

ERangeError	Nach Objekten

~ERangeError

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

ERangeError

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


ERangeError::~ERangeError

ERangeError

Der Destruktor ~ERangeError gibt den Speicher frei, der für das ERangeError-Objekt reserviert war. Rufen Sie ~ERangeError nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~ERangeError automatisch aufgerufen wird.

__fastcall virtual ~ERangeError(void);


ERangeError::ERangeError

ERangeError	Siehe auch

Der Konstruktor ERangeError erzeugt ein neues ERangeError-Objekt.

__fastcall ERangeError(const System::AnsiString Msg);

__fastcall ERangeError(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size);

__fastcall ERangeError(int Ident);

__fastcall ERangeError(int Ident, const System::TVarRec *Args, const int Args_Size);

__fastcall ERangeError(const System::AnsiString Msg, int AHelpContext);

__fastcall ERangeError(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size, int AHelpContext);

__fastcall ERangeError(int Ident, int AHelpContext);

__fastcall ERangeError(int Ident, const System::TVarRec *Args, const int Args_Size, int AHelpContext)


Hierarchie

TObject

Exception

EIntError


ERangeError Beispiel

ERangeError


EReadError

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/classes.hpp

EReadError ist die Exception-Klasse für fehlgeschlagene Versuche, Daten aus einem Stream zu lesen.

Beschreibung

EReadError wird ausgelöst, wenn eine Anwendung versucht, Daten aus einem Stream zu lesen, aber die angegebene Zahl von Bytes nicht lesen kann.

Eine EReadError-Exception kann auch ausgelöst werden, wenn Borland C++ Builder während der Erstellung eines Formulars einen Eigenschaftswert nicht lesen kann. Dies kann der Fall sein, wenn eine Komponente die Formular-Ressource fehlerhaft liest oder die Ressource beschädigt ist.


Eigenschaften von EReadError

EReadError	Alphabetisch

Abgeleitet von Exception

HelpContext

Message


Eigenschaften von EReadError

EReadError	Nach Objekten

HelpContext

Message


Methoden von EReadError

EReadError	Alphabetisch

In EReadError

~EReadError

EReadError

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von EReadError

EReadError	Nach Objekten

~EReadError

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

EReadError

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


EReadError::~EReadError

EReadError	Siehe auch

Der Destruktor ~EReadError gibt den Speicher frei, der für das EReadError-Objekt reserviert war. Rufen Sie ~EReadError nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~EReadError automatisch aufgerufen wird.

__fastcall virtual ~EReadError(void);


EReadError::EReadError

EReadError	Siehe auch

Der Konstruktor EReadError erzeugt ein neues EReadError-Objekt.

__fastcall EReadError(const System::AnsiString Msg);

__fastcall EReadError(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size);

__fastcall EReadError(int Ident);

__fastcall EReadError(int Ident, const System::TVarRec *Args, const int Args_Size);

__fastcall EReadError(const System::AnsiString Msg, int AHelpContext);

__fastcall EReadError(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size, int AHelpContext);

__fastcall EReadError(int Ident, int AHelpContext);

__fastcall EReadError(int Ident, const System::TVarRec *Args, const int Args_Size, int AHelpContext)


Hierarchie

TObject

Exception

EStreamError

EFilerError


EReadError Beispiel

EReadError


ERegistryException

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/registry.hpp

ERegistryException ist die Exception-Klasse für Fehler in Verbindung mit der Registrierung.

Beschreibung

ERegistryException wird ausgelöst, wenn eine der folgenden Bedingungen eintritt:

•	Die Anwendung kann keinen neuen Schlüssel in der Registrierungsdatenbank erzeugen.

•	Die Anwendung kann einen Datenwert mit zugeordnetem Schlüssel nicht lesen.

•	Die Anwendung kann einen binären Datenwert mit zugeordnetem Schlüssel nicht in einen lokalen Puffer einlesen.

•	Die Anwendung kann einem Schlüssel einen Datenwert nicht zuweisen.

Die Erstellung eines Schlüssels schlägt fehl, wenn eine Anwendung versucht, einen Unterschlüssel unter einem Schlüssel zu erzeugen, für den sie nicht den Sicherheitszugriff KEY_CREATE_SUB_KEY besitzt.

Das Lesen eines Datenwerts, dem ein Schlüssel zugeordnet ist, schlägt fehl, wenn eine Anwendung nicht den Sicherheitszugriff KEY_READ besitzt oder wenn versucht wird, den falschen Datentyp aus einem Schlüssel zu lesen (z.B. String-Daten aus einem Integer-Datenwert).

Das Einlesen eines binären Datenwerts in einen lokalen Puffer schlägt fehl, wenn eine Anwendung einen zu kleinen Puffer zuweist.

Das Schreiben eines Datenwerts in einen Schlüssel schlägt fehl, wenn eine Anwendung für den aktuellen Schlüssel nicht den Sicherheitszugriff KEY_WRITE besitzt.


Eigenschaften von ERegistryException

ERegistryException	Alphabetisch

Abgeleitet von Exception

HelpContext

Message


Eigenschaften von ERegistryException

ERegistryException	Nach Objekten

HelpContext

Message


Methoden von ERegistryException

ERegistryException	Alphabetisch

In ERegistryException

~ERegistryException

ERegistryException

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von ERegistryException

ERegistryException	Nach Objekten

~ERegistryException

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

ERegistryException

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


ERegistryException::~ERegistryException

ERegistryException

Der Destruktor ~ERegistryException gibt den Speicher frei, der für das ERegistryException-Objekt reserviert war. Rufen Sie ~ERegistryException nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~ERegistryException automatisch aufgerufen wird.

__fastcall virtual ~ERegistryException(void);


ERegistryException::ERegistryException

ERegistryException	Siehe auch

Der Konstruktor ERegistryException erzeugt ein neues ERegistryException-Objekt.

__fastcall ERegistryException(const System::AnsiString Msg);

__fastcall ERegistryException(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size);

__fastcall ERegistryException(int Ident);

__fastcall ERegistryException(int Ident, const System::TVarRec *Args, const int Args_Size);

__fastcall ERegistryException(const System::AnsiString Msg, int AHelpContext);

__fastcall ERegistryException(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size, int AHelpContext);

__fastcall ERegistryException(int Ident, int AHelpContext);

__fastcall ERegistryException(int Ident, const System::TVarRec *Args, const int Args_Size, int AHelpContext)


Hierarchie

TObject

Exception


ERegistryException Beispiel

ERegistryException


EResNotFound

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/classes.hpp

EResNotFound ist die Exception-Klasse für unauffindbare Ressourcen.

Beschreibung

EResNotFound wird ausgelöst, wenn Borland C++Builder eine angegebene Ressource, wie ein Formular, ein Bitmap oder ein Symbol, nicht in einer.DFM- oder .RES-Datei finden kann oder wenn die Ressource nicht mit der Anwendung verknüpft ist.

Wenn diese Exception beim Start einer Anwendung oder beim Erstellen eines Formulars auftritt, überprüfen Sie, ob in der CPP-Datei des Formulars die Direktive #pragma resource "*.dfm" enthalten ist. Wenn diese fehlt oder auskommentiert ist, wird die DFM-Datei nicht in die ausführbare Datei eingebunden, und eine EResNotFound-Exception wid generiert.


Eigenschaften von EResNotFound

EResNotFound	Alphabetisch

Abgeleitet von Exception

HelpContext

Message


Eigenschaften von EResNotFound

EResNotFound	Nach Objekten

HelpContext

Message


Methoden von EResNotFound

EResNotFound	Alphabetisch

In EResNotFound

~EResNotFound

EResNotFound

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von EResNotFound

EResNotFound	Nach Objekten

~EResNotFound

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

EResNotFound

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


EResNotFound::~EResNotFound

EResNotFound	Siehe auch

Der Destruktor ~EResNotFound gibt den Speicher frei, der für das EResNotFound-Objekt reserviert war. Rufen Sie ~EResNotFound nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~EResNotFound automatisch aufgerufen wird.

__fastcall virtual ~EResNotFound(void);


EResNotFound::EResNotFound

EResNotFound	Siehe auch

Der Konstruktor EResNotFound erzeugt ein neues EResNotFound-Objekt.

__fastcall EResNotFound(const System::AnsiString Msg);

__fastcall EResNotFound(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size);

__fastcall EResNotFound(int Ident);

__fastcall EResNotFound(int Ident, const System::TVarRec *Args, const int Args_Size);

__fastcall EResNotFound(const System::AnsiString Msg, int AHelpContext);

__fastcall EResNotFound(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size, int AHelpContext);

__fastcall EResNotFound(int Ident, int AHelpContext);

__fastcall EResNotFound(int Ident, const System::TVarRec *Args, const int Args_Size, int AHelpContext)


Hierarchie

TObject

Exception


EResNotFound Beispiel

EResNotFound


EStackOverflow

Hierarchie	Eigenschaften	Methoden

Header

vcl/sysutils.hpp

EStackOverflow ist die Exception-Klasse für Stack-Überläufe.

Beschreibung

EStackOverflow wird ausgelöst, wenn der Stack des aktuellen Thread die letzte Guard-Page erreicht — d.h., wenn das System den Stack nicht dynamisch vergrößern kann. Mögliche Gründe sind extrem große lokale Variablen, eine große Rekursionstiefe oder unzulässiger Assembler-Code.


Eigenschaften von EStackOverflow

EStackOverflow	Alphabetisch

Abgeleitet von Exception

HelpContext

Message


Eigenschaften von EStackOverflow

EStackOverflow	Nach Objekten

HelpContext

Message


Methoden von EStackOverflow

EStackOverflow	Alphabetisch

In EStackOverflow

~EStackOverflow

EStackOverflow

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von EStackOverflow

EStackOverflow	Nach Objekten

~EStackOverflow

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

EStackOverflow

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


EStackOverflow::~EStackOverflow

EStackOverflow

Der Destruktor ~EStackOverflow gibt den Speicher frei, der für das EStackOverflow-Objekt reserviert war. Rufen Sie ~EStackOverflow nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~EStackOverflow automatisch aufgerufen wird.

__fastcall virtual ~EStackOverflow(void);


EStackOverflow::EStackOverflow

EStackOverflow	Siehe auch

Der Konstruktor EStackOverflow erzeugt ein neues EStackOverflow-Objekt.

__fastcall EStackOverflow(const System::AnsiString Msg);

__fastcall EStackOverflow(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size);

__fastcall EStackOverflow(int Ident);

__fastcall EStackOverflow(int Ident, const System::TVarRec *Args, const int Args_Size);

__fastcall EStackOverflow(const System::AnsiString Msg, int AHelpContext);

__fastcall EStackOverflow(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size, int AHelpContext);

__fastcall EStackOverflow(int Ident, int AHelpContext);

__fastcall EStackOverflow(int Ident, const System::TVarRec *Args, const int Args_Size, int AHelpContext)


Hierarchie

TObject

Exception


EStackOverflow Beispiel

EStackOverflow


EStringListError

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/classes.hpp

EStringListError ist die Exception-Klasse für ungültige Referenzen auf Listenfelder.

Beschreibung

EStringListError wird ausgelöst, wenn eine Anwendung versucht, mit einem ungültigen Index auf ein Listenfeld zuzugreifen, um beispielsweise einen Eintrag hinzuzufügen.


Eigenschaften von EStringListError

EStringListError	Alphabetisch

Abgeleitet von Exception

HelpContext

Message


Eigenschaften von EStringListError

EStringListError	Nach Objekten

HelpContext

Message


Methoden von EStringListError

EStringListError	Alphabetisch

In EStringListError

~EStringListError

EStringListError

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von EStringListError

EStringListError	Nach Objekten

~EStringListError

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

EStringListError

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


EStringListError::~EStringListError

EStringListError	Siehe auch

Der Destruktor ~EStringListError gibt den Speicher frei, der für das EStringListError-Objekt reserviert war. Rufen Sie ~EStringListError nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~EStringListError automatisch aufgerufen wird.

__fastcall virtual ~EStringListError(void);


EStringListError::EStringListError

EStringListError	Siehe auch

Der Konstruktor EStringListError erzeugt ein neues EStringListError-Objekt.

__fastcall EStringListError(const System::AnsiString Msg);

__fastcall EStringListError(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size);

__fastcall EStringListError(int Ident);

__fastcall EStringListError(int Ident, const System::TVarRec *Args, const int Args_Size);

__fastcall EStringListError(const System::AnsiString Msg, int AHelpContext);

__fastcall EStringListError(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size, int AHelpContext);

__fastcall EStringListError(int Ident, int AHelpContext);

__fastcall EStringListError(int Ident, const System::TVarRec *Args, const int Args_Size, int AHelpContext)


Hierarchie

TObject

Exception


EStringListError Beispiel

EStringListError


EStreamError

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/classes.hpp

EStreamError ist die Exception-Klasse für Stream-Fehler.

Beschreibung

EStreamError ist der Vorfahr, von dem alle Exception-Klassen abstammen, die sich auf Streams beziehen. EStreamError selbst wird ausgelöst, wenn für einen Speicher-Stream keine Ressourcen zugewiesen werden können.


Eigenschaften von EStreamError

EStreamError	Alphabetisch

Abgeleitet von Exception

HelpContext

Message


Eigenschaften von EStreamError

EStreamError	Nach Objekten

HelpContext

Message


Methoden von EStreamError

EStreamError	Alphabetisch

In EStreamError

~EStreamError

EStreamError

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von EStreamError

EStreamError	Nach Objekten

~EStreamError

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

EStreamError

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


EStreamError::~EStreamError

EStreamError	Siehe auch

Der Destruktor ~EStreamError gibt den Speicher frei, der für das EStreamError-Objekt reserviert war. Rufen Sie ~EStreamError nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~EStreamError automatisch aufgerufen wird.

__fastcall virtual ~EStreamError(void);


EStreamError::EStreamError

EStreamError	Siehe auch

Der Konstruktor EStreamError erzeugt ein neues EStreamError-Objekt.

__fastcall EStreamError(const System::AnsiString Msg);

__fastcall EStreamError(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size);

__fastcall EStreamError(int Ident);

__fastcall EStreamError(int Ident, const System::TVarRec *Args, const int Args_Size);

__fastcall EStreamError(const System::AnsiString Msg, int AHelpContext);

__fastcall EStreamError(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size, int AHelpContext);

__fastcall EStreamError(int Ident, int AHelpContext);

__fastcall EStreamError(int Ident, const System::TVarRec *Args, const int Args_Size, int AHelpContext)


Hierarchie

TObject

Exception


EStreamError Beispiel

EStreamError


EThread

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/classes.hpp

EThread ist die Exception-Klasse für Fehler bei der Thread-Synchronisierung.

Beschreibung

EThread wird ausgelöst, wenn in Anwendungen mit mehreren Threads Konflikte auftauchen. Dies kann der Fall sein, wenn die Methode Synchronize aufgerufen wird, bevor ein vorangegangener Aufruf dieser Methode vollständig ausgeführt wurde.


Eigenschaften von EThread

EThread	Alphabetisch

Abgeleitet von Exception

HelpContext

Message


Eigenschaften von EThread

EThread	Nach Objekten

HelpContext

Message


Methoden von EThread

EThread	Alphabetisch

In EThread

~EThread

EThread

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von EThread

EThread	Nach Objekten

~EThread

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

EThread

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


EThread::~EThread

EThread	Siehe auch

Der Destruktor ~EThread gibt den Speicher frei, der für das EThread-Objekt reserviert war. Rufen Sie ~EThread nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~EThread automatisch aufgerufen wird.

__fastcall virtual ~EThread(void);


EThread::EThread

EThread	Siehe auch

Der Konstruktor EThread erzeugt ein neues EThread-Objekt.

__fastcall EThread(const System::AnsiString Msg);

__fastcall EThread(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size);

__fastcall EThread(int Ident);

__fastcall EThread(int Ident, const System::TVarRec *Args, const int Args_Size);

__fastcall EThread(const System::AnsiString Msg, int AHelpContext);

__fastcall EThread(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size, int AHelpContext);

__fastcall EThread(int Ident, int AHelpContext);

__fastcall EThread(int Ident, const System::TVarRec *Args, const int Args_Size, int AHelpContext)


Hierarchie

TObject

Exception


EThread Beispiel

EThread


ETreeViewError

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/comctrls.hpp

ETreeViewError ist die Exception-Klasse für fehlgeschlagene Versuche, auf einen Baumdiagrammknoten zuzugreifen.

Beschreibung

ETreeViewError wird ausgelöst, wenn von einer TTreeView-Komponente ein ungültiger Index angefordert wird.


Eigenschaften von ETreeViewError

ETreeViewError	Alphabetisch

Abgeleitet von Exception

HelpContext

Message


Eigenschaften von ETreeViewError

ETreeViewError	Nach Objekten

HelpContext

Message


Methoden von ETreeViewError

ETreeViewError	Alphabetisch

Abgeleitet von Exception

~Exception

Exception

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von ETreeViewError

ETreeViewError	Nach Objekten

~Exception

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

Exception

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


ETreeViewError

Der Konstruktor ETreeViewError erzeugt ein neues ETreeViewError-Objekt.

__fastcall ETreeViewError(const System::AnsiString Msg);


~ETreeViewError

Der Destruktor ~ETreeViewError gibt den Speicher frei, der für das ETreeViewError-Objekt reserviert war. Rufen Sie ~ETreeViewError nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~ETreeViewError automatisch aufgerufen wird.

__fastcall virtual ~ETreeViewError(void);


Hierarchie

TObject

Exception


ETreeViewError Beispiel

ETreeViewError


EUnderflow

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/sysutils.hpp

EUnderflow ist die Exception-Klasse für Werte, die zu klein sind, um mit Hilfe einer Gleitkomma-Variablen dargestellt zu werden.

Beschreibung

Wenn eine Gleitkommaoperation einen Wert liefert, der zu klein ist, um mit Hilfe einer Gleitkommavariablen dargestellt zu werden, ist das Resultat gewöhnlich 0. Eine Anwendung kann allerdings das Steuerwort des numerischen Koprozessors ändern, um Unterlauf-Exceptions auf seiten der Hardware sichtbar zu machen; in diesem Fall wird EUnderflow ausgelöst, wenn der Koprozessor eine hardwareseitige Unterlauf-Exception feststellt. Das Steuerwort wird nach der Exception zurückgesetzt.


Eigenschaften von EUnderflow

EUnderflow	Alphabetisch

Abgeleitet von Exception

HelpContext

Message


Eigenschaften von EUnderflow

EUnderflow	Nach Objekten

HelpContext

Message


Methoden von EUnderflow

EUnderflow	Alphabetisch

In EUnderflow

~EUnderflow

EUnderflow

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von EUnderflow

EUnderflow	Nach Objekten

~EUnderflow

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

EUnderflow

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


EUnderflow::~EUnderflow

EUnderflow

Der Destruktor ~EUnderflow gibt den Speicher frei, der für das EUnderflow-Objekt reserviert war. Rufen Sie ~EUnderflow nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~EUnderflow automatisch aufgerufen wird.

__fastcall virtual ~EUnderflow(void);


EUnderflow::EUnderflow

EUnderflow	Siehe auch

Der Konstruktor EUnderflow erzeugt ein neues EUnderflow-Objekt.

__fastcall EUnderflow(const System::AnsiString Msg);

__fastcall EUnderflow(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size);

__fastcall EUnderflow(int Ident);

__fastcall EUnderflow(int Ident, const System::TVarRec *Args, const int Args_Size);

__fastcall EUnderflow(const System::AnsiString Msg, int AHelpContext);

__fastcall EUnderflow(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size, int AHelpContext);

__fastcall EUnderflow(int Ident, int AHelpContext);

__fastcall EUnderflow(int Ident, const System::TVarRec *Args, const int Args_Size, int AHelpContext)


Hierarchie

TObject

Exception

EMathError


EUnderflow Beispiel

EUnderflow


EVariantError

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/sysutils.hpp

EVariantError ist die Exception-Klasse für Fehler mit varianten Datentypen.

Beschreibung

EVariantError wird ausgelöst, wenn

•	eine Anwendung versucht, eine ungültige Typumwandlung oder Operation mit einem varianten Datentyp vorzunehmen.

•	ein variantes Objekt nicht das erforderliche OLE IDispatch-Objekt enthält.

•	die Funktion VarArrayCreate nicht in der Lage ist, das geforderte variante Array zu erzeugen.

•	versucht wird, mit einem Objekt, das kein variantes Array ist, eine Operation durchzuführen, die nur für variante Objekte zulässig ist.

•	der Index eines varianten Arrays außerhalb der festgelegten Bereichsgrenzen liegt.


Eigenschaften von EVariantError

EVariantError	Alphabetisch

Abgeleitet von Exception

HelpContext

Message


Eigenschaften von EVariantError

EVariantError	Nach Objekten

HelpContext

Message


Methoden von EVariantError

EVariantError	Alphabetisch

In EVariantError

~EVariantError

EVariantError

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von EVariantError

EVariantError	Nach Objekten

~EVariantError

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

EVariantError

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


EVariantError::~EVariantError

EVariantError

Der Destruktor ~EVariantError gibt den Speicher frei, der für das EVariantError-Objekt reserviert war. Rufen Sie ~EVariantError nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~EVariantError automatisch aufgerufen wird.

__fastcall virtual ~EVariantError(void);


EVariantError::EVariantError

EVariantError	Siehe auch

Der Konstruktor EVariantError erzeugt ein neues EVariantError-Objekt.

__fastcall EVariantError(const System::AnsiString Msg);

__fastcall EVariantError(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size);

__fastcall EVariantError(int Ident);

__fastcall EVariantError(int Ident, const System::TVarRec *Args, const int Args_Size);

__fastcall EVariantError(const System::AnsiString Msg, int AHelpContext);

__fastcall EVariantError(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size, int AHelpContext);

__fastcall EVariantError(int Ident, int AHelpContext);

__fastcall EVariantError(int Ident, const System::TVarRec *Args, const int Args_Size, int AHelpContext)


Hierarchie

TObject

Exception


EVariantError Beispiel

EVariantError


EWriteError

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/classes.hpp

EWriteError ist die Exception-Klasse für fehlgeschlagene Versuche, Daten in einen Stream zu schreiben.

Beschreibung

EWriteError wird unter folgenden Bedingungen ausgelöst:

•	Die Methode WriteBuffer eines Stream-Objekts kann die festgelegte Anzahl von Bytes nicht schreiben.

•	Die IDE kann eine Komponenteneigenschaft nicht in einen Stream schreiben. Ursache kann der Versuch sein, ein Formular zur Entwurfszeit zu speichern.


Eigenschaften von EWriteError

EWriteError	Alphabetisch

Abgeleitet von Exception

HelpContext

Message


Eigenschaften von EWriteError

EWriteError	Nach Objekten

HelpContext

Message


Methoden von EWriteError

EWriteError	Alphabetisch

In EWriteError

~EWriteError

EWriteError

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von EWriteError

EWriteError	Nach Objekten

~EWriteError

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

EWriteError

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


EWriteError::~EWriteError

EWriteError	Siehe auch

Der Destruktor ~EWriteError gibt den Speicher frei, der für das EWriteError-Objekt reserviert war. Rufen Sie ~EWriteError nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~EWriteError automatisch aufgerufen wird.

__fastcall virtual ~EWriteError(void);


EWriteError::EWriteError

EWriteError	Siehe auch

Der Konstruktor EWriteError erzeugt ein neues EWriteError-Objekt.

__fastcall EWriteError(const System::AnsiString Msg);

__fastcall EWriteError(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size);

__fastcall EWriteError(int Ident);

__fastcall EWriteError(int Ident, const System::TVarRec *Args, const int Args_Size);

__fastcall EWriteError(const System::AnsiString Msg, int AHelpContext);

__fastcall EWriteError(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size, int AHelpContext);

__fastcall EWriteError(int Ident, int AHelpContext);

__fastcall EWriteError(int Ident, const System::TVarRec *Args, const int Args_Size, int AHelpContext)


Hierarchie

TObject

Exception

EStreamError

EFilerError


EWriteError Beispiel

EWriteError


Exception

Hierarchie	Eigenschaften	Methoden

Header

vcl/sysutils.hpp

Exception ist die Basisklasse für alle Laufzeit-Exceptions.

Beschreibung

Die Klasse Exception beinhaltet die generischen Eigenschaften und Methoden aller Exceptions. Sie dient als Basisklasse für benutzerdefinierte Exceptions.

Alle Methoden eines Exception-Objekts sind Konstruktoren, die unterschiedliche Möglichkeiten zur Erzeugung von Exception-Meldungen zur Verfügung stellen. Einige der Konstruktoren erzeugen auch Hilfekontext-IDs. Eine Anwendung ruft diese Konstruktoren normalerweise dynamisch auf, wenn eine Exception auftritt.

Bei Exception-Meldungen kann es sich um hart codierte Strings handeln, um formatierte Strings oder um Strings, die aus einer Ressource der Anwendung geladen werden.

Exceptions werden ausgelöst, wenn in einer Anwendung ein Laufzeitfehler auftritt, beispielsweise beim Versuch einer Division durch Null. Wenn eine Exception ausgelöst wird, zeigt normalerweise eine Exception-Instanz ein Dialogfeld an, in dem die Fehlerbedingung beschrieben wird. Wird eine Exception-Bedingung von der Anwendung nicht abgefangen, so wird die voreingestellte Exception-Behandlungsroutine aufgerufen. Auch diese Behandlungsroutine zeigt ein Dialogfeld mit einem OK-Schalter an, so daß die Anwendung normalerweise weiterlaufen kann, wenn der Benutzer auf OK klickt.

Das Exception-Objekt stellt eine einheitliche Schnittstelle für Fehlerbedingungen zur Verfügung  und erlaubt Anwendungen eine elegante Behandlung von Fehlerbedingungen.

Hinweis

Es ist gängige Praxis, die Namen aller abgeleiteten Exceptions mit einem „E“ beginnen zu lassen, gefolgt von einem kurzen und aussagekräftigen Namen.


Eigenschaften von Exception

Exception	Alphabetisch

In Exception

HelpContext

Message


Eigenschaften von Exception

Exception	Nach Objekten

HelpContext

Message


Exception::HelpContext

Exception

HelpContext enthält die Hilfekontext-ID für die kontextsensitive Online-Hilfe, die zu dieser Exception gehört.

__property int HelpContext;

Beschreibung

HelpContext dient zur Aufnahme der Hilfekontext-ID, die zu dem Exception-Objekt gehört. Diese ID legt den Inhalt des Hilfebildschirms fest, der angezeigt wird, wenn der Benutzer als Reaktion auf eine Exception-Fehlermeldung F1 drückt.

Hinweis

Nicht alle Exception-Konstruktoren bieten die Möglichkeit, einen Wert für HelpContext zu übergeben. Um für benutzerdefinierte Exceptions einen Hilfekontext zur Verfügung zu stellen, verwenden Sie nur die Konstruktoren, die nachfolgend unter Siehe auch aufgeführt sind.


Exception::Message

Exception

Message enthält den Textstring, der im Exception-Dialogfeld angezeigt wird, wenn die Exception ausgelöst wird.

__property System::AnsiString Message;

Beschreibung

Message enthält den Text der Fehlermeldung, die angezeigt wird, wenn die Exception ausgelöst wird. Alle Exception-Konstruktoren erwarten einen String-Parameter, der in Message gespeichert wird. Der Meldungstext kann hart codiert sein, als dynamischer Parameter erzeugt werden oder als statischer oder dynamischer Parameter aus einer Ressourcen-Datei geladen werden.


Methoden von Exception

Exception	Alphabetisch

In Exception

~Exception

Exception

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von Exception

Exception	Nach Objekten

~Exception

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

Exception

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Exception::~Exception

Exception

Der Destruktor ~Exception gibt den Speicher frei, der für das Exception-Objekt reserviert war. Rufen Sie ~Exception nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~Exception automatisch aufgerufen wird.

__fastcall virtual ~Exception(void);


Exception::Exception

Exception	Siehe auch

Exception erzeugt eine Instanz einer Exception mit einem einfachen Meldungsstring.

__fastcall Exception(const System::AnsiString Msg);

__fastcall Exception(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size);

__fastcall Exception(int Ident);

__fastcall Exception(int Ident, const System::TVarRec *Args, const int Args_Size);

__fastcall Exception(const System::AnsiString Msg, int AHelpContext);

__fastcall Exception(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size, int AHelpContext);

__fastcall Exception(int Ident, int AHelpContext);

__fastcall Exception(int Ident, const System::TVarRec *Args, const int Args_Size, int AHelpContext)

Beschreibung

Durch einen Aufruf von Exception läßt sich eine Exception mit einem einfachen Meldungsstring erzeugen. Der String Msg enthält die Laufzeit-Fehlermeldung, die im Dialogfeld der Exception angezeigt wird. Msg kann ein hart codierter String oder ein Funktionsaufruf sein, der einen String zurückgibt.


Hierarchie

TObject


Exception Beispiel

Exception


EZeroDivide

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/sysutils.hpp

EZeroDivide ist die Exception-Klasse für Fehler, die aus der Division einer Gleitkommazahl durch Null resultieren.

Beschreibung

EZeroDivide wird ausgelöst, wenn eine Anwendung versucht, einen Gleitkommawert durch Null zu dividieren.

Hinweis

Fehler, die aus der Division einer Ganzzahl durch Null resultieren, lösen eine EDivByZero-Exception aus.


Eigenschaften von EZeroDivide

EZeroDivide	Alphabetisch

Abgeleitet von Exception

HelpContext

Message


Eigenschaften von EZeroDivide

EZeroDivide	Nach Objekten

HelpContext

Message


Methoden von EZeroDivide

EZeroDivide	Alphabetisch

In EZeroDivide

~EZeroDivide

EZeroDivide

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von EZeroDivide

EZeroDivide	Nach Objekten

~EZeroDivide

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

EZeroDivide

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


EZeroDivide::~EZeroDivide

EZeroDivide

Der Destruktor ~EZeroDivide gibt den Speicher frei, der für das EZeroDivide-Objekt reserviert war. Rufen Sie ~EZeroDivide nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~EZeroDivide automatisch aufgerufen wird.


EZeroDivide::EZeroDivide

EZeroDivide

Der Konstruktor EZeroDivide erzeugt ein neues EZeroDivide-Objekt.

__fastcall EZeroDivide(const System::AnsiString Msg);

__fastcall EZeroDivide(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size);

__fastcall EZeroDivide(int Ident);

__fastcall EZeroDivide(int Ident, const System::TVarRec *Args, const int Args_Size);

__fastcall EZeroDivide(const System::AnsiString Msg, int AHelpContext);

__fastcall EZeroDivide(const System::AnsiString Msg, const System::TVarRec *Args, const int Args_Size, int AHelpContext);

__fastcall EZeroDivide(int Ident, int AHelpContext);

__fastcall EZeroDivide(int Ident, const System::TVarRec *Args, const int Args_Size, int AHelpContext)


Hierarchie

TObject

Exception

EMathError


EZeroDivide Beispiel

EZeroDivide


TField

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/db.hpp

Die Komponente TField ist der gemeinsame Vorfahr der Feldkomponenten in einer Datenmenge.

Beschreibung

TField ist ein abstraktes Objekt, in dem das fundamentale Verhalten gekapselt ist, das allen Feldkomponenten gemeinsam ist. Es werden Eigenschaften, Ereignisse und Methoden eingeführt, die folgenden Zwecken dienen:

•	Den Wert eines Feldes in einer Datenmenge löschen.

•	Den Feldwert in einen anderen Datentyp konvertieren.

•	Eingegebene Daten auf Gültigkeit prüfen.

•	Anzeigeformate für die Darstellung und die Bearbeitung festlegen

•	Berechnen des Feldwertes mit Ereignisbehandlungsroutinen für OnCalcFields

•	Abrufen des Feldwertes aus einer anderen Datenmenge

Es dürfen keine Instanzen von TField erstellt werden. Nachkommen von TField werden bei jeder Aktivierung einer Datenmenge automatisch erzeugt. Diese Nachkommen sind dynamisch (Standardeinstellung) oder persistent. Dynamische Feldkomponenten spiegeln die eigentlichen Spalten in der zugrundeliegenden physikalischen Tabelle zum Zeitpunkt des öffnens einer Datenbank wieder. Persistente Feldkomponenten werden zur Entwurfszeit erstellt, wobei mit dem Felder-Editor die Felder in der Datenmenge sowie deren Eigenschaften und Reihenfolge festgelegt wird.

Mit persistenten Feldkomponenten wird sichergestellt, daß bei jedem Ausführen einer Anwendung die gleichen Spalten in der gleichen Reihenfolge verwendet und angezeigt werden, selbst wenn sich die physikalische Struktur der zugrundeliegenden Datenbank ändert. Wird eine Spalte gelöscht oder geändert, auf der eine persistente Feldkomponente basiert, erzeugt Borland C++Builder eine Exception, anstatt die Tabelle trotz der fehlenden Spalte oder der falschen Daten zu öffnen.

Ein Feld in einer Datenmenge ist immer einer der im folgenden aufgeführten Nachkommen von TField:

•	TStringField

•	TIntegerField

•	TSmallIntField

•	TWordField

•	TFloatField

•	TAutoIncField

•	TCurrencyField

•	TBCDField

•	TBooleanField

•	TDateTimeField

•	TDateField

•	TTimeField

•	TBlobField

•	TBytesField

•	TVarBytesField

•	TMemoField

•	TGraphicField


Eigenschaften von TField

TField	Alphabetisch	Legende

In TField

Alignment

AsBoolean

AsCurrency

AsDateTime

AsFloat

AsInteger

AsString

AsVariant

AttributeSet

BDECalcField

Calculated

CanModify

DataSet

DataSize

DataType

DisplayLabel

DisplayName

DisplayText

DisplayWidth

EditMask

FieldKind

FieldName

FieldNo

Index

IsIndexField

IsNull

KeyFields

Lookup

LookupDataSet

LookupKeyFields

LookupResultField

NewValue

OldValue

ReadOnly

Required

Size

Text

Value

Visible

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Name

Owner

Tag


Eigenschaften von TField

TField	Nach Objekten	Legende

Alignment

AsBoolean

AsCurrency

AsDateTime

AsFloat

AsInteger

AsString

AsVariant

AttributeSet

BDECalcField

Calculated

CanModify

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

DataSet

DataSize

DataType

DesignInfo

DisplayLabel

DisplayName

DisplayText

DisplayWidth

EditMask

FieldKind

FieldName

FieldNo

Index

IsIndexField

IsNull

KeyFields

LookupDataSet

LookupKeyFields

LookupResultField

Lookup

Name

NewValue

OldValue

Owner

ReadOnly

Required

Size

Tag

Text

Value

Visible


TField::Alignment

TField	Siehe auch

Mit Alignment wird festgelegt, wie die Daten eines Feldes in einem datensensitiven Steuerelement angezeigt werden.

__property Classes::TAlignment Alignment;

Beschreibung

Mit Alignment wird die Position der Daten eines Feldes in einem datensensitiven Steuerelement festgelegt. Mögliche Werte sind:

Wert	Funktion

taLeftJustify	Ausrichten der Daten am linken Rand des Steuerelements

taCenter	Horizontal zentrierte Ausrichtung der Daten im Steuerelement

taRightJustify	Ausrichten der Daten am rechten Rand des Steuerelements


TField::AsBoolean

TField	Siehe auch

TField löst bei einem Lese- oder Schreibzugriffsversuch auf die Eigenschaft AsBoolean eine Exception aus.

__property bool AsBoolean;

Beschreibung

Mit AsBoolean kann der Wert der Daten eines Feldes als ein Wert vom Typ Boolean übernommen werden oder ein Wert vom Typ Boolean einem Feld zugewiesen werden. TField unterstützt keine Werte vom Typ Boolean und löst bei einem Lese- oder Schreibzugriffsversuch auf die Eigenschaft AsBoolean eine Exception aus.

Nachkommen von TField, die Felder vom Typ Boolean repräsentieren oder Umwandlungen des Wertes der Eigenschaft Value eines Feldes in einen Wert vom Typ Boolean unterstützen, überschreiben AsBoolean, um den Wert des Feldes als einen Wert vom Typ Boolean zu lesen und zu schreiben.


TField::AsCurrency

TField	Siehe auch

TField löst bei einem Lese- oder Schreibzugriffsversuch auf die Eigenschaft AsCurrency eine Exception aus.

__property System::Currency AsCurrency;

Beschreibung

Mit AsCurrency kann der Wert eines Feldes als ein Wert vom Typ Currency (Währung) für ein Objekt oder eine Variable übernommen werden oder einem Feld ein Wert vom Typ Currency zugewiesen werden. TField unterstützt keine Werte vom Typ Currency und löst bei einem Lese- oder Schreibzugriffsversuch auf die Eigenschaft AsCurrency eine Exception aus.

Nachkommen von TField, die Felder vom Typ Currency repräsentieren oder die Umwandlungen der Eigenschaft Value eines Feldes in einen Wert vom Typ Currency unterstützen, überschreiben AsCurrency, um den Wert des Feldes als einen Wert vom Typ Currency zu lesen und zu schreiben.


TField::AsDateTime

TField	Siehe auch

TField löst bei einem Lese- oder Schreibzugriffsversuch auf die Eigenschaft AsDateTime eine Exception aus.

__property System::TDateTime AsDateTime;

Beschreibung

Mit AsDateTime kann der Wert eines Feldes als ein Wert vom Typ TDateTime für ein Objekt oder eine Variable übernommen werden oder einem Feld ein Wert vom Typ TDateTime zugewiesen werden. TField unterstützt keine Werte vom Typ TDateTime und löst bei einem Lese- oder Schreibzugriffsversuch auf die Eigenschaft TDateTime eine Exception aus.

Nachkommen von TField, die Datums-/Zeitfelder repräsentieren oder die Umwandlungen der Eigenschaft Value eines Feldes in einen Wert vom Typ TDateTime unterstützen, überschreiben AsDateTime, um den Wert des Feldes als einen Wert vom Typ TDateTime zu lesen und zu schreiben.


TField::AsFloat

TField	Siehe auch

TField löst bei einem Lese- oder Schreibzugriffsversuch auf die Eigenschaft AsFloat eine Exception aus.

__property double AsFloat;

Beschreibung

Mit AsFloat kann der Wert eines Feldes in einen Wert vom Typ Double übernommen werden oder ein Wert vom Typ Double einem Feld zugewiesen werden. TField unterstützt keine Gleitkommawerte und löst bei einem Lese- oder Schreibzugriffsversuch auf die Eigenschaft AsFloat eine Exception aus.

Nachkommen von TField, die Felder vom Typ Gleitkomma repräsentieren oder die Umwandlungen der Eigenschaft Value eines Feldes in einen Wert vom Typ Double unterstützen, überschreiben AsFloat, um den Wert des Feldes als einen Wert vom Typ Double zu lesen und zu schreiben.


TField::AsInteger

TField	Siehe auch

TField löst bei einem Lese- oder Schreibzugriffsversuch auf die Eigenschaft AsInteger eine Exception aus.

__property long AsInteger;

Beschreibung

Mit AsInteger kann der Wert eines Feldes in einen Wert vom Typ Integer übernommen werden oder ein Wert vom Typ Integer einem Feld zugewiesen werden. TField unterstützt keine Werte vom Typ Integer und löst bei einem Lese- oder Schreibzugriffsversuch auf die Eigenschaft AsInteger eine Exception aus.

Nachkommen von TField, die Felder vom Typ Integer repräsentieren oder Umwandlungen der Eigenschaft Value eines Feldes in einen Wert vom Typ Integer unterstützen, überschreiben AsInteger, um den Wert des Feldes als einen Wert vom Typ Integer zu lesen und zu schreiben.


TField::AsString

TField	Siehe auch

AsString ist der abgekürzte Klassenname der Feldkomponente.

__property System::AnsiString AsString;

Beschreibung

Bei einem Lesezugriff auf die Eigenschaft AsString wird der abgekürzte Klassenname der Feldkomponente in Klammern gesetzt zurückgegeben. Der abgekürzte Klassenname entsteht durch Entfernen des dem Klassennamen vorangestellten „T“ und des nachfolgenden Wortteils „Field“. Im Falle von TField wird nur das „T“ entfernt, da sonst ein leerer String entstehen würde. Für TField ist der abgekürzte Klassenname „Field“. Ein Schreibzugriffsversuch auf die Eigenschaft AsString löst eine Exception aus.

Nachkommen von TField, die Felder vom Typ String repräsentieren oder Umwandlungen der Eigenschaft Value eines Feldes in einen Wert vom Typ String unterstützen, überschreiben AsString, um den Wert des Feldes als einen aussagekräftigen String zu lesen und zu schreiben.


TField::AsVariant

TField	Siehe auch

Mit AsVariant wird der Wert (Value) eines Feldes in einen Wert vom Typ Variant umgewandelt.

__property System::Variant AsVariant;

Beschreibung

Mit AsVariant kann der Wert der Daten eines Feldes in einen Wert vom Typ Variant übernommen werden oder ein Wert vom Typ Variante einem Feld zugewiesen werden. TField unterstützt keine Werte vom Typ Variante und löst bei einem Lesezugriffsversuch auf die Eigenschaft AsVariant eine Exception aus. TField löst bei einem Schreibzugriffsversuch auf die Eigenschaft AsVariant eine Exception aus, wenn die Variante nicht vom Typ varNull ist. Ist die Variante vom Typ varNull, ruft TField die Methode Clear auf.

Nachkommen von TField implementieren die Methode AsVariant, damit der Wert des Feldes als Wert vom Typ Variante gelesen oder geschrieben werden kann.


TField::AttributeSet

TField	Siehe auch

Die Eigenschaft AttributeSet ist der Name der Attributmenge im Daten-Dictionary, die auf eine Feldkomponente angewendet wird.

__property System::AnsiString AttributeSet;

Beschreibung

Eine Attributmenge legt die Eigenschaften für die Anzeige und Formatierung einer Feldkomponente fest, die zur Entwurfszeit in einem datensensitiven Steuerelement angezeigt wird.

Attributmengen werden ein einem Daten-Dictionary mit Namen gespeichert, so daß Entwickler zur Entwurfszeit die Attributmenge erstellen und auf verschiedene Feldkomponenten in einer oder mehreren Datenmengen anwenden können. Wird eine Attributmenge zur Entwurfszeit einer Feldkomponente zugewiesen und ist der Eigentümer dieser Komponente eine TQuery- oder TStoredPorc-Datenmengenkomponente, enthält AttributeSet den Namen der zugewiesenen Attributmenge.


TField::BDECalcField

TField	Siehe auch

Die Eigenschaft BDECalcField zeigt an, ob es sich bei dem Feld um ein mit Hilfe der BDE berechnetes Feld handelt, wobei die Berechnung auf einer Abfrage basiert, die eine aktualisierbare Datenmenge zurückliefert.

__property bool BDECalcField;

Beschreibung

Mit einem Lesezugriff auf BDECalcField wird festgestellt, ob der Wert einer Feldkomponente durch die Borland Database Engine basierend auf einer Abfrage berechnet wird, die eine aktualisierbare Ergebnismenge zurück liefert. Ist der Wert von BDECalcField True, wird der Wert des Feldes durch die BDE berechnet. Berechnete Felder werden nicht in der der Datenmenge zugrundeliegenden physikalischen Tabelle gespeichert oder daraus gelesen. Sie existieren nur in der Anwendung.

Die folgende SQL-Anweisung enthält zum Beispiel ein von der BDE berechnetes Feld (ONHAND * COST):

SELECT PARTNO, DESCRIPTION, ONHAND, COST, (ONHAND * COST) FROM PARTS

Ist der Wert der Eigenschaft RequestLive des TQuery-Objekts, das diese SQL-Anweisung verwendet, True, enthält das TQuery-Objekt ein TField-Objekt für das berechnete Feld, wobei die Eigenschaft BDECalcField den Wert True hat.

BDECalcField darf nicht mit der Eigenschaft Calculated verwechselt werden. Der Wert eines von der BDE berechneten Feldes basiert auf einer Abfrage, die eine aktuelle Datenmenge zurückliefert, während der Wert eines berechneten Feldes innerhalb der Ereignisbehandlungsroutine der Datenmenge für OnCalcField ermittelt wird.

Hinweis

Hat BDECalcField den Wert True, kann das Feld bearbeitet werden, wobei aber die Änderungen verworfen werden. Wird der Eigenschaft ReadOnly der Wert True zugewiesen, kann das Feld nicht bearbeitet werden.


TField::Calculated

TField	Siehe auch

Mit der Eigenschaft Calculated wird festgelegt, ob der Wert eines Feldes durch die Ereignisbehandlungsroutine für OnCalcFields einer Datenmenge berechnet wird.

__property bool Calculated;

Beschreibung

Mit Calculated wird bestimmt, ob der Wert eines Feldes berechnet wird. Hat Calculated den Wert True und tritt das Ereignis OnCalcFields auf, wird die Ereignisbehandlungsroutine für OnCalcField ausgeführt. Die Voreinstellung ist False.

Der Wert eines Calculated-Feldes wird nicht in der der Datenmenge zugrundeliegenden physikalischen Tabelle gespeichert oder daraus gelesen. Calculated-Felder werden statt dessen für jeden Datensatz in der Tabelle von der Ereignisbehandlungsroutine der Datenmenge für OnCalcFields berechnet, wobei üblicherweise in Ausdrücken Werte aus anderen Feldern des Datensatzes für die Erzeugung des berechneten Feldwertes verwendet werden.

Eine Tabelle kann zum Beispiel nicht-berechnete Felder für MENGE und STÜCKPREIS und ein berechnetes Feld für den GESAMTPREIS enthalten, dessen Wert sich durch die Multiplikation von MENGE und STÜCKPREIS ergibt.

Hinweis

Die Einstellung von Calculated darf in Anwendungen nicht geändert werden. Ist der Wert eines Feldes als berechnet gekennzeichnet, erhält Calculated zur Entwurfszeit vom Felder-Editor den Wert True zugewiesen.


TField::CanModify

TField	Siehe auch

Die Eigenschaft CanModify kennzeichnet ein Feld, dessen Inhalt geändert werden kann.

__property bool CanModify;

Beschreibung

Durch einen Lesezugriff auf CanModify wird ermittelt, ob die Daten eines Feldes geändert werden können. CanModify hat nur dann den Wert True, wenn die Eigenschaft ReadOnly den Wert False hat und wenn die Datenmenge für diese Feldkomponente einen Schreibzugriff auf das entsprechende Feld der Datenbank zuläßt.


TField::DataSet

TField	Siehe auch

DataSet kennzeichnet die Datenmenge, zu der eine Feldkomponente gehört.

__property TDataSet* DataSet;

Beschreibung

Durch einen Lesezugriff auf die Eigenschaft DataSet wird die Datenmenge ermittelt, zu der die Feldkomponente gehört. In Anwendungen sollte die Eigenschaft DataSet eines Feldes nicht direkt eingestellt werden. Die Zuweisung erfolgt automatisch beim Erzeugen des Feldes durch eine TFieldDef-Komponente.


TField::DataSize

TField	Siehe auch

Die Eigenschaft DataSize gibt die Größe des Speichers an, der für die Speicherung des Wertes einer Feldkomponente benötigt wird.

__property unsigned short DataSize;

Beschreibung

Durch einen Lesezugriff auf DataSize wird die für das Speichern eines Wertes einer Feldkomponente erforderliche Anzahl an Bytes ermittelt. Vor dem Speichern eines Feldwertes in einen Puffer muß mit DataSize festgestellt werden, ob der Puffer ausreichend groß ist. Der Wert von DataSize, den TField zurückgibt, hängt von der Eigenschaft DataType der Feldkomponente und manchmal vom Wert der Eigenschaft Size ab.

DataType	Wert von DataSize

ftBoolean	2

ftSmallInt	2

ftWord	2

ftAutoInc	4

ftDate	4

ftInteger	4

ftTime	4

ftCurrency	8

ftDateTime	8

ftFloat	8

ftBCD	34

ftString	Size +1 (aber nicht mehr als 8192 Zeichen)

ftVarBytes	Size + 2

ftBytes	Size

ftBlob	0

ftDBaseOle	0

ftFmtMemo	0

ftGraphic	0

ftMemo	0

ftParadoxOle	0

ftTypedBinary	0

ftUnknown	0

Hinweis

Hat die Eigenschaft DataSize den Wert 0, ist der für die Speicherung des Feldwertes maximal benötigte Speicherplatz unbestimmt.


TField::DataType

TField	Siehe auch

Die Eigenschaft DataType gibt den Datentyp einer Feldkomponente an.

__property TFieldType DataType;

Beschreibung

Mit einem Lesezugriff auf die Eigenschaft DataType wird der Datentyp der im Feld enthaltenen Daten ermittelt. Die Eigenschaft DataType nimmt einen der folgenden Werte an:

Wert	Beschreibung

ftUnkown	Unbekannt oder unbestimmt

ftString	Feld für Zeichen oder Strings

ftSmallint	16-Bit-Integer-Feld

ftInteger	32-Bit-Integer-Feld

ftWord	Vorzeichenloses 16-Bit-Integer-Feld

ftBoolean	Feld vom Typ Boolean

ftFloat	Numerisches Gleitkommafeld

ftCurrency	Währungsfeld

ftBCD	Binärcodiertes Dezimalfeld

ftDate	Feld für Datum

ftTime	Feld für Zeit

ftDateTime	Feld für Datum und Zeit

ftBytes	Festegelegte Zahl von Bytes (binäre Speicherung)

ftVarBytes	Variable Zahl von Bytes (binäre Speicherung)

ftAutoInc	Automatisch inkrementiertes 32-Bit-Integer-Feld als Zähler

ftBlob	Binäres Large-OBject-Feld (BLOB)

ftMemo	Memofeld für Texte

ftGraphic	Feld für Bitmaps

ftFmtMemo	Formatiertes Memofeld für Texte

ftParadoxOle	Paradox OLE-Feld

ftDBaseOle	dBase OLE-Feld

ftTypedBinary	Typisiertes Binärfeld


TField::DisplayLabel

TField	Siehe auch

DisplayLabel enthält den Text für eine Feldkomponente, der als Spaltenüberschrift eines Datengitters angezeigt wird.

__property System::AnsiString DisplayLabel;

Beschreibung

Mit DisplayLabel werden einem Datengitter Spaltenüberschriften zugewiesen. Dabei wird die Eigenschaft DisplayName verwendet. Mit dem Setzen von DisplayLabel wird DisplayName von FieldName in den String geändert, den DisplayLabel enthält.


TField::DisplayName

TField	Siehe auch

Die Eigenschaft DisplayName liefert den Namen des Feldes zu Anzeigezwekken zurück.

__property System::AnsiString DisplayName;

Beschreibung

DisplayName wird zur Anzeige eines Strings verwendet, der das Feld für den Benutzer repräsentiert. Tritt eine das Feld betreffende Exception auf, kann zum Beispiel in einem Fehler-String durch Einfügen von DisplayName auf das Feld Bezug genommen werden.

Ist DisplayLabel definiert, enthalten DisplayName und DisplayLabel denselben Wert. Andernfalls haben DisplayName und die Eigenschaft FieldName den gleichen Wert.


TField::DisplayText

TField	Siehe auch

DisplayText ist die String-Darstellung eines Feldwertes für die Anzeige in einem datensensitiven Steuerelement

__property System::AnsiString DisplayText;

Beschreibung

DisplayText ist die String-Darstellung eines Feldwertes für die Anzeige in einem datensensitiven Steuerelement. DisplayText kann nur gelesen werden. Wenn für OnGetText eine Ereignisbehandlungsroutine existiert und der Parameter DisplayText den Wert True hat, wird von dieser Routine der Wert DisplayText zurückgegeben. Andernfalls ist DisplayText der Wert der Eigenschaft AsString.

DisplayText ist die String-Darstellung der Feldeigenschaft Value, wenn es nicht bearbeitet wird. Die Eigenschaft Text wird verwendet wenn das Feld bearbeitet werden soll.


TField::DisplayWidth

TField	Siehe auch

Die Eigenschaft DisplayWidth legt die Zahl der Zeichen fest, die für die Anzeige eines Feldwertes durch ein zugehöriges datensensitives Steuerelement verwendet werden sollen.

__property int DisplayWidth;

Beschreibung

Mit DisplayWidth wird gesteuert, wieviele Zeichen für die Berechnung der Spaltenbreite für das Feld verwendet werden, wenn es von einem TDBLookupListBox-Objekts oder von einem Nachkommen von TCustomDBGrid angezeigt wird. Die eigentliche Breite der Spalten wird durch die durchschnittliche Breite der Zeichen bestimmt. Verwendet das datensensitive Steuerelement, mit dem das Feld angezeigt wird, eine Schriftart mit variablem Zeichenabstand, kann DisplayWidth mehr oder weniger Zeichen ausweisen, als in der Spalte tatsächlich Platz finden.

Hinweis

Die Eigenschaft DisplayWidth bleibt ohne Wirkung, wenn ein expliziter Columns-Wert für das Feld in einem TDBGrid-Objekt definiert ist.


TField::EditMask

TField	Siehe auch 	Beispiel

Die Eigenschaft EditMask enthält die Maske, welche die Eingabemöglichkeiten in einem Datenfeld einschränkt.

__property System::AnsiString EditMask;

Beschreibung

Mit EditMask werden die Zeichen und Formate festgelegt, die als Benutzereingabe zulässig sind. Ein unzulässiges Zeichen wird als Eingabe abgelehnt. Die Zeichen werden einzeln geprüft. Mit einer Ereignisbehandlungsroutine für OnValidate wird die gesamte Eingabe vor dem Speichern in der Datenbank geprüft.

Eine Maske besteht aus drei durch Semikolons getrennte Felder. Der erste Teil ist die eigentliche Maske. Der zweite Teil ist das Zeichen, mit dem festgelegt wird, ob die literalen Zeichen einer Maske in den Daten enthalten sind. Der dritte Teil der Maske enthält das  Zeichen, das nicht eingegebene Zeichen in der Maske repräsentiert.

In folgenden sind die Zeichen aufgeführt, die im ersten Feld der Maske verwendet werden:

Zeichen	Bedeutung in der Maske

      !	Enthält die Maske ein Ausrufezeichen, werden optionale Zeichen in EditText durch vorangestellte Leerzeichen dargestellt. Enthält die Maske kein Ausrufezeichen, werden optionale Zeichen in EditText durch nachgestellte Leerzeichen dargestellt.

     >	Enthält die Maske das Zeichen „>“, sind bis zum Ende der Maske oder bis zum Zeichen „<“ Zeichen alle nachfolgenden Zeichen Großbuchstaben.

     <	Enthält die Maske das Zeichen „<“, sind bis zum Ende der Maske oder bis zum Zeichen „>“ Zeichen alle nachfolgenden Zeichen Kleinbuchstaben.

     <>	Erscheinen diese Zeichen zusammen in einer Maske, wird keine Überprüfung der Groß-/Kleinschreibung durchgeführt, und die Daten werden so formatiert wie eingegeben.

     \	Das Zeichen, das dem Zeichen „\“ folgt, ist ein Schriftzeichen. Dieses Zeichen wird verwendet, um die hier beschriebenen Masken-Sonderzeichen als literale Zeichen in den Daten zuzulassen.

     L	Das Zeichen „L“ zeigt an, daß an dieser Position nur ein Buchstabe des Alphabets zugelassen ist. In Deutschland sind das A-Z und a-z.

     l	Das Zeichen „l“ zeigt an, daß an dieser Position ein Buchstabe des Alphabets zugelassen ist, aber nicht unbedingt erforderlich ist.

     A	Das Zeichen „A“ zeigt an, daß an dieser Position nur ein alphanumerisches Zeichen zugelassen ist. In Deutschland sind das A-Z, a-z und 0-9.

     a	Das Zeichen „a“ zeigt an, daß an dieser Position ein alphanumerisches Zeichen zugelassen ist, aber nicht unbedingt erforderlich ist.

     C	Das Zeichen „C“ zeigt an, daß an dieser Position ein beliebiges-Zeichen erforderlich ist.

     c	Das Zeichen „c“ zeigt an, daß an dieser Position ein beliebiges-Zeichen zugelassen ist, aber nicht unbedingt erforderlich ist.

     0	Das Zeichen „0“ zeigt an, daß an dieser Position nur ein numerisches Zeichen zugelassen ist.

     9	Das Zeichen „9“ zeigt an, daß an dieser Position ein numerisches Zeichen zugelassen ist, aber nicht unbedingt erforderlich ist.

     #	Das Zeichen „#“ zeigt an, daß an dieser Position ein numerisches Zeichen oder ein Plus- oder Minuszeichen zugelassen ist, aber nicht unbedingt erforderlich ist.

     :	Das Zeichen „:“ wird für die Trennung von Stunden, Minuten und Sekunden bei Zeitangaben verwendet. Ist in der Systemsteuerung unter Ländereinstellungen ein anderes Trennzeichen für Stunden, Minuten und Sekunden eingetragen, wird dieses anstelle des Doppelpunkts verwendet.

     /	Das Zeichen „/“ wird für die Trennung von Monaten, Tagen und Jahren bei Datumsangaben verwendet. Ist in der Systemsteuerung unter Ländereinstellungen ein anderes Trennzeichen für Monate, Tage und Jahre eingetragen, wird dieses anstelle des Schrägstrichs verwendet.

     ;	Das Semikolon wird als Trennzeichen für die drei Felder der Maske verwendet.

     _	Der Unterstrich bewirkt das automatische Einfügen von Leerzeichen in den Text. Bei der Eingabe von Zeichen in ein Feld werden die Positionen mit Unterstrich übersprungen.

In der Liste nicht aufgeführte Zeichen können im ersten Teil der Maske als literale Zeichen verwendet werden. Solche Zeichen müssen bei der Eingabe von Daten in das Feld die Kriterien der Maske erfüllen. Sie werden automatisch eingefügt, und der Cursor überspringt sie bei der Bearbeitung. Die Sonderzeichen für die Maske können auch als literale Zeichen verwendet werden, wenn ihnen das Zeichen „\“ vorangestellt wird.

Das zweite Feld der Maske enthält ein einzelnes Zeichen, mit dem festgelegt wird, ob Schriftzeichen der Maske als Teil der Eigenschaft Value des Feldes behandelt werden. Zum Beispiel könnte die Maske für eine Telefonnummer mit Vorwahl folgender String sein:

(000)_000-0000;0;*

Die Null im zweiten Feld zeigt an, daß die Eigenschaft Value des Feldes 10 eingegebene Ziffern enthält, und nicht die 14 Zeichen, die dem Benutzer als Telefonnummer angezeigt werden.

Eine Null im zweiten Feld zeigt an, daß literale nicht eingebunden werden sollten, jedes andere Zeichen würde signalisieren, daß sie eingebunden werden sollten. Das Zeichen, mit dem bestimmt wird, ob literale Zeichen mit einbezogen werden sollen, kann mit dem Editor für die Eigenschaft EditMask oder durch Änderung der typisierten Konstante MaskNoSave im Programmablauf gewechselt werden.

Das dritte Feld der Maske enthält das Zeichen, das im Eingabefeld nicht eingegebene Zeichen (Leerzeichen) repräsentiert. Als Voreinstellung ist das gleiche Zeichen eingetragen, das literale Zeichen repräsentiert. Beide Zeichen werden in einem Eingabefeld identisch dargestellt. Werden allerdings Daten für das Feld eingegeben, markiert der Cursor jede Position, an der Zeichen eingegeben werden sollen, überspringt aber die Positionen, an denen ein Leerzeichen eingefügt ist.

Die Maske wird entfernt, sobald EditMask einen leeren String enthält.


TField::EditMaskPtr

TField

EditMaskPtr hat die gleiche Bedeutung wie EditMask,.nur ist es schreibgeschützt

__property System::AnsiString EditMask


TField::FieldKind

TField	Siehe auch

Die Eigenschaft FieldKind legt fest, ob ein Feld eine Spalte in einer Datenmenge, ein berechnetes Feld oder ein Lookup-Feld repräsentiert.

__property TFieldKind FieldKind;

Beschreibung

Mit FieldKind wird festgelegt, ob es sich bei einem Feld um ein Datenfeld, ein berechnetes Feld oder ein Lookup-Feld handelt. Der Wert von FieldKind kann im Programm geändert werden. In der Praxis aber wird FieldKind zur Entwurfszeit automatisch beim Erzeugen von Feldkomponenten mit dem Felder-Editor gesetzt.

Die Eigenschaft FieldKind nimmt einen der folgenden Werte an:

Wert	Beschreibung

fkData	Das Feld repräsentiert ein physikalisches Feld in einer Datenbanktabelle.

fkCalculated	Das Feld ist berechnet.

fkLookup	Das Feld ist ein Lookup-Feld.

Hinweis

Felder, die von der BDE berechnet werden und die Ergebnisse einer Abfrage anzeigen, die eine aktualisierbare Ergebnismenge liefert, besitzen in der Eigenschaft FieldKind den Wert fkData, nicht fkCalculated.


TField::FieldName

TField	Siehe auch

FieldName ist der Name der physikalischen Spalte in der zugrundeliegenden Datenmenge, an die eine Feldkomponente gebunden ist.

__property System::AnsiString FieldName;

Beschreibung

Mit FieldName wird vom TFieldDef-Objekt beim Erzeugen einer Feldkomponente festgelegt, welches Feld in der zugrundeliegenden Datenmenge durch die Feldkomponente repräsentiert wird. FieldName wird bei der Anzeige von Benutzerinformationen verwendet, wenn DisplayLabel nicht gesetzt wurde. Geben Sie bei der Definition eines berechneten Feldes einen Feldnamen in FieldName an. Bei einem Feld, das nicht berechnet wird, tritt ein EDatabaseError-Exception auf, wenn der in FieldName übergebene Name kein Spaltenname in der physikalischen Tabelle ist.


TField::FieldNo

TField	Siehe auch

FieldNo ist die Ordnungszahl der eigentlichen Spalte in der physikalischen Tabelle, die einer Datenmenge zugrundeliegt.

__property int FieldNo;

Beschreibung

Mit einem Lesezugriff auf FieldNo kann die Ordinalposition in der zugrundeliegenden Tabelle ermittelt werden, wobei eine 1 das erste Feld kennzeichnet. Die Eigenschaft FieldNo darf für die Angabe des Feldes nur in Programmen verwendet werden, die direkte Aufrufe an die Borland Database Engine richten.

Hinweis

Die Eigenschaft FieldNo, die für die Ordinalposition der Feldkomponente in der physikalischen Datenbanktabelle steht, darf nicht mit der Eigenschaft Index verwechselt werden, die der Position der Feldkomponente in der Eigenschaft Fields der Datenmenge entspricht.


TField::Index

TField	Siehe auch

Die Eigenschaft Index ist die Indexnummer der Feldkomponente gespeichert, die in die Eigenschaft Fields der Datenmenge zeigt.

__property int Index;

Beschreibung

Die Eigenschaft Index wird in den folgenden Situationen verwendet:

•	Suchen einer Feldposition in der Datenmenge

•	Ändern der Position eines Feldes in der Datenmenge durch Ändern von Index.  Das Ändern des Index-Wertes wirkt sich auf die Reihenfolge aus, in der Felder im Datengitter angezeigt werden, aber nicht auf die Position der Felder in den physikalischen Datenbanktabellen.

Hinweis

Die Reihenfolge der Felder kann auch während des Entwurfs durch Ziehen und Ablegen der Felder im Felder-Editor geändert werden.


TField::IsIndexField

TField	Siehe auch

Mit IsIndexField wird festgelegt, ob es sich bei einem Feld um ein Index-Feld handelt.

__property bool IsIndexField;

Beschreibung

Mit IsIndexField kann ermittelt werden, ob ein Feld ein Index-Feld ist. Hat IsIndexField den Wert True, gehört das Feld zu den Feldern, die den Index auf die zugrundeliegende Datenbanktabelle bilden. Das Feld ist kein Index-Feld, wenn der Wert von IsIndexField False ist. Eine Feldkomponente muß ein Index-Feld sein, damit es als eines der Feldkomponenten für die LookupKeyFields-Felder in einer Lookup-Tabelle fungieren kann.


TField::IsNull

TField	Siehe auch

Die Eigenschaft IsNull zeigt an, ob dem Feld ein Wert zugewiesen wurde.

__property bool IsNull;

Beschreibung

Mit IsNull wird ermittelt, ob im Feld ein Wert gespeichert ist. Hat IsNull den Wert True, enthält das Feld keinen Wert. Hat IsNull den Wert False, enthält das Feld einen Wert.


TField::KeyFields

TField	Siehe auch

Die Eigenschaft KeyFields kennzeichnet das Feld oder die Felder in der Datenmenge, für die in der Lookup-Datenmenge bei der Durchführung eines Lookup eine Übereinstimmung bestehen muß.

__property System::AnsiString KeyFields;

Beschreibung

KeyFields darf nur bei Lookup-Feldern gesetzt werden (Felder, bei denen FieldKind den Wert fkLookup und Lookup den Wert True hat). KeyFields legen das Feld oder die Felder fest, für die bei Auftreten eines Lookup eine Übereinstimmung erreicht werden muß. Sollen mehrere Felder berücksichtigt werden, trennen Sie die Feldnamen durch ein Semikolon. Die festgelegten Felder müssen vom selben Typ wie die entsprechenden Felder in LookupKeyFields sein, andernfalls schlägt der Lookup fehl.

Für die Werte der KeyFields-Felder in der Datenmenge DataSet werden die passenden Werte der LookupKeyFields-Felder in der Datenmenge LookupDataSet gesucht, um einen bestimmten Datensatz der Lookup-Tabelle zu bestimmen. Der Wert von LookupResultField des Datensatzes wird in die Eigenschaft Value der Feldkomponente übernommen.


TField::Lookup

TField	Siehe auch

Die Eigenschaft Lookup zeigt an, ob es sich bei dem Feld um ein Lookup-Feld handelt.

__property bool Lookup;

Beschreibung

Mit Lookup wird bestimmt, ob ein Feld ein Lookup-Feld ist.

Das Feld ist kein Lookup-Feld, wenn der Wert von Lookup False ist. Hat Lookup den Wert True, handelt es sich um ein Lookup-Feld, und der Wert von FieldKind ist ftLookup.

Ist das Feld ein Lookup-Field, kennzeichnet die Eigenschaft KeyFields die Felder in der Datenmenge, die zur Identifizierung eines Datensatzes in der Datenmenge LookupDataSet mit den LookupKeyFields in der Datenmenge LookupDataSet übereinstimmen müssen. Der Wert des mit LookupResultField gekennzeichneten Datensatzfeldes wird in die Eigenschaft Value der Feldkomponente übernommen.


TField::LookupDataSet

TField	Siehe auch

Die Eigenschaft LookupDataSet bestimmt die Datenmenge, die für das Auffinden der Feldwerte verwendet wird.

__property TDataSet* LookupDataSet;

Beschreibung

LookupDataSet wird für die Festlegung der Datenmenge verwendet, die für das Auffinden von Feldwerten in einem Feld mit dem Wert fkLookup in der Eigenschaft FieldKind verwendet wird.

Handelt es sich bei einer Feldkomponente um ein Lookup-Feld, hat die Eigenschaft Value der Feldkomponente den Wert des durch die Eigenschaft LookupResultField gekennzeichneten Feldes in der durch LookupDataSet bezeichneten Datenmenge. Der Datensatz in der durch LookupDataSet gekennzeichneten Datenmenge, der den richtigen Wert enthält, wird durch Vergleich der mit LookupDataFields festgelegten Felder in der durch LookupDataSet bestimmten Datenmenge mit den aktuellen Werten der mit KeyFields angegebenen Felder in der mit DataSet festgesetzten Datenmenge aufgefunden.


TField::LookupKeyFields

TField	Siehe auch

Die Eigenschaft LookupKeyFields kennzeichnet das oder die Felder in der Lookup-Datenmenge, für die bei der Durchführung eines Lookup eine Übereinstimmung gefunden werden muß.

__property System::AnsiString LookupKeyFields;

Beschreibung

LookupKeyFields darf nur bei Feldkomponenten verwendet werden, bei denen FieldKind den Wert fkLookup hat. Die mit LookupKeyField bestimmten Felder sind die Felder im Index der Datenmenge LookupDataSet, deren Werte mit den Werten der Felder KeyFields in der Datenmenge der Feldkomponente übereinstimmen müssen.

Sollen mehrere Felder berücksichtigt werden, trennen Sie die Feldnamen durch ein Semikolon. Die mit LookupKeyFields bezeichneten Felder müssen vom selben Typ sein wie die entsprechenden durch KeyFields bestimmten Felder, andernfalls schlägt der Lookup fehl.

Ein bestimmter Datensatz in der Lookup-Datenmenge (LookupDataSet) wird gefunden, indem die Werte der Felder LookupKeyFields in LookupDataSet mit den Werten der durch KeyFields gekennzeichneten Felder abgeglichen werden. Der Wert der Feldeigenschaft Value entspricht dem Wert des Feldes LookupResultField im gekennzeichneten Datensatz.


TField::LookupResultField

TField	Siehe auch

Die Eigenschaft LookupResultField kennzeichnet das Feld der Lookup-Datenmenge, dessen Wert der Eigenschaft Value der Feldkomponente zugewiesen wird.

__property System::AnsiString LookupResultField;

Beschreibung

Mit LookupResultField wird ein bestimmtes Feld in der Datenmenge LookupDataSet identifiziert, dessen Wert zum Wert der Feldkomponente wird. Die Eigenschaft FieldKind der Feldkomponente muß den Wert fkLookup haben, und der Datentyp DataTyp der Feldkomponente muß mit dem des Feldes LookupResultField übereinstimmen.

Handelt es sich bei einer Feldkomponente um ein Lookup-Feld, hat die Eigenschaft Value der Feldkomponente den Wert des Feldes LookupResultField in der Datenmenge LookupDataSet. Der Datensatz in der Datenmenge LookupDataSet, der den richtigen Wert enthält, wird durch Vergleich der Felder LookupDataFields in der Datenmenge LookupDataSet mit den aktuellen Werten der Felder KeyFields in der Datenmenge DataSet gefunden.


TField::NewValue

TField	Siehe auch

Die Eigenschaft NewValue repräsentiert den aktuellen Wert der Feldkomponente, einschließlich der anstehenden zwischengespeicherten Aktualisierungen.

__property System::Variant NewValue;

Beschreibung

NewValue wird für das Ermitteln oder Ändern des Feldes verwendet, während zwischengespeicherte Aktualisierungen eingetragen werden. Wird durch den aktuellen Feldwert ein Problem verursacht, kann durch Zuweisen eines neuen Wertes für NewValue das Problem behoben werden.

Die Werte von NewValue und Value sind identisch, außer während des Eintragens von zwischengespeicherten Aktualisierungen. Wird NewValue in einer Ereignisbehandlungsroutine für OnUpdateError oder für OnUpdateRecord gesetzt, unterscheiden sich die Werte NewValue und Value, bis die zwischengespeicherten Aktualisierungen vollständig in der zugrundeliegenden Datenbanktabelle eingetragen sind.


TField::OldValue

TField	Siehe auch

Die Eigenschaft OldValue repräsentiert den ursprünglichen Wert des Feldes (als Variante), bevor er durch eine anstehende zwischengespeicherte Aktualisierung geändert wurde.

__property System::Variant OldValue;

Beschreibung

Durch einen Lesezugriff auf OldValue kann der ursprüngliche Wert des Feldes ermittelt werden, den es vor dem Eintragen zwischengespeicherter Aktualisierungen hatte.

Wurden zwischengespeicherte Aktualisierungen erfolgreich endgültig eingetragen, kann der ursprüngliche Feldwert nicht wiederhergestellt werden.


TField::ReadOnly

TField	Siehe auch

Die Eigenschaft ReadOnly legt fest, ob ein Feld geändert werden kann.

__property bool ReadOnly;

Beschreibung

Soll ein Feld vor Änderungen geschützt werden, wird ReadOnly der Wert True zugewiesen. Im Datengitter werden beim Steuern des Cursors mit der Tabulatortaste Felder übersprungen, deren Eigenschaft ReadOnly den Wert True hat.

Ob ein Feld geändert werden kann, wird besser über die Eigenschaft CanModify ermittelt. CanModify drückt nicht nur den Wert der Eigenschaft ReadOnly aus, sondern auch Beschränkungen, die durch die zugrundeliegende Datenmenge auferlegt sind.


TField::Required

TField	Siehe auch

Mit Required wird angezeigt, ob ein Feld einen Wert erfordert.

__property bool Required;

Beschreibung

Durch einen Lesezugriff auf Required kann ermittelt werden, ob einem Feld ein Wert zugewiesen werden muß oder ob es leer bleiben kann.

Wird ein Feld mit dem Felder-Editor erstellt, wird diese Eigenschaft gemäß der zugrundeliegenden Tabelle gesetzt. Damit die Eigenschaft Required von Feldern, für welche die zugrundeliegende Tabelle keinen Wert erfordert, durch eine Anwendung wirksam auf True gesetzt werden kann, muß eine entsprechende Ereignisbehandlungsroutine für OnValidate erstellt werden.

Spiegelt die Eigenschaft Required eine Eigenschaft der zugrundeliegenden Datenbanktabelle wieder, löst der Versuch, den Wert NIL zu speichern, eine Exception aus. Wird die Eigenschaft Required auf True gesetzt, wenn für die zugrundeliegende Tabelle die Angabe des Feldwertes nicht erforderlich ist, sollte die Ereignisbehandlungsroutine für OnValidate beim Versuch, einen Wert NIL zu speichern, eine Exception auslösen, um gleiche Ergebnisse zu erreichen.


TField::Size

TField	Siehe auch

Die Eigenschaft Size zeigt bei Datentypen, die unterschiedliche Größen unterstützen, die bei der Definition des physikalischen Datenbankfeldes verwendete Größe an.

__property unsigned short Size;

Beschreibung

Die Bedeutung von Size hängt vom Datentyp ab. Size ist die Größe, die mit dem Feld durch die Borland DataBase Engine verbunden wird. Die Bedeutung von Size für verschiedene Datentypen:

Datentyp	Bedeutung

ftBoolean	Size hat immer den Wert 0 und wird nicht verwendet.

ftSmallInt	Size hat immer den Wert 0 und wird nicht verwendet.

ftWord	Size hat immer den Wert 0 und wird nicht verwendet.

ftAutoInc	Size hat immer den Wert 0 und wird nicht verwendet.

ftDate	Size hat immer den Wert 0 und wird nicht verwendet.

ftInteger	Size hat immer den Wert 0 und wird nicht verwendet.

ftTime	Size hat immer den Wert 0 und wird nicht verwendet.

ftCurrency	Size hat immer den Wert 0 und wird nicht verwendet.

ftDateTime	Size hat immer den Wert 0 und wird nicht verwendet.

ftFloat	Size hat immer den Wert 0 und wird nicht verwendet.

ftBCD	Size gibt die Zahl der Ziffern nach dem Dezimalpunkt an.

ftString	Size ist die maximale Anzahl an Zeichen im String.

ftVarBytes	Size ist die maximale Anzahl an Datenbytes, wobei die ersten zwei Byte nicht berücksichtigt sind, welche die eigentliche Anzahl der verwendeten Datenbytes angeben.

ftBytes	Size ist die maximale Anzahl an Datenbytes im String.

ftBlob	Size ist die Anzahl an Bytes vom BLOB, die im Datensatzpuffer gespeichert werden.

ftDBaseOle	Size ist die Anzahl an Bytes vom DBase-BLOB, die im Datensatzpuffer gespeichert werden.

ftFmtMemo	Size ist die Anzahl an Bytes vom Memofeld, die im Datensatzpuffer gespeichert werden.

ftGraphic	Size ist die Anzahl an Bytes des Bildes, die im Datensatzpuffer gespeichert werden.

ftMemo	Size ist die Anzahl an Zeichen vom Memo, die im Datensatzpuffer gespeichert werden.

ftParadoxOle	Size ist die Anzahl an Bytes vom Paradox-OLE-BLOB, die im Datensatzpuffer gespeichert werden.

ftTypedBinary	Size ist die Anzahl an Bytes vom BLOB, die im Datensatzpuffer gespeichert werden.

ftUnknown	Size hat immer den Wert 0 und wird nicht verwendet.


TField::Text

TField	Beispiel

Die Eigenschaft Text enthält den String, der in einem datensensitiven Steuerelement angezeigt wird, wenn sich das Feld im Bearbeitungsmodus befindet.

__property System::AnsiString Text;

Beschreibung

Datensensitive Steuerelemente greifen beim Bereitstellen des Bearbeitungsformats für jedes Feld auf die Eigenschaft Text zurück. Ist eine Ereignisbehandlungsroutine für OnGetText definiert, wird der Wert Text zurückgegeben, wenn der Parameter DisplayText den Wert False hat. Andernfalls ist Text der Wert der Eigenschaft AsString.

Hinweis

Der Inhalt von Text kann sich vom Inhalt der Eigenschaft DisplayText unterscheiden, wenn das Feld im Bearbeitungsmodus eine abweichende String-Darstellung haben soll. Die unterschiedliche String-Darstellung eines Feldwertes wird in der Ereignisbehandlungsroutine für OnGetText implementiert.

Hinweis

Ereignis OnGetText, Eigenschaft DisplayText, Eigenschaft Value, Eigenschaft AsString


TField::Value

TField	Siehe auch

Die Eigenschaft Value enthält die eigentlichen Daten einer Feldkomponente.

__property System::Variant Value;

Beschreibung

Mit Value werden zur Laufzeit Daten direkt von einer Feldkomponente gelesen oder in der Komponente gespeichert. Die Eigenschaft Value wird beispielsweise für die Beeinflussung des Inhalts eines nicht sichtbaren Feldes verwendet.

Außer beim Eintragen von zwischengespeicherten Aktualisierungen haben die Eigenschaften Value und NewValue denselben Inhalt.


TField::Visible

TField	Siehe auch	Beispiel

Mit der Eigenschaft Visible wird festgelegt, ob ein Feld im Datengitter angezeigt wird.

__property bool Visible;

Beschreibung

Das Zuweisen des Wertes False an die Eigenschaft Visible führt dazu, daß das Feld verborgen und im Datengitter nicht angezeigt wird. Hat Visible den Wert True, wird das Feld im Gitter angezeigt.

Hinweis

Die Eigenschaft Visible bleibt ohne Wirkung, wenn für das Feld ein expliziter Wert für Columns definiert ist.


Ereignisse von TField

TField	Alphabetisch	Legende

In TField

OnChange

OnGetText

OnSetText

OnValidate


Ereignisse von TField

TField	Nach Objekten	Legende

OnChange

OnGetText

OnSetText

OnValidate


TField::OnChange

TField	Siehe auch

Das Ereignis OnChange tritt sofort nach dem Speichern der Felddaten im Datensatzpuffer auf.

typedef void __fastcall (__closure *TFieldNotifyEvent)(TField* Sender);

__property TFieldNotifyEvent OnChange;

Beschreibung

Schreiben Sie eine Ereignisbehandlungsroutine für OnChange, um auf Änderungen der Felddaten zu reagieren. Mit Hilfe von OnChange kann nach dem erfolgreichen Speichern der Daten in der zugrundeliegenden Datenbanktabelle eine Reaktion eingeleitet werden.

Durch das Speichern des Feldwertes im aktuellen Datensatzpuffer wird das Ausführen folgender Schritte ausgelöst:

1	Die Ereignisbehandlungsroutine für OnChange wird zur Prüfung der Daten aufgerufen.

2	Wird der aktuelle Wert von Value durch die Ereignisbehandlungsroutine als gültig bewertet, werden die Daten im Datensatzpuffer gespeichert.

3	Löst das Speichern der Daten keine Exception aus, wird die Ereignisbehandlungsroutine für OnChange aufgerufen. Damit kann auf Änderungen reagiert werden.


TField::OnGetText

TField	Siehe auch

Das Ereignis OnGetText wird ausgelöst, wenn die Feldeigenschaften DisplayText oder Text referenziert werden.

typedef void __fastcall (__closure *TFieldGetTextEvent)(TField* Sender,  System::AnsiString &Text, bool DisplayText);

__property TFieldGetTextEvent OnGetText;

Beschreibung

Schreiben Sie eine Ereignisbehandlungsroutine für OnGetText, um die Eigenschaften DisplayText und Text individuell zu verarbeiten. Mit OnGetText kann der Wert Value des Feldes unterschiedlich dargestellt werden, wenn er einfach nur angezeigt oder aber bearbeitet wird. Alternativ dazu kann mit Hilfe von OnGetText auch etwas anderes als der Feldwert dargestellt werden.

Der Parameter Sender hat den Wert self, er bezeichnet also die Feldkomponente. Der Parameter Text nimmt den formatierten Text auf, der von den Eigenschaften DisplayText oder Text verwendet wird. Der Parameter DisplayText zeigt an, ob der Text nur zur Anzeige oder auch bei der Bearbeitung verwendet wird.

Existiert keine Ereignisbehandlungsroutine für OnGetText, entsprechen die Werte der Eigenschaften DisplayText und Text dem Wert der Eigenschaft AsString.


TField::OnSetText

TField	Siehe auch

Das Ereignis OnSetText wird ausgelöst, wenn der Eigenschaft Text ein Wert zugewiesen wird.

typedef void __fastcall (__closure *TFieldSetTextEvent)(TField* Sender, const System::AnsiString Text	);

__property TFieldSetTextEvent OnSetText;

Beschreibung

Wird Text ein neuer Wert zugewiesen, kann mit einer Ereignisbehandlungsroutine für OnSetText darauf reagiert werden. Wird durch eine Ereignisbehandlungsroutine für OnGetText das Format des Feldwertes (Value) für Bearbeitungszwecke verändert, sollte OnSetText den Vorgang rückgängig machen, wenn der bearbeitete String zerlegt wird.

Existiert keine Ereignisbehandlungsroutine für OnSetText, wird die Eigenschaft Text durch das Setzen der Eigenschaft AsString mit gesetzt.


TField::OnValidate

TField	Siehe auch

Kurz vor dem Speichern der Daten im Datensatzpuffer wird das Ereignis OnValidate ausgelöst.

typedef void __fastcall (__closure *TFieldNotifyEvent)(TField* Sender);

__property TFieldNotifyEvent OnValidate;

Beschreibung

Schreiben Sie eine Ereignisbehandlungsroutine, welche die Änderungen an den Felddaten überprüft, bevor die Daten in den Datensatzpuffer geschrieben werden. Während der Eingabe von Daten durch den Benutzer können diese mit Hilfe der Eigenschaft EditMask zeichenweise geprüft werden. Eine Anwendung kann mit OnValidate die Daten insgesamt prüfen.

Wird einer Feldkomponente programmseitig ein Wert zugewiesen, wird die Prüfung durch EditMask umgangen, da kein datensensitives Steuerelement vorhanden ist, das die Berücksichtigung der Maske erzwingt. In Anwendungen können die Daten mit Hilfe von OnValidate vor dem Eintragen in die Datenbanktabelle geprüft werden.

Um den aktuellen Feldwert zu verwerfen, sollte die Ereignisbehandlungsroutine eine Exception auslösen.

Folgende Schritte laufen ab, wenn ein Feld in den aktuellen Datensatzpuffer geschrieben wird:

1	Die Ereignisbehandlungsroutine für OnValidate wird zur Prüfung der Daten aufgerufen.

2	Löst die Ereignisbehandlungsroutine für OnValidate keine Exception aus, werden die Daten in den aktuellen Datensatzpuffer geschrieben.

3	Löst das Schreiben der Daten keine Exception aus, wird die Ereignisbehandlungsroutine für OnChange aufgerufen. Damit kann auf die durchgeführten Änderungen reagiert werden.


Methoden von TField

TField	Alphabetisch

In TField

~TField

Assign

AssignValue

Clear

FocusControl

GetData

IsValidChar

SetData

SetFieldType

TField

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TField

TField	Nach Objekten

~TField

Assign

AssignValue

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

Clear

DefaultHandler

DestroyComponents

Destroying

Dispatch

FieldAddress

FindComponent

FocusControl

FreeInstance

FreeNotification

Free

GetData

GetParentComponent

HasParent

InheritsFrom

InitInstance

InsertComponent

InstanceSize

IsValidChar

MethodAddress

MethodName

NewInstance

RemoveComponent

SetData

SetFieldType

TField


TField::~TField

TField	Siehe auch

Der Destruktor ~TField gibt den Speicher frei, der für das TField-Objekt reserviert war. Rufen Sie ~TField nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TField automatisch aufgerufen wird.

__fastcall virtual ~TField(void);

Beschreibung

~TField schließt die Datenmenge, löscht die TField-Instanz aus der Datenmenge und ruft TComponent::~TComponent auf.

~TField wird automatisch aufgerufen und braucht daher in einer Anwendung für eine TField-Komponente nie explizit aufgerufen zu werden.


TField::Assign

TField	Siehe auch

Die Methode Assign weist den Wert der Eigenschaft Value eines Feldes der Eigenschaft eines anderen Feldes zu oder weist der Feldkomponente ein anderes Objekt zu.

virtual void __fastcall Assign(Classes::TPersistent* Source);

Beschreibung

Mit Assign wird die Eigenschaft Value zu einem anderen Feld kopiert. Die Felder müssen kompatible Datentypen besitzen.

Ist Source ein anderes Feldobjekt, ruft Assign die Methode AssignValue mit Hilfe der Eigenschaft Value des durch Source bezeichneten Feldes auf. Hat der Parameter Source beim Aufruf den Wert NIL, wird der Feldkomponente ein leerer Wert zugewiesen. Wird Assign mit einem anderen Objekttyp aufgerufen, wird die geerbte Methode aufgerufen. Dadurch wird die Übertragung der Feldwerte von anderen Objekttypen möglich, wenn diese in ihrer Methode AssignTo ein TField-Objekt implementieren.


TField::AssignValue

TField	Siehe auch

Die Methode AssignValue setzt das Feld auf den Wert Value, wobei es vom Typ von Value abhängt, ob dazu die Eigenschaft AsInteger, AsBoolean, AsString oder AsFloat verwendet wird.

void __fastcall AssignValue(const System::TVarRec &Value);

Beschreibung

Für das Zuweisen eines Wertes mit Hilfe der Eigenschaften AsÉ wird AssignValue benutzt. Welche Eigenschaft eingesetzt wird, hängt vom Datentyp des Parameters Value ab:

Value	Verwendete Eigenschaft AsÉ

vtInteger	AsInteger

vtBoolean	AsBoolean

vtChar	AsString

vtExtended	AsFloat

vtString	AsString

vtPChar	AsString

vtAnsiString	AsString

vtCurrency	AsCurrency

vtVariant	AsVariant

Gehört Value nicht einem der aufgeführten Typen an, sondern ist vom Typ TObject oder einer seiner Nachkommen, verwendet AssignValue die Methode Assign für die Wertzuweisung.


TField::Clear

TField	Siehe auch

Die Methode Clear weist einem Feld den Wert NULL zu.

virtual void __fastcall Clear(void);

Beschreibung

Mit Clear können Sie einem Feld einen Nullwert zuweisen.


TField::FocusControl

TField	Siehe auch

Die Methode FocusControl ermöglicht es einer Feldkomponente, den Fokus eines Formulars auf die erste datensensitive Komponente zu setzen, die mit ihr verknüpft ist.

void __fastcall FocusControl(void);

Beschreibung

Mit FocusControl können Sie den Fokus auf ein mit dem Feld verknüpftes datensensitives Steuerelement verlagern. Da sich der Feldwert auch ändern kann, wenn das datensensitive Steuerelement nicht den Fokus hat, kann es sinnvoll sein, mit Hilfe von FocusControl den neuen Wert zu überprüfen.


TField::GetData

TField	Siehe auch

Die Methode GetDate gibt die Felddaten unformatiert zurück.

bool __fastcall GetData(void * Buffer);

Beschreibung

Mit GetDate können Sie die in einem Feld enthaltenen Daten unformatiert, nicht umgewandelt und nicht interpretiert in einem Puffer speichern.

Anders als bei den Eigenschaften DisplayText, Text oder AsÉ findet bei GetData keine Umwandlung oder Interpretation der Daten statt. Buffer muß für die Daten genügend Speicherplatz bieten. Mit der Eigenschaft DataSize können Sie den benötigten Speicherplatz ermitteln. Wenn die Daten NULL sind, gibt GetData False zurück und überträgt keine Daten in den Puffer. Andernfalls gibt GetData True zurück.

Hinweis

GetData kann nicht auf BLOB-Felder angewendet werden.


TField::IsValidChar

TField	Siehe auch

Die Methode IsValidChar prüft, ob ein bestimmtes Zeichens als Eingabe für ein Feld zulässig ist.

virtual bool __fastcall IsValidChar(char InputChar);

Beschreibung

Für ein TField-Objekt gibt IsValidChar immer True zurück und zeigt so die Zulässigkeit des Zeichens an. Abgeleitete Klassen können IsValidChar überschreiben, um die Eingabe auf Daten zu beschränken, die von DataType unterstützt werden. Integer-Felder überschreiben IsValidChar, damit nur Zahlen, Plus- und Minuszeichen eingegeben werden können.


TField::SetData

TField	Siehe auch

Die Methode SetData weist einem Feld unformatierte Daten zu.

void __fastcall SetData(void * Buffer);

Beschreibung

Mit SetData können Sie einem Feld Daten in einem Format zuweisen, das von der zugrundeliegenden Datenbank verwendet wird. Jede Methode, die der Feldkomponente Daten zuweist, ruft SetData auf, sobald die Daten in dem physikalischen Format vorliegen, das von der Datenbanktabelle unterstützt wird.

SetData ruft vor dem Speichen der Daten im aktuellen Datensatzpuffer die Ereignisbehandlungsroutine für OnValidate auf. Wenn die Daten erfolgreich gespeichert wurden, ruft SetData die Ereignisbehandlungsroutine für OnChange auf.

Hinweis

SetData sollte nicht von Nachkommen von TField verwendet werden, die BLOB-Feldtypen implementieren.


TField::SetFieldType

TField	Siehe auch

Die Methode SetFieldType stellt eine Schnittstelle für Methoden bereit, die die Eigenschaft DataType eines Feldes setzen können.

virtual void __fastcall SetFieldType(TFieldType Value);

Beschreibung

SetFieldType stellt lediglich eine Schnittstelle bereit, die von abgeleiteten Klassen überschrieben werden kann, um eine Methode zu implementieren, die dei Eigenschaft DataType setzt. Die Methode ist für abgeleitete Klassen hilfreich, die mehrere zugrundeliegende Datentypen unterstützen. Ein TBlobField-Objekt kann beispielsweise die Datentypen ftBlob, ftFmtMemo, ftParadoxOle, ftDBaseOle oder ftTypedBinary unterstützen.


TField::TField

TField	Siehe auch

Der Konstruktor TField erzeugt ein neues TField-Objekt.

__fastcall virtual TField(Classes::TComponent* AOwner);

Beschreibung

TField erzeugt und initialisiert eine neue TField-Instanz und fügt sie dem im Parameter AOwner angegebenen Eigentümer hinzu. Nach dem Aufruf des geerbten Konstruktors weist TField der Eigenschaft Visible den Wert True zu.

Verwenden Sie TField nicht für TField-Komponenten, da diese eine abstrakte Basisklasse darstellen, die nicht direkt instantiiert werden sollte. Die Methode TField von untergeordneten Klassen wird normalerweise indirekt aufgerufen, wenn Sie mit dem Felder-Editor persistente Feldkomponenten erzeugen.


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent


TField Beispiel

TField


 TFileListBox

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/filectrl.hpp

TFileListBox ist ein spezialisiertes Listenfeld, im dem alle Dateien eines angegebenen Verzeichnisses aufgeführt werden.

Beschreibung

Wenn Sie TFileListBox einem Formular hinzufügen, kann der Benutzer eine Datei auswählen. Wird TFileListBox zusammen mit TDriveComboBox, TFilterComboBox und TDirectoryListBox verwendet, stehen dem Formular alle Dateiauswahlmöglichkeiten zur Verfügung.

Wenn Sie einer Anwendung jedoch ein Windows 95-Standarddialogfeld zum öffnen oder Speichern von Dateien hinzufügen wollen, müssen Sie TOpenDialog oder TSaveDialog einsetzen.


Eigenschaften von TFileListBox

TFileListBox	Alphabetisch	Legende

In TFileListBox

Directory

Drive

FileEdit

FileName

FileType

Mask

ShowGlyphs

Abgeleitet von TCustomListBox

Canvas

ExtendedSelect

IntegralHeight

ItemHeight

ItemIndex

Items

MultiSelect

SelCount

Selected

TopIndex

Abgeleitet von TWinControl

Brush

ClientOrigin

ClientRect

ControlCount

Controls

Ctl3D

Handle

HelpContext

ParentCtl3D

Showing

TabOrder

TabStop

Abgeleitet von TControl

Align

BoundsRect

ClientHeight

ClientWidth

Color

ControlState

ControlStyle

Cursor

DragCursor

DragMode

Enabled

Font

Height

Hint

Left

Name

Parent

ParentColor

ParentFont

ParentShowHint

PopupMenu

ShowHint

Top

Visible

Width

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TFileListBox

TFileListBox	Nach Objekten	Legende

Align

BoundsRect

Brush

Canvas

ClientHeight

ClientOrigin

ClientRect

ClientWidth

Color

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlCount

ControlState

Controls

ControlStyle

Ctl3D

Cursor

DesignInfo

Directory

DragCursor

DragMode

Drive

Enabled

ExtendedSelect

FileEdit

FileName

FileType

Font

Handle

Height

HelpContext

Hint

IntegralHeight

ItemHeight

ItemIndex

Items

Left

Mask

MultiSelect

Name

Owner

ParentColor

ParentCtl3D

ParentFont

ParentShowHint

Parent

PopupMenu

SelCount

Selected

ShowGlyphs

ShowHint

Showing

TabOrder

TabStop

Tag

TopIndex

Top

Visible

Width


TFileListBox::Directory

TFileListBox	Siehe auch

Bei der Eigenschaft Directory handelt es sich um das Verzeichnis, das alle Dateien enthält, die im Dateilistenfeld aufgeführt sind.

__property System::AnsiString Directory;

Beschreibung

Setzen Sie Directory so, daß im Dateilistenfeld alle Dateien eines neuen Verzeichnisses angezeigt werden. Enthält das Formular ein TDirectoryListBox-Objekt, setzen Sie die Eigenschaft FileList des Verzeichnislistenfeldes so, daß die Eigenschaft Directory automatisch aktualisiert wird, wenn der Benutzer ein neues Verzeichnis auswählt.


TFileListBox::Drive

TFileListBox	Siehe auch

Die Eigenschaft Drive bezeichnet das Laufwerk, das die im Listenfeld aufgeführten Dateien enthält.

__property char Drive;

Beschreibung

Belegen Sie Drive mit dem Laufwerk, das die Dateien enthält, die im Listenfeld angezeigt werden sollen. Wenn sich der Wert von Drive ändert, ändert sich auch der Wert von Directory und zeigt dann das aktuelle Verzeichnis im angegebenen Laufwerk an.

Enthält das Formular ein TDirectoryListBox-Objekt, setzen Sie die Eigenschaft FileList des Verzeichnislistenfeldes so, daß die Eigenschaft Drive automatisch aktualisiert wird, sobald sich die Eigenschaft Drive des Verzeichnislistenfeldes ändert.


TFileListBox::FileEdit

TFileListBox	Siehe auch

Die Eigenschaft FileEdit verknüpft das Verzeichnislistenfeld mit einem Eingabefeld, in dem die aktuell ausgewählte Datei angezeigt wird.

__property Stdctrls::TEdit* FileEdit;

Beschreibung

Belegen Sie FileEdit mit einem Eingabefeld, das die im Dateilistenfeld ausgewählte Datei anzeigt, so wie dies normalerweise in Dateiauswahldialogen der Fall ist. Ist keine Datei im Dateilistenfeld ausgewählt, enthält das Eingabefeld als Text den aktuellen Wert der Eigenschaft Mask des Dateilistenfeldes.

Hinweis

Wenn der Benutzer den Text des Eingabefeldes ändert, werden die Änderungen nicht automatisch im Dateilistenfeld angezeigt. Mit der Methode ApplyFilePath können Sie das Dateilistenfeld bei einer Textänderung im Eingabefeld aktualisieren.


TFileListBox::FileName

TFileListBox	Siehe auch

Die Eigenschaft FileName gibt den Namen der ausgewählten Datei im Dateilistenfeld einschließlich des Pfades an.

__property System::AnsiString FileName;

Beschreibung

Setzen Sie FileName, um das Dateilistenfeld mit einer bestimmten Datei zu initialisieren. Mit einem Lesezugriff auf FileName kann der Name der vom Benutzer ausgewählten Datei ermittelt werden.

Ist die Eigenschaft FileEdit gesetzt, enthält das verknüpfte Eingabefeld immer dann den Wert von FileName, wenn sich die Eigenschaft FileName ändert.


TFileListBox::FileType

TFileListBox	Siehe auch

 Die Eigenschaft FileType legt fest, welche Dateien im Dateilistenfeld basierend auf den Attributen der Dateien angezeigt werden.

__property TFileType FileType;

Beschreibung

Belegen Sie FileType mit dem Typ der Dateien, die im Listenfeld angezeigt werden sollen. Mit FileType lassen sich mehrere Dateitypen angeben. Wenn FileType beispielsweise die Werte ftReadOnly und ftHidden enthält, werden im Listenfeld nur verborgene und schreibgeschützte Dateien angezeigt. Die Eigenschaft FileType kann folgende Werte annehmen:

Wert	Bedeutung

ftReadOnly	Das Listenfeld enthält schreibgeschützte Dateien.

ftHidden	Das Listenfeld enthält verborgene Dateien.

ftSystem	Das Listenfeld enthält Systemdateien.

ftVolumeID	Das Listenfeld enthält die Datenträgerbezeichnung.

ftDirectory	Das Listenfeld enthält Verzeichnisse.

ftArchive	Das Listenfeld enthält Archivdateien.

ftNormal	Das Listenfeld enthält Dateien ohne spezielle Attribute zu berücksichtigen.

Wenn Sie FileType mit Hilfe des Objektinspektors setzen wollen, klicken Sie auf die Eigenschaft FileType und sehen sich die Attributwerte an. Danach setzen Sie die einzelnen Werte entweder auf True oder False, um sie in die FileType-Menge aufzunehmen oder nicht.

Hinweis

Es ist auch möglich, nur Dateien mit einem bestimmten Namen aufzulisten. Zu diesem Zweck verwenden Sie entweder die Eigenschaft Mask oder fügen ein TFilterComboBox-Objekt in das Formular ein.


TFileListBox::Mask

TFileListBox	Siehe auch

Die Eigenschaft Mask schränkt die im Dateilistenfeld angezeigten Dateien ein.

__property System::AnsiString Mask;

Beschreibung

Setzen Sie Mask auf einen regulären Ausdruck, um die Anzeige im Listenfeld auf die Dateien zu beschränken, die mit der Maske übereinstimmen.  Der Maskenwert ist ein Dateiname, der Platzhalterzeichen enthalten darf. Das Platzhalterzeichen Sternchen (*) steht für eine beliebige Anzahl zu vergleichender Zeichen. Das Platzhalterzeichen Fragezeichen (?) steht für ein einzelnes Zeichen. Die Dateimaske *.* ist voreingestellt und zeigt alle Dateien an.

Wenn Sie mehrere Dateimasken angeben wollen, trennen Sie die einzelnen Masken mit einem Semikolon voneinander. Ein Beispiel: *.PAS; *.EXE.

Enthält das Formular ein TFilterComboBox-Objekt, setzen Sie die Eigenschaft FileList des Filterkombinationsfeldes so, daß die Eigenschaft Mask automatisch aktualisiert wird, wenn sich die Mask-Eigenschaft des Filterkombinationsfeldes ändert.


TFileListBox::ShowGlyphs

TFileListBox

Die Eigenschaft ShowGlyphs legt fest, ob neben den im Dateilistenfeld aufgeführten Dateinamen Bitmaps dargestellt werden.

__property bool ShowGlyphs;

Beschreibung

Setzen Sie ShowGlyphs auf True, wenn Symbole für die Kennzeichnung des Dateityps neben den Dateien in der Liste angezeigt werden sollen. Soll die Liste nur die Dateinamen enthalten, setzen Sie ShowGlyphs auf False.


Ereignisse von TFileListBox

TFileListBox	Alphabetisch	Legende

In TFileListBox

OnChange

Abgeleitet von TWinControl

OnEnter

OnExit

OnKeyDown

OnKeyPress

OnKeyUp

Abgeleitet von TControl

OnClick

OnDblClick

OnDragDrop

OnDragOver

OnEndDrag

OnMouseDown

OnMouseMove

OnMouseUp

OnStartDrag


Ereignisse von TFileListBox

TFileListBox	Nach Objekten	Legende

OnChange

OnClick

OnDblClick

OnDragDrop

OnDragOver

OnEndDrag

OnEnter

OnExit

OnKeyDown

OnKeyPress

OnKeyUp

OnMouseDown

OnMouseMove

OnMouseUp

OnStartDrag


TFileListBox::OnChange

TFileListBox

Das Ereignis OnChange tritt ein, sobald der Benutzer in der Liste eine andere Datei auswählt.

typedef void __fastcall (__closure *TNotifyEvent)(System::TObject* Sender);

__property Classes::TNotifyEvent OnChange;

Beschreibung

Schreiben Sie eine Behandlungsroutine für das Ereignis OnChange, wenn bei einer Änderung der Eigenschaft FileName eine bestimmte Aktion ausgeführt werden soll. Wurde die Eigenschaft FileEdit gesetzt, wird das Eingabefeld vor dem Eintreten des Ereignisses OnChange aktualisiert.


Methoden von TFileListBox

TFileListBox	Alphabetisch

In TFileListBox

~TFileListBox

ApplyFilePath

TFileListBox

Update

Abgeleitet von TCustomListBox

Clear

ItemAtPos

ItemRect

Abgeleitet von TWinControl

Broadcast

CanFocus

ContainsControl

ControlAtPos

DisableAlign

EnableAlign

Focused

GetTabOrderList

HandleAllocated

HandleNeeded

InsertControl

Invalidate

PaintTo

Realign

RemoveControl

Repaint

ScaleBy

ScrollBy

SetBounds

SetFocus

UpdateControlState

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

GetTextLen

Hide

Perform

Refresh

ScreenToClient

SendToBack

SetTextBuf

Show

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TFileListBox

TFileListBox	Nach Objekten

~TFileListBox

ApplyFilePath

Assign

BeginDrag

BringToFront

Broadcast

CanFocus

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

Clear

ClientToScreen

ContainsControl

ControlAtPos

DefaultHandler

DestroyComponents

Destroying

DisableAlign

Dispatch

DragDrop

Dragging

EnableAlign

EndDrag

FieldAddress

FindComponent

Focused

FreeInstance

FreeNotification

Free

GetParentComponent

GetTabOrderList

GetTextBuf

GetTextLen

HandleAllocated

HandleNeeded

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InsertControl

InstanceSize

Invalidate

ItemAtPos

ItemRect

MethodAddress

MethodName

NewInstance

PaintTo

Perform

Realign

Refresh

RemoveComponent

RemoveControl

Repaint

ScaleBy

ScreenToClient

ScrollBy

SendToBack

SetBounds

SetFocus

SetTextBuf

Show

TFileListBox

UpdateControlState

Update


TFileListBox::TFileListBox

TFileListBox

TFileListBox erzeugt eine Instanz von TFileListBox.

__fastcall virtual TFileListBox(Classes::TComponent* AOwner);


TFileListBox::ApplyFilePath

TFileListBox	Siehe auch

Die Methode ApplyFilePath aktualisiert das Dateilistenfeld so, daß ein vollständiger Dateiname angezeigt wird.

virtual void __fastcall ApplyFilePath(const System::AnsiString EditText);

Beschreibung

Durch einen Aufruf von ApplyFilePath können die Eigenschaften Directory, Drive, FileName und Mask so geändert werden, daß sie den im Parameter EditText angegebenen Werten entsprechen. Ist beispielsweise ein Eingabefeld über die Eigenschaft FileEdit mit dem Dateilistenfeld verknüpft, kann durch einen Aufruf von ApplyFilePath in der Ereignisbehandlungsroutine für OnChange das Dateilistenfeld immer dann aktualisiert werden, wenn der Benutzer einen Wert in das Eingabefeld eingibt.

ApplyFilePath aktualisiert die Eigenschaft Mask nur dann, wenn der Parameter EditText Platzhalterzeichen enthält. Beinhaltet das Formular ein TDirectoryListBox-Objekt, das dieses Dateilistenfeld-Objekt in seiner Eigenschaft FileList enthält, werden die Eigenschaften Directory und Drive des Verzeichnislistenfeldes ebenfalls aktualisiert. Wenn das Formular außerdem ein TDriveComboBox-Objekt enthält, welches das Verzeichnislistenfeld in seiner DirList-Eigenschaft angibt, wird auch die Eigenschaft Drive des Laufwerk-Kombinationsfeldes aktualisiert. Die Eigenschaft Mask eines TFilterComboBox-Objekts wird allerdings nicht aktualisiert.


TFileListBox::~TFileListBox

TFileListBox

Der Destruktor ~TFileListBox gibt den Speicher frei, der für das TFileListBox-Objekt reserviert war. Rufen Sie ~TFileListBox nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TFileListBox automatisch aufgerufen wird.

__fastcall virtual ~TFileListBox(void);


TFileListBox::Update

TFileListBox	Beispiel

Die Methode Update aktualisiert die Verzeichnisliste des Dateilistenfeldes.

void __fastcall Update(void);

Beschreibung

Rufen Sie Update immer dann auf, wenn die im Dateilistenfeld aufgeführten Dateien veraltet sein könnten. Wenn in einer Anwendung beispielsweise Dateien angelegt, umbenannt oder gelöscht werden, läßt sich durch einen Aufruf von Update sicherstellen, daß die Änderungen im Dateilistenfeld berücksichtigt werden.

Das Listenfeld wird automatisch aktualisiert, wenn sich die Eigenschaft Drive, Directory, FileType oder Mask ändert.


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TControl

TWinControl

TCustomListBox


TFileListBox Beispiel

TFileListBox


TFiler

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/classes.hpp

Die Klasse TFiler ist die abstrakte Basisklasse für Reader- und Writer-Objekte, die für das Streamen von Komponenten und deren Eigenschaften in Formulare und geerbte Formulare verwendet werden.

Beschreibung

TFiler ist ein Objekt, das mit Stream- und Komponenten-Objekten arbeitet. Es definiert die internen Mechanismen des Streaming-Systems von Borland C++Builder zum Lesen bzw. Schreiben der mit Komponenten verknüpften Daten aus bzw. in ein Stream-Objekt. TReader und TWriter implementieren die im Filer-Objekt definierten Verhaltensweisen.

Ein Filer-Typ wird als Parameter für Komponentenmethoden verwendet, die für Stream-Operationen ein Reader- oder Writer-Objekt benötigen. Jedes Filer-Objekt verfügt über ein verbundenes Stream-Objekt, das als Parameter an seinen Konstruktor übergeben wird. Dieses verbundene Stream-Objekt ist üblicherweise für die Erstellung der Nachkommen von Filer-Objekten verantwortlich.

Mit den Eigenschaften können Stream-Operationen für TFiler untergeordnete Komponenten verwaltet werden. Mit Hilfe von Filer-Objekten werden Eigenschaften von Komponentenobjekten als Daten aus einem Stream gelesen bzw. in diesen geschrieben. Zur Beschleunigung der Lese- und Schreiboperationen unterstützen Filer-Objekte das Puffern der Daten.

TFiler besitzt abstrakte Methoden, die in den untergeordneten Reader- und Writer-Objekte angepaßt werden. Dazu gehören Methoden zur Definition von Eigenschaften, mit denen ein Objekt verborgene oder komplexe Daten wie die Eigenschaften eines Objekts speichern kann. Diese Methoden arbeiten mit denen der Komponenten- und Stream-Objekte zusammen.

Hinweis

Die meisten der Eigenschaften und Methoden von Filer sind im Streaming-System von Borland C++Builder aus Gründen des Komforts als public deklariert. Die Mehrheit der Eigenschaften und Methoden wird niemals direkt in einer Anwendung aufgerufen.


Eigenschaften von TFiler

TFiler	Alphabetisch

In TFiler

Ancestor

IgnoreChildren

Root


Eigenschaften von TFiler

TFiler	Nach Objekten

Ancestor

IgnoreChildren

Root


TFiler::Ancestor

TFiler	Siehe auch

Mit der Eigenschaft Ancestor wird beim Schreiben von Komponenten in geerbten Formularen bestimmt, ob auch die Eigenschaften der geerbten Komponenten geschrieben werden.

__property TPersistent* Ancestor;

Beschreibung

Rufen Sie Ancestor nicht direkt auf. Die Methode wird intern von Methoden des Writer-Objekts zum Schreiben von Komponenten in geerbten Formularen eingesetzt.

Da das Writer-Objekt nur die Werte der Eigenschaften schreiben muß, die sich von den geerbten unterscheiden, werden alle geerbten Komponenten mit Ancestor überwacht und die Eigenschaften vor dem Schreiben verglichen. Hat Ancestor den Wert NULL, existiert keine entsprechende geerbte Komponente, und das Writer-Objekt schreibt die Komponente vollständig in den Stream.

Ancestor hat immer den Wert NULL, sofern keine Aufrufe von WriteDescendent und WriteDescendentRes aktiv sind, da diese Methoden für untergeordnete Objekte aufgerufen werden, die ein Ancestor-Objekt haben.

Im allgemeinen hat die Eigenschaft Ancestor einer Komponente den Wert NULL, wenn keine Formulare geschrieben werden, die mit $$Visual From Inheritance $$erstellt wurden. In Borland C++Builder wird WriteDescendentRes zum Schreiben solcher Formulare in den Stream verwendet.

Wenn Sie die Methode DefineProperties schreiben oder überschreiben, beachten Sie, daß Ancestor gesetzt sein könnte. Außerdem müssen gegebenenfalls Eigenschaften geschrieben werden. Üblicherweise werden DefineProperty-Lesevorgänge vom Ancestor nicht berücksichtigt.


TFiler::IgnoreChildren

TFiler	Siehe auch

Mit der Eigenschaft IgnoreChildren kann ein Writer-Objekt eine Komponente die untergeordneten Komponenten speichern.

__property bool IgnoreChildren;

Beschreibung

Benutzer rufen IgnoreChildren selten auf. Mit der Eigenschaft wird intern festgelegt, ob untergeordnete Komponenten geschrieben werden, wenn eine Komponente in einen Stream gestellt wird. Bei einigen Komponenten wird Root geändert, wenn diese in einen Stream gestellt werden.

Hat IgnoreChildren den Wert True, schreibt das Writer-Objekt eine Komponente ohne deren untergeordnete Komponenten. Hat IgnoreChildren den Wert False, stellt das Writer-Objekt auch die untergeordneten Objekte in den Stream.


TFiler::Root

TFiler	Siehe auch

Mit der Eigenschaft Root wird dem Filer-Objekt mitgeteilt, welches Objekt der vom Filer-Objekt gelesenen oder geschriebenen Objekte bildet.

__property TComponent* Root;

Beschreibung

Rufen Sie Root nicht direkt auf. Die Eigenschaft wird intern zum Ermitteln des Stammobjekts verwendet, wenn untergeordnete Komponenten in den Stream gestellt werden. Root repräsentiert den Eigentümer aller Komponenten der aktuellen Stream-Operation.

Die Methoden ReadRootComponent und WriteRootComponent weisen Root einen Wert zu, bevor sie ihre Komponenten und untergeordneten Komponenten lesen oder schreiben.


Methoden von TFiler

TFiler	Alphabetisch

In TFiler

~TFiler

DefineBinaryProperty

DefineProperty

FlushBuffer

TFiler

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TFiler

TFiler	Nach Objekten

~TFiler

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

DefineBinaryProperty

DefineProperty

Dispatch

FieldAddress

FlushBuffer

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance

TFiler


TFiler::~TFiler

TFiler	Siehe auch

Mit ~TFiler wird ein Filer-Objekt freigegeben.

__fastcall virtual ~TFiler(void);

Beschreibung

~TFiler sollte nicht direkt in einer Anwendung aufgerufen werden. Statt dessen sollten Sie Free aufrufen. Mit Free wird überprüft, ob das Objekt nicht bereits freigegeben wurde. Anschließend wird gegebenenfalls die Methode Destroy aufgerufen.

Die Methode ~TFiler für Filer-Objekte gibt den dem Puffer zugewiesenen Speicher frei. Die Freigabe des Speichers für die Objektinstanz wird automatisch von Destroy ausgeführt. Die Methode ~TFiler von TFiler wird von den Nachkommen in ihren jeweiligen Destruktoren aufgerufen.


TFiler::DefineBinaryProperty

TFiler	Siehe auch

TFiler führt die Methode DefineBinaryProperty als abstrakte Methode ein.

virtual void __fastcall DefineBinaryProperty(const System::AnsiString Name, TStreamProc ReadData, TStreamProc  WriteData, bool HasData);

Beschreibung

Jedes abgeleitete Filer-Objekt deklariert eine Methode DefineBinaryProperty, die binäre Daten definiert, die der Nachkomme wie Eigenschaften liest oder schreibt.


TFiler::DefineProperty

TFiler	Siehe auch

TFiler führt die Methode DefineProperty als abstrakte Methode ein.

virtual void __fastcall DefineProperty(const System::AnsiString Name, TReaderProc ReadData, TWriterProc  WriteData, bool HasData);

Beschreibung

Jedes abgeleitete Filer-Objekt deklariert eine Methode DefineProperty, die Daten definiert, die der Nachkomme wie Eigenschaften liest oder schreibt.


TFiler::FlushBuffer

TFiler

TFiler führt die Methode DefineBinaryProperty als abstrakte Methode ein.

virtual void __fastcall FlushBuffer(void);

Beschreibung

Jedes abgeleitete Filer-Objekt definiert eine Methode FlushBuffer, die das Synchronisieren des Filer-Objektpuffers mit dem verbundenen Stream ermöglicht.


TFiler::TFiler

TFiler	Siehe auch

Die Methode TFiler erzeugt ein Filer-Objekt.

__fastcall TFiler(TStream* Stream, int BufSize);

Beschreibung

Mit TFiler können Sie zur Laufzeit einen Nachkommen von Filer erstellen. TFiler wird automatisch von Methoden und Routinen aufgerufen, die ein Filer-Objekt benötigen. Am häufigsten werden Filer-Objekte in Methoden von Stream-Objekten erstellt.

TFiler weist Speicherplatz für ein Filer-Objekt zu und verbindet es mit dem im Parameter Stream angegebenen Stream. Der Puffer erhält die Größe BufSize.


Hierarchie

TObject


TFiler Beispiel

TFiler


TFileStream

Hierarchie	Eigenschaften	Methoden

Header

vcl/classes.hpp

Das Objekt TFileStream ist ein Stream-Objekt, das von Anwendungen genutzt wird, um Daten aus einer Datei auf der Festplatte zu lesen oder in eine solche Datei zu schreiben.

Beschreibung

Mit TFileStream wird der Zugriff auf Informationen abgewickelt, die in Dateiform vorliegen. TFileStream öffnet die Datei mit dem angegebenen Namen und liest bzw. schreibt Daten mit Hilfe der zugehörigen Methoden. Wenn die Anwendung bereits ein Handle auf die Datei besitzt und die Datei bereits im passenden Modus geöffnet ist, verwenden Sie statt dessen das Objekt THandleStream.


Eigenschaften von TFileStream

TFileStream	Alphabetisch	Legende

Abgeleitet von THandleStream

Handle

Abgeleitet von TStream

Position

Size


Eigenschaften von TFileStream

TFileStream	Nach Objekten	Legende

Handle

Position

Size


Methoden von TFileStream

TFileStream	Alphabetisch

In TFileStream

~TFileStream

TFileStream

Abgeleitet von THandleStream

Read

Seek

Write

Abgeleitet von TStream

CopyFrom

ReadBuffer

ReadComponent

ReadComponentRes

ReadResHeader

WriteBuffer

WriteComponent

WriteComponentRes

WriteDescendent

WriteDescendentRes

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TFileStream

TFileStream	Nach Objekten

~TFileStream

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

CopyFrom

DefaultHandler

Dispatch

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance

ReadBuffer

ReadComponentRes

ReadComponent

ReadResHeader

Read

Seek

TFileStream

WriteBuffer

WriteComponentRes

WriteComponent

WriteDescendentRes

WriteDescendent

Write


TFileStream::~TFileStream

TFileStream	Siehe auch

Der Destruktor ~TFileStream gibt den Speicher frei, der für das TFileStream-Objekt reserviert war. Rufen Sie ~TFileStream nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TFileStream automatisch aufgerufen wird.

__fastcall virtual ~TFileStream(void);

~TFileStream gibt das Handle des Datei-Streams frei, bevor das Objekt selbst freigegeben wird.


TFileStream::TFileStream

TFileStream	Siehe auch

TFileStream erzeugt eine Instanz von TFileStream.

__fastcall TFileStream(const System::AnsiString FileName, unsigned short Mode);

Mit TFileStream wird ein Datei-Stream zum Lesen aus oder Schreiben in die benannte Datei instantiiert. Beim Erzeugen des Datei-Streams geben Sie an, wie die Datei geöffnet werden soll.

Der Parameter Mode steuert, auf welche Art die Datei geöffnet wird. Der Parameter besteht aus zwei Elementen: Eines beschreibt das öffnen, und eines legt den Modus für gemeinsamen Zugriff fest. Beide Elemente werden durch ein logisches ODER verknüpft. Der öffnen-Modus kann folgende Konstantenwerte annehmen:

Wert	Bedeutung

fmCreate	Es wird eine Datei mit dem angegebenen Namen angelegt. Ist eine solche Datei bereits vorhanden, wird die Datei zum Schreiben geöffnet.

fmOpenRead	Die Datei wird ausschließlich zum Lesen geöffnet.

fmOpenWrite	Die Datei wird ausschließlich zum Schreiben geöffnet. Beim Schreiben in die Datei wird der aktuelle Inhalt vollständig ersetzt.

fmOpenReadWrite	Die Datei wird so geöffnet, daß der aktuelle Inhalt geändert werden kann, ohne daß er ersetzt wird.

Für den Zugriffsmodus sind folgende Konstantenwerte verfügbar:

Wert	Bedeutung

fmShareCompat	Der Zugriffsmodus ist kompatibel zu dem Verfahren, mit dem Dateisteuerblöcke (FCBs) geöffnet werden.

fmShareExclusive	Andere Anwendungen können die Datei nicht öffnen.

fmShareDenyWrite	Andere Anwendungen können die Datei ausschließlich zum Lesen öffnen.

fmShareDenyRead	Andere Anwendungen können die Datei ausschließlich zum Schreiben öffnen.

fmShareDenyNone	Andere Anwendungen können die Datei ohne Einschränkungen zum Lesen oder Schreiben öffnen.

Wenn die Datei nicht geöffnet werden kann, löst TFileStream eine Exception aus.


Zugriff

Read-only


Hierarchie

TObject

TStream

THandleStream


TFileStream Beispiel

TFileStream


 TFindDialog

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/dialogs.hpp

TFindDialog generiert einen Suchdialog, mit dem der Benutzer Text in einer Datei suchen kann.

Beschreibung

Die Komponente TFindDialog zeigt ein nicht modales Windows-Dialogfenster an, mit dessen Hilfe ein Benutzer einen bestimmten Text-String suchen kann. Der Dialog wird zur Laufzeit erst angezeigt, wenn er durch einen Aufruf der Methode Execute aktiviert wird.


Eigenschaften von TFindDialog

TFindDialog	Alphabetisch	Legende

In TFindDialog

FindText

Handle

Left

Options

Position

Top

Abgeleitet von TCommonDialog

Ctl3D

HelpContext

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Name

Owner

Tag


Eigenschaften von TFindDialog

TFindDialog	Nach Objekten	Legende

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

Ctl3D

DesignInfo

FindText

Handle

HelpContext

Left

Name

Options

Owner

Position

Tag

Top


TFindDialog::FindText

TFindDialog

Die Eigenschaft FindText enthält den Suchstring.

__property System::AnsiString FindText;

Beschreibung

FindText enthält den Text-String, nach dem der Benutzer suchen will. Klickt der Benutzer auf Weitersuchen, wird der Text im Eingabefeld automatisch der Eigenschaft FindText zugewiesen. Wenn Sie FindText im Objektinspektor oder im Quelltext einen Wert zuweisen, wird dieser als Standard-Suchstring bereits beim öffnen des Dialogfeldes im Eingabefeld angezeigt.


TFindDialog::Handle

TFindDialog	Beispiel

Die Eigenschaft Handle ist das Fenster-Handle des Suchdialogs.

__property HWND Handle;

Beschreibung

Mit der Eigenschaft Handle können Sie auf das Handle des Suchdialogs zugreifen.


TFindDialog::Left

TFindDialog	Siehe auch	Example

Legt die X-Koordinate (die horizontale Position) der linken oberen Ecke des Suchdialogs fest.

__property int Left;

Beschreibung

Left hat den gleichen Wert wie die erste Zahl in Position.


TFindDialog::Options

TFindDialog	Siehe auch

Die Eigenschaft Options legt das Aussehen und das Verhalten des Suchdialogs fest.

__property TFindOptions Options;

Beschreibung

Die folgende Tabelle enthält die möglichen Werte für Options:

Wert	Bedeutung

frDisableMatchCase	Deaktiviert das Kontrollfeld Groß-/Kleinschreibung.

frDisableUpDown	Deaktiviert die Schaltflächen Aufwärts und Abwärts, mit denen die Suchrichtung festgelegt wird.

frDisableWholeWord	Deaktiviert das Kontrollfeld Als Wort.

frDown	Aktiviert die Schaltfläche Abwärts, wenn das Dialogfeld geöffnet wird. Wenn das Flag nicht gesetzt ist, wird beim öffnen des Dialogs die Schaltfläche Aufwärts aktiviert (in der Voreinstellung ist frDown True).

frFindNext	Dieses Flag wird gesetzt, wenn der Benutzer auf Weitersuchen klickt, und gelöscht, wenn das Dialogfeld geschlossen wird.

frHideMatchCase	Entfernt das Kontrollfeld Groß-/Kleinschreibung aus dem Dialog.

frHideWholeWord	Entfernt das Kontrollfeld Als Wort aus dem Dialog.

frHideUpDown	Entfernt die Schaltflächen Abwärts und Aufwärts aus dem Dialog.

frMatchCase	Aktiviert die Schaltfläche Groß-/Kleinschreibung, wenn das Dialogfeld geöffnet wird.

frReplace	Ist nur für TReplaceDialog von Bedeutung. Dieses Flag wird vom System gesetzt und besagt, daß die Anwendung die aktuelle Fundstelle (und nur diese) des Strings in FindText durch den String in ReplaceText ersetzen soll.

frReplaceAll	Ist nur für TReplaceDialog von Bedeutung. Dieses Flag wird vom System gesetzt und besagt, daß die Anwendung alle Fundstellen des Strings in FindText durch den String in ReplaceText ersetzen soll.

frShowHelp	Zeigt im Dialogfeld die Schaltfläche Hilfe an.

frWholeWord	Aktiviert die Schaltfläche Als Wort, wenn das Dialogfeld geöffnet wird.

In der Voreinstellung sind alle Optionen außer frDown deaktiviert.


TFindDialog::Position

TFindDialog	Siehe auch	Beispiel

Die Eigenschaft Position legt die Position des Suchdialogs auf dem Bildschirm fest.

__property POINT Position;

Beschreibung

Position enthält die Koordinaten der linken oberen Ecke des Dialogfeldes.


TFindDialog::Top

TFindDialog	Siehe auch	Beispiel

Die Eigenschaft Top legt die y-Koordinate (vertikale Position) der linken oberen Ecke des Suchdialogs fest.

__property int Top;

Beschreibung

Der in Top gespeicherte Wert entspricht dem zweiten Integer der Eigenschaft Position.


Ereignisse von TFindDialog

TFindDialog	Alphabetisch	Legende

In TFindDialog

OnFind


Ereignisse von TFindDialog

TFindDialog	Nach Objekten	Legende

OnFind


TFindDialog::OnFind

TFindDialog	Siehe auch

Das Ereignis OnFind tritt ein, wenn der Benutzer auf die Schaltfläche Weitersuchen klickt.

typedef void __fastcall (__closure *TNotifyEvent)(System::TObject* Sender);

__property Classes::TNotifyEvent OnFind;

Beschreibung

Mit einer Ereignisbehandlungsroutine für OnFind können Sie auf Grundlage der in Options gesetzten Flags nach dem in FindText angegebenen Text suchen. Wenn Sie ein TMemo-Objekt durchsuchen wollen, rufen Sie seine Methode Search auf.


Methoden von TFindDialog

TFindDialog	Alphabetisch

In TFindDialog

~TFindDialog

CloseDialog

Execute

TFindDialog

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TFindDialog

TFindDialog	Nach Objekten

~TFindDialog

Assign

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

CloseDialog

DefaultHandler

DestroyComponents

Destroying

Dispatch

Execute

FieldAddress

FindComponent

FreeInstance

FreeNotification

Free

GetParentComponent

HasParent

InheritsFrom

InitInstance

InsertComponent

InstanceSize

MethodAddress

MethodName

NewInstance

RemoveComponent

TFindDialog


TFindDialog::~TFindDialog

TFindDialog	Siehe auch

Der Destruktor ~TFindDialog gibt den Speicher frei, der für das TFindDialog-Objekt reserviert war. Rufen Sie ~TFindDialog nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TFindDialog automatisch aufgerufen wird.

__fastcall virtual ~TFindDialog(void);


TFindDialog::CloseDialog

TFindDialog

Die Methode CloseDialog schließt den Suchdialog.

void __fastcall CloseDialog(void);

Beschreibung

Die Methode CloseDialog schließt das Dialogfeld und gibt das Fenster-Handle frei. Die meisten Eigenschaften von TFindDialog (einschließlich FindText) bleiben dabei jedoch unverändert.


TFindDialog::Execute

TFindDialog

Die Methode Execute zeigt den Suchdialog an.

bool __fastcall Execute(void);

Beschreibung

Execute öffnet den Suchdialog und gibt True zurück, wenn das Fenster-Handle erfolgreich zugewiesen wurde. Wenn das Dialogfeld beim Aufruf bereits geöffnet ist, bringt Execute es in den Vordergrund, aktiviert das übergeordnete Formular und gibt ebenfalls True zurück.


TFindDialog::TFindDialog

TFindDialog	Siehe auch

Die Methode TFindDialog erzeugt eine Instanz von TFindDialog.

__fastcall virtual TFindDialog(Classes::TComponent* AOwner);

Beschreibung

Die Methode TFindDialog erzeugt eine Instanz von TFindDialog. Zur Laufzeit wird der neue Dialog im Formular erst angezeigt, wenn die Methode Execute aufgerufen wird.


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TCommonDialog


TFindDialog Beispiel

TFindDialog


TFieldDataLink

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/dbtables.hpp

TFieldDataLink ist ein Hilfsobjekt, das ein datensensitives Steuerelement bei der Verwaltung seiner Verknüpfung zu einem TField-Objekt und bei der Reaktion auf Datenereignisse unterstützt.

Beschreibung

TFieldDataLink wird als Element in allen datensensitiven Objekten verwendet, die eine Verknüpfung zu einem TField-Objekt benötigen und auf Datenereignisse reagieren oder Datenbankinformationen überwachen müssen. Das datensensitive Objekt muß ein Nachkomme von TWinControl sein.

Der Konstruktor des datensensitiven Objektes sollte den Konstruktor des TFieldDataLink-Elements aufrufen und alle relevanten Ereignisbehandlungsroutinen initialisieren. Das datensensitive Objekt kann dann über die Eigenschaft FieldName des TFieldDataLink-Objekts eine Verknüpfung zu einem TField-Objekt und über die Eigenschaft DataSource eine Verknüpfung zu einer Datenmenge herstellen.


Eigenschaften von TFieldDataLink

TFieldDataLink	Alphabetisch	Legende

In TFieldDataLink

CanModify

Control

Editing

Field

FieldName

Abgeleitet von TDataLink

Active

ActiveRecord

BufferCount

DataSet

DataSource

DataSourceFixed

ReadOnly

RecordCount


Eigenschaften von TFieldDataLink

TFieldDataLink	Nach Objekten	Legende

ActiveRecord

Active

BufferCount

CanModify

Control

DataSet

DataSourceFixed

DataSource

Editing

FieldName

Field

ReadOnly

RecordCount


TFieldDataLink::CanModify

TFieldDataLink	Siehe auch

Die Eigenschaft CanModify gibt an, ob das in der Eigenschaft Control festgelegte Steuerelement ein durch ein TFieldDataLink-Objekt verwaltetes Feld der Datenbanktabelle ändern kann.

__property bool CanModify;

Beschreibung

Mit einem Lesezugriff auf CanModify können Sie feststellen, ob das dem TFieldDataLink-Objekt übergeordnete Steuerelement, das in der Eigenschaft Control festgelegt ist, die durch dieses Feld repräsentierten Daten in der Datenbank ändern kann. CanModify kann den Wert False haben, wenn auf das Steuerelement nur zum Lesen zugegriffen werden kann oder wenn das zugrundeliegende Feld keine Aktualisierungen erlaubt.


TFieldDataLink::Control

TFieldDataLink	Siehe auch

Die Eigenschaft Control gibt den datensensitiven Nachkommen von TWinControl an, der mit Hilfe dieses TFieldDataLink-Objekts Reaktionen auf Datenereignisse und die Verknüpfung zu einem TField-Objekt verwaltet.

__property Controls::TWinControl* Control;

Beschreibung

Diese Eigenschaft sollte nur von Nachkommen von TWinControl gesetzt werden, die die Verknüpfung zu einem TField-Objekt mit Hilfe eines TFieldDataLink-Objekts unterhalten. Diese datensensitiven Steuerelemente können in ihrem eigenen Konstruktor nach dem Aufruf des TFieldDataLink-Kontruktors die Eigenschaft Control ihres TFieldDataLink-Elements auf self setzen. Bei der Bearbeitung von Datenereignissen kann diese Eigenschaft dann für den Zugriff auf Methoden des Steuerelements verwendet werden.


TFieldDataLink::Editing

TFieldDataLink	Siehe auch

Die Eigenschaft Editing zeigt an, ob sich die Datenmenge, die das mit dem TFieldDataLink-Objekt verknüpfte Feld enthält, im Bearbeitungsmodus befindet.

__property bool Editing;

Beschreibung

Mit Editing können Sie ermitteln, ob der Wert des mit dem TDataLink-Objekt verknüpften Feldes zur Zeit bearbeitet werden kann.  Wenn Editing False ist, kann die Datenmenge durch einen Aufruf der Methode Edit eventuell in den Bearbeitungsmodus versetzt werden.  Der Aufruf schlägt jedoch fehl, wenn das Feld nicht bearbeitet werden kann.  Editing ist beispielsweise immer dann False, wenn die Eigenschaft CanModify False ist.


TFieldDataLink::Field

TFieldDataLink	Siehe auch

Das TField-Objekt Field repräsentiert das Feld in der zugrundeliegenden Datenbanktabelle, das von dem TFieldDataLink-Objekt verwaltet wird.

__property Db::TField* Field;

Beschreibung

Mit einem Lesezugriff auf Field können Sie auf das Feldobjekt zugreifen, mit dem das in der Eigenschaft Control des TFieldDataLink-Objekts angegebene Steuerelement verbunden ist.

Hinweis

Bevor mit Hilfe der Eigenschaft Field ein Feldinhalt geändert wird, sollte die Anwendung die Eigenschaft CanModify überprüfen. Das Field-Objekt erkennt nicht alle Einschränkungen, die für die Bearbeitung des TFieldDataLink-Objekts bestehen.


TFieldDataLink::FieldName

TFieldDataLink	Siehe auch

FieldName ist der Name des Feldes, mit dem das in der Eigenschaft Control des TFieldDataLink-Objekts angegebene Steuerelement verbunden ist.

__property System::AnsiString FieldName;

Beschreibung

Mit FieldName wird die Eigenschaft FieldName des datensensitiven Steuerelements implementiert, das dem TFieldDataLink-Objekt übergeordnet ist. Indem Sie FieldName einen Wert zuweisen, verknüpfen Sie das TFieldDataLink-Objekt mit dem entsprechenden Feld der Datenmenge.


Ereignisse von TFieldDataLink

TFieldDataLink	Alphabetisch

In TFieldDataLink

OnActiveChange

OnDataChange

OnEditingChange

OnUpdateData


Ereignisse von TFieldDataLink

TFieldDataLink	Nach Objekten

OnActiveChange

OnDataChange

OnEditingChange

OnUpdateData


TFieldDataLink::OnActiveChange

TFieldDataLink	Siehe auch

Das Ereignis OnActiveChange tritt auf, wenn sich die Eigenschaft Active des TFieldDataLink-Objekts ändert.

typedef void __fastcall (__closure *TNotifyEvent)(System::TObject* Sender);

__property Classes::TNotifyEvent OnActiveChange;

Beschreibung

Mit einer Ereignisbehandlungsroutine für OnActiveChange können Sie unmittelbar nach jeder Änderung der Eigenschaft Active der Datenmenge bestimmte Aktionen durchführen. Da ein Objekt nur auf Ereignisse reagieren kann, während das TFieldDataLink-Objekt aktiv ist, bietet sich OnActiveChange für Aktualisierungen an, nachdem bei einer deaktivierten Datenmenge Änderungen aufgetreten sind.


TFieldDataLink::OnDataChange

TFieldDataLink	Siehe auch

Das Ereignis OnDataChange tritt auf, wenn sich der Inhalt der Datenmenge ändert.

typedef void __fastcall (__closure *TNotifyEvent)(System::TObject* Sender);

__property Classes::TNotifyEvent OnDataChange;

Beschreibung

Mit einer Ereignisbehandlungsroutine für OnDataChange können Sie bestimmte Aktionen durchführen, wenn sich ein Feldinhalt geändert hat. OnDataChange erlaubt dem Steuerelement zu reagieren, wenn es von der Datenmenge darüber benachrichtigt wird, daß sich die Daten geändert haben.


TFieldDataLink::OnEditingChange

TFieldDataLink	Siehe auch

Das Ereignis EditingChanged tritt auf, nachdem sich der Bearbeitungsmodus des DataSource-Objekts geändert hat.

typedef void __fastcall (__closure *TNotifyEvent)(System::TObject* Sender);

__property Classes::TNotifyEvent OnEditingChange;

Beschreibung

Mit einer Ereignisbehandlungsroutine für OnEditingChange können Sie bestimmte Aktionen durchführen, wenn sich der Bearbeitungsmodus der Datenmenge ändert.  Mit Hilfe dieses Ereignisses kann in dem Steuerelement, das dieses TFieldDataLink-Objekt verwendet, der Bearbeitungsmodus für den Benutzer sichtbar gemacht werden.


TFieldDataLink::OnUpdateData

TFieldDataLink	Siehe auch

Das Ereignis OnUpdateData tritt auf, wenn anstehende Änderungen in der Datenmenge gespeichert werden.

typedef void __fastcall (__closure *TNotifyEvent)(System::TObject* Sender);

__property Classes::TNotifyEvent OnUpdateData;

Beschreibung

Mit einer Ereignisbehandlungsroutine für OnUpdateData können Sie die auf dem Bildschirm angezeigten Daten des Feldes in der Datenbank speichern.  Das Speichern der Daten Mit einer Ereignisbehandlungsroutine für OnUpdateData löst keinen Aufruf von OnDataChange aus.


Methoden von TFieldDataLink

TFieldDataLink	Alphabetisch	Legende

In TFieldDataLink

~TFieldDataLink

ActiveChanged

Edit

EditingChanged

FocusControl

LayoutChanged

Modified

RecordChanged

Reset

TFieldDataLink

UpdateData

Abgeleitet von TDataLink

UpdateRecord

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TFieldDataLink

TFieldDataLink	Nach Objekten	Legende

~TFieldDataLink

ActiveChanged

Assign

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

EditingChanged

Edit

FieldAddress

FocusControl

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

LayoutChanged

MethodAddress

MethodName

Modified

NewInstance

RecordChanged

Reset

TFieldDataLink

UpdateData

UpdateRecord


TFieldDataLink::~TFieldDataLink

TFieldDataLink

Der Destruktor ~TFieldDataLink gibt den Speicher frei, der für das TFieldDataLink-Objekt reserviert war. Rufen Sie ~TFieldDataLink nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TFieldDataLink automatisch aufgerufen wird.

__fastcall virtual ~TFieldDataLink(void);


TFieldDataLink::ActiveChanged

TFieldDataLink	Siehe auch

Die Methode ActiveChanged ruft die Ereignisbehandlungsroutine für OnActiveChanged auf, falls ein solcher existiert.

virtual void __fastcall ActiveChanged(void);

Beschreibung

Änderungen an der Eigenschaft Active lösen die Methode ActiveChanged aus.  Wenn eine Ereignisbehandlungsroutine für OnActiveChanged existiert, wird er von ActiveChanged aufgerufen.  Wenn ActiveChanged dadurch ausgelöst wird, daß der Eigenschaft Active der Wert True zugewiesen wurde, überprüft die Methode vor dem Aufruf der Ereignisbehandlungsroutine, ob das Feld für dieses TFieldDataLink-Objekt noch gültig ist.


TFieldDataLink::Edit

TFieldDataLink	Siehe auch

Edit versucht, das DataSource-Objekt in einen Bearbeitungsmodus zu versetzen.

bool __fastcall Edit(void);

Beschreibung

Mit Edit können Sie prüfen, ob der Feldinhalt geändert werden kann. Der Rückgabewert True gibt an, daß sich das Feld bereits in einem Bearbeitungsmodus befand, oder daß das DataSource-Objekt erfolgreich in diesen Modus versetzt wurde. False zeigt an, daß das DataSource-Objekt nicht in einen Bearbeitungsmodus versetzt werden konnte. Ist beispielsweise die Eigenschaft CanModify False, schlägt der Aufruf von Edit fehl und gibt False zurück.


TFieldDataLink::EditingChanged

TFieldDataLink	Siehe auch

EditingChanged sorgt dafür, daß die Eigenschaft CanModify beachtet wird, wenn sich die Feldzuordnung ändert.

virtual void __fastcall EditingChanged(void);

Beschreibung

Bei einer Änderung der Feldzuordnung kann die Eigenschaft CanModify ihre Gültigkeit verlieren, da einzelne Feldkomponenten möglicherweise keine Bearbeitung zulassen.  Befindet sich das TFieldDataLink-Objekt in einem Bearbeitungsmodus, wenn die Eigenschaft Field geändert wird, prüft EditingChanged die Eigenschaft CanModify.  Ist die Eigenschaft False, wird der Bearbeitungsmodus beendet.

Hinweis

Darin liegt ein wesentlicher Unterschied zur geerbten Methode EditingChanged von TDataLink.  Die Funktionalität der geerbten Methode wird bei TFieldDataLink durch die Ereignisbehandlungsroutine für OnEditingChange ersetzt.


TFieldDataLink::FocusControl

TFieldDataLink	Siehe auch

Die Methode FocusControl verlagert den Eingabefokus auf das in der Eigenschaft Control angegebene Steuerelement.

virtual void __fastcall FocusControl(Db::TFieldRef Field);

Beschreibung

Durch einen Aufruf von FocusControl können Sie den Eingabefokus auf das mit dem TFieldDataLink-Objekt verbundene Steuerelement verlagern.  FocusControl überprüft, ob das Steuerelement den Eingabefokus erhalten kann, und ruft, wenn dies der Fall ist, dessen Methode SetFocus auf.


TFieldDataLink::LayoutChanged

TFieldDataLink	Siehe auch

Die Methode LayoutChanged stellt sicher, daß nach Änderungen am Layout des Containers, der das in der Eigenschaft Control des TFieldDataLink-Objekts angegebene Steuerelement enthält, die Eigenschaft Field weiterhin einen gültigen Wert enthält.

virtual void __fastcall LayoutChanged(void);

Beschreibung

LayoutChanged wird nach Änderungen am Layout eines der Container des Steuerelements aufgerufen, die die Gültigkeit seiner Feldzuordnung beeinflussen könnten.  Wenn das Steuerelement beispielsweise in ein TCustomDBGrid-Objekt eingebettet ist und eine der Spalten gelöscht wird, enthält die Eigenschaft Field möglicherweise keinen gültigen Wert mehr.


TFieldDataLink::Modified

TFieldDataLink	Siehe auch	Beispiel

Die Methode Modified wacht über Änderungen an den Daten des Feldes, die noch nicht in der Datenmenge gespeichert wurden.

void __fastcall Modified(void);

Beschreibung

Rufen Sie Modified auf, wenn das Steuerelement des TFieldDataLink-Objekts mit der Bearbeitung von Eingaben beginnt.


TFieldDataLink::RecordChanged

TFieldDataLink	Siehe auch

Die Methode RecordChanged ruft die Ereignisbehandlungsroutine für OnDataChange auf, wenn sich der Inhalt des aktuellen Datensatzes in der Datenmenge ändert.

virtual void __fastcall RecordChanged(Db::TField* Field);

Beschreibung

Anwendungen können diese als protected deklarierte Methode nicht aufrufen.  Sie wird automatisch ausgelöst, wenn sich der Inhalt des aktuellen Datensatzes ändert.  RecordChanged ruft die Ereignisbehandlungsroutine für OnDataChange auf, falls ein solcher existiert.


TFieldDataLink::Reset

TFieldDataLink	Siehe auch

Die Methode Reset ruft die Ereignisbehandlungsroutine für OnDataChange auf, damit Änderungen am Feldinhalt, die noch nicht gespeichert wurden, verworfen werden können.

void __fastcall Reset(void);

Beschreibung

Das einem TFieldDataLink-Objekt übergeordnete Steuerelement ruft dessen Methode Reset auf, wenn der Benutzer Änderungen am Feldinhalt verwerfen will.  Reset ruft die Ereignisbehandlungsroutine für OnDataChange auf, ohne anstehende Änderungen im Datensatz der Datenmenge zu speichern.


TFieldDataLink::TFieldDataLink

TFieldDataLink

Der Konstruktor TFieldDataLink erzeugt ein neues TFieldDataLink-Objekt.

__fastcall TFieldDataLink(void);


TFieldDataLink::UpdateData

TFieldDataLink	Siehe auch

Die Methode UpdateData ruft die Ereignisbehandlungsroutine für OnUpdateData auf, so daß das datensensitive Steuerelement anstehende Änderungen in der Datenmenge speichern kann.

virtual void __fastcall UpdateData(void);

Beschreibung

UpdateData überschreibt die gleichnamige geerbte Methode und ruft die zugeordnete Ereignisbehandlungsroutine für OnUpdateData auf.


Zugriff

Read-only


Gültigkeitsbereich

Protected


Hierarchie

TObject

TPersistent

TDataLink


TFieldDataLink Beispiel

TFieldDataLink


TFieldDef

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/db.hpp

Das TFieldDef-Objekt ist eine Felddefinition, die einem physischen Feld eines Datensatzes in einer der Datenmenge zugrundeliegenden Tabelle entspricht.

Beschreibung

Für jedes Feld einer Datenmenge wird automatisch eine Felddefinition erstellt. Eine Felddefinition hat ein entsprechendes TField-Objekt, aber nicht alle TField-Objekte besitzen ein zugehöriges Felddefinitionsobjekt. Zum Beispiel haben berechnete Felder keine Felddefinitionsobjekte.

Es gibt zwei wesentliche Einsatzbereiche von TFieldDef-Objekten:

•	Sammeln von Information über die Feldtypen einer nicht geöffneten Tabelle.

•	Erstellen einer neuen Tabelle.

Die Felddefinitionen werden in der Eigenschaft Items eines TFieldDefs-Objektes gespeichert, das alle Felddefinitionen einer Datenmenge enthält.

Mit Hilfe der Eigenschaften und Methoden von TFieldDef können die Merkmale entsprechend dem physischen Feld in der Datenmenge festgelegt werden.

Das TFieldDef-Objekt ist ein direkter Nachkomme von TObject und besitzt deshalb alle Methoden, die für alle Objekte verwendet werden können.


Eigenschaften von TFieldDef

TFieldDef	Alphabetisch	Legende

In TFieldDef

BDECalcField

DataType

FieldClass

FieldNo

Name

Required

Size


Eigenschaften von TFieldDef

TFieldDef	Nach Objekten	Legende

BDECalcField

DataType

FieldClass

FieldNo

Name

Required

Size


TFieldDef::BDECalcField

TFieldDef	Siehe auch

Mit der Eigenschaft BDECalcField wird festgelegt, ob es sich bei einem Feld um ein durch die Borland Database Engine berechnetes Feld handelt.

__property bool BDECalcField;

Beschreibung

Mit einem Lesezugriff auf BDECalcField kann ermittelt werden, ob das Feld durch die BDE berechnet wird. Die Borland Database Engine berechnet gegebenenfalls zur Laufzeit die Felder in einem aktualisierbaren Abfrageergebnis. Handelt es sich bei dem Feld um ein durch die BDE berechnetes Feld, gibt BDECalcField den Wert True zurück, andernfalls False.

So enthält in der folgenden SQL-Anweisung die Datenmenge ein Feld für den berechneten Wert BESTAND * PREIS.

SELECT TEILENR, BESCHREIBUNG, BESTAND, PREIS, (BESTAND * PREIS) FROM TEILE

Hat die Eigenschaft ReqestLive des TQuery-Objekts den Wert True, bewirkt die Felddefinition für dieses berechnete Feld, daß der Eigenschaft BDECalcField der Wert True zugewiesen wird.

Hat BDECalcField den Wert True, kann das Feld bearbeitet werden, wobei aber die Änderungen verworfen werden. Wird der Eigenschaft ReadOnly der Wert True zugewiesen, kann das Feld nicht bearbeitet werden.

Die Eigenschaft BDECalcField ist schreibgeschützt.


TFieldDef::DataType

TFieldDef	Siehe auch

Mit der Eigenschaft DataType wird der Typ eines physischen Feldes festgelegt.

__property TFieldType DataType;

Beschreibung

Mit der Eigenschaft DataType kann ermittelt werden, welchen Datentyp ein Feld enthält:

Wert	Beschreibung

ftUnkown	Unbekannt oder unbestimmt

ftString	Zeichen- oder Stringfeld

ftSmallint	16-Bit-Integer-Feld

ftInteger	32-Bit-Integer-Feld

ftWord	Vorzeichenloses 16-Bit-Integer-Feld

ftBoolean	Logisches Feld

ftFloat	Numerisches Gleitkommafeld

ftCurrency	Währungsfeld

ftBCD	Binärcodiertes Dezimalfeld

ftDate	Datumsfeld

ftTime	Zeitfeld

ftDateTime	Feld für Datum und Zeit

ftBytes	Feste Anzahl von Bytes (binäre Speicherung)

ftVarBytes	Variable Anzahl von Bytes (binäre Speicherung)

ftAutoInc	Autoinkrement-32-Bit -Integer-Feld als Zählerfeld

ftBlob	BLOB-Field

ftMemo	Memofeld für Text

ftGraphic	Bitmap-Feld

ftFmtMemo	Formatiertes Memofeld für Text

ftParadoxOle	Paradox-OLE-Feld

ftDBaseOle	dBASE-OLE-Feld

ftTypedBinary	Typisiertes Binärfeld

Die Eigenschaft DataType ist eine Nur-Lesen-Eigenschaft.


TFieldDef::FieldClass

TFieldDef	Siehe auch

Mit der Eigenschaft FieldClass wird die Klasse des Feldobjekts festgelegt, das diesem Felddefinitionsobjekt entspricht.

__property System::TMetaClass* FieldClass;

Beschreibung

Mit der Eigenschaft FieldClass kann die Klasse des Feldobjekts ermittelt werden, das diesem Felddefinitionsobjekt entspricht. Der Wert der Eigenschaft FieldClass basiert auf der Eigenschaft DataType des Feldes. Ist der Wert von DataType zum Beispiel ftString, hat FieldClass den Wert TStringField.

Das von der Methode CreateField aus der Felddefinition erstellte Feldobjekt ist eine Instanz von FieldClass.

Die Eigenschaft FieldClass ist eine Nur-Lesen-Eigenschaft.


TFieldDef::FieldNo

TFieldDef	Siehe auch

Mit der Eigenschaft FieldNo wird die physische Feldnummer festgelegt, die von der Borland Database Engine zur Referenzierung des Feldes verwendet wird.

__property int FieldNo;

Beschreibung

Mit FieldNo kann die Position des physischen Feldes in der Tabelle ermittelt werden, das die Felddefinition referenziert. Hat zum Beispiel FieldNo den Wert 2, ist das Feld das zweite Feld der Tabelle.

Die Eigenschaft FieldNo ist eine Nur-Lesen-Eigenschaft.


TFieldDef::Name

TFieldDef	Siehe auch	Beispiel

In der Eigenschaft Name ist die Bezeichnung des physischen Feldes in der zugrundeliegenden Tabelle gespeichert.

__property System::AnsiString Name;

Beschreibung

Mit der Eigenschaft Name kann die Bezeichnung des physischen Feldes in der Tabelle ermittelt werden.

Die Eigenschaft Name ist eine Nur-Lesen-Eigenschaft.


TFieldDef::Required

TFieldDef	Siehe auch

Die Eigenschaft Required legt fest, ob ein physisches Feld in der zugrundeliegenden Tabelle einen Wert enthalten muß.

__property bool Required;

Beschreibung

Mit Required kann ermittelt werden, ob ein Feld in einer Tabelle einen Wert enthalten muß. Hat Required den Wert True, muß das Feld einen Wert enthalten. Anderfalls kann das Feld leer bleiben.

Die Eigenschaft Required ist eine Nur-Lesen-Eigenschaft.


TFieldDef::Size

TFieldDef	Siehe auch

Die Eigenschaft Size gibt die Größe des Feldes in der physischen Tabelle an.

__property unsigned short Size;

Beschreibung

Mit der Eigenschaft Size kann die Größe des entsprechenden physischen Feldes ermittelt werden.

Size liefern sinnvolle Informationen nur für ein Felddefinitionsobjekt mit einem der folgenden TFieldType-Werte: ftString, ftBCD, ftBytes, ftVarBytes, ftBlob, ftMemo oder ftGraphic. Bei String- und Byte-Feldern enthält Size die Anzahl der für das Feld in der Tabelle reservierten Bytes. Für ein BCD-Feld gibt Size die Zahl der Stellen nach dem Dezimaltrennzeichen an. Bei einem BLOB-, Memo- oder Grafikfeld enthält Size die Zahl der Bytes des Feldwertes, die in der Datenbanktabelle gespeichert werden.

Die Eigenschaft Size ist eine Nur-Lesen-Eigenschaft.


Methoden von TFieldDef

TFieldDef	Alphabetisch

In TFieldDef

~TFieldDef

CreateField

TFieldDef

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TFieldDef

TFieldDef	Nach Objekten

~TFieldDef

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

CreateField

DefaultHandler

Dispatch

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance

TFieldDef


TFieldDef::~TFieldDef

TFieldDef	Siehe auch

Der Destruktor ~TFieldDef gibt den Speicher frei, der für das TFieldDef-Objekt reserviert war. Rufen Sie ~TFieldDef nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TFieldDef automatisch aufgerufen wird.

__fastcall virtual ~TFieldDef(void);


TFieldDef::TFieldDef

TFieldDef	Siehe auch

TFieldDef erzeugt eine Instanz von TFieldDef.

__fastcall TFieldDef(TFieldDefs* Owner, const System::AnsiString Name, TFieldType DataType, unsigned short  Size, bool Required, int FieldNo);

Beschreibung

Durch einen Aufruf TFieldDef kann eine Felddefinition erstellt werden, wenn im Programm eine neue Tabelle erstellt wird.

Ist der an TFieldDef übergebene Parameter Owner nicht Nil, wird das angegebene TFieldDefs-Objekt der Eigentümer dieser Felddefinition. Die in den Parametern Name, DataType, Size, Required und FieldNo übergebenen Werte werden den entsprechenden gleichnamigen Eigenschaften zugewiesen.


TFieldDef::CreateField

TFieldDef	Siehe auch

Die Methode CreateField erstellt nach den Spezifikationen des TFieldDef-Objekts eine TField-Komponente des entsprechenden Typs.

TField* __fastcall CreateField(Classes::TComponent* Owner);

Beschreibung

Ein Datenmengenobjekt ruft CreateField zur Erstellung der Feldkomponenten aus den Felddefinitionsobjekten auf. In Anwendungen wird CreateField niemals direkt aufgerufen.


Zugriff

Read-only


Hierarchie

TObject


TFieldDef Beispiel

TFieldDef


TFieldDefs

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/db.hpp

Ein TFieldDefs-Objekt speichert die Felddefinitionsobjekte (TFieldDef), welche die physischen Felder der zugrundeliegenden Datenmenge repräsentieren.

Beschreibung

TFieldDefs wird von einer Datenmenge für die Verwaltung der Felddefinitionen benutzt, die für die Erstellung von Feldobjekten verwendet werden, die Feldern in der Datenbanktabelle entsprechen. TTable-Objekte verwenden TFieldDefs-Objekte bei der Erstellung einer neuen Datenbanktabelle.

Die Eigenschaften und Methoden von TFieldDefs können für folgende Aufgaben eingesetzt werden:

•	Zugreifen auf eine bestimmte Felddefinition

•	Hinzufügen oder Löschen von Felddefinitionen in der Liste

•	Ermitteln der Anzahl definierter Felder

•	Kopieren von Felddefinitionen in eine andere Tabelle


Eigenschaften von TFieldDefs

TFieldDefs	Alphabetisch	Legende

In TFieldDefs

Count

Items


Eigenschaften von TFieldDefs

TFieldDefs	Nach Objekten	Legende

Count

Items


TFieldDefs::Count

TFieldDefs	Siehe auch

Die Eigenschaft Count gibt die Anzahl TFieldDef-Objekte an, deren Eigentümer dieses TFieldDefs-Objekt ist.

__property int Count;

Beschreibung

Mit der Eigenschaft Count kann die Zahl der Felddefinitionen ermittelt werden, die dieses TFieldDefs-Objekt enthält. So können mit Hilfe von Count alle Felddefinitionen im Array Items iterativ verarbeitet werden.

Die Eigenschaft Count ist eine Nur-lesen-Eigenschaft. Der Wert von Count wird indirekt beim Hinzufügen oder Löschen von Felddefinitionen geändert.


TFieldDefs::Items

TFieldDefs	Siehe auch

Bei der Eigenschaft Items handelt es sich um ein Array mit Zeigern, die auf die Felddefinitionen verweisen, die jedes physische Feld einer Datenmenge beschreiben.

__property TFieldDef* Items[int Index];

Beschreibung

Mit Items kann auf eine bestimmte Felddefinition zugegriffen werden. Mit dem Parameter Index wird die Felddefinition angegeben, auf die zugegriffen werden soll. Index ist ein Integer, der die Position der Felddefinition in der Liste der Felddefinitionen kennzeichnet. Der Wert kann zwischen 0 und Count - 1 liegen.

Die Eigenschaft Items ist eine Nur-lesen-Eigenschaft. Der Wert von Items wird indirekt beim Hinzufügen oder Löschen von Felddefinitionen geändert.


Methoden von TFieldDefs

TFieldDefs	Alphabetisch

In TFieldDefs

~TFieldDefs

Add

AddFieldDesc

Assign

Clear

Find

IndexOf

TFieldDefs

Update

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TFieldDefs

TFieldDefs	Nach Objekten

~TFieldDefs

AddFieldDesc

Add

Assign

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

Clear

DefaultHandler

Dispatch

FieldAddress

Find

FreeInstance

Free

IndexOf

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance

TFieldDefs

Update


TFieldDefs::~TFieldDefs

TFieldDefs	Siehe auch

Der Destruktor ~TFieldDefs gibt den Speicher frei, der für das TFieldDefs-Objekt reserviert war. Rufen Sie ~TFieldDefs nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TFieldDefs automatisch aufgerufen wird.

__fastcall virtual ~TFieldDefs(void);

Beschreibung

~TFieldDefs entfernt alle Felddefinitionsobjekte aus der Array-Eigenschaft Items und igbt Items frei. Dann wird der Destruktor des übergeordneten Objekts aufgerufen.


TFieldDefs::Add

TFieldDefs	Siehe auch

Die Eigenschaft Add erstellt ein neues Felddefinitionsobjekt und fügt es der Eigenschaft Items dieses TFieldDefs-Objekts hinzu.

void __fastcall Add(const System::AnsiString Name, TFieldType DataType, unsigned short Size, bool Required );

Beschreibung

Add darf nur beim Erstellen einer neuen Tabelle verwendet werden, da das Array der Eigenschaft Items automatisch beim öffnen der Datenmenge initialisiert wird.

Add verwendet die in den Parametern Name, DataType, Size, Required übergebene Werte und weist sie den entsprechenden  Eigenschaften des neuen Felddefinitionsobjekts zu.

Existiert bereits eine gleichnamige Felddefinition, wird eine EDatabaseError-Exception ausgelöst.


TFieldDefs::AddFieldDesc

TFieldDefs	Siehe auch

Die Eigenschaft AddFieldDesc erstellt ein neues Felddefinitionsobjekt und fügt es dem Array der Eigenschaft Items für dieses TFieldDefs-Objekt hinzu.

void __fastcall AddFieldDesc(const Bde::FLDDesc &FieldDesc, bool Required, unsigned short FieldNo);

Beschreibung

Anwendungen sollten diese Methode nicht aufrufen. Sie wird von der Datenmenge bei geöffneter Datenbanktabelle zum Initialisieren des Arrays der Eigenschaft Items verwendet.

Statt dessen können Sie mit der Methode Update das Array der Eigenschaft Items als Reaktion auf Änderungen der Datenmenge aktualisieren.

AddFieldDesc verwendet die von der Borland Database Engine für den Parameter FieldDesc bereitgestellten Informationen.


TFieldDefs::Assign

TFieldDefs	Siehe auch

Mit der Methode Assign wird eine Menge von Felddfinitionsobjekten in das Array der Eigenschaft Items eines anderen TFieldDefs-Objekts kopiert.

void __fastcall Assign(TFieldDefs* FieldDefs);

Beschreibung

Mit Assign kann ein TFieldDefs-Objekt in ein anderes kopiert werden. Die Felddefinitionen werden in das Array der Eigenschaft Items kopiert. Dabei wird das TFieldDefs-Objekt als Wert für den Parameter FieldDefs angegeben.

Wird Items mit neuen Einträgen versehen, werden die Zeiger auf Felddefinitionen freigegeben, die Items zuvor enthielt.


TFieldDefs::Clear

TFieldDefs	Siehe auch

Mit der Methode Clear werden alle Einträge der Eigenschaft Items freigegeben.

void __fastcall Clear(void);

Beschreibung

Mit Clear können Sie alle Felddefinitionsobjekte aus dem TFieldDefs-Objekt entfernen.


TFieldDefs::Find

TFieldDefs	Siehe auch

Die Methode Find sucht mit Hilfe des Feldnamens eine Felddefinition im Array der Eigenschaft Items.

TFieldDef* __fastcall Find(const System::AnsiString Name);

Beschreibung

Mit Find können Sie Informationen über eine bestimmte Felddefinition abrufen. Geben Sie den Feldnamen als Wert für den Parameter Name an.


TFieldDefs::IndexOf

TFieldDefs	Siehe auch

Die Methode IndexOf sucht mit Hilfe des Feldnamens die Indexnummer einer Felddefinition im Array der Eigenschaft Items.

int __fastcall IndexOf(const System::AnsiString Name);

Beschreibung

Mit der Methode IndexOf können Sie die Position einer Felddefinition im Array der Eigenschaft Items ermitteln. IndexOf gibt dabei Werte zwischen 0 (erste Position) bis Count - 1 zurück. Geben Sie den Feldnamen als Wert für den Parameter Name an.


TFieldDefs::TFieldDefs

TFieldDefs	Siehe auch

Mit der Methode TFieldDefs wird eine Instanz von TFieldDefs erstellt.

__fastcall TFieldDefs(TDataSet* DataSet);

Beschreibung

In Anwendungen sollte TFieldDefs nicht direkt aufgerufen werden. TFieldDefs wird automatisch von einer Datenmenge zur Beschreibung der Felder der Datenbank erstellt.

Nach dem Aufruf des Konstruktors des übergeordneten Objekts erstellt TFieldDefs das Array der Eigenschaft Items.


TFieldDefs::Update

TFieldDefs	Siehe auch	Beispiel

Die Methode Update aktualisiert die Felddefinitionen im Array der Eigenschaft Items, um diese an den aktuellen Status der physischen Felder in der zugrundeliegenden Datenmenge anzupassen.

void __fastcall Update(void);

Beschreibung

Mit Update können Sie die Felddefinitionen aktualisieren, wenn sich die Struktur der zugrundeliegenden Datenmenge ändert. Dazu muß die Datenmenge nicht geöffnet werden.


Zugriff

Read-only


Hierarchie

TObject


TFieldDefs Beispiel

TFieldDefs


TFloatField

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/dbtables.hpp

Ein TFloatField-Objekt repräsentiert ein Feld in einer Datenmenge, das Gleitkommawerte enthält.

Beschreibung

Felder vom Typ Gleitkomma können Werte zwischen 5.0 * 10EXP-324 bis 1.7 * 10EXP308 (positiv oder negativ) mit einer Genauigkeit von 15 Stellen enthalten.

TFloatField führt neue Eigenschaften mit folgenden Funktionen ein:

•	Umwandlung von Gleitkommawerten und anderen Datentypen

•	Begrenzung des Bereichs oder der Genauigkeit der gültigen Werte, die für das Feld zugelassen sind.

•	Formatierung der Werte zur Anzeige

Als ein Nachkomme von TNumericField enthält TFloatField zahlreiche Eigenschaften, Methoden und Ereignisse, die für die Verwaltung des Wertes und der Eigenschaften eines numerischen Feldes in einer Datenbank geeignet sind.

TFloatField ist der direkte Vorfahr der Komponente TCurrencyField.


Eigenschaften von TFloatField

TFloatField	Alphabetisch	Legende

In TFloatField

Currency

MaxValue

MinValue

Precision

Value

Abgeleitet von TNumericField

DisplayFormat

EditFormat

Abgeleitet von TField

Alignment

AsBoolean

AsCurrency

AsDateTime

AsFloat

AsInteger

AsString

AsVariant

AttributeSet

BDECalcField

Calculated

CanModify

DataSet

DataSize

DataType

DisplayLabel

DisplayName

DisplayText

DisplayWidth

EditMask

EditMaskPtr

FieldKind

FieldName

FieldNo

Index

IsIndexField

IsNull

KeyFields

Lookup

LookupDataSet

LookupKeyFields

LookupResultField

NewValue

OldValue

ReadOnly

Required

Size

Text

Visible

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Name

Owner

Tag


Eigenschaften von TFloatField

TFloatField	Nach Objekten	Legende

Alignment

AsBoolean

AsCurrency

AsDateTime

AsFloat

AsInteger

AsString

AsVariant

AttributeSet

BDECalcField

Calculated

CanModify

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

Currency

DataSet

DataSize

DataType

DesignInfo

DisplayFormat

DisplayLabel

DisplayName

DisplayText

DisplayWidth

EditFormat

EditMaskPtr

EditMask

FieldKind

FieldName

FieldNo

Index

IsIndexField

IsNull

KeyFields

LookupDataSet

LookupKeyFields

LookupResultField

Lookup

MaxValue

MinValue

Name

NewValue

OldValue

Owner

Precision

ReadOnly

Required

Size

Tag

Text

Value

Visible


TFloatField::Currency

TFloatField	Siehe auch

Mit der Eigenschaft Currency wird festgelegt, ob der Feldwert als Währungsbetrag formatiert werden soll.

__property bool Currency;

Beschreibung

Mit der Eigenschaft Currency wird die Formatierung des Feldes für die Ansicht und Bearbeitung in einem datensensitiven Steuerelement festgelegt.

Die Formatierung des Feldes zur Ansicht wird gegebenenfalls durch die zugewiesene Eigenschaft DisplayFormat festgelegt. Ist DisplayFormat nicht zugewiesen, ist das Format des Feldes in der Ansicht durch Currency festgelegt. Hat Currency den Wert True, wird der Wert mit Hilfe der Funktion FloatToText mit dem Formatierungsattribut ffCurrency für die Ansicht formatiert. Hat Currency den Wert False, wird der Wert im Format ffGereral formatiert.

Die Formatierung des Feldes für die Bearbeitung wird gegebenenfalls durch die zugewiesene Eigenschaft EditFormat (oder DisplayFormat) festgelegt. Sind weder EditFormat noch DisplayFormat definiert, ist die Formatierung des Feldes für die Bearbeitung durch Currency festgelegt. Hat Currency den Wert True, wird der Wert mit Hilfe der Funktion FloatToText mit dem Formatierungsattribut ffFixed für die Bearbeitung formatiert. Hat Currency den Wert False, wird der Wert im Format ffGereral formatiert.


TFloatField::MaxValue

TFloatField	Siehe auch

Mit MaxValue wird der maximale Wert festgelegt, der in einem Feld vom Typ Gleitkomma gespeichert werden kann.

__property double MaxValue;

Beschreibung

Mit MaxValue wird der Maximalwert, der in ein Feld eingetragen werden kann, gelesen oder gesetzt. Wird ein größerer Wert als MaxValue eingetragen, wird eine Exception EDatabaseError ausgelöst.


TFloatField::MinValue

TFloatField	Siehe auch

Mit MinValue wird der minimale Wert festgelegt, der in einem Feld vom Typ Gleitkomma gespeichert werden kann.

__property double MinValue;

Beschreibung

Mit MinValue wird der Minimalwert, der in ein Feld eingetragen werden kann, gelesen oder gesetzt. Wird ein kleinerer Wert als MinValue eingetragen, wird eine Exception EDatabaseError ausgelöst.


TFloatField::Precision

TFloatField	Siehe auch

Mit der Eigenschaft Precision wird die Genauigkeit festgelegt, die bei der Formatierung des Wertes in einem Gleitkommafeld verwendet wird.

__property int Precision;

Beschreibung

Mit Precision wird die Zahl der Stellen nach dem Dezimalpunkt festgelegt, auf die der Wert vor dem Runden formatiert werden soll. Precision hat Einfluß auf das Format des Gleitkommawertes, wenn dieser als String angezeigt wird, nicht auf den eigentlichen Gleitkommawert, der im Feld gespeichert ist.

Der Standardwert von Precision ist 15 Dezimalstellen.


TFloatField::Value

TFloatField	Siehe auch

Die Eigenschaft Value ist der eigentliche Inhalt des Gleitkommafeldes.

__property double Value;

Beschreibung

Mit Value werden zur Laufzeit Daten direkt aus einer Gleitkommakomponente gelesen oder in die Komponente geschrieben. Die Verwendung der Eigenschaft Value entspricht derjenigen der Eigenschaft AsFloat. Value wird verwendet, wenn bekannt ist, daß es sich bei der Feldkomponente um ein Feld vom Typ Gleitkomma handelt. AsFloat wird verwendet, wenn generische Feldkomponenten eingesetzt werden.


Ereignisse von TFloatField

TFloatField	Alphabetisch	Legende

Abgeleitet von TField

OnChange

OnGetText

OnSetText

OnValidate


Ereignisse von TFloatField

TFloatField	Nach Objekten	Legende

OnChange

OnGetText

OnSetText

OnValidate


Methoden von TFloatField

TFloatField	Alphabetisch

In TFloatField

~TFloatField

IsValidChar

TFloatField

Abgeleitet von TField

Assign

AssignValue

Clear

FocusControl

GetData

SetData

SetFieldType

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TFloatField

TFloatField	Nach Objekten

~TFloatField

Assign

AssignValue

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

Clear

DefaultHandler

DestroyComponents

Destroying

Dispatch

FieldAddress

FindComponent

FocusControl

FreeInstance

FreeNotification

Free

GetData

GetParentComponent

HasParent

InheritsFrom

InitInstance

InsertComponent

InstanceSize

IsValidChar

MethodAddress

MethodName

NewInstance

RemoveComponent

SetData

SetFieldType

TFloatField


TFloatField::~TFloatField

TFloatField

Der Destruktor ~TFloatField gibt den Speicher frei, der für das TFloatField-Objekt reserviert war. Rufen Sie ~TFloatField nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TFloatField automatisch aufgerufen wird.

__fastcall virtual ~TFloatField(void);


TFloatField::IsValidChar

TFloatField	Siehe auch

Mit der Methode IsValidChar wird festgelegt, ob ein bestimmtes Zeichen in einem Gleitkommafeld zulässig ist.

virtual bool __fastcall IsValidChar(char InputChar);

Beschreibung

Mit IsValidChar wird festgelegt, ob das als Wert von InputChar angegebene Zeichen in einem Feld vom Typ Gleitkomma zulässig ist.

Zulässige Zeichen sind +, -, E, e, 0 bis 9 und das Zeichen, das als Dezimaltrennzeichen festgelegt ist. Enthält InputChar eines dieser Zeichen, ist True der Rückgabewert von IsValidChar. Ansonsten wird False zurückgegeben.

Mit IsValidChar wird bei datensensitiven Steuerelementen die Zulässigkeit eines bestimmten Zeichens als Eingabe für ein Feld geprüft.


TFloatField::TFloatField

TFloatField	Siehe auch

Die Methode TFloatField erzeugt eine Instanz von TFloatField.

__fastcall virtual TFloatField(Classes::TComponent* AOwner);

Beschreibung

Mit TFloatField wird eine Instanz von TFloatField erstellt und initialisiert. Nach dem Aufruf des geerbten Konstruktors setzt TFloatField den Datentyp (Eigenschaft DataType) auf ftFloat und Precision auf 15.

Es ist nur selten notwendig, TFloatField direkt aufzurufen, da eine Feldkomponente vom Typ Gleitkomma automatisch für alle entsprechenden Felder einer Datenmenge instantiiert wird.


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TField

TNumericField


TFloatField Beispiel

TFloatField


 TFilterComboBox

Hierarchie	Eigenschaften	Methoden	Ereignisse

Header

vcl/filectrl.hpp

TFilterComboBox ist ein spezielles Kombinationsfeld, das dem Benutzer eine Reihe von Dateifiltern zur Auswahl anbietet.

Beschreibung

Mit einem Filter-Kombinationsfeld können Sie in einem Formular, das bereits ein Steuerelement zur Dateiauswahl enthält, eine Reihe vordefinierter Filter zur Verfügung stellen. Zusammen mit TDriveComboBox, TDirectoryListBox und TFileListBox stellt TFilterComboBox umfassende Funktionen zur Dateiauswahl in einem Formular bereit.

Mit TOpenDialog oder TSaveDialog können Sie Ihrer Anwendung einen der unter Windows 95 üblichen Standarddialoge zum öffnen oder Speichern einer Datei hinzufügen.


Eigenschaften von TFilterComboBox

TFilterComboBox	Alphabetisch	Legende

In TFilterComboBox

FileList

Filter

Mask

Abgeleitet von TCustomComboBox

Canvas

DroppedDown

ItemIndex

Items

SelLength

SelStart

SelText

Abgeleitet von TWinControl

Brush

ClientOrigin

ClientRect

ControlCount

Controls

Ctl3D

Handle

HelpContext

ParentCtl3D

Showing

TabOrder

TabStop

Abgeleitet von TControl

Align

BoundsRect

ClientHeight

ClientWidth

Color

ControlState

ControlStyle

Cursor

DragCursor

DragMode

Enabled

Font

Height

Hint

Left

Name

Parent

ParentColor

ParentFont

ParentShowHint

PopupMenu

ShowHint

Text

Top

Visible

Width

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TFilterComboBox

TFilterComboBox	Nach Objekten	Legende

Align

BoundsRect

Brush

Canvas

ClientHeight

ClientOrigin

ClientRect

ClientWidth

Color

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlCount

ControlState

Controls

ControlStyle

Ctl3D

Cursor

DesignInfo

DragCursor

DragMode

DroppedDown

Enabled

FileList

Filter

Font

Handle

Height

HelpContext

Hint

ItemIndex

Items

Left

Mask

Name

Owner

ParentColor

ParentCtl3D

ParentFont

ParentShowHint

Parent

PopupMenu

SelLength

SelStart

SelText

ShowHint

Showing

TabOrder

TabStop

Tag

Text

Top

Visible

Width


TFilterComboBox::FileList

TFilterComboBox

Die Eigenschaft FileList stellt eine einfache Möglichkeit dar, ein Filter-Kombinationsfeld mit einem Listenfeld für Dateien zu verknüpfen.

__property TFileListBox* FileList;

Beschreibung

Wenn das Formular ein TFileListBox-Objekt enthält, das eine Liste von Dateien anzeigt, weisen Sie dieses Objekt der Eigenschaft FileList zu. Das Filter-Kombinationsfeld schränkt daraufhin die im Listenfeld angezeigten Dateien auf bestimmte Typen ein. Wenn im Kombinationsfeld ein neuer Filter ausgewählt wird und die beiden Steuerelemente miteinander verknüpft sind, zeigt das Listenfeld nur noch die Dateien an, die dem Filter entsprechen.

Weisen Sie FileList das Listenfeld zu, das die Dateien anzeigen soll, die dem ausgewählten Filter entsprechen.


TFilterComboBox::Filter

TFilterComboBox

Die Eigenschaft Filter legt alle Dateimasken fest, die im Kombinationsfeld angezeigt werden.

__property System::AnsiString Filter;

Zur Laufzeit wird der Eigenschaft Mask der Dateifilter zugewiesen, den der Benutzer im Filter-Kombinationsfeld auswählt.

Eine Dateimaske oder ein Dateifilter ist ein Dateiname, der normalerweise Platzhalter enthält (z.B. *.CPP). Zur Laufzeit wird der vom Benutzer im Kombinationsfeld ausgewählte Dateifilter der Eigenschaft Mask zugewieen.So können Sie der Eigenschaft Filter einen Wert für einen bestimmten Dateityp zuweisen:

1	Geben Sie einen beschreibenden Text für den Dateityp ein.

2	Geben Sie das Zeichen | ein (das Pipe- bzw. Oder-Zeichen).

3	Geben Sie den Dateifilter ein.

Geben Sie vor und nach dem Zeichen | keine Leerzeichen ein.

Ein Beispiel:

OpenDialog1->Filter = ‘Textdateien|*.TXT’

In diesem Fall würde im Filter-Kombinationsfeld beispielsweise der String ‘Textdateien’ angezeigt.

So können Sie der Eigenschaft Filter Werte für mehrere Dateitypen zuweisen:

1	Geben Sie wie im obigen Beispiel einen Dateifilter ein.

2	Geben Sie den nächsten Dateifilter ein. Trennen Sie mit dem Zeichen | den zweiten vom ersten Dateifilter.

3	Geben Sie beliebig viele weitere Dateifilter ein, jeweils getrennt durch das Zeichen |.

Sie können mehrere Dateifilter mit Platzhaltern angeben, wenn Sie sie mit Semikolons voneinander trennen.


TFilterComboBox::Mask

TFilterComboBox

Die Eigenschaft Mask gibt den String zurück, der im Kombinationsfeld als Filter ausgewählt wurde.

__property System::AnsiString Mask;


Ereignisse von TFilterComboBox

TFilterComboBox	Alphabetisch	Legende

In TFilterComboBox

OnChange

Abgeleitet von TCustomComboBox

OnDropDown

Abgeleitet von TWinControl

OnEnter

OnExit

OnKeyDown

OnKeyPress

OnKeyUp

Abgeleitet von TControl

OnClick

OnDblClick

OnDragDrop

OnDragOver

OnEndDrag

OnStartDrag


Ereignisse von TFilterComboBox

TFilterComboBox	Nach Objekten	Legende

OnChange

OnClick

OnDblClick

OnDragDrop

OnDragOver

OnDropDown

OnEndDrag

OnEnter

OnExit

OnKeyDown

OnKeyPress

OnKeyUp

OnStartDrag


TFilterComboBox::OnChange

TFilterComboBox

Das Ereignis OnChange tritt ein, wenn sich der Inhalt des Kombinationsfeldes ändert.

typedef void __fastcall (__closure *TNotifyEvent)(System::TObject* Sender);

__property Classes::TNotifyEvent OnChange;

Mit OnChange können Sie spezielle Aktionen durchführen, wenn sich der Inhalt des Kombinationsfeldes ändert.


Methoden von TFilterComboBox

TFilterComboBox	Alphabetisch

In TFilterComboBox

TFilterComboBox

Abgeleitet von TCustomComboBox

Clear

SelectAll

Abgeleitet von TWinControl

Broadcast

CanFocus

ContainsControl

ControlAtPos

DisableAlign

EnableAlign

Focused

GetTabOrderList

HandleAllocated

HandleNeeded

InsertControl

Invalidate

PaintTo

Realign

RemoveControl

Repaint

ScaleBy

ScrollBy

SetBounds

SetFocus

Update

UpdateControlState

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

GetTextLen

Hide

Perform

Refresh

ScreenToClient

SendToBack

SetTextBuf

Show

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TFilterComboBox

TFilterComboBox	Nach Objekten

Assign

BeginDrag

BringToFront

Broadcast

CanFocus

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

Clear

ClientToScreen

ContainsControl

ControlAtPos

DefaultHandler

DestroyComponents

Destroying

DisableAlign

Dispatch

DragDrop

Dragging

EnableAlign

EndDrag

FieldAddress

FindComponent

Focused

FreeInstance

FreeNotification

Free

GetParentComponent

GetTabOrderList

GetTextBuf

GetTextLen

HandleAllocated

HandleNeeded

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InsertControl

InstanceSize

Invalidate

MethodAddress

MethodName

NewInstance

PaintTo

Perform

Realign

Refresh

RemoveComponent

RemoveControl

Repaint

ScaleBy

ScreenToClient

ScrollBy

SelectAll

SendToBack

SetBounds

SetFocus

SetTextBuf

Show

TFilterComboBox

UpdateControlState

Update


~TFilterComboBox

Der Destruktor ~TFilterComboBox gibt den Speicher frei, der für das TFilterComboBox-Objekt reserviert war. Rufen Sie ~TFilterComboBox nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TFilterComboBox automatisch aufgerufen wird.

__fastcall virtual ~TFilterComboBox(void);


TFilterComboBox::TFilterComboBox

TFilterComboBox

Der Konstruktor TFilterComboBox erzeugt ein neues TFilterComboBox-Objekt.

__fastcall virtual TFilterComboBox(Classes::TComponent* AOwner);


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TControl

TWinControl

TCustomComboBox


TFilterComboBox Beispiel

TFilterComboBox


TFolderBitmap

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/filectrl.hpp

TFolderBitmap wird für Bitmaps verwendet, die in Verzeichnis-Listenfeldern geöffnete, geschlossene und aktuelle Ordner darstellen.

Beschreibung

TFolderBitmap wird für Ordnersymbole verwendet, die in einem Listenfeld Verzeichnisse repräsentieren.


Eigenschaften von TFolderBitmap

TFolderBitmap	Alphabetisch	Legende

Abgeleitet von TBitmap

Canvas

Empty

Handle

Height

IgnorePalette

Monochrome

Palette

TransparentColor

Width

Abgeleitet von TGraphic

Modified


Eigenschaften von TFolderBitmap

TFolderBitmap	Nach Objekten	Legende

Canvas

Empty

Handle

Height

IgnorePalette

Modified

Monochrome

Palette

TransparentColor

Width


Ereignisse von TFolderBitmap

TFolderBitmap	Alphabetisch

Abgeleitet von TGraphic

OnChange


Ereignisse von TFolderBitmap

TFolderBitmap	Nach Objekten

OnChange


Methoden von TFolderBitmap

TFolderBitmap	Alphabetisch

In TFolderBitmap

~TFolderBitmap

TFolderBitmap

Abgeleitet von TBitmap

Assign

Dormant

FreeImage

LoadFromClipboardFormat

LoadFromResourceID

LoadFromResourceName

LoadFromStream

ReleaseHandle

ReleasePalette

SaveToClipboardFormat

SaveToStream

Abgeleitet von TGraphic

LoadFromFile

SaveToFile

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TFolderBitmap

TFolderBitmap	Nach Objekten

~TFolderBitmap

Assign

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

Dormant

FieldAddress

FreeImage

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

LoadFromClipboardFormat

LoadFromFile

LoadFromResourceID

LoadFromResourceName

LoadFromStream

MethodAddress

MethodName

NewInstance

ReleaseHandle

ReleasePalette

SaveToClipboardFormat

SaveToFile

SaveToStream

TFolderBitmap


TFolderBitmap::~TFolderBitmap

TFolderBitmap

Der Destruktor ~TFolderBitmap gibt den Speicher frei, der für das TFolderBitmap-Objekt reserviert war. Rufen Sie ~TFolderBitmap nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TFolderBitmap automatisch aufgerufen wird.

__fastcall virtual ~TFolderBitmap(void);


TFolderBitmap::TFolderBitmap

TFolderBitmap

Der Konstruktor TFolderBitmap erzeugt ein neues TFolderBitmap-Objekt.

__fastcall TFolderBitmap(void);

Beschreibung

Mit TFolderBitmap können Sie zur Laufzeit ein Ordnersymbol erzeugen.

TFolderBitmap weist dem Ordnersymbol Speicher zu und ruft den Konstruktor des übergeordneten Objekts auf. Anschließend werden dem Ordnersymbol Höhe und Breite zugewiesen.


Zugriff

Read-only


Hierarchie

TObject

TPersistent

TGraphic

TBitmap


TFolderBitmap Beispiel

TFolderBitmap


TFont

Hierarchie	Eigenschaften	Methoden	Ereignisse

Header

vcl/graphics.hpp

Mit einem Objekt der Klasse TFont können Sie das Aussehen eines Textes festlegen. TFont kapselt eine HFONT-Struktur von Windows.

Ein TFont-Objekt definiert einen Zeichensatz. Dazu wird dessen Höhe, der Name der Schriftart usw. angegeben. Die Höhe wird in der Eigenschaft Height festgelegt. Die Schriftart wird in der Eigenschaft Name angegeben. Die Größe in Punkt wird in der Eigenschaft Size festgelegt. Die Farbe wird von der Eigenschaft Color definiert. Die Attribute der Schriftart (fett, kursiv usw.) können mit der Eigenschaft Style festgelegt werden.

Sobald eine Schriftart geändert wird, wird das Ereignis OnChange ausgelöst.

Zusätzlich zu den folgenden Eigenschaften, Methoden und Ereignissen enthält dieses Objekt die Methoden, die allen Objekten gemeinsam sind. Ein TFont-Objekt ist ein indirekter Nachkomme von TPersistent.


Eigenschaften von TFont

TFont	Alphabetisch	Legende

In TFont

Color

Handle

Height

Name

Pitch

PixelsPerInch

Size

Style


Eigenschaften von TFont

TFont	Nach Objekten	Legende

Color

Handle

Height

Name

Pitch

PixelsPerInch

Size

Style


TFont::Color

TFont

Die Eigenschaft Color bestimmt die Farbe des Textes.

__property TColor Color;

Im folgenden sind die möglichen Farbwerte aufgeführt:

Wert	Bedeutung

clBlack	Schwarz

clMaroon	Rotbraun

clGreen	Grün

clOlive	Olivgrün

clNavy	Marineblau

clPurple	Violett

clTeal	Blaugrün

clGray	Grau

clSilver	Silbergrau

clRed	Rot

clLime	Limonengrün

clBlue	Blau

clFuchsia	Pink

clAqua	Türkis

clWhite	Weiß

clBackground	Aktuelle Hintergrundfarbe von Windows

clActiveCaption	Aktuelle Farbe der Titelleiste des aktiven Fensters

clInactiveCaption	Aktuelle Farbe der Titelleiste von inaktiven Fenstern

clMenu	Aktuelle Hintergrundfarbe von Menüs

clWindow	Aktuelle Hintergrundfarbe von Fenstern

clWindowFrame	Aktuelle Farbe von Fensterrahmen

clMenuText	Aktuelle Textfarbe in Menüs

clWindowText	Aktuelle Farbe von Text in Fenstern

clCaptionText	Aktuelle Farbe des Textes in der Titelleiste des aktiven Fensters

clActiveBorder	Aktuelle Farbe des Rahmens des aktiven Fensters

clInactiveBorder	Aktuelle Farbe des Rahmens von inaktiven Fenstern

clAppWorkSpace	Aktuelle Farbe des Arbeitsbereichs der Anwendung

clHighlight	Aktuelle Hintergrundfarbe von markiertem Text

clHightlightText	Aktuelle Farbe von markiertem Text

clBtnFace	Aktuelle Farbe einer Schaltfläche

clBtnShadow	Aktuelle Farbe des Schattens einer Schaltfläche

clGrayText	Aktuelle Farbe eines abgedunkelten Textes

clBtnText	Aktuelle Farbe von Text in einer Schaltfläche

clInactiveCaptionText	Aktuelle Farbe des Textes in der Titelleiste eines inaktiven Fensters

clBtnHighlight	Aktuelle Farbe der Markierung in einer Schaltfläche

cl3DDkShadow 	Nur bei Windows 95: Schatten für dreidimensionale Anzeigeelemente

cl3DLight 	Nur bei Windows 95: Farbe für dreidimensionale Anzeigeelemente (für Kanten, die der Lichtquelle zugewandt sind)

clInfoText 	Nur bei Windows 95: Textfarbe für Tool-Tip-Steuerelemente

clInfoBk 	Nur bei Windows 95: Hintergrundfarbe für Tool-Tip-Steuerelemente

Bei der zweiten Hälfte der hier aufgeführten Farben handelt es sich um die Systemfarben von Windows. Die angezeigte Farbe hängt vom Farbschema ab, das aktuell in Windows eingestellt ist. Mit Hilfe der Systemsteuerung können diese Farben geändert werden. Die tatsächlich angezeigte Farbe ist von System zu System verschieden. Beispielsweise können Farben im violetten Bereich einen unterschiedlichen Anteil an Blau enthalten.


TFont::Handle

TFont	Beispiel

Mit der Eigenschaft Handle können Sie auf das Schriften-Handle der Windows-GDI zugreifen.

__property HFONT Handle;

Falls Sie eine Funktion der Windows-API benötigen, die das Handle eines Schriftobjekts erfordert, können Sie das Handle von der Eigenschaft Handle eines TFont-Objekts übernehmen.


TFont::Height

TFont	Beispiel

Die Eigenschaft Height bestimmt die Höhe der Schrift.

__property int Height;

Height bezeichnet die Höhe der Schrift. Bei dieser handelt es sich um die Größe der Schrift ohne den internen Abstand am oberen Rand der Schrift. Mit der Eigenschaft Height können Sie die Höhe einer Schrift in Pixel festlegen. Wenn für Sie die Größe der Schrift in Punkt entscheidender ist, verwenden Sie statt Height die Eigenschaft Size. In einer Anwendung wird die Schriftgröße vom Benutzer normalerweise in Punkt angegeben. Programmierer hingegen befassen sich bei der Anzeige einer Schrift auf dem Bildschirm normalerweise mit der tatsächlichen Größe der Schrift in Pixeln. In dieser ist der interne Abstand enthalten.

In Borland C++Builder wird der Wert der Eigenschaft Height mit folgender Formel bestimmt:

Font->Height = -Font->Size * 72 / Font->PixelsPerInch

Wenn Sie daher für die Eigenschaft Height einen positiven Wert eingeben, wird die Eigenschaft Size der Schrift in eine negative Zahl umgewandelt. Wenn Sie im Gegensatz dazu für die Eigenschaft Size einen positiven Wert eingeben, ergibt sich für die Eigenschaft Height der Schrift eine negative Zahl. Ein positiver Wert für Height enthält den internen Abstand. In einem negativen Wert ist dieser nicht enthalten.


TFont::Name

TFont	Beispiel

Die Eigenschaft Name bezeichnet die Schriftart.

__property TFontName Name;


TFont::Pitch

TFont

Die Eigenschaft Pitch bestimmt den Zeichenabstand einer Schrift.

__property TFontPitch Pitch;

Die Eigenschaft Pitch enthält den für eine Schriftart charakteristischen Zeichenabstand. Zeichen mit verschiedenem Zeichenabstand sind verschieden breit. Die folgenden Zeichen sind in einer Schrift mit variablem Zeichenabstand gesetzt. Beachten Sie, daß die Breite von zehn 'i' kleiner ist als die Breite von zehn 'M'.

iiiiiiiiii

MMMMMMMMMM

Die folgenden Zeichen sind in einer Schrift mit festem Zeichenabstand gesetzt. Zehn 'i' haben dabei dieselbe Breite wie zehn 'M':

iiiiiiiiii

MMMMMMMMMM

Im folgenden finden Sie die möglichen Werte für Pitch:

Wert	Bedeutung

fpDefault	Der Zeichenabstand wird auf den Standardwert eingestellt. Dieser hängt von der Schriftart ab, die in der Eigenschaft Name festgelegt wurde.

fpFixed	Der Zeichenabstand wird auf einen festen Wert eingestellt. Alle Zeichen der Schrift haben dieselbe Breite.

fpVariable	Der Zeichenabstand wird auf variable Werte eingestellt. Alle Zeichen der Schrift haben verschiedene Breiten.


TFont::PixelsPerInch

TFont

Mit der Eigenschaft PixelsPerInch kann in Borland C++Builder sichergestellt werden, daß die Größe der Schrift beim Kopieren von der Zeichenfläche des Formulars zum Drucker nicht verändert wird.

__property int PixelsPerInch;

Falls beispielsweise die Schriftgröße auf dem Bildschirm 8 Punkt beträgt, hat sie beim Drucken ebenfalls die Größe 8 Punkt. Die Eigenschaft PixelsPerInch wirkt sich nur auf Druckerschriften aus und sollte nicht geändert werden.

Mit den Eigenschaften Size und Height können Sie die Größe einer Schrift ändern.


TFont::Size

TFont

Die Eigenschaft Size bestimmt die Größe der Schrift in Punkt.

__property int Size;

Bemessen Sie die Höhe der Schrift einschließlich des internen Abstands der Schrift. Wenn für Sie die Höhe der Schrift auf dem Bildschirm (die Anzahl der Pixel) von Bedeutung ist, verwenden Sie statt dessen die Eigenschaft Height. Mit der Eigenschaft Size können Sie die Höhe einer Schrift in Punkt festlegen.

In Borland C++Builder wird Size mit folgender Formel berechnet:

Font->Size = -Font->Height * Font->PixelsPerInch / 72

Wenn Sie daher in der Eigenschaft Size eine Größe in Punkt eingeben, wird die Eigenschaft Height in einen negativen Wert umgewandelt. Wenn Sie im Gegensatz dazu für die Eigenschaft Height einen positiven Wert eingeben, ergibt sich für die Eigenschaft Size der Schrift ein negativer Wert.


TFont::Style

TFont

Mit der Eigenschaft Style können Sie bestimmen, ob die Schrift normal, kursiv, unterstrichen, fett usw. angezeigt wird.

__property TFontStyles Style;

Im folgenden finden Sie die möglichen Werte von Style:

Wert	Bedeutung

fsBold	Die Schrift wird fett angezeigt.

fsItalic	Die Schrift wird kursiv angezeigt.

fsUnderline	Die Schrift wird unterstrichen.

fsStrikeout	Die Schrift wird durchgestrichen.

Bei der Eigenschaft Style handelt es sich um eine Menge. Sie kann daher mehrere Werte enthalten. Eine Schrift kann beispielsweise fett und kursiv angezeigt werden.


Ereignisse von TFont

TFont	Alphabetisch

Abgeleitet von TGraphicsObject

OnChange


Ereignisse von TFont

TFont	Nach Objekten

OnChange


Methoden von TFont

TFont	Alphabetisch

In TFont

~TFont

Assign

TFont

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TFont

TFont	Nach Objekten

~TFont

Assign

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance

TFont


TFont::~TFont

TFont

Der Destruktor ~TFont gibt den Speicher frei, der für das TFont-Objekt reserviert war. Rufen Sie ~TFont nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TFont automatisch aufgerufen wird.

__fastcall virtual ~TFont(void);


TFont::Assign

TFont

virtual void __fastcall Assign(Classes::TPersistent* Source);


TFont::TFont

TFont

Der Konstruktor TFont erzeugt ein neues TFont-Objekt.

__fastcall TFont(void);


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TGraphicsObject


TFont Beispiel

TFont


 TFontDialog

Hierarchie	Eigenschaften	Methoden	Ereignisse

Header

vcl/dialogs.hpp

Mit TFontDialog können Sie ein Dialogfeld zur Auswahl einer Schrift erstellen.

Beschreibung

Mit TFontDialog können Sie ein Windows-Dialogfeld zur Auswahl von Schriften anzeigen. Das Dialogfeld wird erst sichtbar, wenn es mit der Methode Execute aktiviert wird. Sobald vom Benutzer eine Schrift ausgewählt und auf OK geklickt wurde, wird das Dialogfeld geschlossen, und die ausgewählte Schrift wird in der Eigenschaft Font gespeichert.


Eigenschaften von TFontDialog

TFontDialog	Alphabetisch	Legende

In TFontDialog

Device

Font

MaxFontSize

MinFontSize

Options

Abgeleitet von TCommonDialog

Ctl3D

Handle

HelpContext

StaticRect

Template

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Name

Owner

Tag


Eigenschaften von TFontDialog

TFontDialog	Nach Objekten	Legende

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

Ctl3D

DesignInfo

Device

Font

Handle

HelpContext

MaxFontSize

MinFontSize

Name

Options

Owner

StaticRect

Tag

Template


TFontDialog::Device

TFontDialog

Mit der Eigenschaft Device können Sie das Gerät wählen, dessen Liste mit verfügbaren Schriften abgerufen werden soll.

__property TFontDialogDevice Device;

Beschreibung

Im folgenden finden Sie die möglichen Werte von Device:

Wert	Bedeutung

fdScreen	Die Schriften werden vom Bildschirm abgerufen.

fdPrinter	Die Schriften werden vom Drucker abgerufen.

fdBoth	Die Schriften werden sowohl vom Bildschirm als auch vom Drucker abgerufen.


TFontDialog::Font

TFontDialog	Siehe auch

Mit der Eigenschaft Font können Sie die ausgewählte Schrift ermitteln.

__property Graphics::TFont* Font;

Beschreibung

Sobald vom Benutzer im Dialogfeld eine Schrift ausgewählt und auf OK geklickt wurde, wird die ausgewählte Schrift in der Eigenschaft Font gespeichert. Um beim öffnen des Dialogfeldes eine Standardschrift anzuzeigen, weisen Sie der Eigenschaft Font im Objektinspektor oder im Programm einen Wert zu.


TFontDialog::MaxFontSize

TFontDialog	Siehe auch

Mit der Eigenschaft MaxFontSize können Sie die maximale Schriftgröße bestimmen, die im Dialog für Schriften verfügbar ist.

__property int MaxFontSize;

Beschreibung

Mit MaxFontSize können Sie die im Dialogfeld verfügbare Schriftgröße begrenzen.

Hinweis

MaxFontSize hat nur eine Funktion, wenn in Options das Flag fdLimitSize eingestellt wurde.


TFontDialog::MinFontSize

TFontDialog	Siehe auch

Mit der Eigenschaft MinFontSize können Sie die minimale Schriftgröße bestimmen, die im Dialog für Schriften verfügbar ist.

__property int MinFontSize;

Beschreibung

Mit MinFontSize können Sie die im Dialogfeld verfügbare Schriftgröße begrenzen.

Hinweis

MinFontSize hat nur eine Funktion, wenn in Options das Flag fdLimitSize eingestellt wurde.


TFontDialog::Options

TFontDialog	Siehe auch

Mit der Eigenschaft Options können Sie das Aussehen und das Verhalten des Dialogfeldes für Schriften bestimmen.

__property TFontDialogOptions Options;

Beschreibung

Mit der Eigenschaft Options können Sie das Erscheinungsbild und die Funktionalität des Dialogfeldes anpassen. Im folgenden finden Sie die möglichen Werte von Options:

Wert	Bedeutung

fdAnsiOnly	Es werden nur Schriften angezeigt, die den Windows-Zeichensatz verwenden. Symbolschriften werden im Dialogfeld nicht aufgeführt.

fdApplyButton	Im Dialogfeld wird eine Schaltfläche zum Zuweisen angezeigt. Dies geschieht unabhängig davon, ob eine entsprechende Ereignisbehandlungsroutine existiert.

fdEffects	Im Dialogfeld werden die Kontrollfelder für die Effekte (Durchstreichen und Unterstreichen) sowie das Listenfeld zur Farbauswahl angezeigt.

fdFixedPitchOnly	Im Dialogfeld werden nur Schriften mit festem Zeichenabstand angezeigt. Die Schriftarten mit variablemZeichenabstand werden nicht aufgeführt.

fdForceFontExist	Der Benutzer kann nur Schriften eingeben, die im Dialogfeld angezeigt werden (das heißt die Schriften, die im Kombinationsfeld Schriftart aufgeführt sind). Wird der Name einer anderen Schriftart eingegeben, wird eine Fehlermeldung angezeigt.

fdLimitSize	Die Eigenschaften MaxFontSize und MinFontSize werden aktiviert. Mit diesen Eigenschaften können Sie die im Dialogfeld angezeigte Schriftgröße auf einen Bereich beschränken.

fdNoFaceSel	Das Dialogfeld wird geöffnet, ohne daß eine vorgegebene Schriftart im Kombinationsfeld angezeigt wird.

fdNoOEMFonts	Die OEM-Schriften werden aus dem Kombinationsfeld des Dialogfeldes entfernt. Nur die restlichen Schriften werden angezeigt.

fdScalableOnly	Im Dialogfeld werden nur die skalierbaren Schriften angezeigt. Die nicht skalierbaren Schriften werden aus der Liste entfernt.

fdNoSimulations	Die GDI-Schriften werden aus dem Kombinationsfeld des Dialogfeldes entfernt. Nur die restlichen Schriften werden angezeigt.

fdNoSizeSel	Das Dialogfeld wird geöffnet, und im entsprechenden Kombinationsfeld wird eine vorgegebene Schriftart angezeigt.

fdNoStyleSel	Das Dialogfeld wird geöffnet, ohne daß im entsprechenden Kombinationsfeld ein vorgegebener Stil angezeigt wird.

fdNoVectorFonts	Die Vektorschriften werden aus dem Kombinationsfeld des Dialogfeldes entfernt. Nur die restlichen Schriften werden angezeigt.

fdShowHelp	Im Dialogfeld wird die Schaltfläche Hilfe angezeigt.

fdTrueTypeOnly	Im Dialogfeld werden nur die TrueType-Schriften angezeigt. Die anderen Schriftarten werden nicht aufgeführt.

fdWysiwyg	Es werden nur die Schriften angezeigt, die sowohl im Drucker als auch am Bildschirm verfügbar sind. Die anderen Schriften werden im Dialogfeld nicht aufgeführt.

Standardmäßig ist nur die Option fdEffects aktiviert.


Ereignisse von TFontDialog

TFontDialog	Alphabetisch	Legende

In TFontDialog

OnApply


Ereignisse von TFontDialog

TFontDialog	Nach Objekten	Legende

OnApply


TFontDialog::OnApply

TFontDialog	Siehe auch

Das Ereignis OnApply wird ausgelöst, wenn auf die Schaltfläche Übernehmen geklickt wird.

__property TFDApplyEvent OnApply;

Beschreibung

Falls dem Ereignis OnApply eine Ereignisbehandlungsroutine zugewiesen wurde, oder falls in Options das Flag fdApplyButton aktiviert wurde, wird im Dialogfeld eine Schaltlfäche Übernehmen angezeigt. Mit einer Ereignisbehandlungsroutine für OnApply können Sie die ausgewählte Schrift zuweisen, ohne das Dialogfeld zu schließen.


Methoden von TFontDialog

TFontDialog	Alphabetisch

In TFontDialog

~TFontDialog

Execute

TFontDialog

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TFontDialog

TFontDialog	Nach Objekten

~TFontDialog

Assign

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

DestroyComponents

Destroying

Dispatch

Execute

FieldAddress

FindComponent

FreeInstance

FreeNotification

Free

GetParentComponent

HasParent

InheritsFrom

InitInstance

InsertComponent

InstanceSize

MethodAddress

MethodName

NewInstance

RemoveComponent

TFontDialog


TFontDialog::~TFontDialog

TFontDialog	Siehe auch

Der Destruktor ~TFontDialog gibt den Speicher frei, der für das TFontDialog-Objekt reserviert war. Rufen Sie ~TFontDialog nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TFontDialog automatisch aufgerufen wird.

__fastcall virtual ~TFontDialog(void);


TFontDialog::Execute

TFontDialog

Mit der Methode Execute wird das Dialogfeld zur Schriftauswahl angezeigt.

bool __fastcall Execute(void);

Beschreibung

Mit Execute können Sie das Dialogfeld zur Schriftauswahl öffnen. Nachdem eine Schriftart ausgewählt und auf OK geklickt wurde, wird der Wert True zurückgegeben.


TFontDialog::TFontDialog

TFontDialog

TFontDialog erzeugt und initialisiert eine Instanz der Klasse TFontDialog.

__fastcall virtual TFontDialog(Classes::TComponent* AOwner);

Beschreibung

Mit der Methode TFontDialog können Sie eine Instanz von TFontDialog erstellen. Das neue Dialogfeld erscheint zur Laufzeit erst dann im Formular, wenn die Methode Execute aufgerufen wird.


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TCommonDialog


TFontDialog Beispiel

TFontDialog


TForm

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/forms.hpp

Bei TForm handelt es sich um die Komponente für ein Standard-Anwendungsfenster (Formular).

Beschreibung

Mit TForm können Sie ein Formular wie ein Hauptfenster, ein Dialogfeld oder ein untergeordnetes MDI-Fenster erstellen. Das Formular kann andere Objekte wie TButton-, TCheckBox- und TComboBox-Objekte enthalten.

Formulare können auch TLoginDialog- und TPasswordDialog-Objekte enthalten.


Eigenschaften von TForm

TForm	Alphabetisch	Legende

In TForm

Active

ActiveControl

ActiveMDIChild

ActiveOleControl

BorderIcons

BorderStyle

Canvas

ClientHandle

ClientHeight

ClientWidth

Designer

DropTarget

FormStyle

Icon

IgnoreFontProperty

KeyPreview

MDIChildCount

MDIChildren

Menu

ModalResult

ObjectMenuItem

OleFormObject

PixelsPerInch

Position

PrintScale

Scaled

TileMode

Visible

WindowMenu

WindowState

Abgeleitet von TScrollingWinControl

AutoScroll

HorzScrollBar

VertScrollBar

Abgeleitet von TWinControl

Brush

ClientOrigin

ControlCount

Controls

Ctl3D

Handle

HelpContext

ImeMode

ImeName

Showing

TabOrder

TabStop

Abgeleitet von TControl

Align

BoundsRect

Caption

ClientRect

Color

ControlState

ControlStyle

Cursor

Enabled

Font

Height

Hint

Left

Name

PopupMenu

ShowHint

Top

Width

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TForm

TForm	Nach Objekten	Legende

ActiveControl

ActiveMDIChild

ActiveOleControl

Active

Align

AutoScroll

BorderIcons

BorderStyle

BoundsRect

Brush

Canvas

Caption

ClientHandle

ClientHeight

ClientOrigin

ClientRect

ClientWidth

Color

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlCount

ControlState

Controls

ControlStyle

Ctl3D

Cursor

Designer

DesignInfo

DropTarget

Enabled

Font

FormStyle

Handle

Height

HelpContext

Hint

HorzScrollBar

Icon

IgnoreFontProperty

ImeMode

ImeName

KeyPreview

Left

MDIChildCount

MDIChildren

Menu

ModalResult

Name

ObjectMenuItem

OleFormObject

Owner

PixelsPerInch

PopupMenu

Position

PrintScale

Scaled

ShowHint

Showing

TabOrder

TabStop

Tag

TileMode

Top

VertScrollBar

Visible

Width

WindowMenu

WindowState


TForm::Active

TForm	Siehe auch

Mit dem booleschen Wert der Eigenschaft Active wird festgelegt, ob das Formular den Fokus hat.

__property bool Active;

Beschreibung

Mit Active können Sie ermitteln, ob das Formular den Fokus hat.

Hat Active den Wert True, besitzt das Formular den Fokus, andernfalls nicht.


TForm::ActiveControl

TForm	Siehe auch

Die Eigenschaft ActiveControl ist das Steuerelement, das den Fokus besitzt.

__property Controls::TWinControl* ActiveControl;

Beschreibung

Mit ActiveControl können Sie das Steuerelement ermitteln oder festlegen, das den Fokus besitzt.

Besitzt das Formular den Fokus nicht, erhält das in ActiveControl angegebene Steuerelement im Formular den Fokus, sobald das Formular den Fokus empfängt.

Hinweis

Wird der Fokus einem anderen Steuerelement zugewiesen, wird ActiveControl vor dem Auslösen des Ereignisses OnExit aktualisiert.

In der Anwendung kann zu einem bestimmten Zeitpunkt nur ein Steuerelement den Fokus besitzen.


TForm::ActiveMDIChild

TForm	Siehe auch

Bei der Eigenschaft ActiveMDIChild handelt es sich um das untergeordnete MDI-Fenster, das den Fokus hat.

__property TForm* ActiveMDIChild;

Beschreibung

Mit ActiveMDIChild können Sie das untergeordnete MDI-Fenster ermitteln, das den Fokus besitzt.

Ist das Formular kein übergeordnetes MDI-Fenster (das ist der Fall, wenn die Eigenschaft FormStyle nicht den Wert fsMDIForm hat), gibt ActiveMDIChild den Wert NULL zurück.


TForm::ActiveOleControl

TForm	Siehe auch

Bei der Eigenschaft ActiveOLEControl handelt es sich um ein OLE-Steuerelement im Formular, das auf €nderungen des Fokus reagiert.

__property Controls::TWinControl* ActiveControl;

Beschreibung

Mit ActiveOLEControl können Sie ein OLE-Steuerelement im Formular ermitteln oder einstellen, das auf €nderungen des Fokus reagiert.

Hat ActiveOLEControl nicht den Wert NULL, ist die Benutzeroberfläche für das angegebene OLE-Steuerelement deaktiviert, wenn es nicht den Fokus hat. Ebenso wird das Dokumentenfenster für das angegebene OLE-Steuerelement aktiviert bzw. deaktiviert, wenn das Formular den Fokus erhält bzw. abgibt.


TForm::BorderIcons

TForm

Bei der Eigenschaft BorderIcons handelt es sich um eine Wertemenge, die festlegt, welche Symbole in der Titelleiste des Formulars angezeigt werden.

__property TBorderIcons BorderIcons;

Beschreibung

Mit BorderIcons können Sie die Symbole ermitteln oder einstellen, die in der Titelleiste des Formulars angezeigt werden. BorderIcons kann folgende TBorderIcons-Werte enthalten:

Wert	Beschreibung

biSystemMenu	Das Formular hat ein Systemmenü.

biMinimize	Das Formular hat eine Schaltfläche zum Verkleinern des Formulars zum Symbol.

biMaximize	Das Formular hat eine Schaltfläche zum Vergrößern des Formulars zum Vollbild.

biHelp	Das Formular zeigt Hilfe in Popup-Fenstern an, nicht in einem Hilfefenster. Sind biMinimize und biMaximize nicht enthalten, wird ein Fragezeichen in der Titelleiste des Formulars angezeigt.


TForm::BorderStyle

TForm	Beispiel

Bei der Eigenschaft BorderStyle handelt es sich um eine Wertemenge, die das Aussehen und das Verhalten des Formularrahmens bestimmt.

__property TFormBorderStyle BorderStyle;

Beschreibung

Mit BorderStyle können Sie das Aussehen und Verhalten des Formularrahmen ermitteln und einstellen. BorderStyle kann folgende TFormBorderStyle-Werte enthalten:

Wert	Beschreibung

bsDialog	In der Größe unveränderlicher Standardrahmen für Dialogfelder

bsSingle	In der Größe unveränderlicher Rahmen (einzelne Linie)

bsNone	In der Größe unveränderliche nicht sichtbare Rahmenlinie

bsSizeable	In der Größe veränderlicher Rahmen ($$Voreinstellung)

bsToolWindow	Rahmen wie bei bsSingle, aber mit kleinerem Titel

bsSizeToolWin	Rahmen wie bei bsSizeable, aber mit kleinerem Titel

Hinweis

Dem Rahmenstil eines untergeordneten MDI-Formulars können die Werte bsDialog oder bsNone nicht zugewiesen werden.


TForm::Canvas

TForm	Siehe auch

Die Eigenschaft Canvas repräsentiert die Zeichenfläche der Anwendung.

__property Graphics::TCanvas* Canvas;

Beschreibung

Mit Canvas können Sie die Zeichenfläche der Anwendung ermitteln. Canvas wird häufig in der Ereignisbehandlungsroutine für OnPaint verwendet.


TForm::ClientHandle

TForm

Die Eigenschaft ClientHandle ist das Handle (HWND) des internen MDI-Client-Fensters des Formulars.

__property HWND ClientHandle;

Beschreibung

Mit ClientHandle können Sie das Handle des internen MDI-Client-Fensters des Formulars ermitteln.

ClientHandle ist nur von Bedeutung, wenn das Formular ein übergeordnetes MDI-Objekt ist, also der Eigenschaft FormStyle des Formulars der Wert fsMDIForm zugewiesen wurde.


TForm::ClientHeight

TForm	Siehe auch 	Beispiel

Die Eigenschaft ClientHeigt repräsentiert die Höhe (in Pixel) des Client-Bereichs des Formulars.

__property ClientHeight;

Beschreibung

Mit ClientHeight können Sie die Höhe (in Pixel) des Client-Bereichs des Formulars ermitteln oder einstellen. Der Client-Bereich ist der nutzbare Bereich innerhalb des Formularrahmens.


ClientRect

Die Eigenschaft ClientRect repräsentiert den Client-Bereich des Formulars.

Beschreibung

Mit ClientHeight können Sie den Client-Bereich des Formulars ermitteln oder einstellen. Der Client-Bereich ist der nutzbare Bereich innerhalb des Formularrahmens.

ClientRect entspricht Rect(0,0,ClientWidth, ClientHeight).


TForm::ClientWidth

TForm	Siehe auch 	Beispiel

Der Wert der Eigenschaft ClientWidth ist ein Integer, der die Breite des Client-Bereichs des Formulars in Pixel repräsentiert.

__property ClientWidth;

Beschreibung

Mit ClientWidth können Sie die Breite (in Pixel) des Client-Bereichs des Formulars ermitteln oder einstellen. Der Client-Bereich ist der nutzbare Bereich innerhalb des Formularrahmens.


TForm::Designer

TForm	Siehe auch

Die Eigenschaft Designer gibt den Designer für das Formular an.

__property TDesigner* Designer;

Beschreibung

Mit Designer können Sie den Designer für das Formular ermitteln oder einstellen.


TForm::DropTarget

TForm

Der boolesche Wert der Eigenschaft DropTarget gibt an, ob im Formular Objekte abgelegt werden können.

__property bool DropTarget;

Beschreibung

Mit der Eigenschaft DropTarget können Sie ermitteln oder festlegen, ob im Formular Objekte abgelegt werden können.


TForm::FormStyle

TForm

Die Eigenschaft FormStyle enthält eine Wertemenge, die den Stil des Formulars repräsentiert.

__property TFormStyle FormStyle;

Beschreibung

Mit FormStyle können Sie den Stil des Formulars ermitteln oder einstellen. FormStyle kann eine Kombination der folgenden TFormStyle-Werte enthalten:

Wert	Beschreibung

fsNormal	Das Formular ist weder ein übergeordnetes noch ein untergeordnetes MDI-Fenster.

fsMDIChild	Das Formular ist ein untergeordnetes MDI-Fenster.

fsMDIForm	Das Formular ist ein übergeordnetes MDI-Fenster.

fsStayOnTop	Das Formular wird auf anderen Formularen im Projekt angezeigt, sofern deren Eigenschaft FormStyle nicht ebenfalls den Wert fsStayOnTop enthält.

Hinweis

Es ist nicht empfehlenswert, FormStyle zur Laufzeit zu ändern.

Ist das Formular das Hauptformular einer MDI-Anwendung, muß die Eigenschaft FormStyle den Wert fsMDIForm enthalten.


TForm::Icon

TForm

Die Eigenschaft Icon repräsentiert das Symbol des Formulars.

__property Graphics::TIcon* Icon;

Beschreibung

Mit Icon können Sie das Symbol des Formulars ermitteln oder einstellen. Das Symbol des Formulars wird angezeigt, wenn das Formular zum Symbol verkleinert wird.

Hinweis

Ist Icon nicht gesetzt, wird für das Formular das Symbol der Anwendung verwendet.


TForm::IgnoreFontProperty

TForm	Siehe auch

Die Eigenschaft IgnoreFontProperty legt fest, ob Text im Formular mit der Schriftart dargestellt wird, die in der Eigenschaft TControl::Font vorgegeben ist.

__property bool IgnoreFontProperty;


TForm::KeyPreview

TForm	Siehe auch

Mit dem booleschen Wert der Eigenschaft KeyPreview wird angegeben, ob Tastaturereignisse im Formular eintreten sollen, bevor sie im aktiven Steuerelement eintreten.

__property bool KeyPreview;

Beschreibung

Hat die Eigenschaft KeyPreview den Wert True, treten Tastaturereignisse im Formular ein, bevor sie im aktiven Steuerelement eintreten. (Das aktive Steuerelement wird mit der Eigenschaft ActiveControl angegeben.)

Steuertasten (TAB, UMSCHALT+TAB, die Pfeiltasten usw.) werden von KeyPreview nicht beeinflußt, da diese kein Tastaturereignis auslösen.

Hat KeyPreview den Wert False, treten Tastaturereignisse im aktiven Steuerelement ein.

Der Standardwert von KeyPreview ist False.


TForm::MDIChildCount

TForm

Die Eigenschaft MDIChildCount enthält die Anzahl der geöffneten untergeordneten MDI-Formulare.

__property int MDIChildCount;

Beschreibung

Mit der Eigenschaft MDIChildCount können Sie die Anzahl der geöffneten untergeordneten MDI-Formulare ermitteln.

MDIChildCount ist nur von Bedeutung, wenn das Formular ein übergeordnetes MDI-Objekt ist, also der Eigenschaft FormStyle des Formulars der Wert fsMDIForm zugewiesen wurde.


TForm::MDIChildren

TForm

Die Eigenschaft MDIChildren enthält ein Array mit untergeordneten MDI-Formularen.

__property TForm* MDIChildren[int I];

Beschreibung

Mit MDIChildren können Sie auf untergeordnete Formulare zugreifen.

I ist dabei der Index des untergeordneten Formulars, auf das zugegriffen werden soll. Der Index entspricht der Z-Reihenfolge des untergeordneten Formulars, beginnend mit 0. Soll zum Beispiel auf das erste untergeordnete Formular in der Z-Reihenfolge zugegriffen werden, muß I der Wert 0 zugewiesen werden.

MDIChildren ist nur von Bedeutung, wenn das Formular ein übergeordnetes MDI-Formular ist, also der Eigenschaft FormStyle des Formulars der Wert fsMDIForm zugewiesen wurde.


TForm::Menu

TForm	Siehe auch

Die Eigenschaft Menu gibt das Hauptmenü des Formulars an.

__property Menus::TMainMenu* Menu;

Beschreibung

Mit Menu können Sie das Hauptmenü des Formulars ermitteln oder einstellen.

Menu wird die erste TMainMenu-Komponente zugewiesen, die während des Entwurfs dem Formular hinzugefügt wird.


TForm::ModalResult

TForm	Siehe auch	Beispiel

Hat die Eigenschaft ModalResult einen von Null abweichenden Wert, wird das Formular geschlossen, wenn es ein modales Fenster ist.

__property TModalResult ModalResult;

Beschreibung

Mit der Eigenschaft ModalResult können Sie das Formular schließen, wenn es ein modales Fenster ist.

Die Voreinstellung für den Wert der Eigenschaft ModalResult ist 0. Weisen Sie zum Schließen des Formulars ModalResult einen von 0 abweichenden Wert zu. Der ModalResult zugewiesene Wert wird der Rückgabewert des Aufrufs von ShowModal, der der Anzeige des Formulars dient.

ModalResult kann einen der folgenden TModalResult Werte annehmen:

Konstante	Wert

mrNone	0

mrOk	idOK

mrCancel	idCancel

mrAbort	idAbort

mrRetry	idRetry

mrIgnore	idIgnore

mrYes	idYes

mrNo	idNo

mrAll	mrNo + 1


TForm::ObjectMenuItem

TForm

Die Eigenschaft ObjectMenuItem ist ein OLE-Objektmenüelement, das auf das Auswählen eines OLE-Objekts reagiert.

__property Menus::TMenuItem* ObjectMenuItem;

Beschreibung

Mit ObjectMenuItem können Sie ein Menüelement ermitteln oder einstellen, das aktiviert oder deaktiviert wird, wenn ein OLE-Objekt im Formular ausgewählt oder abgewählt wird.

Das OLE-Objektmenüelement kann für Standard-OLE-Befehle wie Activate oder Convert verwendet werden. (Die Implementierung dieser Befehle erfolgt durch den OLE-Server.)


TForm::OleFormObject

TForm

Die Eigenschaft OleFormObject ist ein TOleFormObject-Objekt.

__property TOleFormObject* OleFormObject;


TForm::PixelsPerInch

TForm	Siehe auch

Der Wert der Eigenschaft PixelsPerInch repräsentiert die Proportionen der Schrift auf dem System, auf dem das Formular entworfen wurde.

__property int PixelsPerInch;

Beschreibung

Mit PixelsPerInch können Sie zur Laufzeit die Skalierung des Formulars an die aktuelle Bildschirmauflösung anpassen. Wird die Voreinstellung von PixelsPerInch geändert, hat das Formular nicht unter allen Bildschirmauflösungen die gleichen Proportionen.

Während des Entwurfs wird PixelsPerInch automatisch beim Speichern des Formulars gesetzt. An PixelsPerInch vorgenommene €nderungen im Objektinspektor sind nur zur Laufzeit sichtbar.

Damit PixelsPerInch wirksam werden kann, muß die Eigenschaft Scaled des Formulars den Wert True enthalten.


TForm::Position

TForm	Beispiel

Der Wert der Eigenschaft Position repräsentiert die Größe und die Position des Formulars.

__property TPosition Position;

Beschreibung

Mit der Eigenschaft Position können Sie die Größe und die Position des Formulars ermitteln und einstellen. Position kann einen der folgenden TPosition-Werte enthalten:

Wert	Beschreibung

poDesigned	Das Formular wird in der gleichen Position und mit gleicher Höhe und Breite wie während des Entwurfs angezeigt.

poDefault	Die Position und die Breite und Höhe des Formulars wird durch Windows festgelegt. Bei jedem Ausführen der Anwendung wird das Formularfenster etwas nach rechts unten versetzt angezeigt. Das Formular wird unabhängig von der Bildschirmauflösung immer möglichst am rechten Rand und am unteren Rand des Bildschirms ausgerichtet.

poDefaultPosOnly	Das Formular wird in der Entwurfsgröße angezeigt. Windows legt die Position auf dem Bildschirm fest. Bei jedem Ausführen der Anwendung wird das Formularfenster etwas nach rechts unten versetzt angezeigt. Findet das Formular nicht in voller Größe rechts unten Platz, wird es links oben ausgerichtet.

poDefaultSizeOnly	Das Formular wird in der Entwurfsgröße angezeigt. Windows legt die Position auf dem Bildschirm fest. Das Formular wird unabhängig von der Bildschirmauflösung immer möglichst am rechten Rand und am unteren Rand des Bildschirms ausgerichtet.

poScreenCenter	Das Formular wird in der Mitte des Bildschirms in der Entwurfsgröße angezeigt.


TForm::PrintScale

TForm

Der Wert der Eigenschaft PrintScale repräsentiert die Proportionen für ein gedrucktes Formular.

__property TPrintScale PrintScale;

Beschreibung

Mit der Eigenschaft PrintScale können Sie die Proportionen des gedruckten Formulars ermitteln oder einstellen. PrintScale kann einen der folgenden TPrintScale-Werte enthalten:

Wert	Beschreibung

poNone	Es wird keine spezielle Skalierung verwendet, das Aussehen des gedruckten Formulars und die Anzeige auf dem Bildschirm können voneinander abweichen.

poProportional	Das Formular wird so gedruckt, daß es ungefähr der auf dem Bildschirm angezeigten Größe entspricht (WYSIWYG). Das Formularbild wird so skaliert, daß der Druck ungefähr der auf dem Bildschirm angezeigten Größe entspricht.

poPrintToFit	Das Formular wird unter Beibehaltung der Bildschirmproportionen gedruckt und gegebenenfalls an die Größe der Seite angepaßt.


TForm::Scaled

TForm	Siehe auch

Der boolesche Wert der Eigenschaft Scaled gibt an, ob die Größe des Formulars mit Hilfe des Wertes der Eigenschaft PixelsPerInch skaliert wird.

__property bool Scaled;

Beschreibung

Hat Scaled den Wert True und weicht der Wert von PixelsPerInch von der aktuellen Systemeinstellung ab, wird das Formular auf eine neue Größe skaliert. Es wird keine Skalierung durchgeführt, wenn Scaled den Wert False hat.


TForm::TileMode

TForm	Siehe auch

Der Wert von TileMode repräsentiert die Art, in der ein untergeordnetes MDI-Formular beim Aufruf der Methode Tile angeordnet wird.

__property TTileMode TileMode;

Beschreibung

TileMode kann einen der folgenden TTileMode-Werte enthalten:

Wert	Beschreibung

tbHorizontal	Jedes Formular erstreckt sich über die Breite des übergeordneten Formulars.

tbVertical	Jedes Formular erstreckt sich über Höhe des übergeordneten Formulars.

TileMode ist nur von Bedeutung, wenn das Formular ein untergeordnetes MDI-Objekt ist, also der Eigenschaft FormStyle des Formulars der Wert fsMDIChild zugewiesen wurde.


TForm::Visible

TForm	Siehe auch	Beispiel

Mit dem booleschen Wert der Eigenschaft Visible wird festgelegt, ob das Formular sichtbar ist.

__property Visible;

Beschreibung

Mit Visible können Sie ermitteln oder einstellen, ob das Formular sichtbar ist.

Hat Visible den Wert True, ist das Formular sichtbar, sofern es nicht vollständig durch andere Formulare verdeckt wird. Hat Visible den Wert False, ist das Formular nicht sichtbar.

Sie können Visible den Wert True zuweisen und das Formular in den Vordergrund bringen, indem Sie die Methode Show oder ShowModal aufrufen.


TForm::WindowMenu

TForm

Die Eigenschaft WindowMenu gibt das Menü Fenster für ein übergeordnetes MDI-Formular an.

__property Menus::TMenuItem* WindowMenu;

Beschreibung

Mit WindowMenu können Sie das Menü Fenster für ein übergeordnetes MDI-Formular ermitteln oder einstellen. Das Windows-Menü ist in MDI-Anwendungen ein Standardmenü. Es enthält Befehle für die Verwaltung der Fenster in der Anwendung durch den Benutzer. Es enthält normalerweise die Optionen Überlappend, Nebeneinander, Symbole anordnen usw.

Das Menü führt auch die untergeordneten, aktuell geöffneten Fenster in der Anwendung im unteren Teil des Menüs auf. Wählt der Benutzer eines dieser Fenster im Menü aus, wird es das aktive Fenster in der Anwendung.

Obwohl dieses Menü meistens den Namen Fenster erhält, kann jeder Name verwendet werden, der für ein existierendes Menüelement in der Menüleiste vergeben wurde. Die Namen geöffneter untergeordneter Formulare werden dem Menü zur Laufzeit automatisch hinzugefügt.

WindowMenu ist nur von Bedeutung, wenn das Formular ein übergeordnetes MDI-Objekt ist, also der Eigenschaft FormStyle des Formulars der Wert fsMDIForm zugewiesen wurde.


TForm::WindowState

TForm	Siehe auch

Der Wert des Ereignisses WindowState repräsentiert die Art, in der ein Formular angezeigt wird.

__property TWindowState WindowState;

Beschreibung

Mit WindowMenu können Sie ermitteln oder einstellen, ob das Formulars als Symbol verkleinert, als Vollbild oder in normaler Größe angezeigt wird.

WindowState kann einen der folgenden TWindowState-Werte enthalten:

Wert	Beschreibung

wsNormal	Das Formular wird in normaler Größe angezeigt (nicht als Symbol und nicht als Vollbild).

wsMinimized	Das Formular wird als Symbol angezeigt.

wsMaximized	Das Formular wird als Vollbild angezeigt.


Ereignisse von TForm

TForm	Alphabetisch	Legende

In TForm

OnActivate

OnClose

OnCloseQuery

OnCreate

OnDeactivate

OnDestroy

OnHide

OnPaint

OnResize

OnShow

Abgeleitet von TWinControl

OnKeyDown

OnKeyPress

OnKeyUp

Abgeleitet von TControl

OnClick

OnDblClick

OnDragDrop

OnDragOver

OnMouseDown

OnMouseMove

OnMouseUp


Ereignisse von TForm

TForm	Nach Objekten	Legende

OnActivate

OnClick

OnCloseQuery

OnClose

OnCreate

OnDblClick

OnDeactivate

OnDestroy

OnDragDrop

OnDragOver

OnHide

OnKeyDown

OnKeyPress

OnKeyUp

OnMouseDown

OnMouseMove

OnMouseUp

OnPaint

OnResize

OnShow


TForm::OnActivate

TForm

Das Ereignis OnActivate tritt ein, wenn das Formular den Fokus erhält.

typedef void __fastcall (__closure *TNotifyEvent)(System::TObject* Sender);

__property Classes::TNotifyEvent OnActivate;

Beschreibung

Für OnActivate können Sie eine Ereignisbehandlungsroutine programmieren, die spezielle Aktionen durchführt, wenn das Formular den Fokus erhält.


OnClick

Das Ereignis OnClick tritt ein, wenn auf das Formular geklickt wird.

__property OnClick;

Beschreibung

Mit OnClick können Sie eine Ereignisbehandlungsroutine programmieren, die spezielle Aktionen durchführt, wenn auf das Formular geklickt wird.


TForm::OnClose

TForm

Das Ereignis OnClose tritt ein, wenn das Formular geschlossen wird.

typedef void __fastcall (__closure *TCloseEvent)(System::TObject* Sender, TCloseAction &Action);

__property TCloseEvent OnClose;

Beschreibung

Für OnClose können Sie eine Ereignisbehandlungsroutine programmieren, die spezielle Aktionen durchführt, wenn das Formular geschlossen wird.


TForm::OnCloseQuery

TForm

Das Ereignis OnCloseQuery tritt während des Ereignisses OnClose ein.

typedef void __fastcall (__closure *TCloseQueryEvent)(System::TObject* Sender, bool &CanClose);

__property TCloseQueryEvent OnCloseQuery;

Beschreibung

Mit OnCloseQuery können Sie Bedingungen angeben, unter denen ein Formular geschlossen werden kann.


TForm::OnCreate

TForm

Das Ereignis OnCreate tritt ein, wenn das Formular erstellt wird.

typedef void __fastcall (__closure *TNotifyEvent)(System::TObject* Sender);

__property Classes::TNotifyEvent OnCreate;

Beschreibung

Für OnCreate können Sie eine Ereignisbehandlungsroutine programmieren, die spezielle Aktionen durchführt, wenn das Formular den Fokus erhält.


OnDblClick

Das Ereignis OnDblClick tritt ein, wenn doppelt auf das Formular geklickt wird.

__property OnDblClick;

Beschreibung

Für OnDblClick können Sie eine Ereignisbehandlungsroutine programmieren, die spezielle Aktionen durchführt, wenn doppelt auf das Formular geklickt wird.


TForm::OnDeactivate

TForm

Das Ereignis OnDeactivate tritt ein, wenn das Formular den Fokus abgibt.

typedef void __fastcall (__closure *TNotifyEvent)(System::TObject* Sender);

__property Classes::TNotifyEvent OnDeactivate;

Beschreibung

Für OnDeactivate können Sie eine Ereignisbehandlungsroutine programmieren, die spezielle Aktionen durchführt, wenn das Formular den Fokus abgibt.


TForm::OnDestroy

TForm

Das Ereignis OnDestroy tritt ein, wenn das Formular freigegeben wird.

typedef void __fastcall (__closure *TNotifyEvent)(System::TObject* Sender);

__property Classes::TNotifyEvent OnDestroy;

Beschreibung

Mit OnDestroy können Sie eine Ereignisbehandlungsroutine programmieren, die spezielle Aktionen durchführt, wenn das Formular aufgelöst wird.


OnDragDrop

Das Ereignis OnDragDrop tritt ein, wenn im Formular Objekte abgelegt werden.

__property OnDragDrop;

Beschreibung

Für OnDragDrop können Sie eine Ereignisbehandlungsroutine programmieren, die spezielle Aktionen durchführt, wenn im Formular Objekte abgelegt werden.


OnDragOver

Das Ereignis OnDragOver tritt ein, wenn im Formular eine Ablegeoperation stattfindet.

__property OnDragOver;

Beschreibung

Für OnDragOver können Sie eine Ereignisbehandlungsroutine programmieren, die spezielle Aktionen durchführt, wenn im Formular eine Ablegeoperation stattfindet.


TForm::OnHide

TForm

Das Ereignis OnHide tritt ein, wenn das Formular verborgen wird, also die Eigenschaft Visible des Formulars den Wert False hat.

typedef void __fastcall (__closure *TNotifyEvent)(System::TObject* Sender);

__property Classes::TNotifyEvent OnHide;

Beschreibung

Für OnHide können Sie eine Ereignisbehandlungsroutine programmieren, die spezielle Aktionen durchführt, wenn das Formular ausgeblendet ist, also die Eigenschaft Visible des Formulars der Wert False zugewiesen wird.


OnKeyDown

Das Ereignis OnKeyDown tritt ein, wenn eine Taste gedrückt gehalten wird, während das Formular den Fokus hat.

__property OnKeyDown;

Beschreibung

Für OnKeyDown können Sie eine Ereignisbehandlungsroutine programmieren, die spezielle Aktionen durchführt, wenn eine Taste gedrückt gehalten wird, während das Formular den Fokus hat.


OnKeyPress

Das Ereignis OnKeyPress tritt ein, wenn eine Taste gedrückt wird, während das Formular den Fokus hat.

__property OnKeyPress;

Beschreibung

Für OnKeyPress können Sie eine Ereignisbehandlungsroutine programmieren, die spezielle Aktionen durchführt, wenn eine Taste gedrückt wird, während das Formular den Fokus hat.


OnKeyUp

Das Ereignis OnKeyUp tritt ein, wenn eine Taste losgelassen wird, während das Formular den Fokus hat.

__property OnKeyUp;

Beschreibung

Für OnKeyUp können Sie eine Ereignisbehandlungsroutine programmieren, die spezielle Aktionen durchführt, wenn eine Taste losgelassen wird, während das Formular den Fokus hat.


OnMouseDown

Das Ereignis OnMouseDown tritt ein, wenn eine Maustaste gedrückt wird, während das Formular den Fokus hat.

__property OnMouseDown;

Beschreibung

Für OnMouseDown können Sie eine Ereignisbehandlungsroutine programmieren, die spezielle Aktionen durchführt, wenn eine Maustaste gedrückt wird, während das Formular den Fokus hat.


OnMouseMove

Das Ereignis OnMouseMove tritt ein, wenn die Maus bewegt wird, während das Formular den Fokus hat.

__property OnMouseMove;

Beschreibung

Für OnMouseMove können Sie eine Ereignisbehandlungsroutine programmieren, die spezielle Aktionen durchführt, wenn die Maus bewegt wird, während das Formular den Fokus hat.


OnMouseUp

Das Ereignis OnMouseUp tritt ein, wenn eine Maustaste losgelassen wird, während das Formular den Fokus hat.

__property OnMouseUp;

Beschreibung

Für OnMouseUp können Sie eine Ereignisbehandlungsroutine programmieren, die spezielle Aktionen durchführt, wenn eine Maustaste losgelassen wird, während das Formular den Fokus hat.


TForm::OnPaint

TForm

Das Ereignis OnPaint tritt ein, wenn das Formular neu gezeichnet wird.

typedef void __fastcall (__closure *TNotifyEvent)(System::TObject* Sender);

__property Classes::TNotifyEvent OnPaint;

Beschreibung

Für OnPaint können Sie eine Ereignisbehandlungsroutine programmieren, die spezielle Aktionen durchführt, wenn das Formular neu gezeichnet wird.


TForm::OnResize

TForm

Das Ereignis OnResize tritt ein, wenn die Größe des Formulars geändert wird.

typedef void __fastcall (__closure *TNotifyEvent)(System::TObject* Sender);

__property Classes::TNotifyEvent OnResize;

Beschreibung

Für OnResize können Sie eine Ereignisbehandlungsroutine programmieren, die spezielle Aktionen durchführt, wenn die Größe des Formulars geändert wird.


TForm::OnShow

TForm

Das Ereignis OnShow tritt ein, wenn das Formular sichtbar ist, also die Eigenschaft Visible des Formulars den Wert True hat.

typedef void __fastcall (__closure *TNotifyEvent)(System::TObject* Sender);

__property Classes::TNotifyEvent OnShow;

Beschreibung

Mit OnShow können Sie eine Ereignisbehandlungsroutine programmieren, die spezielle Aktionen durchführt, wenn das Formular sichtbar ist, also wenn die Eigenschaft Visible des Formulars den Wert True hat.


Methoden von TForm

TForm	Alphabetisch

In TForm

~TForm

ArrangeIcons

Cascade

Close

CloseQuery

DefocusControl

FocusControl

GetFormImage

Hide

Next

Previous

Print

Release

SendCancelMode

SetFocus

SetFocusedControl

Show

ShowModal

TForm

Tile

Abgeleitet von TScrollingWinControl

ScrollInView

Abgeleitet von TWinControl

Broadcast

CanFocus

ContainsControl

ControlAtPos

DisableAlign

EnableAlign

Focused

GetTabOrderList

HandleAllocated

HandleNeeded

InsertControl

Invalidate

PaintTo

Realign

RemoveControl

Repaint

ScaleBy

ScrollBy

SetBounds

Update

UpdateControlState

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

GetTextLen

Perform

Refresh

ScreenToClient

SendToBack

SetTextBuf

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TForm

TForm	Nach Objekten

~TForm

ArrangeIcons

Assign

BeginDrag

BringToFront

Broadcast

CanFocus

Cascade

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

ClientToScreen

CloseQuery

Close

ContainsControl

ControlAtPos

DefaultHandler

DefocusControl

DestroyComponents

Destroying

DisableAlign

Dispatch

DragDrop

Dragging

EnableAlign

EndDrag

FieldAddress

FindComponent

FocusControl

Focused

FreeInstance

FreeNotification

Free

GetFormImage

GetParentComponent

GetTabOrderList

GetTextBuf

GetTextLen

HandleAllocated

HandleNeeded

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InsertControl

InstanceSize

Invalidate

MethodAddress

MethodName

NewInstance

Next

PaintTo

Perform

Previous

Print

Realign

Refresh

Release

RemoveComponent

RemoveControl

Repaint

ScaleBy

ScreenToClient

ScrollBy

ScrollInView

SendCancelMode

SendToBack

SetBounds

SetFocusedControl

SetFocus

SetTextBuf

ShowModal

Show

TForm

Tile

UpdateControlState

Update


TForm::~TForm

TForm

Der Destruktor ~TForm gibt den Speicher frei, der für das TForm-Objekt reserviert war. Rufen Sie ~TForm nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TForm automatisch aufgerufen wird.

__fastcall virtual ~TForm(void);

Beschreibung

~TForm führt die folgende Aufgaben aus:

•	Die Objekte werden freigegeben, die den Eigenschaften Canvas, Icon und Menu zugeordnet waren.

•	Die Ereignisbehandlungsroutine für OnDestroy wird für alle Objekte aufgerufen, die der Eigenschaft OleFormObject zugeordnet sind, wenn die Eigenschaft nicht den Wert NULL hat.

•	Der Speicher wird freigegeben, der von private-Objekten belegt war.

•	Die Methode TScrollingWinControl::~TScrollingWinControl wird aufgerufen.


TForm::ArrangeIcons

TForm

Die Methode ArrangeIcons ordnet die zum Symbol verkleinerten untergeordneten MDI-Formulare an.

void __fastcall ArrangeIcons(void);

Beschreibung

Mit ArrangeIcons können Sie die zum Symbol verkleinerten untergeordneten MDI-Formulare mit gleichmäßigen Abständen so anordnen, daß sie sich nicht überlappen.

ArrangeIcons arbeitet nur, wenn das Formular ein übergeordnetes MDI-Formular ist, also der Eigenschaft FormStyle des Formulars der Wert fsMDIForm zugewiesen wurde.


TForm::Cascade

TForm

Die Methode Cascade ordnet untergeordnete MDI-Formulare überlappend an.

void __fastcall Cascade(void);

Beschreibung

Mit Cascade können Sie untergeordnete MDI-Formulare überlappend anordnen.

Cascade arbeitet nur, wenn das Formular ein übergeordnetes MDI-Formular ist, also der Eigenschaft FormStyle des Formulars der Wert fsMDIForm zugewiesen wird.


TForm::Close

TForm	Siehe auch

Die Methode Close schließt ein Formular.

void __fastcall Close(void);

Beschreibung

Mit Close können Sie ein Formular schließen.

Durch einen Aufruf der Methode CloseQuery prüft die Methode Close, ob das Formular geschlossen werden kann. Gibt CloseQuery den Wert False zurück, wird die Operation abgebrochen. Ist das nicht der Fall, tritt das Ereignis OnClose ein.

Hinweis

Wird das Hauptfenster der Anwendung geschlossen, wird die Anwendung beendet.


TForm::CloseQuery

TForm	Siehe auch

Die Methode CloseQuery gibt einen booleschen Wert zurück, der angibt, ob das Formular geschlossen werden kann.

bool __fastcall CloseQuery(void);

Beschreibung

Mit CloseQuery können Sie ermitteln, ob das Formular geschlossen werden kann. CloseQuery gibt True zurück, wenn das Formular geschlossen werden kann, anderenfalls wird False zurückgegeben.

Bei einem übergeordneten MDI-Formular ruft CloseQuery zum Ermitteln des Rückgabewerts die Methode CloseQuery des untergeordneten MDI-Formulars auf.


TForm::DefocusControl

TForm	Siehe auch

Die Methode DefocusControl entfernt den Fokus von einem Steuerelement im Formular.

void __fastcall DefocusControl(Controls::TWinControl* Control, bool Removing);

Beschreibung

Mit DefocusControl können Sie den Fokus von einem Steuerelement im Formular entfernen.

Control ist das Steuerelement, von dem der Fokus entfernt werden soll. Ist Control das aktive Steuerelement im Formular, wird der Eigenschaft ActiveControl des Formulars der Wert NULL zugewiesen.

Mit dem booleschen Wert Removing wird angegeben, ob der Fokus dem übergeordneten Objekt des Fokus zugewiesen werden soll.


TForm::GetFormImage

TForm	Siehe auch

Die Methode GetFormImage liefert ein Bitmap des Formulars, das seinem Ausdruck entspricht.

Graphics::TBitmap* __fastcall GetFormImage(void);


TForm::Hide

TForm	Siehe auch	Beispiel

Die Methode Hide verbirgt das Formular.

void __fastcall Hide(void);

Beschreibung

Hide weist der Eigenschaft Visible den Wert False zu.


TForm::Next

TForm

Die Methode Next weist den Fokus dem nächsten untergeordneten MDI-Formular zu.

void __fastcall Next(void);

Beschreibung

Mit Next können Sie den Fokus dem nächsten untergeordneten MDI-Formular zuweisen.

Next arbeitet nur, wenn das Formular ein übergeordnetes MDI-Formular ist, also der Eigenschaft FormStyle des Formulars der Wert fsMDIForm zugewiesen wird.


TForm::Previous

TForm

Die Methode Next weist den Fokus den vorherigem untergeordneten MDI-Formular zu.

void __fastcall Previous(void);

Beschreibung

Mit Previous können Sie den Fokus dem vorherigen untergeordneten MDI-Formular zuweisen.

Previous arbeitet nur, wenn das Formular ein übergeordnetes MDI-Formular ist, also der Eigenschaft FormStyle des Formulars der Wert fsMDIForm zugewiesen wird.


TForm::Print

TForm	Siehe auch

Die Methode Print druckt das Formular.

void __fastcall Print(void);


TForm::Release

TForm

Die Methode Release gibt das Formular und den zugeordneten Speicher frei.

void __fastcall Release(void);

Beschreibung

Mit Release können Sie ein Formular und den zugeordneten Speicher freigeben.

Release und Free haben die gleiche Funktion. Release gibt das Formular jedoch erst frei, wenn die Ausführung aller Ereignisbehandlungsroutinen für das Formular und den Komponenten des Formulars abgeschlossen ist.


TForm::SendCancelMode

TForm

Die Methode SendCancelMode beendet den modalen Status des Formulars.

void __fastcall SendCancelMode(Controls::TControl* Sender);

Beschreibung

Mit SendCancelMode können Sie die Maus freigeben und die Eingaben über die Bildlaufleiste sowie die Verarbeitung von Menüereignissen im Formular beenden.


TForm::SetFocus

TForm	Siehe auch	Beispiel

Die Methode SetFocus weist den Fokus dem Formular zu.

virtual void __fastcall SetFocus(void);

Beschreibung

Mit SetFocus können Sie den Fokus dem Formular zuweisen.

SetFocus ruft gegebenenfalls die Methode SetFocus des aktiven Steuerelements auf.

Mit Active können Sie ermitteln, ob das Formular den Fokus hat.


TForm::SetFocusedControl

TForm	Siehe auch

Die Methode SetFocusedControl weist den Fokus einem Steuerelement im Formular zu.

bool __fastcall SetFocusedControl(Controls::TWinControl* Control);

Beschreibung

Mit SetFocusedControl können Sie den Fokus einem Steuerelement im Formular zuweisen.


TForm::Show

TForm	Siehe auch	Beispiel

Die Methode Show zeigt das Formular an.

void __fastcall Show(void);

Beschreibung

Mit Show können Sie der Eigenschaft Visible des Formulars den Wert True zuweisen und das Formular in den Vordergrund bringen.


TForm::ShowModal

TForm	Siehe auch

Die Methode ShowModal zeigt das Formular als modales Formular an.

int __fastcall ShowModal(void);

Beschreibung

Im ShowModal können Sie das Formular als modales Formular anzeigen, daß vom Benutzer geschlossen werden muß, bevor die Anwendungsausführung fortgesetzt wird.

Wird der Eigenschaft ModalResult eines modalen Formulars ein von 0 verschiedener Wert zugewiesen, wird das Formular geschlossen.

ShowModal gibt die Eigenschaft ModalResult des Formulars zurück.


TForm::TForm

TForm	Siehe auch

Die Methode TForm erstellt und initialisiert ein neues TForm-Objekt oder ein von TForm abgeleitetes Objekt.

__fastcall virtual TForm(Classes::TComponent* AOwner);

-oder-

__fastcall TForm(Classes::TComponent* AOwner, int Dummy);

Beschreibung

Mit TForm können Sie ein neues TForm-Objekt oder ein von TForm abgeleitetes Objekt erstellen und initialisieren.

AOwner ist der Eigentümer des TForm-Objekts.

TForm führt die folgenden Aufgaben aus:

•	Die Methode TScrollingWinControl::TScrollingWinControl wird aufgerufen, wobei AOwner übergeben wird.

•	Den Eigenschaften Left, Top, Width und Height werden die Werte 0, 0, 320 und 240 zugewiesen.

•	Der Eigenschaft WindowState wird der Wert wsNormal, der Eigenschaft Visible der Wert False und der Eigenschaft Ctrl3d der Wert True, der Eigenschaft BorderIcons [biSystemMenu, biMinimize, biMaximize] und der Eigenschaft BorderStyle der Wert bsSizeable zugewiesen.

•	Für die Eigenschaften Icon und Canvas wird Speicher zugewiesen.

•	Dem Ereignis Icon.OnChange wird der Wert IconChanged zugewiesen.

•	Der Eigenschaft TControl::ControlStyle wird [csAcceptsControls, csCaptureMouse, csClickEvents, csSetCaption, csDoubleClicks] zugewiesen.

•	Der Eigenschaft Canvas::Control wird der Wert Self zugewiesen.

•	Der Eigenschaft PixelsPerInch wird der Wert der Eigenschaft PixelsPerInch und der Eigenschaft PrintScale der Wert poProportional zugewiesen.

•	Die Methode TScrollingWinControl::Create wird aufgerufen und an AOwner übergeben.

•	Die Methode Screen::AddForm aufgerufen. Dabei wird Self übergeben.


TForm::Tile

TForm	Siehe auch

Die Methode Tile ordnet untergeordnete MDI-Formulare so an, daß alle die gleiche Größe haben.

void __fastcall Tile(void);

Beschreibung

Die Methode Tile ordnet untergeordnete MDI-Formulare so an, daß alle die gleiche Größe haben. So angeordnete Formulare füllen den gesamten Client-Bereich des übergeordneten Formulars aus. Wie die Formulare angeordnet werden, hängt von dem jeweiligen Wert der Eigenschaft TileMode ab.

Tile arbeitet nur, wenn das Formular ein übergeordnetes MDI-Formular ist, also der Eigenschaft FormStyle des Formulars der Wert fsMDIForm zugewiesen wird.


TForm::FocusControl

TForm	Siehe auch

Die Methode FocusControl weist den Fokus einem Steuerelement im Formular zu.

void __fastcall FocusControl(Controls::TWinControl* Control);

Beschreibung

Mit FocusControl können Sie den Fokus einem Steuerelement im Formular zuweisen.

Control ist ein TWinControl-Objekt, das das Steuerelement kapselt, dem der Fokus zugewiesen werden soll.


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TControl

TWinControl

TScrollingWinControl


TForm Beispiel

TForm


TGraphicField

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/dbtables.hpp

Die Komponente TGraphicField repräsentiert ein Grafikfeld in einer Datenmenge.

Beschreibung

Grafikfelder gehören zur Gruppe der BLOB-Felder (BLOB = Binary Large OBject). Die Felddaten beinhalten einen BLOB-Header, der die Codierung des grafischen Feldwertes beschreibt. TGraphicField unterscheidet sich von seinem direkten Vorfahren TBlobField nur darin, daß die Eigenschaft DataType den Wert ftGraphic besitzt. Als Nachkomme von TBlobField enthält TGraphicField viele Eigenschaften, Methoden und Ereignisse, die sich für die Verwaltung des Wertes und der Eigenschaften eines BLOB-Feldes in einer Datenbank eignen.


Eigenschaften von TGraphicField

TGraphicField	Alphabetisch	Legende

Abgeleitet von TBlobField

BlobType

Value

Abgeleitet von TField

Alignment

AsBoolean

AsCurrency

AsDateTime

AsFloat

AsInteger

AsString

AsVariant

AttributeSet

BDECalcField

Calculated

CanModify

DataSet

DataSize

DataType

DisplayLabel

DisplayName

DisplayText

DisplayWidth

EditMask

EditMaskPtr

FieldKind

FieldName

FieldNo

Index

IsIndexField

IsNull

KeyFields

Lookup

LookupDataSet

LookupKeyFields

LookupResultField

NewValue

OldValue

ReadOnly

Required

Size

Text

Visible

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Name

Owner

Tag


Eigenschaften von TGraphicField

TGraphicField	Nach Objekten	Legende

Alignment

AsBoolean

AsCurrency

AsDateTime

AsFloat

AsInteger

AsString

AsVariant

AttributeSet

BDECalcField

BlobType

Calculated

CanModify

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

DataSet

DataSize

DataType

DesignInfo

DisplayLabel

DisplayName

DisplayText

DisplayWidth

EditMaskPtr

EditMask

FieldKind

FieldName

FieldNo

Index

IsIndexField

IsNull

KeyFields

LookupDataSet

LookupKeyFields

LookupResultField

Lookup

Name

NewValue

OldValue

Owner

ReadOnly

Required

Size

Tag

Text

Value

Visible


Ereignisse von TGraphicField

TGraphicField	Alphabetisch	Legende

Abgeleitet von TField

OnChange

OnGetText

OnSetText

OnValidate


Ereignisse von TGraphicField

TGraphicField	Nach Objekten	Legende

OnChange

OnGetText

OnSetText

OnValidate


Methoden von TGraphicField

TGraphicField	Alphabetisch

In TGraphicField

~TGraphicField

TGraphicField

Abgeleitet von TBlobField

Assign

Clear

LoadFromFile

LoadFromStream

SaveToFile

SaveToStream

SetFieldType

SetText

Abgeleitet von TField

AssignValue

FocusControl

GetData

IsValidChar

SetData

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TGraphicField

TGraphicField	Nach Objekten

~TGraphicField

Assign

AssignValue

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

Clear

DefaultHandler

DestroyComponents

Destroying

Dispatch

FieldAddress

FindComponent

FocusControl

FreeInstance

FreeNotification

Free

GetData

GetParentComponent

HasParent

InheritsFrom

InitInstance

InsertComponent

InstanceSize

IsValidChar

LoadFromFile

LoadFromStream

MethodAddress

MethodName

NewInstance

RemoveComponent

SaveToFile

SaveToStream

SetData

SetFieldType

SetText

TGraphicField


TGraphicField::~TGraphicField

TGraphicField

Der Destruktor ~TGraphicField gibt den Speicher frei, der für das TGraphicField-Objekt reserviert war. Rufen Sie ~TGraphicField nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TGraphicField automatisch aufgerufen wird.

__fastcall virtual ~TGraphicField(void);


TGraphicField::TGraphicField

TGraphicField	Siehe auch

TGraphicField ist der Konstruktor für eine Grafikfeld-Komponente.

__fastcall virtual TGraphicField(Classes::TComponent* AOwner);

Beschreibung

Mit der Methode TGraphicField wird eine Instanz von TGraphicField erzeugt und initialisiert. Nach dem Aufruf des geerbten Konstruktors setzt TGraphicField die Eigenschaft DataType auf ftGraphic.

Es ist nur selten nötig, TGraphicField direkt aufzurufen, da für alle Grafikfelder in einer Datenmenge automatisch eine entsprechende Komponente instantiiert wird.


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TField

TBlobField


TGraphicField Beispiel

TGraphicField


TGraphic

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/graphics.hpp

TGraphic bildet in Borland C++Builder die abstrakte Basisklasse für Grafikobjekte, Symbole, Bitmaps und Metadateien, die Bilder speichern bzw. anzeigen können.

Wenn der Typ der Grafik bekannt ist (Bitmap, Symbol oder Metadatei), verwenden Sie zum Speichern das passende Objekt (TBitmap, TIcon oder TMetafile). Andernfalls setzen Sie ein TPicture-Objekt ein, das TGraphic-Objekt beliebigen Typs aufnehmen kann.


Eigenschaften von TGraphic

TGraphic	Alphabetisch	Legende

In TGraphic

Empty

Height

Modified

Width


Eigenschaften von TGraphic

TGraphic	Nach Objekten	Legende

Empty

Height

Modified

Width


TGraphic::Empty

TGraphic

Die Eigenschaft Empty signalisiert, ob das Grafikobjekt eine Grafik enthält.

__property bool Empty;

Beschreibung

Alle abgeleiteten Grafikobjekte definieren eine eigene Methode zum Zugriff die Eigenschaft Empty.


TGraphic::Height

TGraphic	Beispiel

Die Eigenschaft Height bezeichnet die vertikale Größe der Grafik in Pixel.

__property int Height;

Beschreibung

Alle abgeleiteten Grafikobjekte definieren eigene Methoden für den Schreib- bzw. Lesezugriff auf die Eigenschaft Height.


TGraphic::Modified

TGraphic	Beispiel

Die Eigenschaft Modified gibt an, ob das Grafikobjekt gewechselt oder bearbeitet wurde.

__property bool Modified;

Beschreibung

Der Wert True bedeutet, daß das Grafikobjekt geändert wurde. Der Wert False sagt aus, daß sich das Grafikobjekt noch in demselben Zustand wie beim Laden befindet.

Die Eigenschaft Modified bezieht sich nur auf Bitmap-Objekte. Wenn ein Symbol oder eine Metadatei-Grafik geändert wurden, hat Modified selbst dann nicht den Wert True, wenn eine Änderung stattgefunden hat.

Das geänderte Objekt kann mit der Methode SaveToFile in einer Datei gespeichert und bei Bedarf mit LoadFromFile wieder geladen werden.


TGraphic::Width

TGraphic	Beispiel

Die Eigenschaft Width bezeichnet die maximale Breite des Grafikobjekts in Pixel.

__property int Width;

Beschreibung

Alle abgeleiteten Grafikobjekte definieren eigene Methoden für den Schreib- bzw. Lesezugriff auf Width.


Ereignisse von TGraphic

TGraphic	Alphabetisch

In TGraphic

OnChange


Ereignisse von TGraphic

TGraphic	Nach Objekten

OnChange


TGraphic::OnChange

TGraphic

Das Ereignis OnChange wird ausgelöst, wenn ein Bitmap geändert wird.

__property Classes::TNotifyEvent OnChange;


Methoden von TGraphic

TGraphic	Alphabetisch

In TGraphic

~TGraphic

LoadFromClipboardFormat

LoadFromFile

LoadFromStream

SaveToClipboardFormat

SaveToFile

SaveToStream

TGraphic

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TGraphic

TGraphic	Nach Objekten

~TGraphic

Assign

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

LoadFromClipboardFormat

LoadFromFile

LoadFromStream

MethodAddress

MethodName

NewInstance

SaveToClipboardFormat

SaveToFile

SaveToStream

TGraphic


TGraphic::~TGraphic

TGraphic

Der Destruktor ~TGraphic gibt den Speicher frei, der für das TGraphic-Objekt reserviert war. Rufen Sie ~TGraphic nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TGraphic automatisch aufgerufen wird.

__fastcall virtual ~TGraphic(void);


TGraphic::LoadFromClipboardFormat

TGraphic	Siehe auch

TGraphic führt die abstrakte Methode LoadFromClipboardFormat ein.

virtual void __fastcall LoadFromClipboardFormat(unsigned short AFormat, int AData, HPALETTE APalette );

Beschreibung

Alle abgeleiteten Grafikobjekte definieren eine Methode LoadFromClipboardFormat, mit der die aktuelle Grafik durch die ersetzt wird, die der Parameter AData bezeichnet. Die Grafik wird aus der Zwischenablage übernommen.

Das Format des neuen Grafikobjekts muß mit der Methode RegisterClipboardFormat bei der Zwischenablage registriert sein. Andernfalls wird eine Exception ausgelöst.


TGraphic::LoadFromFile

TGraphic

Die Methode LoadFromFile lädt ein Grafikobjekt aus einer Datei.

virtual void __fastcall LoadFromFile(const System::AnsiString Filename);

Beschreibung

LoadFromFile liest die Datei, die in FileName bezeichnet wird, und lädt die Daten in das Grafikobjekt.


TGraphic::LoadFromStream

TGraphic

TGraphic führt die abstrakte Methode LoadFromStream ein.

virtual void __fastcall LoadFromStream(Classes::TStream* Stream);

Beschreibung

Alle abgeleiteten Grafikobjekte definieren eine eigene Methode LoadFromStream, mit der ein Grafikobjekt aus einem Stream geladen wird.


TGraphic::SaveToClipboardFormat

TGraphic

TGraphic führt die abstrakte Methode SaveToClipboardFormat ein.

virtual void __fastcall SaveToClipboardFormat(unsigned short &AFormat, int &AData, HPALETTE &APalette );

Beschreibung

Alle abgeleiteten Grafikobjekte definieren eine eigene Methode SaveToClipboardFormat, mit der ein Grafikobjekt aus einem Stream geladen wird.


TGraphic::SaveToFile

TGraphic

Die Methode SaveToFile speichert ein Grafikobjekt in einer Datei.

virtual void __fastcall SaveToFile(const System::AnsiString Filename);

Beschreibung

Der Parameter FileName bezeichnet die Datei, in der das Grafikobjekt gespeichert werden soll.


TGraphic::SaveToStream

TGraphic

TGraphic führt die abstrakte Methode SaveToStream ein.

virtual void __fastcall SaveToStream(Classes::TStream* Stream);

Beschreibung

Der Parameter Stream bezeichnet den Stream, in dem das Grafikobjekt gespeichert werden soll.


TGraphic::TGraphic

TGraphic

Der Konstruktor TGraphic erzeugt ein neues TGraphic-Objekt.

__fastcall virtual TGraphic(void);


Zugriff

Read-only


Hierarchie

TObject

TPersistent


TGraphic Beispiel

TGraphic


TGraphicsObject

Hierarchie	Methoden	Ereignisse	Siehe auch

Header

vcl/graphics.hpp

TGraphicsObject ist die abstrakte Basisklasse für Objekte, die ein Windows-Grafikobjekt kapseln: TBrush, TFont und TPen.

Beschreibung

Sie werden Objekte von TGraphicsObject ableiten, wenn ein Bild auf einer Zeichenfläche (TCanvas) dargestellt wird. Jedes TGraphicsObject-Objekt beschreibt ein Windows-Grfaikobjekt, das im Gerätekontext der Zeichenfläche referenziert wird.

TGraphicsObject führt einen Mechanismus ein, mit dem auf Änderungen in den Eigenschaften des Grafikobjekts reagiert werden kann.


Ereignisse von TGraphicsObject

TGraphicsObject	Alphabetisch

In TGraphicsObject

OnChange


Ereignisse von TGraphicsObject

TGraphicsObject	Nach Objekten

OnChange


TGraphicsObject::OnChange

TGraphicsObject	Siehe auch

Das Ereignis OnChange wird sofort ausgelöst, wenn sich das Windows-Grafikobjekt ändert.

typedef void __fastcall (__closure *TNotifyEvent)(System::TObject* Sender);

__property Classes::TNotifyEvent OnChange;

Beschreibung

Schreiben Sie eine Ereignisbehandlungsroutine, die eine bestimmte Aktion ausführt, wenn sich das Grafikobjekt ändert. Die Eigenschaften des Grafikobjekts enthalten die neuen Einstellungen, wenn OnChange ausgelöst wird.


Methoden von TGraphicsObject

TGraphicsObject	Alphabetisch	Legende

In TGraphicsObject

~TGraphicsObject

Changed

TGraphicsObject

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TGraphicsObject

TGraphicsObject	Nach Objekten	Legende

~TGraphicsObject

Assign

Changed

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance

TGraphicsObject


TGraphicsObject::~TGraphicsObject

TGraphicsObject

Der Destruktor ~TGraphicsObject gibt den Speicher frei, der für das TGraphicsObject-Objekt reserviert war. Rufen Sie ~TGraphicsObject nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TGraphicsObject automatisch aufgerufen wird.

__fastcall virtual ~TGraphicsObject(void)


TGraphicsObject::Changed

TGraphicsObject	Siehe auch

Die Methode Changed löst ein OnChange-Ereignis aus, sobald sich die Eigenschaften des Grafikobjekts ändern.

virtual void __fastcall Changed(void);

Beschreibung

Nachkommen von TGraphicsObject rufen Changed auf, nachdem die Eigenschaften geändert wurden, die im TGraphicsObject-Objekt gekapselt sind.


TGraphicsObject::TGraphicsObject

TGraphicsObject

Der Konstruktor TGraphicsObject erzeugt ein neues TGraphicsObject-Objekt.

__fastcall TGraphicsObject(void);


Gültigkeitsbereich

Protected


Hierarchie

TObject

TPersistent


TGraphicsObject Beispiel

TGraphicsObject


TGridDataLink

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/dbgrids.hpp

TGridDataLink ist ein Hilfsobjekt, das die Verknüpfung zur Datenmenge sowie die Feldzuordnung für ein TCustomDBGrid-Objekt verwaltet.

Beschreibung

TGridDataLink ist für den Einsatz in Verbindung mit einem TCustomDBGrid vorgesehen. Es sollte nur von der Klasse TCustomDBGrid verwendet werden.


Eigenschaften von TGridDataLink

TGridDataLink	Alphabetisch	Legende

In TGridDataLink

DefaultFields

FieldCount

Fields

SparseMap

Abgeleitet von TDataLink

Active

ActiveRecord

BufferCount

DataSet

DataSource

DataSourceFixed

Editing

ReadOnly

RecordCount


Eigenschaften von TGridDataLink

TGridDataLink	Nach Objekten	Legende

ActiveRecord

Active

BufferCount

DataSet

DataSourceFixed

DataSource

DefaultFields

Editing

FieldCount

Fields

ReadOnly

RecordCount

SparseMap


TGridDataLink::DefaultFields

TGridDataLink	Siehe auch

Die Eigenschaft DefaultFields gibt an, ob beim öffnen der Datenmenge die der Datenmenge zugrundeliegenden Feldkomponenten dynamisch erzeugt werden.

__property bool DefaultFields;

Beschreibung

Mit einem Lesezugriff auf DefaultFields wird festgestellt, ob bei einer Datenmenge dynamisch erzeugte oder persistente (statische) Feldkomponenten verwendet werden. Hat DefaultFields den Wert True, werden bei der Datenmenge dynamisch zugewiesene Feldkomponenten verwendet. Hat DefaultFields den Wert False, werden entwerder bei der Datenmenge persistente Feldkomponenten verwendet, oder die benutzerdefinierte Feldzuordung enthält nicht zugewiesene Felder.

Wenn DefaultFields den Wert False hat, zeigt TCustomDBGrid eventuell nicht alle in der zugrundeliegenden Datenbanktabelle enthaltenen Felder an.


TGridDataLink::FieldCount

TGridDataLink	Siehe auch

Die Eigenschaft FieldCount gibt die Anzahl der Einträge in der Feldzuordnungstabelle an.

__property int FieldCount;

Beschreibung

Mit einem Lesezugriff auf FieldCount wird die Anzahl der Einträge in der Feldzuordnungstabelle ermittelt. In Verbindung mit der Eigenschaft Fields kann so in einer Anwendung eine Iteration über alle zugeordneten Felder erfolgen.

Im Entwurfsmodus enstpricht der Wert in FieldCount der Spaltenzahl des TCustomDBGrid-Objekts. Zur Laufzeit kann der Wert in FieldCount die Spaltenzahl übersteigen. Die Feldzuordnungstabelle enthält eventuell undefinierte Felder, die zur Laufzeit nicht als Spalten erscheinen.


TGridDataLink::Fields

TGridDataLink	Siehe auch

Die Eigenschaft Fields ermöglicht den Zugriff auf alle Feldkomponenten, die in der Feldzuordnungstabelle eingetragen sind.

__property Db::TField* Fields[int I];

Beschreibung

Mit Fields kann auf die Feldkomponenten über einen Index zugegriffen werden. Fields ist ein Array, bei dem die Indizierung mit der 0 beginnt. Hat die Eigenschaft SparseMap den Wert True, enthält die Feldzuordnungstabelle undefinierte Felder. Für diese Einträge gibt Fields den Wert NULL zurück.

Muß im Rahmen einer Anwendung der Reihe nach auf alle Feldkomponenten der Spalten des TCusotmDBGrid-Objekts zugegriffen werden, kann Field zusammen mit der Eigenschaft FieldCount verwendet werden:

for(int i=0; i < FieldCount-1; i++)

    if(Fields[i] != NULL) {

        //  Fields[i] is the field component for the next column at runtime

    }


TGridDataLink::SparseMap

TGridDataLink	Siehe auch

Die Eigenschaft SparseMap signalisiert, daß das TCustomDBGrid-Objekt die Feldzuordnungstabelle angepaßt hat, weshalb diese eventuell undefinierte Felder enthält.

__property bool SparseMap;

Beschreibung

Mit einem Lesezugriff auf SparseMap kann festgestellt werden, ob die Feldzuordnungstabelle nicht einfach nur die zugrundeliegenden Datenmenge abbildet. TCustomDBGrid setzt SparseMap, wenn die Feldzuordnungstabelle aufgebaut wird. SparseMap hat den Wert False, wenn TCustomDBGrid direkt aus der Datenmenge eine Stardard-Feldzuordnungstabelle aufbaut. Jede Änderung der mit den Spalten verbundenen Feldkomponenten bewirkt, daß TCustomDBGrid den Wert von SparseMap auf True setzt. Hat SparseMap den Wert True, enthält die Feldzuordnungstabelle eventuell undefinierte Felder, wenn die Spaltenattribute auf einen ungültigen Feldnamen oder auf eine nicht zugewiesene Feldkomponente hinweisen.


Methoden von TGridDataLink

TGridDataLink	Alphabetisch	Legende

In TGridDataLink

~TGridDataLink

ActiveChanged

AddMapping

ClearMapping

DataSetChanged

DataSetScrolled

EditingChanged

FocusControl

GetMappedIndex

LayoutChanged

Modified

RecordChanged

Reset

TGridDataLink

UpdateData

Abgeleitet von TDataLink

Edit

UpdateRecord

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TGridDataLink

TGridDataLink	Nach Objekten	Legende

~TGridDataLink

ActiveChanged

AddMapping

Assign

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

ClearMapping

DataSetChanged

DataSetScrolled

DefaultHandler

Dispatch

EditingChanged

Edit

FieldAddress

FocusControl

FreeInstance

Free

GetMappedIndex

InheritsFrom

InitInstance

InstanceSize

LayoutChanged

MethodAddress

MethodName

Modified

NewInstance

RecordChanged

Reset

TGridDataLink

UpdateData

UpdateRecord


TGridDataLink::~TGridDataLink

TGridDataLink	Siehe auch

Der Destruktor ~TGridDataLink gibt den Speicher frei, der für das TGridDataLink-Objekt reserviert war. Rufen Sie ~TGridDataLink nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TGridDataLink automatisch aufgerufen wird.

__fastcall virtual ~TGridDataLink(void);

Beschreibung

~TGridDataLink gibt den Speicher frei, der von der Feldzuordnungstabelle belegt war, und ruft dann den Destruktor des übergeordneten Objekts auf.


TGridDataLink::ActiveChanged

TGridDataLink	Siehe auch

Die Methode ActiveChangend benachrichtigt das TCustomDBGrid-Objekt von Änderungen der Eigenschaft Active.

virtual void __fastcall ActiveChanged(void);

Beschreibung

In Anwendungen kann die Prozedur ActiveChanged nicht direkt aufgerufen werden. Änderungen der Eigenschaft Active lösen die Ausführung dieser Prozedur aus, was wiederum zum Aufruf der Methode LinkActive des TCustomDBGrid-Objekts führt, das Eigentümer des TGridDataLink-Objekts ist.


TGridDataLink::AddMapping

TGridDataLink	Siehe auch

Die Methode AddMapping fügt eine Feldkomponente an das Ende der Feldzuordnungstabelle an.

bool __fastcall AddMapping(const System::AnsiString FieldName);

Beschreibung

In Anwendungen sollte AddMapping nicht direkt aufgerufen werden, da dies die Synchronisation der Feldzuordnungstabelle mit den Spalten des TCustomDBGrid-Objekts zerstört. Das TCustomDBGrid-Objekt ruft die Methode AddMapping zum Aufbau einer den Spalten entsprechenden Feldzuordnungstabelle iterativ auf.


TGridDataLink::ClearMapping

TGridDataLink	Siehe auch

Die Methode ClearMapping leert die Feldzuordnungstabelle und gibt den zugehörigen Speicher frei.

void __fastcall ClearMapping(void);

Beschreibung

In Anwendungen sollte ClearMapping nicht direkt aufgerufen werden, da dies die Synchronisation der Feldzuordnungstabelle mit den Spalten des TCustomDBGrid-Objekts zerstört. Das TCustomDBGrid-Objekt ruft vor jedem Regenerieren der Feldzuordnungstabelle zuerst ClearMapping auf.


TGridDataLink::DataSetChanged

TGridDataLink	Siehe auch

Die Methode DataSetChanges benachrichtigt das TCustomDBGrid-Objekt über eine Änderung der Datenmenge.

virtual void __fastcall DataSetChanged(void);

Beschreibung

In Anwendungen kann die Prozedur DataSetChanged nicht direkt aufgerufen werden. Die Änderung des Inhalts der Datenmenge löst diese Methode automatisch aus. Mit DataSetChanged kann das TCustomDBGrid-Objekt die Änderung der Datenmenge überwachen.


TGridDataLink::DataSetScrolled

TGridDataLink	Siehe auch

Die Methode DataSetScrolled benachrichtigt das TCustomDBGrid-Objekt, wenn der Bildlauf der Datenmenge beendet ist.

virtual void __fastcall DataSetScrolled(int Distance);

Beschreibung

In Anwendungen kann die Prozedur DataSetScrolled nicht direkt aufgerufen werden. Diese Prozedur wird automatisch ausgeführt, wenn die Datenmenge des TCustomDBGrid-Objekts einem Bildlauf unterzogen wird. TGridDataLink ruft zur Weitergabe der Information die Methode Scroll auf.


TGridDataLink::EditingChanged

TGridDataLink	Siehe auch

Die Methode EditingChanged benachrichtigt das TCustomDBGrid-Objekt, wenn sich der Bearbeitungsmodus der Datenmenge ändert.

virtual void __fastcall EditingChanged(void);

Beschreibung

In Anwendungen kann die Prozedur EditingChanged nicht direkt aufgerufen werden. Die Änderung der Eigenschaft Editing löst den Aufruf dieser Prozedur aus. Mit EditingChanged kann das TCustomDBGrid-Objekt den Benutzer visuell über den aktuellen Bearbeitungsmodus informieren.


TGridDataLink::FocusControl

TGridDataLink	Siehe auch

Die Methode FocusControl ruft den Editor auf und verlagert den Fokus auf ein Eingabefeld im TCustomDBGrid-Objekts.

virtual void __fastcall FocusControl(Db::TFieldRef Field);

Beschreibung

Mit der Prozedur FocusControl wird der Editor für die Repräsentation von Field im TCustomDBGrid-Objekt aufgerufen. FocusControl wird Field im TCustomDBGrid-Objekt ausgewählt. Dann wird das TCusomDBGrid-Objekt veranlaßt, den Editor zu aktivieren.


TGridDataLink::GetMappedIndex

TGridDataLink	Siehe auch

Die Methode GetMappIndex liefert den Index einer Feldkomponente in der Datenmenge, der einem Index in der Feldzuordnungstabelle entspricht.

int __fastcall GetMappedIndex(int ColIndex);

Wird GetMappedIndex auf einen Index angewendet, der in die Feldzuordnungstabelle zeigt, wird der entsprechende Index zurückgegeben, der in die Datenmenge zeigt. Die Feldzuordnungstabelle und die Datenmenge sind Arrays, bei denen die Indizierung mit 0 beginnt. Wenn ein Eintrag der Feldzuordnungstabelle auf ein undefiniertes Feld verweist, gibt GetMappedIndex den Wert -1 zurück.


TGridDataLink::LayoutChanged

TGridDataLink	Siehe auch

Die Methode LayoutChanged benachrichtigt das TCustomDBGrid-Objekt über die Änderung des Layouts informiert, wenn die Änderung Auswirkungen auf die Repräsentation der Datenmenge hat.

virtual void __fastcall LayoutChanged(void);

Beschreibung

In Anwendungen kann die Methode LayoutChanged nicht direkt aufgerufen werden. Das TCustomDBGrid-Objekt, das der Eigentümer eines TGridDataLink-Objekts ist, ruft diese Methode automatisch auf, wenn die Layout-Änderungen die Repräsentation der Datenmenge beeinflussen. LayoutChanged ermöglicht es dem TCustomDBGrid-Objekt, seine Version von LayoutChanged aufzurufen, um sein Layout neu aufzubauen.


TGridDataLink::Modified

TGridDataLink	Siehe auch	Beispiel

Die Methode Modified protokolliert Änderungen an den Daten, die noch nicht im aktuellen Datensatz der Datenbank gespeichert wurden.

void __fastcall Modified(void);

Beschreibung

In Anwendungen sollte die Prozedur Modified nicht direkt aufgerufen werden. Modified wird automatisch aufgerufen, sobald das TCustomDBGrid-Objekt beginnt, ein Feld zu bearbeiten. Mit Modified kann das TGridDataLink-Objekt feststellen, ob Änderungen anstehen, die noch nicht eingetragen wurden.


TGridDataLink::RecordChanged

TGridDataLink	Siehe auch

Die Methode RecordChanged informiert das TCustomDBGrid-Objekt über Änderungen, die im aktuellen Datensatz oder Feld des DataSource-Objekts vorgenommen wurden.

virtual void __fastcall RecordChanged(Db::TField* Field);

Beschreibung

In Anwendungen kann RecordChanged nicht direkt aufgerufen werden. Die Methode wird automatisch ausgeführt, sobald sich der Inhalt des aktuellen Datensatzes ändert. Mit dem Parameter Field wird angezeigt, welches Feld des aktuellen Datensatzes geändert wurde. Hat Field den Wert NULL, wurde der gesamte Datensatz geändert.

Mit RecordChanged wird das TCustomDBGrid-Objekt über diese Änderungen informiert, so daß die Anzeige der betroffenen Spalten aktualisiert werden kann.


TGridDataLink::Reset

TGridDataLink	Siehe auch

Die Methode Reset verwirft alle anstehende Änderungen der Datenmenge, die noch nicht im aktuellen Datensatz gespeichert sind.

void __fastcall Reset(void);

Beschreibung

Reset wird ausgelöst, wenn der Benutzer durch eine entsprechende Aktion vorgibt, daß die anstehenden Änderungen der Datenmenge verworfen werden sollen.


TGridDataLink::TGridDataLink

TGridDataLink	Siehe auch

TGridDataLink erzeugt eine Instanz von TGridDataLink.

__fastcall TGridDataLink(TCustomDBGrid* AGrid);

Beschreibung

In Anwendungen sollte die Methode TGridDataLink nicht direkt zur Erstellung eines TGridDataLink-Objekts aufrufen werden. Das TCustomDBGrid-Objekt, das der Eigentümer eines TGridDataLink-Objekts ist, ruft TGridDataLink in seinem eigenen Konstruktor auf.


TGridDataLink::UpdateData

TGridDataLink	Siehe auch

Die Methode UpdateData ermöglicht es dem TCustomDBGrid-Objekt, Änderungen in die Datenmenge einzutragen.

virtual void __fastcall UpdateData(void);

Beschreibung

In Anwendungen kann die Prozedur UpdateData nicht direkt aufgerufen werden. Sie wird automatisch aufgerufen, wenn anstehende Änderungen in die Datenmenge übernommen werden müssen. Mit UpdateData wird das TCustomDBGrid-Objekt veranlaßt, bisher nicht gespeicherte Änderungen des aktuellen Feldes in die zugrundeliegende Field-Komponente zu übernehmen.


Zugriff

Read-only


Gültigkeitsbereich

Protected


Hierarchie

TObject

TPersistent

TDataLink


TGridDataLink Beispiel

TGridDataLink


 TGroupBox

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/stdctrls.hpp

TGroupBox erzeugt ein Windows-Gruppenfeld.

Beschreibung

Die Komponente TGroupBox repräsentiert ein Standard-Windows-Gruppenfeld, mit dem funktional zusammengehörige Steuerelemente eines Formulars gruppiert werden können. Sobald ein weiteres Steuerelement innerhalb einer Gruppe plaziert wird, ist das Gruppenfeld das übergeordnete Objekt dieser Komponente.


Eigenschaften von TGroupBox

TGroupBox	Alphabetisch	Legende

Abgeleitet von TWinControl

Brush

ClientOrigin

ClientRect

ControlCount

Controls

Ctl3D

Handle

HelpContext

ParentCtl3D

Showing

TabOrder

TabStop

Abgeleitet von TControl

Align

BoundsRect

Caption

ClientHeight

ClientWidth

Color

ControlState

ControlStyle

Cursor

DragCursor

DragMode

Enabled

Font

Height

Hint

Left

Name

Parent

ParentColor

ParentFont

ParentShowHint

PopupMenu

ShowHint

Top

Visible

Width

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TGroupBox

TGroupBox	Nach Objekten	Legende

Align

BoundsRect

Brush

Caption

ClientHeight

ClientOrigin

ClientRect

ClientWidth

Color

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlCount

ControlState

Controls

ControlStyle

Ctl3D

Cursor

DesignInfo

DragCursor

DragMode

Enabled

Font

Handle

Height

HelpContext

Hint

Left

Name

Owner

ParentColor

ParentCtl3D

ParentFont

ParentShowHint

Parent

PopupMenu

ShowHint

Showing

TabOrder

TabStop

Tag

Top

Visible

Width


Ereignisse von TGroupBox

TGroupBox	Alphabetisch	Legende

Abgeleitet von TWinControl

OnEnter

OnExit

Abgeleitet von TControl

OnClick

OnDblClick

OnDragDrop

OnDragOver

OnEndDrag

OnMouseDown

OnMouseMove

OnMouseUp

OnStartDrag


Ereignisse von TGroupBox

TGroupBox	Nach Objekten	Legende

OnClick

OnDblClick

OnDragDrop

OnDragOver

OnEndDrag

OnEnter

OnExit

OnMouseDown

OnMouseMove

OnMouseUp

OnStartDrag


Methoden von TGroupBox

TGroupBox	Alphabetisch

In TGroupBox

~TGroupBox

TGroupBox

Abgeleitet von TWinControl

Broadcast

CanFocus

ContainsControl

ControlAtPos

DisableAlign

EnableAlign

Focused

GetTabOrderList

HandleAllocated

HandleNeeded

InsertControl

Invalidate

PaintTo

Realign

RemoveControl

Repaint

ScaleBy

ScrollBy

SetBounds

SetFocus

Update

UpdateControlState

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

GetTextLen

Hide

Perform

Refresh

ScreenToClient

SendToBack

SetTextBuf

Show

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TGroupBox

TGroupBox	Nach Objekten

~TGroupBox

Assign

BeginDrag

BringToFront

Broadcast

CanFocus

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

ClientToScreen

ContainsControl

ControlAtPos

DestroyComponents

Destroying

DisableAlign

Dispatch

DragDrop

Dragging

EnableAlign

EndDrag

FieldAddress

FindComponent

Focused

FreeInstance

FreeNotification

Free

GetParentComponent

GetTabOrderList

GetTextBuf

GetTextLen

HandleAllocated

HandleNeeded

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InsertControl

InstanceSize

Invalidate

MethodAddress

MethodName

NewInstance

PaintTo

Perform

Realign

Refresh

RemoveComponent

RemoveControl

Repaint

ScaleBy

ScreenToClient

ScrollBy

SendToBack

SetBounds

SetFocus

SetTextBuf

Show

TGroupBox

UpdateControlState

Update


TGroupBox::~TGroupBox

TGroupBox

Der Destruktor ~TGroupBox gibt den Speicher frei, der für das TGroupBox-Objekt reserviert war. Rufen Sie ~TGroupBox nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TGroupBox automatisch aufgerufen wird.

__fastcall virtual ~TGroupBox(void);


TGroupBox::TGroupBox

TGroupBox

Der Konstruktor TGroupBox erzeugt ein neues TGroupBox-Objekt.

__fastcall virtual TGroupBox(Classes::TComponent* AOwner);


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TControl

TWinControl

TCustomControl

TCustomGroupBox


TGroupBox Beispiel

TGroupBox


TGraphicControl

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/controls.hpp

Die Komponente TGraphicControl ist ein abstraktes, nicht fensterorientiertes Steuerelement, von dem Sie benutzerdefinierte, nicht fensterorientierte Steuerelemente ableiten können.

Beschreibung

Die meisten grafischen Steuerelemente dienen hauptsächlich zur Anzeige von Text oder Grafiken. Zu den von TGraphicControl abgeleiteten Steuerelementen gehören TBevel, TImage, TPaintBox, TShape, TSpeedButton und TCustomLabel. Von TCustomLabel sind wiederum TDBText und TLabel abgeleitet.

Zusätzlich zu den von der abstrakten Komponente TControl geerbten Merkmalen verfügt TGraphicControl über die Eigenschaft Canvas und die virtuelle Methode Paint. Mit Canvas können Sie auf die Zeichenoberfläche zugreifen. Paint wird als Reaktion auf WM_PAINT-Botschaften des übergeordneten Steuerelements aufgerufen.

Grafische Steuerelemente können weder fokussiert werden, noch können sie andere Steuerelemente enthalten. Da grafische Steuerelemente kein Windows-Handle benötigen, verbrauchen sie weniger Systemressourcen. Außerdem werden sie schneller gezeichnet als fensteroriertierte Steuerelemente.

Wenn Sie ein Steuerelement erzeugen wollen, das den Eingabefokus erhalten und als Container für andere Steuerelemente dienen kann, das aber zugleich über die Eigenschaft Canvas und die Methode Paint verfügt, leiten Sie eine Klasse von TCustomControl ab.


Eigenschaften von TGraphicControl

TGraphicControl	Alphabetisch	Legende

In TGraphicControl

Canvas

Abgeleitet von TControl

Align

BoundsRect

ClientHeight

ClientOrigin

ClientRect

ClientWidth

ControlState

ControlStyle

Cursor

Enabled

Height

Hint

Left

Name

Parent

ShowHint

Top

Visible

Width

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TGraphicControl

TGraphicControl	Nach Objekten	Legende

Align

BoundsRect

Canvas

ClientHeight

ClientOrigin

ClientRect

ClientWidth

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlState

ControlStyle

Cursor

DesignInfo

Enabled

Height

Hint

Left

Name

Owner

Parent

ShowHint

Tag

Top

Visible

Width


TGraphicControl::Canvas

TGraphicControl	Siehe auch

Die Eigenschaft Canvas ist ein TCanvas-Objekt, das die Zeichenoberfläche für das grafische Steuerelement darstellt.

__property Graphics::TCanvas* Canvas;

Beschreibung

Mit den Eigenschaften des TCanvas-Objekts können Sie auf der Oberfläche des Steuerelements zeichnen. Canvas kapselt einen Windows-Gerätekontext, der alle Werkzeuge und Methoden bereitstellt, die zum Zeichnen benötigt werden.

Wenn ein Fenster-Handle benötigt wird, um ein Handle für einen Gerätekontext zu erhalten, verwendet Canvas das Fenster-Handle des übergeordneten Objekts, da das TGraphicControl-Objekt selbst kein Fenster-Handle hat.

Canvas ist als protected deklariert und kann in Nachkommen von TGraphicControl als public deklariert werden.


Methoden von TGraphicControl

TGraphicControl	Alphabetisch	Legende

In TGraphicControl

~TGraphicControl

Paint

TGraphicControl

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

GetTextLen

Hide

Invalidate

Perform

Refresh

Repaint

ScreenToClient

SendToBack

SetBounds

SetTextBuf

Show

Update

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TGraphicControl

TGraphicControl	Nach Objekten	Legende

~TGraphicControl

Assign

BeginDrag

BringToFront

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

ClientToScreen

DefaultHandler

DestroyComponents

Destroying

Dispatch

DragDrop

Dragging

EndDrag

FieldAddress

FindComponent

FreeInstance

FreeNotification

Free

GetParentComponent

GetTextBuf

GetTextLen

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InstanceSize

Invalidate

MethodAddress

MethodName

NewInstance

Paint

Perform

Refresh

RemoveComponent

Repaint

ScreenToClient

SendToBack

SetBounds

SetTextBuf

Show

TGraphicControl

Update


TGraphicControl::~TGraphicControl

TGraphicControl	Siehe auch

Der Destruktor ~TGraphicControl gibt den Speicher frei, der für das TGraphicControl-Objekt reserviert war. Rufen Sie ~TGraphicControl nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TGraphicControl automatisch aufgerufen wird.

__fastcall virtual ~TGraphicControl(void);


TGraphicControl::Paint

TGraphicControl	Siehe auch

Die Methode Paint von TGraphicControl stellt eine Schnittstelle für eine Methode dar, die das Bild des grafisches Steuerelements zeichnet.

virtual void __fastcall Paint(void);

Beschreibung

Ein grafisches Steuerelement erhält von seinem übergeordneten Objekt eine WM_PAINT-Botschaft, wenn es sich selbst zeichnen soll. Das Steuerelement reagiert auf diese Botschaft, indem es seine Zeichenfläche initialisiert und die Methode Paint aufruft. Indem Sie die Methode Paint überschreiben, können Sie festlegen, wie das Bild des Steuerelements gezeichnet werden soll.

Die Methode Paint stellt lediglich eine Schnittstelle dar, die von abgeleiteten Objekten überschrieben werden kann, um sich selbst zu zeichnen. Alle instantiierbaren grafischen Steuerelemente müssen Paint überschreiben, um sich selbst zu zeichnen.


TGraphicControl::TGraphicControl

TGraphicControl	Siehe auch

Die Methode TGraphicControl ist der Konstruktor für TGraphicControl.

__fastcall virtual TGraphicControl(Classes::TComponent* AOwner);

Beschreibung

Die Methode TGraphicControl erzeugt und initialisiert ein neues Grafiksteuerelement und fügt es in den Eigentümer ein, der im Parameter AOwner bezeichnet ist. Dazu wird die Methode InsertComponent des Eigentümers aufgerufen.

TGraphicControl erzeugt das TCanvas-Objekt für die Eigenschaft Canvas, nachdem der geerbte Konstruktor aufgerufen wurde.

Fast alle Steuerelemente überschreiben TGraphicControl, um individuelle Eigenschaften zu initialisieren. Wenn Sie die Methode TGraphicControl überschreiben, rufen Sie immer zuerst den geerbten Konstruktor auf und gehen dann zur Initialisierung der Komponente über.


Gültigkeitsbereich

Protected

Published

Zugriff

Read-only


Gültigkeitsbereich

Protected


Hierarchie

TObject

TPersistent

TComponent

TControl


TGraphicControl Beispiel

TGraphicControl


THandleStream

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/classes.hpp

THandleStream ist ein Stream-Objekt, mit dem Anwendungen Informationen aus Dateien lesen bzw. in Dateien schreiben können. Dateien werden dabei über ein Handle identifiziert.

Beschreibung

Über THandleStream erfolgt der Zugriff auf Dateien, die bereits geöffnet sind. Jeder Datei wird beim öffnen ein Handle zugewiesen, das die Datei für den Zugriff über ein THandleStream-Objekt eindeutig identifiziert. Soll beispielsweise das Erstellungsdatum einer Datei ermittelt werden, muß die Anwendung die Datei öffnen, ein Handle anfordern und die Funktion FileGetDate unter Verwendung dieses Handles aufrufen. Das Objekt THandleStream ermöglicht es einer Anwendung, bei E/A-Operationen auf Dateiebene eine einheitliche Stream-Schnittstelle zu verwenden.

Für Dateien, die noch nicht geöffnet sind, verwenden Sie das Objekt TFileStream.


Eigenschaften von THandleStream

THandleStream	Alphabetisch	Legende

In THandleStream

Handle

Abgeleitet von TStream

Position

Size


Eigenschaften von THandleStream

THandleStream	Nach Objekten	Legende

Handle

Position

Size


THandleStream::Handle

THandleStream	Siehe auch	Beispiel

Die Eigenschaft bezeichnet das Handle der Datei, aus welcher der Stream liest bzw. in welche der Stream schreibt.

__property int Handle;

Beschreibung

Den Wert von Handle benötigen Sie, wenn Sie Dateiverwaltungsfunktionen aufrufen, die ein Handle erfordern. Lese- und Schreibvorgänge aus bzw. in die Datei werden mit den Methoden von THandleStream ausgeführt.

Handle ist eine Nur-Lesen-Eigenschaft, deren Wert nicht verändert werden kann. Es ist also nicht möglich, durch Setzen der Eigenschaft Handle zwischen Lese- und Schreibzugriff oder umgekehrt zu wechseln. Sie müssen folgendermaßen vorgehen, wenn Sie beispielsweise von einem Datei-Handle für den Nur-Lesen-Modus zu einem Handle für den Schreiben-Modus wechseln wollen:

1	Geben Sie das Stream-Objekt frei.

2	Schließen Sie die Datei mit FileClose.

3	öffnen Sie die Datei erneut im Schreiben-Modus, und erzeugen Sie mit Hilfe des Handles eine neue Instanz eines Handle-Streams. Alternativ dazu öffnen Sie ein TFileStream-Objekt für die Datei, wobei Sie für den Stream Schreibzugriff vorgeben.

Hinweis

Rufen Sie die Funktion FileClose für das Handle erst dann auf, wenn das THandleStream-Objekt freigegeben wurde.


Methoden von THandleStream

THandleStream	Alphabetisch

In THandleStream

~THandleStream

Read

Seek

THandleStream

Write

Abgeleitet von TStream

CopyFrom

ReadBuffer

ReadComponent

ReadComponentRes

ReadResHeader

WriteBuffer

WriteComponent

WriteComponentRes

WriteDescendent

WriteDescendentRes

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von THandleStream

THandleStream	Nach Objekten

~THandleStream

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

CopyFrom

DefaultHandler

Dispatch

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance

ReadBuffer

ReadComponentRes

ReadComponent

ReadResHeader

Read

Seek

THandleStream

WriteBuffer

WriteComponentRes

WriteComponent

WriteDescendentRes

WriteDescendent

Write


THandleStream::~THandleStream

THandleStream	Siehe auch

Der Destruktor ~THandleStream gibt den Speicher frei, der für das THandleStream-Objekt reserviert war. Rufen Sie ~THandleStream nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~THandleStream automatisch aufgerufen wird.

__fastcall virtual ~THandleStream(void);


THandleStream::Read

THandleStream	Siehe auch

Die Methode Read liest die in Count angegebene Zahl von Bytes aus der Datei, die dem Handle-Stream zugeordnet ist, in den Puffer ein, der mit dem Parameter Buffer bezeichnet ist.

virtual long __fastcall Read(void *Buffer, long Count);

Beschreibung

Mit Read können Daten aus einer Datei gelesen werden, die dem Handle-Stream zugeordnet ist und deren Größe in Byte nicht bekannt ist. Beginnend an der aktuellen Position werden maximal so viele Bytes gelesen, wie mit Count angegeben. Anschließend wird die aktuelle Dateiposition der tatsächlich übertragenen Byte-Anzahl angepaßt. Diese Anzahl wird zurückgegeben. Sie ist eventuell kleiner als der Wert von Count, wenn bereits vorher das Dateiende erreicht wird.

Alle anderen Methoden eines Handle-Streams zum Lesen von Daten (ReadBuffer, ReadComponent) rufen die Methode Read für den eigentlichen Lesevorgang auf.

Hinweis

Rufen Sie Read nicht auf, wenn die Datei im Modus fmOpenWrite geöffnet wurde, um das Datei-Handle anzufordern.


THandleStream::Seek

THandleStream	Siehe auch

Die Methode Seek setzt die aktuelle Position im Handle-Stream auf einen neuen Wert.

virtual long __fastcall Seek(long Offset, unsigned short Origin);

Beschreibung

Mit Seek wird die aktuelle Position innerhalb der Datei, die dem Handle-Stream zugeordnet ist, entsprechend dem Wert von Offset angepaßt. Seek ermöglicht es einer Anwendung, den Dateizeiger beliebig zu setzen.

Der Parameter Origin legt fest, wie der Parameter Offset interpretiert werden soll. Folgende Werte sind für Origin möglich:

Werte	Bedeutung

soFromBeginning	Offset bezieht sich auf den Anfang der Datei. Seek verschiebt zur Position Offset. Offset muß größer oder gleich Null sein.

soFromCurrent	Offset bezieht sich auf den aktuellen Wert der Eigenschaft Position. Seek verschiebt zu <aktuelle Position> + Offset.

soFromEnd	Offset bezieht sich auf das Ende der Datei. Offset muß kleiner oder gleich Null sein und bezeichnet die Anzahl von Bytes vor dem Dateiende.

Seek gibt den neuen Wert der Eigenschaft Position zurück.


THandleStream::THandleStream

THandleStream	Siehe auch

Der Konstruktor THandleStream erzeugt ein neues THandleStream-Objekt.

__fastcall THandleStream(int AHandle);

Beschreibung

Mit THandleStream können Sie ein THandleStream-Objekt für ein bestimmtes Handle instantiieren. Das Handle muß erzeugt werden, indem die Ressource im geeigneten Modus geöffnet oder erzeugt wird. Wenn Sie beispielsweise ein THandleStream-Objekt zum Lesen aus einer Datei erzeugen, ermitteln Sie das Datei-Handle, indem Sie die Datei im Modus fmOpenRead oder fmOpenReadWrite öffnen. Um ein THandleStream-Objekt zum Schreiben in eine Datei zu erzeugen, ermitteln Sie das Datei-Handle, indem Sie die Datei im Modus fmOpenWrite oder fmOpenReadWrite öffnen.


THandleStream::Write

THandleStream	Siehe auch

Die Methode Write schreibt die mit Count vorgegebene Anzahl von Bytes aus dem Puffer (Buffer) an die aktuelle Position in der Datei.

virtual long __fastcall Write(const void *Buffer, long Count);

Beschreibung

Mit Write werden, beginnend an der aktuellen Position, so viele Bytes in die Datei geschrieben, die dem Handle-Stream zugeordnet ist, wie in Count vorgegeben. Die neue Dateiposition wird entsprechend angepaßt. Die Anzahl der tatsächlich geschriebenen Bytes bildet den Rückgabewert.

Alle anderen Methoden eines Handle-Streams zum Schreiben von Daten (WriteBuffer, WriteComponent) rufen Write für den eigentlichen Schreibvorgang auf.

Hinweis

Rufen Sie Write nicht auf, wenn Sie die Datei im Modus fmOpenRead geöffnet haben, um das Datei-Handle abzurufen.


Zugriff

Read-only


Hierarchie

TObject

TStream


THandleStream Beispiel

THandleStream


 THeaderControl

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/comctrls.hpp

THeaderControl ist ein Container für THeaderSection-Objekte. Er stellt eine Menge in der Größe veränderbarer Tabellenköpfe bereit.

Beschreibung

THeaderControl repräsentiert Tabellenköpfe, die der Benutzer zur Laufzeit in der Größe anpassen kann. Jeder Tabellenkopf wird durch ein in der Eigenschaft Sections aufgeführtes THeaderSection-Objekt repräsentiert.

Der Tabellenkopfbereich kann über Spalten oder Feldern mit Informationen plaziert werden. Zum Beispiel könnten Tabellenkopfbereiche über einem Listenfeld (TListBox) plaziert werden. Da THeaderControl ein generisches Tabellenkopfelement bereitstellt, das mit nahezu jeder visuellen Komponente verbunden werden kann, wird eine Änderung, die zur Laufzeit am Tabellenkopfbereich vorgenommen wird, nicht automatisch für die darunterliegenden Komponenten übernommen. Wenn Sie zum Beispiel die Spalte unter einem Tabellenkopfbereich immer zusammen mit der Größe der Kopfzeile verändern wollen, müssen Sie für diese Aufgabe eine Ereignisbehandlungsroutine für OnSectionResize schreiben.


Eigenschaften von THeaderControl

THeaderControl	Alphabetisch	Legende

In THeaderControl

Canvas

Sections

Abgeleitet von TWinControl

Brush

ClientOrigin

ClientRect

ControlCount

Controls

Handle

HelpContext

Showing

TabOrder

TabStop

Abgeleitet von TControl

Align

BoundsRect

ClientHeight

ClientWidth

ControlState

ControlStyle

Cursor

DragCursor

DragMode

Enabled

Font

Height

Hint

Left

Name

Parent

ParentFont

ParentShowHint

PopupMenu

ShowHint

Top

Visible

Width

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von THeaderControl

THeaderControl	Nach Objekten	Legende

Align

BoundsRect

Brush

Canvas

ClientHeight

ClientOrigin

ClientRect

ClientWidth

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlCount

ControlState

Controls

ControlStyle

Cursor

DesignInfo

DragCursor

DragMode

Enabled

Font

Handle

Height

HelpContext

Hint

Left

Name

Owner

ParentFont

ParentShowHint

Parent

PopupMenu

Sections

ShowHint

Showing

TabOrder

TabStop

Tag

Top

Visible

Width


THeaderControl::Canvas

THeaderControl	Siehe auch

Die Eigenschaft Canvas ermöglicht zur Laufzeit den Zugriff auf die Zeichenfläche des Tabellenkopf-Steuerelements.

__property Graphics::TCanvas* Canvas;

Beschreibung

Mit der Nur-Lesen-Eigenschaft Canvas können Sie zur Laufzeit auf die Zeichenfläche des Tabellenkopf-Steuerelements zugreifen, die beim Implementieren einer Ereignisbehandlungsroutine für das Ereignis OnDrawSection verwendet werden kann.


THeaderControl::Sections

THeaderControl	Siehe auch

Die Eigenschaft Sections enthält eine Liste von Tabellenkopfbereichen (Tabellenköpfe).

__property THeaderSections* Sections;

Beschreibung

In der Eigenschaft Sections ist THeaderSections gespeichert, eine Kollektion von THeaderSection-Objekten. Tabellenkopfbereiche können während des Entwurfs mit dem Bereichseditor hinzugefügt, entfernt oder bearbeitet werden. Wählen Sie zum öffnen des Bereichseditor die Eigenschaft Sections im Objektinspektor, und klicken Sie dann doppelt auf die Wertespalte oder einmal auf die Werkzeugschaltfläche.


Ereignisse von THeaderControl

THeaderControl	Alphabetisch	Legende

In THeaderControl

OnDrawSection

OnResize

OnSectionClick

OnSectionResize

OnSectionTrack

Abgeleitet von TControl

OnDragDrop

OnDragOver

OnEndDrag

OnMouseDown

OnMouseMove

OnMouseUp

OnStartDrag


Ereignisse von THeaderControl

THeaderControl	Nach Objekten	Legende

OnDragDrop

OnDragOver

OnDrawSection

OnEndDrag

OnMouseDown

OnMouseMove

OnMouseUp

OnResize

OnSectionClick

OnSectionResize

OnSectionTrack

OnStartDrag


THeaderControl::OnDrawSection

THeaderControl	Siehe auch

Das Ereignis OnDrawSection tritt ein, wenn ein Tabellenkopfbereich neu gezeichnet werden muß.

typedef void __fastcall (__closure *TDrawSectionEvent)(THeaderControl* HeaderControl, THeaderSection* Section, const Windows::TRect &Rect, bool Pressed);

__property TDrawSectionEvent OnDrawSection;

Beschreibung

Das Ereignis OnDrawSection tritt ein, wenn die Anzeige des Tabellenkopfbereichs aktualisiert werden muß, weil zum Beispiel der Benutzer einen Bereich auswählt oder dessen Größe ändert. Das Ereignis OnDrawSection tritt nur ein, wenn der Eigenschaft Style des Tabellenkopfbereiches der Wert hsOwnerDraw zugewiesen wurde.

TDrawSectionEvent ist der Typ der Eigenschaft OnDrawSection.


THeaderControl::OnResize

THeaderControl	Siehe auch

Das Ereignis OnResize tritt ein, wenn die Größe des Tabellenkopf-Steuerelements geändert wird.

typedef void __fastcall (__closure *TNotifyEvent)(System::TObject* Sender);

__property Classes::TNotifyEvent OnResize;

Beschreibung

Das Ereignis OnResize tritt ein, wenn die Größe des Tabellenkopf-Steuerelements zur Laufzeit geändert wird.


THeaderControl::OnSectionClick

THeaderControl	Siehe auch

Das Ereignis OnSectionClick tritt ein, wenn auf eine der Bereiche des Tabellenkopf-Steuerelements geklickt wird.

typedef void __fastcall (__closure *TSectionNotifyEvent)(THeaderControl* HeaderControl, THeaderSection* Section);

__property TSectionNotifyEvent OnSectionClick;

Beschreibung

Das Ereignis OnSectionClick tritt ein, wenn zur Laufzeit auf einen Tabellenkopfbereich geklickt wird. Weisen Sie der Eigenschaft AllowClick den Wert False zu, ist das Klicken auf den Bereich nicht möglich.

TSectionNotifyEvent ist der Typ der Ereignisse OnSectionClick und OnSectionResize.


THeaderControl::OnSectionResize

THeaderControl	Siehe auch

Das Ereignis OnSectionResize tritt ein, wenn die Größe eines Bereichs Tabellenkopf-Steuerelement geändert wird.

typedef void __fastcall (__closure *TSectionNotifyEvent)(THeaderControl* HeaderControl, THeaderSection* Section);

__property TSectionNotifyEvent OnSectionResize;

Beschreibung

Das Ereignis OnSectionResize tritt ein, wenn die Größe eines Tabellenkopfbereichs zur Laufzeit geändert wird. Das ist der Fall, wenn der Benutzer den Mauszeiger zwischen zwei Bereichen positioniert und nach links oder rechts zieht.

TSectionNotifyEvent ist der Typ der Ereignisse OnSectionClick und OnSectionResize.


THeaderControl::OnSectionTrack

THeaderControl	Siehe auch

Das Ereignis OnSectionTrack tritt ein, während die Größe eines Bereichs Tabellenkopf-Steuerelement geändert wird.

enum TSectionTrackState { tsTrackBegin, tsTrackMove, tsTrackEnd };

typedef void __fastcall (__closure *TSectionTrackEvent)(THeaderControl* HeaderControl, THeaderSection* Section, int Width, TSectionTrackState State);

__property TSectionTrackEvent OnSectionTrack;

Beschreibung

Das Ereignis OnSectionTrack überwacht das Ziehen des Tabellenkopfbereichrahmens. OnSectionTrack tritt ein, wenn der Mauszeiger zwischen zwei Bereichen positioniert und die linke Maustaste losgelassen wird.

OnSectionTrack besitzt den Typ TSectionTrackEvent, dessen Parameter Width und State die Größe des Tabellenkopfbereichs (in Pixel) und den Status des Ereignisses bezeichnen. Die Eigenschaft State kann einen der folgenden Werte einnehmen:

Wert	Beschreibung

tsTrackBegin	Der Rahmen wurde bisher nicht gezogen.

tsTrackMove	Der Rahmen wird gerade gezogen.

tsTrackEnd	Der Rahmen wird nicht mehr gezogen.

Mit OnSectionTrack können Sie eine Ereignisbehandlungsroutine programmieren, die zur Laufzeit spezielle Aktionen durchführt, wenn die Größe eines Tabellenkopfbereichs verändert wird.


Methoden von THeaderControl

THeaderControl	Alphabetisch

In THeaderControl

~THeaderControl

THeaderControl

Abgeleitet von TWinControl

Broadcast

CanFocus

ContainsControl

ControlAtPos

DisableAlign

EnableAlign

Focused

GetTabOrderList

HandleAllocated

HandleNeeded

InsertControl

Invalidate

PaintTo

Realign

RemoveControl

Repaint

ScaleBy

ScrollBy

SetBounds

SetFocus

Update

UpdateControlState

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

GetTextLen

Hide

Perform

Refresh

ScreenToClient

SendToBack

SetTextBuf

Show

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von THeaderControl

THeaderControl	Nach Objekten

~THeaderControl

Assign

BeginDrag

BringToFront

Broadcast

CanFocus

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

ClientToScreen

ContainsControl

ControlAtPos

DefaultHandler

DestroyComponents

Destroying

DisableAlign

Dispatch

DragDrop

Dragging

EnableAlign

EndDrag

FieldAddress

FindComponent

Focused

FreeInstance

FreeNotification

Free

GetParentComponent

GetTabOrderList

GetTextBuf

GetTextLen

HandleAllocated

HandleNeeded

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InsertControl

InstanceSize

Invalidate

MethodAddress

MethodName

NewInstance

PaintTo

Perform

Realign

Refresh

RemoveComponent

RemoveControl

Repaint

ScaleBy

ScreenToClient

ScrollBy

SendToBack

SetBounds

SetFocus

SetTextBuf

Show

THeaderControl

UpdateControlState

Update


THeaderControl::~THeaderControl

THeaderControl	Siehe auch

Die Methode ~THeaderControl gibt das THeaderControl-Objekt und den zugewiesenen Speicher frei.

__fastcall virtual ~THeaderControl(void);

Beschreibung

Die Methode THeaderControl gibt ein Tabellenkopf-Steuerelement zusammen mit dessen Zeichenfläche und Tabellenkopfbereichen frei.


THeaderControl::THeaderControl

THeaderControl	Siehe auch

Die Methode THeaderControl erzeugt und initialisiert eine THeaderControl-Komponente.

__fastcall virtual THeaderControl(Classes::TComponent* AOwner);

Beschreibung

Die Methode THeaderControl erzeugt ein Tabellenkopf-Steuerelement zusammen mit dessen Zeichenfläche und Tabellenkopfbereichen.


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TControl

TWinControl


THeaderControl Beispiel

THeaderControl


THeaderSection

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/comctrls.hpp

THeaderSection repräsentiert einen Bereich einer Kopfleiste.

Beschreibung

Alle THeaderControl-Objekte verwenden ein THeaderSections-Objekt, um eine Kollektion von THeaderSection-Objekten zu verwalten.


Eigenschaften von THeaderSection

THeaderSection	Alphabetisch	Legende

In THeaderSection

Alignment

AllowClick

Left

MaxWidth

MinWidth

Right

Style

Text

Width

Abgeleitet von TCollectionItem

Collection

Index


Eigenschaften von THeaderSection

THeaderSection	Nach Objekten	Legende

Alignment

AllowClick

Collection

Index

Left

MaxWidth

MinWidth

Right

Style

Text

Width


THeaderSection::Alignment

THeaderSection	Siehe auch	Beispiel

Die Eigenschaft legt fest, wie Text in Kopfleistenbereichen ausgerichtet wird.

__property Classes::TAlignment Alignment;

Beschreibung

Alignment kann folgende Werte annehmen:

Wert	Bedeutung

taLeftJustify	Text wird an der linken Seite ausgerichtet.

taCenter	Text wird zentriert.

taRightJustify	Text wird an der rechten Seite ausgerichtet.


THeaderSection::AllowClick

THeaderSection	Siehe auch

Die Eigenschaft legt fest, ob ein Bereich zur Laufzeit angeklickt werden kann.

__property bool AllowClick;

Beschreibung

Wenn AllowClick den Vorgabewert True hat, kann der Kopfleistenbereich zur Laufzeit angeklickt werden. Es ergibt sich dann die Funktion einer Schaltfläche. Der Bereich scheint in die Bildschirmfläche vertieft. Wenn dem Klick-Ereignis eine Funktion zugeordnet werden soll, schreiben Sie eine Ereignisbehandlungsroutine für OnSectionClick.


THeaderSection::Left

THeaderSection	Siehe auch	Beispiel

Die Eigenschaft bestimmt die horizontale Position des linken Randes des Kopfleistenbereichs.

__property int Left;

Beschreibung

Der Wert von Left entspricht der horizontalen Koordinate des linken Randes des Kopfleistenbereichs, bezogen auf den linken Rand des Steuerelements. Als Maßeinheit gelten Pixel.


THeaderSection::MaxWidth

THeaderSection	Siehe auch

Die Eigenschaft gibt die maximale Breite des Kopfleistenbereichs an.

__property int MaxWidth;

Beschreibung

Mit MaxWidth wird die minimale Breite des Kopfleistenbereichs in Pixel festgelegt. Wenn MaxWidth = MinWidth, ist eine Größenveränderung zur Laufzeit nicht möglich.


THeaderSection::MinWidth

THeaderSection	Siehe auch

Die Eigenschaft gibt die minimale Breite des Kopfleistenbereichs an.

__property int MinWidth;

Beschreibung

Mit MinWidth wird die minimale Breite des Kopfleistenbereichs in Pixel festgelegt. Wenn MinWidth = MaxWidth, ist eine Größenveränderung zur Laufzeit nicht möglich.


THeaderSection::Right

THeaderSection	Siehe auch

Die Eigenschaft gibt die horizontale Position des rechten Randes des Kopfleistenbereichs an.

__property int Right;

Beschreibung

Der Wert von Right entspricht der horizontalen Koordinate des rechten Randes des Kopfleistenbereichs, gemessen vom linken Rand des Steuerelements. Als Maßeinheit gelten Pixel. Somit entspricht Right der Summe von Left und Width.


THeaderSection::Style

THeaderSection	Siehe auch

Die Eigenschaft legt fest, wie der Text angezeigt wird, der zum Kopfleistenbereich gehört.

__property THeaderSectionStyle Style;

Beschreibung

Wenn Style den Vorgabewert hsText hat, wird der in Text enthaltene String im Kopfleistenbereich angezeigt. Die Ausrichtung wird dabei von Alignment gesteuert. Die Schriftart ist in der Eigenschaft Font vorgegeben.

Wenn Style dagegen auf hsOwnerDraw gesetzt ist, wird der Inhalt des Kopfleistenbereichs zur Laufzeit durch die entsprechenden Anweisungen in einer Ereignisbehandlungsroutine für THeaderControl.OnDrawSection auf der Zeichenfläche des Steuerelements dargestellt.


THeaderSection::Text

THeaderSection	Siehe auch	Beispiel

Die Eigenschaft enthält die Beschriftung des Kopfleistenbereichs.

__property System::AnsiString Text;

Die Eigenschaft Text enthält einen String, der den Kopfleistenbereich oder die darunterliegende Spalte näher beschreibt. Wenn die Eigenschaft Style den Wert hsText hat, erscheint der Wert von Text innerhalb des Bereichs.


THeaderSection::Width

THeaderSection	Siehe auch	Beispiel

Die Eigenschaft bezeichnet die Breite eines Kopfleistenbereichs.

__property int Width;

Beschreibung

Die Eigenschaft Width bezeichnet die voreingestellte Breite des Kopfleistenbereichs in Pixel. Die einzelnen Bereiche können zur Laufzeit vergrößert und verkleinert werden, indem ihre Umrandung gezogen wird.


Methoden von THeaderSection

THeaderSection	Alphabetisch

In THeaderSection

~THeaderSection

Assign

THeaderSection

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von THeaderSection

THeaderSection	Nach Objekten

~THeaderSection

Assign

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance

THeaderSection


THeaderSection::~THeaderSection

THeaderSection

Der Destruktor ~THeaderSection gibt den Speicher frei, der für das THeaderSection-Objekt reserviert war. Rufen Sie ~THeaderSection nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~THeaderSection automatisch aufgerufen wird.

__fastcall virtual ~THeaderSection(void);


THeaderSection::Assign

THeaderSection	Siehe auch

Die Methode kopiert den Inhalt eines Kopfleistenbereichs in einen neuen.

virtual void __fastcall Assign(Classes::TPersistent* Source);

Beschreibung

Mit Assign wird ein neuer Kopfleistenbereich erzeugt, bei dem die Werte für Alignment, AllowClick, MaxWidth, MinWidth, Style, Text und Width mit denen des Quellobjekts identisch sind.


THeaderSection::THeaderSection

THeaderSection	Siehe auch

Die Methode THeaderSection erzeugt und initialisiert einen Kopfleistenbereich.

__fastcall virtual THeaderSection(Classes::TCollection* Collection);

Beschreibung

THeaderSection nimmt eine Instanz von THeaderSections als Argument entgegen.


Gültigkeitsbereich

Published

Zugriff

Read-only


Hierarchie

TObject

TPersistent

TCollectionItem


THeaderSection Beispiel

THeaderSection


THeaderSections

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/comctrls.hpp

THeaderSections ist ein Container für THeaderSection-Objekte.

Beschreibung

Alle THeaderSections-Objekte enthalten eine Kollektion von THeaderSection-Objekten in einem THeaderControl-Objekt. THeaderSections verwaltet in seinem Array Items einen Index der einzelnen Kopfleistenbereiche. Die Eigenschaft Count enthält deren Anzahl. Zur Entwurfszeit verwenden Sie den zugehörigen Editor, um Kopfleistenbereiche hinzuzufügen, zu entfernen oder zu ändern.


Eigenschaften von THeaderSections

THeaderSections	Alphabetisch	Legende

In THeaderSections

Items

Abgeleitet von TCollection

Count


Eigenschaften von THeaderSections

THeaderSections	Nach Objekten	Legende

Count

Items


THeaderSections::Items

THeaderSections	Siehe auch

Die Eigenschaft ist der Index der einzelnen Kopfleistenbereiche in der Kollektion.

__property THeaderSection* Items[int Index];

Beschreibung

Der Wert des Parameters Index entspricht der Eigenschaft Index von THeaderSection. Er bezeichnet die Position des Bereichs in der Kopfleiste.


Methoden von THeaderSections

THeaderSections	Alphabetisch

In THeaderSections

~THeaderSections

Add

THeaderSections

Abgeleitet von TCollection

Assign

BeginUpdate

Clear

EndUpdate

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von THeaderSections

THeaderSections	Nach Objekten

~THeaderSections

Add

Assign

BeginUpdate

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

Clear

DefaultHandler

Dispatch

EndUpdate

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance

THeaderSections


THeaderSections::~THeaderSections

THeaderSections

Der Destruktor ~THeaderSections gibt den Speicher frei, der für das THeaderSections-Objekt reserviert war. Rufen Sie ~THeaderSections nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~THeaderSections automatisch aufgerufen wird.

__fastcall virtual ~THeaderSections(void);


THeaderSections::Add

THeaderSections	Siehe auch

Die Methode erzeugt eine neue Instanz von THeaderSection und fügt sie dem Array Items hinzu.

THeaderSection* __fastcall Add(void);

Beschreibung

Add gibt den neuen Bereich zurück. Während des Entwurfs können Sie den für Kopfleisten vorgesehenen Editor verwenden, um weitere Bereich hinzuzufügen.


THeaderSections::THeaderSections

THeaderSections	Siehe auch

Der Konstruktor THeaderSections erzeugt und initialisiert ein neues THeaderSections-Objekt.

__fastcall THeaderSections(THeaderControl* HeaderControl);

Beschreibung

Die Methode THeaderSections nimmt eine Instanz von THeaderControl als Parameter entgegen.


Zugriff

Read-only


Hierarchie

TObject

TPersistent

TCollection


THeaderSections Beispiel

THeaderSections


 THeader

Hierarchie	Eigenschaften	Methoden	Ereignisse

Header

vcl/extctrls.hpp

Die Komponente THeader ist ein in Bereiche unterteiltes visuelles Steuerelement. Die einzelnen Bereiche enthalten Text und können mit der Maus vergrößert und verkleinert werden. Die Klasse THeader dient lediglich der Abwärtskompatibilität. In Anwendungen für Microsoft Windows 95 und Windows NT sollten Sie die Komponente THeaderControl verwenden.

Zur Entwurfszeit wird ein Bereich dadurch vergrößert bzw. verkleinert, indem mit der rechten Maustaste auf die Umrandung geklickt und die neue Größe eingestellt wird. Zur Laufzeit kann der Benutzer dies mit der linken Maustaste erledigen. Die Breite der übrigen Bereiche bleibt jeweils unverändert.

Die einzelnen Bereiche werden mit der Eigenschaft Sections definiert. Die Eigenschaft AllowResize gibt an, ob der Benutzer die Bereiche zur Laufzeit in der Größe ändern kann. Eine Größenänderung löst ein OnSizing-Ereignis aus.

Entsprechende Ereignisbehandlungsroutinen könnten dann dafür sorgen, daß der Text neu ausgerichtet wird.


Eigenschaften von THeader

THeader	Alphabetisch	Legende

In THeader

AllowResize

BorderStyle

Sections

SectionWidth

Width

Abgeleitet von TWinControl

Brush

ClientOrigin

ClientRect

ControlCount

Controls

Handle

HelpContext

Showing

TabOrder

TabStop

Abgeleitet von TControl

Align

BoundsRect

ClientHeight

ClientWidth

ControlState

ControlStyle

Cursor

Enabled

Font

Height

Hint

Left

Name

Parent

ParentFont

ParentShowHint

PopupMenu

ShowHint

Top

Visible

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von THeader

THeader	Nach Objekten	Legende

Align

AllowResize

BorderStyle

BoundsRect

Brush

ClientHeight

ClientOrigin

ClientRect

ClientWidth

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlCount

ControlState

Controls

ControlStyle

Cursor

DesignInfo

Enabled

Font

Handle

Height

HelpContext

Hint

Left

Name

Owner

ParentFont

ParentShowHint

Parent

PopupMenu

Sections

SectionWidth

ShowHint

Showing

TabOrder

TabStop

Tag

Top

Visible

Width


THeader::AllowResize

THeader

Die Eigenschaft legt fest, ob der Benutzer die Kopfleiste zur Laufzeit vergrößern und verkleinern kann.

__property bool AllowResize;

Beschreibung

Wenn AllowResize den Wert False hat, können die einzelnen Bereiche nicht in der Größe verändert werden. Andernfalls kann die Breite durch Ziehen der Umrandung verändert werden. Der Vorgabewert ist True.


THeader::BorderStyle

THeader	Beispiel

Die Eigenschaft legt fest, ob die Kopfleiste mit einer Umrandung dargestellt wird.

property BorderStyle: TBorderStyle;

Beschreibung

Die Eigenschaft kann die folgenden Werte annehmen:

Wert	Bedeutung

bsNone	Keine sichtbare Umrandung.

bsSingle	Einfache Umrandung.


THeader::Sections

THeader

Diese Eigenschaft enthält eine Liste von Strings mit dem Text der einzelnen Bereiche einer Kopfleiste.

__property Classes::TStrings* Sections;

Beschreibung

Die Anzahl der Zeilen in der String-Liste entspricht der Anzahl der Bereiche, aus denen die Kopfleiste besteht. Wenn die String-Liste leer ist, verfügt die Kopfleiste nur über einen einzigen leeren Bereich. Enthält die String-Liste dagegen ein oder mehrere Zeilen, wird jedem dieser Textelemente ein eigener Bereich zugewiesen. Die erste Zeile gelangt in den Bereich ganz links, die nächste Zeile in den zweiten Bereich von links und so fort.


THeader::SectionWidth

THeader

Die Eigenschaft gibt die Breite eines Bereichs in Pixel an.

__property int SectionWidth[int X];

Beschreibung

Der Integer X ist ein Index, der auf die einzelnen Bereiche verweist. Die Indexwerte reichen von 0 bis zur Anzahl der Bereiche minus 1. Der erste Bereich hat den Index 0.


THeader::Width

THeader	Beispiel

Die Eigenschaft gibt die horizontale Größe des Steuerelements oder Formulars in Pixel an.

?????????????????????????

Beschreibung

Wenn der Wert von Width erhöht wird, wird das Formular bzw. das Steuerelement breiter.


Ereignisse von THeader

THeader	Alphabetisch	Legende

In THeader

OnSized

OnSizing


Ereignisse von THeader

THeader	Nach Objekten	Legende

OnSized

OnSizing


THeader::OnSized

THeader	Siehe auch

Das Ereignis wird ausgelöst, nachdem die Kopfleiste in der Größe verändert wurde.

typedef void __fastcall (__closure *TSectionEvent)(System::TObject* Sender, int ASection, int AWidth	);

__property TSectionEvent OnSized;

Beschreibung

Überschreiben Sie OnSized so, daß eine bestimmte Aktion ausgeführt wird, nachdem die Kopfleiste vergrößert oder verkleinert wurde.


THeader::OnSizing

THeader	Siehe auch

Das Ereignis wird ausgelöst, wenn die Größe der Kopfleiste gerade verändert wird.

typedef void __fastcall (__closure *TSectionEvent)(System::TObject* Sender, int ASection, int AWidth	);

__property TSectionEvent OnSizing;

Beschreibung

Überschreiben Sie OnSizing so, daß eine bestimmte Aktion stattfindet, während die Kopfzeile vergrößert oder verkleinert wird.


Methoden von THeader

THeader	Alphabetisch

In THeader

~THeader

THeader

Abgeleitet von TWinControl

Broadcast

CanFocus

ContainsControl

ControlAtPos

DisableAlign

EnableAlign

Focused

GetTabOrderList

HandleAllocated

HandleNeeded

InsertControl

Invalidate

PaintTo

Realign

RemoveControl

Repaint

ScaleBy

ScrollBy

SetBounds

SetFocus

Update

UpdateControlState

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

GetTextLen

Hide

Perform

Refresh

ScreenToClient

SendToBack

SetTextBuf

Show

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von THeader

THeader	Nach Objekten

~THeader

Assign

BeginDrag

BringToFront

Broadcast

CanFocus

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

ClientToScreen

ContainsControl

ControlAtPos

DefaultHandler

DestroyComponents

Destroying

DisableAlign

Dispatch

DragDrop

Dragging

EnableAlign

EndDrag

FieldAddress

FindComponent

Focused

FreeInstance

FreeNotification

Free

GetParentComponent

GetTabOrderList

GetTextBuf

GetTextLen

HandleAllocated

HandleNeeded

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InsertControl

InstanceSize

Invalidate

MethodAddress

MethodName

NewInstance

PaintTo

Perform

Realign

Refresh

RemoveComponent

RemoveControl

Repaint

ScaleBy

ScreenToClient

ScrollBy

SendToBack

SetBounds

SetFocus

SetTextBuf

Show

THeader

UpdateControlState

Update


THeader::~THeader

THeader

Der Destruktor ~THeader gibt den Speicher frei, der für das THeader-Objekt reserviert war. Rufen Sie ~THeader nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~THeader automatisch aufgerufen wird.

__fastcall virtual ~THeader(void);


THeader::THeader

THeader

Der Konstruktor THeader erzeugt ein neues THeader-Objekt.

__fastcall virtual THeader(Classes::TComponent* AOwner);


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TControl

TWinControl

TCustomControl


THeader Beispiel

THeader


THintWindow

Hierarchie	Eigenschaften	Methoden

Header

vcl/controls.hpp

Die Komponente THintWindow ist ein einfaches benutzerdefiniertes Steuerelement, das von TCustomControl angeleitet ist. Es handelt sich dabei um ein kleines Popup-Fenster, das zur Laufzeit über einem Steuerelement angezeigt wird, wenn die Eigenschaft ShowHint dieses Steuerelements auf True gesetzt ist.

Beschreibung

Zusätzlich zu den Merkmalen, die von TCustomControl geerbt wurden, besitzt THintWindow mehrere Eigenschaften und Methoden. Die geerbten Eigenschaften Canvas, Caption und Color werden als public deklariert. THintWindow überschreibt die geschützten Methoden CreateParams und Paint und führt drei neue Methoden ein:

•	ActivateHint dient zur Anzeige eines Hinweisfensters.

•	IsHintMsg ermöglicht es dem Hinweisfenster, Botschaften zu überwachen, die von der Anwendung ausgehen, und so zu bestimmen, wann es ausgeblendet werden soll.

•	ReleaseHandle gibt das Fenster-Handle des Hinweisfensters frei.

Wenn Sie für Ihre Zwecke einen neuen Art von Hinweisfenster erzeugen wollen, leiten Sie von THintWindow einen neuen Typ ab, überschreiben die Methoden nach Bedarf und weisen der  Variablen HintWindowClass beim Start der Anwendung den neuen Typ zu.


Eigenschaften von THintWindow

THintWindow	Alphabetisch	Legende

Abgeleitet von TCustomControl

Canvas

Abgeleitet von TWinControl

Brush

ClientOrigin

ClientRect

ControlCount

Controls

Handle

HelpContext

Showing

TabOrder

TabStop

Abgeleitet von TControl

Align

BoundsRect

Caption

ClientHeight

ClientWidth

Color

ControlState

ControlStyle

Cursor

Enabled

Height

Hint

Left

Name

Parent

ShowHint

Top

Visible

Width

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von THintWindow

THintWindow	Nach Objekten	Legende

Align

BoundsRect

Brush

Canvas

Caption

ClientHeight

ClientOrigin

ClientRect

ClientWidth

Color

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlCount

ControlState

Controls

ControlStyle

Cursor

DesignInfo

Enabled

Handle

Height

HelpContext

Hint

Left

Name

Owner

Parent

ShowHint

Showing

TabOrder

TabStop

Tag

Top

Visible

Width


Methoden von THintWindow

THintWindow	Alphabetisch

In THintWindow

~THintWindow

ActivateHint

IsHintMsg

ReleaseHandle

THintWindow

Abgeleitet von TWinControl

Broadcast

CanFocus

ContainsControl

ControlAtPos

DisableAlign

EnableAlign

Focused

GetTabOrderList

HandleAllocated

HandleNeeded

InsertControl

Invalidate

PaintTo

Realign

RemoveControl

Repaint

ScaleBy

ScrollBy

SetBounds

SetFocus

Update

UpdateControlState

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

GetTextLen

Hide

Perform

Refresh

ScreenToClient

SendToBack

SetTextBuf

Show

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von THintWindow

THintWindow	Nach Objekten

~THintWindow

ActivateHint

Assign

BeginDrag

BringToFront

Broadcast

CanFocus

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

ClientToScreen

ContainsControl

ControlAtPos

DefaultHandler

DestroyComponents

Destroying

DisableAlign

Dispatch

DragDrop

Dragging

EnableAlign

EndDrag

FieldAddress

FindComponent

Focused

FreeInstance

FreeNotification

Free

GetParentComponent

GetTabOrderList

GetTextBuf

GetTextLen

HandleAllocated

HandleNeeded

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InsertControl

InstanceSize

Invalidate

IsHintMsg

MethodAddress

MethodName

NewInstance

PaintTo

Perform

Realign

Refresh

ReleaseHandle

RemoveComponent

RemoveControl

Repaint

ScaleBy

ScreenToClient

ScrollBy

SendToBack

SetBounds

SetFocus

SetTextBuf

Show

THintWindow

UpdateControlState

Update


THintWindow::~THintWindow

THintWindow

Der Destruktor ~THintWindow gibt den Speicher frei, der für das THintWindow-Objekt reserviert war. Rufen Sie ~THintWindow nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~THintWindow automatisch aufgerufen wird.

__fastcall virtual ~THintWindow(void);


THintWindow::ActivateHint

THintWindow

Die Methode aktiviert das Hinweisfenster.

virtual void __fastcall ActivateHint(const Windows::TRect &Rect, const System::AnsiString AHint);

Beschreibung

Die Methode ActivateHint aktiviert das Hinweisfenster, setzt dessen Beschriftung auf den String, der im Parameter AHint übergeben wurde, und dimensioniert das Begrenzungsrechteck entsprechend dem Wert von Rect. Standardmäßig ruft ActivateHint die API-Funktion SetWindowPos auf, um das Hinweisfenster darzustellen.

Nach der Aktivierung durchlaufen alle von der Anwendung ausgehenden Botschaften die Methode IsHintMsg des Hinweisfensters. Dabei wird entschieden, ob das Hinweisfenster ausgeblendet werden muß oder nicht.

Das Aussehen des Hinweisfensters läßt sich mit der Methode Paint beeinflussen. Lediglich das im Parameter Rect übergebene Rechteck sollte nicht verändert werden, da es explizit von der Anwendung festgelegt wurde.


THintWindow::IsHintMsg

THintWindow

Die Methode ermittelt, ob das Hinweisfenster ausgeblendet werden muß, weil die Anwendung eine Botschaft sendet.

virtual bool __fastcall IsHintMsg(MSG &Msg);

Beschreibung

Die Methode IsHintMsg prüft das Vorhandensein von Botschaften, während das Hinweisfenster aktiv ist, das heißt, nachdem ActivateHint aufgerufen wurde. Sobald eine Botschaft erkannt wird, die von der Maus, der Tastatur, einem Befehl oder einem Aktivierungsereignis ausgeht, gibt IsHintMsg den Wert True zurück und veranlaßt damit die Anwendung, das Hinweisfenster auszublenden.


THintWindow::ReleaseHandle

THintWindow

Die Methode gibt das Handle des Hinweisfensters frei.

void __fastcall ReleaseHandle(void);

Beschreibung

Die Methode ReleaseHandle ruft die Methode DestroyHandle auf und gibt damit das Handle auf das Hinweisfenster frei.


THintWindow::THintWindow

THintWindow

Der Konstruktor THintWindow erzeugt ein neues THintWindow-Objekt.

__fastcall virtual THintWindow(Classes::TComponent* AOwner);


Gültigkeitsbereich

Published

Zugriff

Read-only


Hierarchie

TObject

TPersistent

TComponent

TControl

TWinControl

TCustomControl


THintWindow Beispiel

THintWindow


 THotKey

Hierarchie	Eigenschaften	Methoden	Ereignisse

Header

vcl/comctrls.hpp

Mit der Komponente THotKey kann zur Laufzeit ein Tastenkürzel definiert werden. Das bedeutet, der Benutzer gibt in der Komponente eine Tastenkombination ein. Diese besteht normalerweise aus einer Sondertaste (z.B. STRG, ALT oder UMSCHALT) und einer weiteren Taste (z.B. Buchstabe, Ziffer, Pfeiltaste oder Funktionstaste). Das Tastenkürzel wird mit einem anderen Steuerelement verknüpft, indem es dessen Eigenschaft HotKey zugeordnet wird.

Zur Entwurfszeit wird ein Tastenkürzel mit den Eigenschaften HotKey und Modifiers definiert. Die Tastenbezeichnungen werden im Tastenkürzel-Steuerelement angezeigt. Mit der Eigenschaft InvalidKeys können bestimmte Sondertasten von der Verwendung in Tastenkürzeln ausgeschlossen werden. Zur Laufzeit wird die Tastenkombination geändert, indem einfach eine neue eingegeben wird. Die Eigenschaft HotKey kann dann beispielsweise der entsprechenden Eigenschaft eines Menüeintrags zugewiesen werden.

Zusätzlich zu den hier beschriebenen Eigenschaften, Methoden und Ereignissen besitzt diese Komponente die Eigenschaften, Methoden und Ereignisse, die allen fensterorientierten Steuerelementen gemeinsam sind. Die Komponente THotKey ist ein indirekter Nachkomme von TWinControl.


Eigenschaften von THotKey

THotKey	Alphabetisch	Legende

Abgeleitet von TCustomHotKey

AutoSize

HotKey

InvalidKeys

Modifiers

Abgeleitet von TWinControl

Brush

ClientOrigin

ClientRect

ControlCount

Controls

Handle

HelpContext

Showing

TabOrder

TabStop

Abgeleitet von TControl

Align

BoundsRect

ClientHeight

ClientWidth

ControlState

ControlStyle

Cursor

Enabled

Height

Hint

Left

Name

Parent

ParentShowHint

PopupMenu

ShowHint

Top

Visible

Width

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von THotKey

THotKey	Nach Objekten	Legende

Align

AutoSize

BoundsRect

Brush

ClientHeight

ClientOrigin

ClientRect

ClientWidth

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlCount

ControlState

Controls

ControlStyle

Cursor

DesignInfo

Enabled

Handle

Height

HelpContext

Hint

HotKey

InvalidKeys

Left

Modifiers

Name

Owner

ParentShowHint

Parent

PopupMenu

ShowHint

Showing

TabOrder

TabStop

Tag

Top

Visible

Width


Ereignisse von THotKey

THotKey	Alphabetisch	Legende

Abgeleitet von TWinControl

OnEnter

OnExit

Abgeleitet von TControl

OnMouseDown

OnMouseMove

OnMouseUp


Ereignisse von THotKey

THotKey	Nach Objekten	Legende

OnEnter

OnExit

OnMouseDown

OnMouseMove

OnMouseUp


Methoden von THotKey

THotKey	Alphabetisch

Abgeleitet von TCustomHotKey

~TCustomHotKey

TCustomHotKey

Abgeleitet von TWinControl

Broadcast

CanFocus

ContainsControl

ControlAtPos

DisableAlign

EnableAlign

Focused

GetTabOrderList

HandleAllocated

HandleNeeded

InsertControl

Invalidate

PaintTo

Realign

RemoveControl

Repaint

ScaleBy

ScrollBy

SetBounds

SetFocus

Update

UpdateControlState

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

GetTextLen

Hide

Perform

Refresh

ScreenToClient

SendToBack

SetTextBuf

Show

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von THotKey

THotKey	Nach Objekten

~TCustomHotKey

Assign

BeginDrag

BringToFront

Broadcast

CanFocus

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

ClientToScreen

ContainsControl

ControlAtPos

DefaultHandler

DestroyComponents

Destroying

DisableAlign

Dispatch

DragDrop

Dragging

EnableAlign

EndDrag

FieldAddress

FindComponent

Focused

FreeInstance

FreeNotification

Free

GetParentComponent

GetTabOrderList

GetTextBuf

GetTextLen

HandleAllocated

HandleNeeded

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InsertControl

InstanceSize

Invalidate

MethodAddress

MethodName

NewInstance

PaintTo

Perform

Realign

Refresh

RemoveComponent

RemoveControl

Repaint

ScaleBy

ScreenToClient

ScrollBy

SendToBack

SetBounds

SetFocus

SetTextBuf

Show

TCustomHotKey

UpdateControlState

Update


~THotKey

Der Destruktor ~THotKey gibt den Speicher frei, der für das THotKey-Objekt reserviert war. Rufen Sie ~THotKey nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~THotKey automatisch aufgerufen wird.

__fastcall virtual ~THotKey(void);


THotKey

Der Konstruktor THotKey erzeugt ein neues THotKey-Objekt.

__fastcall virtual THotKey(Classes::TComponent* AOwner);


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TControl

TWinControl

TCustomHotKey


THotKey Beispiel

THotKey


TIconOptions

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/comctrls.hpp

Das Objekt TIconOptions steuert, wie die Symbole in einer Listenansicht angeordnet werden.

Beschreibung

TIconOptions wird in Verbindung mit einer Listenansicht verwendet, deren Eigenschaft ViewStyle den Wert vsIcon oder vsSmallIcon besitzt. Die Eigenschaften von TIconOptions steuern dann, wie die Symbole angeordnet werden.

Die Eigenschaften von TIconOptions sind nur dann gültig, wenn ein Listenansicht-Objekt als Eigentümer fungiert.

Hinweis

TIconOptions hat keinen Effekt, wenn die zugehörige Listenansicht in der Eigenschaft ViewStyle nicht den Wert vsIcon oder vsSmallIcon besitzt.


Eigenschaften von TIconOptions

TIconOptions	Alphabetisch	Legende

In TIconOptions

Arrangement

AutoArrange

WrapText


Eigenschaften von TIconOptions

TIconOptions	Nach Objekten	Legende

Arrangement

AutoArrange

WrapText


TIconOptions::Arrangement

TIconOptions	Siehe auch

Die Eigenschaft Arrangement steuert, wie die einzelnen Elemente einer Listenansicht ausgerichtet werden.

__property TIconArrangement Arrangement;

Beschreibung

Mit Arrangement kann eine zeilenorientierte oder eine spaltenorientierte Anordnung erreicht werden. Voraussetzung ist, daß ViewStyle nicht den Wert vsIcon oder vsSmallIcon besitzt. Arrangement kann folgende Werte annehmen:

Wert	Bedeutung

iaTop	Die Elemente werden zeilenweise von links nach rechts und von oben nach unten angeordnet.

iaLeft	Die Elemente werden spaltenweise von oben nach unten angeordnet. Die erste Spalte steht ganz links in der Listenansicht.


TIconOptions::AutoArrange

TIconOptions	Siehe auch

Die Eigenschaft AutoArrange legt fest, ob die Symbole in einer Listenansicht automatisch neu angeordnet werden sollen, wenn ein Listenelement hinzugefügt, gelöscht oder verschoben wird.

__property bool AutoArrange;

Beschreibung

Mit AutoArrange wird vorgegeben, ob die Elemente einer Listenansicht automatisch neu angeordnet werden, wenn €nderungen stattfinden. Der Wert False bedeutet, daß die Symbole erst dann neu angeordnet werden, wenn die Methode Arrange der Listenansicht aufgerufen wird.


TIconOptions::WrapText

TIconOptions	Siehe auch

Die Eigenschaft WrapText steuert, ob die Beschriftung eines Symbols in der Listenansicht in einer einzigen Zeile steht oder ob ein Zeilenumbruch möglich ist.

__property bool WrapText;

Beschreibung

Wenn WrapText den Wert True hat und die Beschriftung eines Symbols breiter ist als das Symbol selbst, wird der Text nicht in einer einzigen Zeile dargestellt, sondern umbrochen.


Methoden von TIconOptions

TIconOptions	Alphabetisch

In TIconOptions

~TIconOptions

TIconOptions	public

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TIconOptions

TIconOptions	Nach Objekten

TIconOptions	public

~TIconOptions

Assign

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


TIconOptions::~TIconOptions

TIconOptions

Der Destruktor ~TIconOptions gibt den Speicher frei, der für das TIconOptions-Objekt reserviert war. Rufen Sie ~TIconOptions nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TIconOptions automatisch aufgerufen wird.

__fastcall virtual ~TIconOptions(void);


TIconOptions::TIconOptions

TIconOptions	Siehe auch

TIconOptions erzeugt eine Instanz von TIconOptions.

__fastcall TIconOptions(TCustomListView* AOwner);

Rufen Sie TIconOptions in einer Anwendung nicht direkt auf. Die Eigenschaften eines TIconOptions-Objekts sind nur dann gültig, wenn ein Listenansicht-Objekt als Eigentümer fungiert. Dieses erzeugt eine Instanz von TIconOptions.

Nach Aufruf des geerbten Konstruktors nimmt TIconOptions die folgenden Initialisierungen vor:

•	Arrangement wird auf iaTop gesetzt.

•	AutoArrange wird auf False gesetzt.

•	WrapText wird auf True gesetzt.


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent


TIconOptions Beispiel

TIconOptions


TIcon

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/graphics.hpp

Das Objekt TIcon kapselt ein Windows-Symbol.

Beschreibung

Mit TIcon wird ein Symbol innerhalb einer Bilderliste repräsentiert. Symbole können allen Objekten zugewiesen werden, die eine Eigenschaft Icon besitzen (z.B. TForm oder TPicture).

Symbol-Objekte werden aus einer Windows-Symboldatei geladen (.ICO). Zur Darstellung des Symbols auf einer Zeichenfläche dient die Methode Draw des TCanvas-Objekts. Symbole können nicht gedehnt werden, verwenden Sie also in Verbindung mit einem Symbol nicht die Methode TCanvas.StretchDraw.


Eigenschaften von TIcon

TIcon	Alphabetisch	Legende

In TIcon

Empty

Handle

Height

Width

Abgeleitet von TGraphic

Modified


Eigenschaften von TIcon

TIcon	Nach Objekten	Legende

Empty

Handle

Height

Modified

Width


TIcon::Empty

TIcon	Siehe auch

Die Eigenschaft Empty zeigt an, ob das Symbol-Objekt ein Symbol enthält.

__property bool Empty;

Beschreibung

Wenn Empty den Wert True hat, wurde kein Symbol in das Objekt geladen.


TIcon::Handle

TIcon	Siehe auch	Beispiel

Die Eigenschaft Handle ermöglicht den Zugriff auf das Symbol-Handle der Windows-GDI.

__property HICON Handle;

Beschreibung

Über den Wert von Handle können Sie ein bestimmtes Symbol identifizieren, wenn Sie eine Windows-API-Funktion verwenden, die das Handle eines Symbol-Objekts erfordert. Die Eigenschaft Handle ist NULL, wenn das Symbol nicht geladen wurde.

Wenn das referenzierte Symbol mit der Eigenschaft Handle gewechselt werden soll, rufen Sie vorher die Methode ReleaseHandle auf. Das Symbolbild kann auch geladen werden, indem ein anderes Symbol-Objekt zugewiesen wird. Außerdem stehen hierfür die Methoden LoadFromClipboardFormat, LoadFromFile und LoadFromStream zur Verfügung.


TIcon::Height

TIcon	Siehe auch	Beispiel

Die Eigenschaft Height bezeichnet die vertikale Größe des Symbols in Pixel.

Beschreibung

Alle Symbole in einer Anwendung besitzen dieselbe Höhe, und diese wird von Windows festgelegt. Mit einem Lesezugriff auf Height kann die gemeinsame Höhe ermittelt werden.

Der Versuch eines Schreibzugriffs auf die Eigenschaft Height löst eine Exception aus.


TIcon::Width

TIcon	Siehe auch	Beispiel

Die Eigenschaft Width bezeichnet die horizontale Größe des Symbols in Pixel.

Beschreibung

Alle Symbole in einer Anwendung besitzen dieselbe Breite, und diese wird von Windows festgelegt. Mit einem Lesezugriff auf Width kann die gemeinsame Breite ermittelt werden.

Der Versuch eines Schreibzugriffs auf die Eigenschaft Width löst eine Exception aus.


Ereignisse von TIcon

TIcon	Alphabetisch

Abgeleitet von TGraphic

OnChange


Ereignisse von TIcon

TIcon	Nach Objekten

OnChange


Methoden von TIcon

TIcon	Alphabetisch

In TIcon

~TIcon

Assign

LoadFromStream

ReleaseHandle

SaveToStream

TIcon

Abgeleitet von TGraphic

LoadFromClipboardFormat

LoadFromFile

SaveToClipboardFormat

SaveToFile

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TIcon

TIcon	Nach Objekten

~TIcon

Assign

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

LoadFromClipboardFormat

LoadFromFile

LoadFromStream

MethodAddress

MethodName

NewInstance

ReleaseHandle

SaveToClipboardFormat

SaveToFile

SaveToStream

TIcon


TIcon::~TIcon

TIcon	Siehe auch

Der Destruktor ~TIcon gibt den Speicher frei, der für das TIcon-Objekt reserviert war. Rufen Sie ~TIcon nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TIcon automatisch aufgerufen wird.

__fastcall virtual ~TIcon(void);

Beschreibung

Bevor das Objekt freigegeben wird, wird das Windows-Handle freigegeben.


TIcon::Assign

TIcon	Siehe auch

Die Methode Assign kopiert ein Symbol von einem anderen TIcon-Objekt.

virtual void __fastcall Assign(Classes::TPersistent* Source);

Beschreibung

Mit Assign wird die Kopie eines anderen Symbol-Objekts erzeugt. Wenn das mit dem Parameter Source bezeichnete Objekt ebenfalls ein TIcon-Objekt ist, kopiert die Methode Assign das darin enthaltene Symbolbild. Andernfalls ruft Assign die geerbte Methode auf, welche Symbolkopien aus einem Quellobjekt anderen Typs erzeugt. Das Quellobjekt muß jedoch in seiner Methode AssignTo festlegen, wie eine Kopie an ein TIcon-Objekt übertragen werden kann.


TIcon::LoadFromStream

TIcon	Siehe auch

Die Methode LoadFromStream lädt das Symbol aus einem Stream.

virtual void __fastcall LoadFromStream(Classes::TStream* Stream);

Beschreibung

Mit LoadFromStream wird das interne Abbild des Symbols aus dem Stream gelesen, der im Parameter Stream übergeben wird. Wenn das Symbol aus einer ICO-Datei geladen werden soll, verwenden Sie die Methode LoadFromFile. Mit LoadFromClipboardFormat wiederum läßt sich das Symbol aus der Zwischenablage laden.


TIcon::ReleaseHandle

TIcon	Siehe auch

Die Methode ReleaseHandle gibt das Windows-GDI-Objekt frei, das vom Symbol repräsentiert wird.

HICON __fastcall ReleaseHandle(void);

Beschreibung

Mit ReleaseHandle werden die Ressourcen freigegeben, die für die Darstellung des Symbols reserviert waren. ReleaseHandle setzt die Eigenschaft Handle auf NULL.

Rufen Sie ReleaseHandle auf, bevor Sie die Eigenschaft Handle setzen, damit die Ressourcen, die dem Symbol zugeordnet sind, nicht verloren gehen.


TIcon::SaveToStream

TIcon	Siehe auch

Die Methode SaveToStream speichert das Symbol in einem Stream.

virtual void __fastcall SaveToStream(Classes::TStream* Stream);

Beschreibung

Mit SaveToStream wird das interne Abbild des Symbols in den Stream geschrieben, der mit dem Parameter Stream bezeichnet ist. Wenn das Symbol dagegen in eine ICO-Datei geschrieben werden soll, verwenden Sie die Methode SaveToFile. Mit SaveToClipboardFormat wiederum kann das Symbol in der Zwischenablage gespeichert werden.


TIcon::TIcon

TIcon	Siehe auch

TIcon erzeugt eine Instanz von TIcon.

__fastcall virtual TIcon(void);

Beschreibung

Mit TIcon wird ein leeres Symbol-Objekt erzeugt. Ein Symbol kann erst dann auf einer Zeichenfläche dargestellt oder zu einer Bilderliste hinzugefügt werden, wenn ein Bild aus einer Datei oder einem Stream in das Symbol geladen oder wenn ein anderes Symbol-Objekt zugewiesen wurde. Erstellen Sie kein Symbol-Objekt, um die Icon-Eigenschaft eines Formulars oder Bildes einzustellen. Solche Objekte erzeugen ein TIcon-Objekt in ihren eigenen Konstruktoren. Wenden Sie statt dessen die Methoden LoadFromFile, LoadFromStream oder LoadFromClipboardFormat auf das TIcon-Objekt an, das bei einem Lesezugriff auf die Eigenschaft zurückgegeben wird.


Zugriff

Read-only


Hierarchie

TObject

TPersistent

TGraphic


TIcon Beispiel

TIcon


TIconImage

Hierarchie	Methoden	Siehe auch

Header

vcl/graphics.hpp

TIconImage ist die interne Repräsentation des Bitmap-Bildes für ein TIcon-Objekt.

Beschreibung

TIconImage wird in Borland C++Builder nur für interne Zwecke verwendet. Das Objekt repräsentiert das interne Abbild des Bitmaps, das vom Objekt TIcon gekapselt wird. Alle Daten und Methoden, die in TIconImage eingeführt werden, sind als private deklariert. Sie enthalten Informationen über die spezielle Struktur HICON, einschließlich der Zeiger auf die von Windows definierten Standard- HICON-Strukturen. TIconImage wird im Konstruktor des TIcon-Objekts referenziert, wenn das interne Abbild erzeugt wird.


Methoden von TIconImage

TIconImage	Alphabetisch

In TIconImage

~TIconImage

TIconImage

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TIconImage

TIconImage	Nach Objekten

~TIconImage

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance

TIconImage


TIconImage::~TIconImage

TIconImage

Der Destruktor ~TIconImage gibt den Speicher frei, der für das TIconImage-Objekt reserviert war. Rufen Sie ~TIconImage nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TIconImage automatisch aufgerufen wird.

__fastcall virtual ~TIconImage(void);


TIconImage::TIconImage

TIconImage

Der Konstruktor TIconImage erzeugt ein neues TIconImage-Objekt.

__fastcall TIconImage(void);


Hierarchie

TObject

TInternalImage


TIconImage Beispiel

TIconImage


 TImage

Hierarchie	Eigenschaften	Methoden	Ereignisse

Header

vcl/extctrls.hpp

Mit der Komponente TImage kann in einem Formular ein Grafikelement dargestellt werden. Das Bild wird in der Eigenschaft Picture festgelegt. Wenn die Größe des Steuerelements automatisch an das enthaltene Bild angepaßt werden soll, setzen Sie die Eigenschaft AutoSize auf True. Wenn dagegen das Bild an die Größe des Steuerelements angepaßt werden soll, verwenden Sie die Eigenschaft Stretch.

Zusätzlich zu den hier beschriebenen Eigenschaften, Methoden und Ereignissen besitzt diese Komponente auch die Eigenschaften und Methoden, die allen Steuerelementen gemeinsam sind.


Eigenschaften von TImage

TImage	Alphabetisch	Legende

In TImage

In TImage

AutoSize

Canvas

Picture

Abgeleitet von TControl

Align

BoundsRect

ClientHeight

ClientOrigin

ClientRect

ClientWidth

ControlState

ControlStyle

Cursor

DragCursor

DragMode

Enabled

Height

Hint

Left

Name

Parent

ParentShowHint

PopupMenu

ShowHint

Top

Visible

Width

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TImage

TImage	Nach Objekten	Legende

Align

AutoSize

BoundsRect

Canvas

ClientHeight

ClientOrigin

ClientRect

ClientWidth

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlState

ControlStyle

Cursor

DesignInfo

DragCursor

DragMode

Enabled

Height

Hint

Left

Name

Owner

ParentShowHint

Parent

Picture

PopupMenu

ShowHint

Tag

Top

Visible

Width


TImage::AutoSize

TImage

Die Eigenschaft legt fest, ob das Steuerelement an die Größe des enthaltenen Bildes angepaßt werden soll.

__property bool AutoSize;

Wenn AutoSize den Wert True hat, wird das Steuerelement in der Größe an das enthaltene Bild angepaßt. Der Wert False bewirkt, daß das Steuerelement in der Größe unverändert bleibt, unabhängig davon, ob das enthaltene Bild größer oder kleiner ist. Eventuell sind dann nur Teile des Bildes zu sehen.

Hinweis

AutoSize hat nur dann einen Effekt, wenn die Eigenschaft vor dem Laden des Bildes auf True gesetzt wird.

Mit der Eigenschaft Stretch können Sie das Bild vergrößern, wenn dieses kleiner ist als das umgebende Steuerelement.


TImage::Canvas

TImage

Die Zeichenfläche des Bildes.

__property Graphics::TCanvas* Canvas;


TImage::Picture

TImage

Die Eigenschaft bestimmt das Bild, das in einer TImage-Komponente angezeigt wird.

__property Graphics::TPicture* Picture;

Der Wert der Eigenschaft bezeichnet ein TPicture-Objekt, das ein Symbol, eine Metadatei, eine Bitmap-Grafik oder eine benutzerdefinierte Grafik enthalten kann.


Ereignisse von TImage

TImage	Alphabetisch	Legende

Abgeleitet von TControl

OnClick

OnDblClick

OnDragDrop

OnDragOver

OnEndDrag

OnMouseDown

OnMouseMove

OnMouseUp

OnStartDrag


Ereignisse von TImage

TImage	Nach Objekten	Legende

OnClick

OnDblClick

OnDragDrop

OnDragOver

OnEndDrag

OnMouseDown

OnMouseMove

OnMouseUp

OnStartDrag


Methoden von TImage

TImage	Alphabetisch

In TImage

~TImage

TImage

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

GetTextLen

Hide

Invalidate

Perform

Refresh

Repaint

ScreenToClient

SendToBack

SetBounds

SetTextBuf

Show

Update

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TImage

TImage	Nach Objekten

~TImage

Assign

BeginDrag

BringToFront

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

ClientToScreen

DefaultHandler

DestroyComponents

Destroying

Dispatch

DragDrop

Dragging

EndDrag

FieldAddress

FindComponent

FreeInstance

FreeNotification

Free

GetParentComponent

GetTextBuf

GetTextLen

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InstanceSize

Invalidate

MethodAddress

MethodName

NewInstance

Perform

Refresh

RemoveComponent

Repaint

ScreenToClient

SendToBack

SetBounds

SetTextBuf

Show

TImage

Update


TImage::~TImage

TImage

Der Destruktor ~TImage gibt den Speicher frei, der für das TImage-Objekt reserviert war. Rufen Sie ~TImage nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TImage automatisch aufgerufen wird.

__fastcall virtual ~TImage(void);


TImage::TImage

TImage

Der Konstruktor TImage erzeugt ein neues TImage-Objekt.

__fastcall virtual TImage(Classes::TComponent* AOwner);


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TControl

TGraphicControl


TImage Beispiel

TImage


 TImageList

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/controls.hpp

Die Komponente TImageList ist eine Kollektion von Bildern mit identischer Größe. Jedes Bild kann über seinen Index referenziert werden.

Beschreibung

Bilderlisten dienen dazu, große Mengen von Symbolen oder Bitmaps zu verwalten. Alle Bilder einer Bilderliste befinden sich in einem einzigen großen Bitmap mit Bildschirmformat. Eine Bilderliste kann auch ein monochromes Bitmap mit Masken enthalten, das dazu dient, Bilder transparent zu zeichnen.

In einer Bilderliste finden sehr viele Bilder gleicher Größe Platz, die jeweils über ihren Index (0 bis n - 1) abgerufen werden können. Dazu gehören Methoden für einfaches Speichern und Zeichnen der enthaltenen Bilder.

TImageList ist von TCustomImageList abgeleitet und umfaßt viele der Methoden und geschützten Eigenschaften von TCustomImageList.


Eigenschaften von TImageList

TImageList	Alphabetisch	Legende

Abgeleitet von TCustomImageList

AllocBy

BkColor

BlendColor

Count

DragCursor

Dragging

DrawingStyle

Handle

Height

ImageType

Masked

ShareImages

Width

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Name

Owner

Tag


Eigenschaften von TImageList

TImageList	Nach Objekten	Legende

AllocBy

BkColor

BlendColor

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

Count

DesignInfo

DragCursor

Dragging

DrawingStyle

Handle

Height

ImageType

Masked

Name

Owner

ShareImages

Tag

Width


Ereignisse von TImageList

TImageList	Alphabetisch	Legende

Abgeleitet von TCustomImageList

OnChange


Ereignisse von TImageList

TImageList	Nach Objekten	Legende

OnChange


Methoden von TImageList

TImageList	Alphabetisch

In TCustomImageList

~TImageList

TImageList

Abgeleitet von TCustomImageList

Add

AddIcon

AddImages

AddMasked

Assign

BeginDrag

Clear

Delete

DragLock

DragMove

DragUnlock

Draw

DrawOverlay

EndDrag

FileLoad

GetBitmap

GetHotSpot

GetIcon

GetImageBitmap

GetMaskBitmap

GetResource

HandleAllocated

HideDragImage

Insert

InsertIcon

InsertMasked

Move

Overlay

RegisterChanges

Replace

ReplaceIcon

ReplaceMasked

ResourceLoad

SetDragImage

ShowDragImage

UnRegisterChanges

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TImageList

TImageList	Nach Objekten

~TImageList

AddIcon

AddImages

AddMasked

Add

Assign

BeginDrag

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

Clear

DefaultHandler

Delete

DestroyComponents

Destroying

Dispatch

DragLock

DragMove

DragUnlock

DrawOverlay

Draw

EndDrag

FieldAddress

FileLoad

FindComponent

FreeInstance

FreeNotification

Free

GetBitmap

GetHotSpot

GetIcon

GetImageBitmap

GetMaskBitmap

GetParentComponent

GetResource

HandleAllocated

HasParent

HideDragImage

InheritsFrom

InitInstance

InsertComponent

InsertIcon

InsertMasked

Insert

InstanceSize

MethodAddress

MethodName

Move

NewInstance

Overlay

RegisterChanges

RemoveComponent

ReplaceIcon

ReplaceMasked

Replace

ResourceLoad

SetDragImage

ShowDragImage

TImageList

UnRegisterChanges


TImageList::~TImageList

TImageList

Der Destruktor ~TImageList gibt den Speicher frei, der für das TImageList-Objekt reserviert war. Rufen Sie ~TImageList nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TImageList automatisch aufgerufen wird.

__fastcall virtual ~TImageList(void);


TImageList::TImageList

TImageList

Der Konstruktor TImageList erzeugt ein neues TImageList-Objekt.

__fastcall virtual TImageList(Classes::TComponent* AOwner);


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TCustomImageList


TImageList Beispiel

TImageList


TIndexDef

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/dbtables.hpp

Das Objekt TIndexDef ist eine Indexdefinition, die einen Index in einer Datenbanktabelle beschreibt.

Beschreibung

Mit den Eigenschaften und Methoden einer Indexdefinition lassen sich folgende Informationen gewinnen:

•	Der Name eines Index.

•	Die Felder, die den Index bilden, oder der dBASE-Ausdruck, der die Reihenfolge des Index festlegt.

•	Die Merkmale des Index.

TIndexDef wird von TTable-Objekten verwendet, um die Indizes einer Datenbanktabelle zu erstellen oder zu verwalten.


Eigenschaften von TIndexDef

TIndexDef	Alphabetisch	Legende

In TIndexDef

Expression

Fields

Name

Options

Source


Eigenschaften von TIndexDef

TIndexDef	Nach Objekten	Legende

Expression

Fields

Name

Options

Source


TIndexDef::Expression

TIndexDef	Siehe auch

Die Eigenschaft Expression enthält einen String, der den dBASE-Schlüsselausdruck darstellt.

__property System::AnsiString Expression;

Beschreibung

Mit einem Lesezugriff auf Expression kann der Schlüsselausdruck eines dBASE-Index ermittelt werden.

Ein Schlüsselausdruck für eine dBASE-Tabelle ist entweder ein Feldname oder eine Kombination von Feldnamen, Funktionen und Operatoren, mit der die Sortierreihenfolge von Datensätzen in der Tabelle bestimmt wird. Wenn es sich bei der Tabelle nicht um eine dBASE-Tabelle handelt, ist der String Expression leer.

Wenn die Eigenschaft Options den nicht Wert ixExpression enthält, ist der zurückgegebene Eigenschafts-String Expression leer. Mit der Eigenschaft Fields lassen sich die Felder eines Index ermitteln, der kein dBASE-Index ist.

Hinweis

Details zu Schlüsselausdrücken finden Sie in der dBASE-Dokumentation.


TIndexDef::Fields

TIndexDef	Siehe auch

Die Eigenschaft Fields bezeichnet die Felder, aus denen der Index besteht.

__property System::AnsiString Fields;

Beschreibung

Mit einem Lesezugriff auf Fields können die Felder bestimmt werden, aus denen der Index besteht. Der zurückgegebene String enthält entweder die Namen der Felder oder die Nummern der Felder. Im letzten Fall entsprechend die Nummern den physikalischen Feldnummern in der Tabelle. Mehrere Felder werden durch Semikolons getrennt.

Wenn der Index auf einem dBASE-Schlüsselausdruck basiert, bezeichnet die Eigenschaft Fields nicht die Felder, aus denen der Index besteht. Der zurückgegebene String Fields bleibt somit leer, wenn die Eigenschaft Options den Wert ixExpression enthält. Um die Definition eines dBASE-Index zu bestimmen, verwenden Sie statt dessen die Eigenschaft Expression.


TIndexDef::Name

TIndexDef	Siehe auch	Beispiel

Die Eigenschaft Name bezeichnet die Indexdefinition.

__property System::AnsiString Name;

Beschreibung

Mit dieser Eigenschaft kann der Name einer Indexdefinition bestimmt werden. Physikalische Tabellen verwenden diesen Namen zur Bestimmung des Index.

Hinweis

Bei gewarteten dBASE-Indizes bezeichnet Name das Index-Tag. Bei Paradox-Tabellen ist die Eigenschaft Name eines Primärschlüssels ein leerer String.


TIndexDef::Options

TIndexDef	Siehe auch

Die Eigenschaft Options beschreibt die Merkmale eines Index.

__property TIndexOptions Options;

Beschreibung

Mit einem Lesezugriff auf Options können Sie die Attribute des Index ermitteln. Die Eigenschaft ist eine Menge, die leer sein oder einen der folgenden Wert enthalten kann:

Wert	Beschreibung

ixPrimary	Der Index ist der Primärindex der Tabelle.

ixUnique	Jeder Indexwert ist eindeutig, es gibt keine Duplikate.

ixDescending	Der Index ist absteigend orientiert.

ixExpression	Die Indexreihenfolge hängt von einem dBASE-Schlüsselausdruck ab.

ixCaseInsensitive	Der Index berücksichtigt die Groß- und Kleinschreibung.

Hinweis

Einige Datenbanktreiber unterstützen eventuell nur eine Teilmenge dieser Optionen. Beispielsweise wird ixCaseInsensitive in dBASE-Tabellen nicht unterstützt.


TIndexDef::Source

TIndexDef	Siehe auch

Die Eigenschaft Source enthält den Namen für einen gewarteten dBASE-Index.

__property System::AnsiString Source;

Beschreibung

Wenn in der Tabelle dBASE-MDX-Indizes verwendet werden, enthält die Eigenschaft Name den Namen des Index-Tags, und Source enthält den Namen der Indexdatei. Source ist nur in Verbindung mit Indizes für dBASE-Tabellen verwendbar.


Methoden von TIndexDef

TIndexDef	Alphabetisch

In TIndexDef

~TIndexDef

TIndexDef

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TIndexDef

TIndexDef	Nach Objekten

~TIndexDef

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance

TIndexDef


TIndexDef::TIndexDef

TIndexDef	Siehe auch

Die Methode TIndexDef erzeugt eine Instanz von TIndexDef.

__fastcall TIndexDef(TIndexDefs* Owner, const System::AnsiString Name, const System::AnsiString Fields,  TIndexOptions Options);

Beschreibung

Eine Anwendung sollte TIndexDef nicht direkt aufrufen. Der Konstruktor für ein TIndexDef-Objekt wird von einem TIndexDefs-Objekt aufgerufen, wenn dieses einen neuen Index in seine Liste einfügt. Um ein neues TIndexDef-Objekt zu erzeugen, rufen Sie die Methode Add des jeweiligen TIndexDefs-Objekts auf.

TIndexDef weist die Parameterwerte von Name, Fields und Options den gleichnamigen Eigenschaften zu. Der Parameter Owner ist das TIndexDefs-Objekt, das alle Indexdefinitionen der Tabelle enthält.


TIndexDef::~TIndexDef

TIndexDef	Siehe auch

Mit der Methode ~TIndexDef wird eine Instanz von TIndexDef freigegeben.

__fastcall virtual ~TIndexDef(void);

Beschreibung

Rufen Sie ~TIndexDef für TIndexDef niemals direkt auf. Das TIndexDefs-Objekt, das Eigentümer der Indexdefinition ist, ruft zur Freigabe die Methode Free auf. Free überprüft zuerst, ob das TIndexDef-Objekt nicht bereits freigegeben wurde, und ruft ~TIndexDef nur bei Bedarf auf.

~TIndexDef löscht vor dem Aufruf des geerbten Konstruktors die Indexdefinition aus der Eigenschaft Items des TIndexDefs-Objekts, das der Eigentümer ist.


Zugriff

Read-only


Hierarchie

TObject


TIndexDef Beispiel

TIndexDef


TIndexDefs

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/dbtables.hpp

Das Objekt TIndexDefs enthält die Liste der verfügbaren Indexdefinitionen für eine Tabelle.

Beschreibung

Mit den Eigenschaften und Methoden von TIndexDefs lassen sich folgende Aktionen ausführen:

•	Auf eine bestimmte Indexdefinition zugreifen.

•	Die Anzahl der Indexdefinitionen in einem TIndexDefs-Objekt bestimmen.

•	Indexdefinitionen hinzufügen oder löschen.

•	Alle Indexdefinitionen von einem TIndexDefs-Objekt in ein anderes kopieren.

TIndexDefs wird von TTable- oder TMemoryDataSet-Objekten beim Erzeugen oder Verwalten von Tabellenindizes verwendet.


Eigenschaften von TIndexDefs

TIndexDefs	Alphabetisch	Legende

In TIndexDefs

Count

Items

Updated


Eigenschaften von TIndexDefs

TIndexDefs	Nach Objekten	Legende

Count Count

Items

Updated


TIndexDefs::Count

TIndexDefs	Siehe auch

Die Eigenschaft Count bezeichnet die Anzahl der Indexdefinitionen des TIndexDefs-Objekts.

__property int Count;

Beschreibung

Mit einem Lesezugriff auf Count läßt sich die Anzahl der Indizes ermitteln, die der Datenmenge zugeordnet sind. Die Eigenschaft Count kann als Wertvorgabe für einen Schleifenzähler dienen, wenn über alle Indexdefinitionen im Array Items iteriert werden soll.

Count ist eine Nur-Lesen-Eigenschaft. Der Wert wird indirekt beim Hinzufügen oder Löschen von Indexdefinitionen geändert.


TIndexDefs::Items

TIndexDefs	Siehe auch

Die Eigenschaft Items ist ein Array von Zeigern auf die Indexdefinitionen, mit denen jeder Index einer Tabelle beschrieben wird.

__property TIndexDef* Items[int Index];

Beschreibung

Mit Items kann auf eine bestimmte Indexdefinition zugegriffen werden. Die gewünschte Indexdefinition in der Liste wird mit dem Integer-Parameter Index bezeichnet. Gültige Werte liegen im Bereich von 0 bis Count - 1.

Items ist eine Nur-Lesen-Eigenschaft. Der Wert wird indirekt beim Hinzufügen oder Löschen von Indexdefinitionen geändert.


TIndexDefs::Updated

TIndexDefs	Siehe auch	Beispiel

Updated gibt an, ob die Indexdefinitionen im Array Items exakt den Indizes in der zugrundeliegenden Datenbank entsprechen.

Beschreibung

Mit dieser Eigenschaft können Sie feststellen, ob die Indexdefinitionen noch aktuell sind. Wenn Updated False ist, rufen Sie die Methode Update auf, die die Indizes neu aus der zugrundeliegenden Datenbank liest.


Methoden von TIndexDefs

TIndexDefs	Alphabetisch

In TIndexDefs

~TIndexDefs

Add

Assign

Clear

FindIndexForFields

GetIndexForFields

IndexOf

TIndexDefs

Update

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TIndexDefs

TIndexDefs	Nach Objekten

~TIndexDefs

Add

Assign

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

Clear

DefaultHandler

Dispatch

FieldAddress

FindIndexForFields

FreeInstance

Free

GetIndexForFields

IndexOf

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance

TIndexDefs

Update


TIndexDefs::~TIndexDefs

TIndexDefs	Siehe auch

Der Destruktor ~TIndexDefs gibt den Speicher frei, der für das TIndexDefs-Objekt reserviert war. Rufen Sie ~TIndexDefs nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TIndexDefs automatisch aufgerufen wird.

__fastcall virtual ~TIndexDefs(void);

Beschreibung

Nach dem Aufruf des geerbten Destruktors entfernt ~TIndexDefs alle Indexdefinitionen aus der Eigenschaft Items und gibt die Einträge frei.


TIndexDefs::Add

TIndexDefs	Siehe auch

Die Methode Add erzeugt eine neue Indexdefinition und fügt sie der Eigenschaft Items des TIndexDefs-Objekts hinzu.

void __fastcall Add(const System::AnsiString Name, const System::AnsiString Fields, TIndexOptions);

Beschreibung

Diese Methode braucht in Anwendungen nicht aufgerufen zu werden. Sobald die Datenmenge geöffnet ist, wird Add aufgerufen, um das Array Items zu füllen.

Soll zur Datenmenge ein Index hinzugefügt werden, verwenden Sie die Methode AddIndex des Objekts TTable. Soll das Index-Array nach dem Hinzufügen eines neuen Index geändert werden, verwenden Sie statt dessen die Methode Update.

Mit Add wird eine Indexdefinition erzeugt. Die in den Parametern Name, Fields und Options übergebenen Parameter werden den gleichnamigen Eigenschaften von TIndexDef zugewiesen.

Falls bereits eine Indexdefinition mit demselben Namen existiert, wird eine EDatabaseError-Exception ausgelöst.

Der Typ TIndexOptions ist eine Wertemenge, die beim Erzeugen eines neuen Index verwendet werden kann. Die Menge Options kann entweder leer sein oder einen der folgenden Werte enthalten:

Wert	Beschreibung

ixPrimary	Der Index ist der Primärindex der Tabelle.

ixUnique	Jeder Wert im Index ist eindeutig, es gibt keine Duplikate.

ixDescending	Der Index ist absteigend orientiert.

ixExpression	Die Indexrichtung hängt von einem dBASE-Schlüsselausdruck ab.

ixCaseInsensitive	Der Index unterscheidet nicht zwischen Groß- und Kleinschreibung.

Hinweis

Einige Datenbanktreiber unterstützen nur eine Teilmenge dieser Optionen. Beispielsweise wird ixCaseInsensitive in dBASE-Tabellen nicht unterstützt.


TIndexDefs::Assign

TIndexDefs	Siehe auch

Die Methode Assign erzeugt aus dem Parameter IndexDefs eine neue Menge von TIndexDef-Objekten im Array Items.

void __fastcall Assign(TIndexDefs* IndexDefs);

Beschreibung

Mit Assign wird ein TIndexDefs-Objekt in ein anderes kopiert.

Assign entfernt alle Indexdefinitionen für das Eigenschafts-Array Items und kopiert dann die Indexdefinitionen in Items. Geben Sie als Wert des Parameters IndexDefs das Objekt TIndexDefs an.


TIndexDefs::Clear

TIndexDefs	Siehe auch

Die Methode Clear dient zum Löschen und Freigeben aller Indexdefinitionen in der Eigenschaft Items.

void __fastcall Clear(void);

Beschreibung

Mit Clear werden aus dem Array Items alle Indexdefinitionen entfernt.


TIndexDefs::FindIndexForFields

TIndexDefs	Siehe auch

Die Methode FindIndexForFields dient zum Auffinden einer Indexdefinition im Eigenschafts-Array Items.

TIndexDef* __fastcall FindIndexForFields(const System::AnsiString Fields);

Beschreibung

Mit FindIndexForFields wird nach dem Index gesucht, der mit den Feldern beginnt, die im Parameter Fields angegeben sind. Wenn der Index aus mehr als einem Feld besteht, trennen Sie die Felder mit Semikolons.

Die Methode FindIndexForFields gibt, falls möglich, die Indexdefinition zurück, die exakt mit den angegebenen Feldern in der angegebenen Reihenfolge übereinstimmt. Wenn keine exakte Übereinstimmung gefunden werden kann, gibt FindIndexForFields den ersten Index zurück, der mit den vorgegebenen Feldern beginnt. Falls gar keine Übereinstimmung existiert, wird eine Exception ausgelöst.

Mit der Methode GetIndexForFields können Sie die Suche auf Indizes beschränken, die nicht zwischen Groß- und Kleinschreibung unterscheiden.


TIndexDefs::GetIndexForFields

TIndexDefs	Siehe auch

Die Methode GetIndexForFields dient zum Auffinden einer Indexdefinition im Array Items.

TIndexDef* __fastcall GetIndexForFields(const System::AnsiString Fields, bool CaseInsensitive);

Beschreibung

Mit GetIndexForFields wird nach dem Index gesucht, der mit den Feldern beginnt, die im Parameter Fields angegeben sind. Wenn der Index aus mehr als einem Feld besteht, trennen Sie die Felder mit Semikolons. Setzen Sie den Parameter CaseInsensitive auf True, um die Suche auf Indizes zu beschränken, die nicht zwischen Groß- und Kleinschreibung unterscheiden.

Die Methode GetIndexForFields gibt, falls möglich, die Indexdefinition zurück, die exakt mit den angegebenen Feldern in der angegebenen Reihenfolge übereinstimmt. Wenn keine exakte Übereinstimmung gefunden werden kann, gibt GetIndexForFields den ersten Index zurück, der mit den vorgegebenen Feldern beginnt. Falls gar keine Übereinstimmung existiert, gibt GetIndexForFields NULL zurück.

Hinweis

Wenn CaseInsensitive True ist, werden absteigende Indizes auch dann in die Suche einbezogen, wenn sie zwischen Groß- und Kleinschreibung unterscheiden.


TIndexDefs::IndexOf

TIndexDefs	Siehe auch

Die Methode IndexOf gibt die Position der Indexdefinition im Eigenschafts-Array Items zurück.

int __fastcall IndexOf(const System::AnsiString Name);

Beschreibung

Mit IndexOf kann die Position der Indexdefinition im Eigenschafts-Array Items ermittelt werden. IndexOf gibt einen Wert im Bereich von Null (erste Indexdefinition) bis Count - 1 zurück. Geben Sie den Namen des Index als Wert des Parameters Name an.

Wenn es keine Indexdefinition mit dem angegebenen Namen gibt, wird der Wert -1 zurückgegeben.

Hinweis

Die Methode IndexOf sucht einen Index basierend auf dessen Namen. Im Gegensatz dazu berücksichtigt FindIndexForFields die Namen der Felder, aus denen der Index besteht.


TIndexDefs::TIndexDefs

TIndexDefs	Siehe auch

Der Konstruktor TIndexDefs erzeugt ein neues TIndexDefs-Objekt.

__fastcall TIndexDefs(TTable* Table);

Beschreibung

Anwendungen sollten TIndexDefs nicht direkt aufrufen. Die Datenmenge erzeugt automatisch ein TIndexDefs-Objekt, mit dem die Indizes der Tabelle gewartet werden.

Nach dem Aufruf des geerbten Konstruktors erzeugt TIndexDefs das Array der Eigenschaft Items.


TIndexDefs::Update

TIndexDefs	Siehe auch

Die Methode Update aktualisiert entsprechend dem Zustand der Tabelle die Indexdefinitionen in der Eigenschaft Items.

void __fastcall Update(void);

Beschreibung

Update wird aufgerufen, wenn die Indizes einer Tabelle geändert wurden. Die Indexdefinitionen werden von Update aktualisiert, ohne die Tabelle zu öffnen.


Zugriff

Read-only


Hierarchie

TObject


TIndexDefs Beispiel

TIndexDefs


TIniFile

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/inifiles.hpp

Die Klasse TIniFile bietet systemnahe Funktionalität für den Umgang mit Initialisierungsdateien (.INI) unter Windows 3.x (16-Bit-Basis). Diese Dateien dienen zum Speichern und Abrufen von anwendungsspezifischen Informationen und Einstellungen.

Beschreibung

Mit TIniFile kann unter Windows 3.x die Verwaltung von anwendungsspezifischen Informationen in einer INI-Datei realisiert werden. Das Textformat dieser INI-Datei ist die Basis des Standardverfahrens, mit dem Windows 3.x-Anwendungen individuelle Einstellungen von einer Sitzung zur nächsten protokollieren. In einer INI-Datei sind die Informationen in logischen Einheiten, den sogenannten ãAbschnitten„ zusammengefaßt. So enthält beispielsweise die Datei WIN.INI einen Abschnitt ã[Desktop]„. Die eigentlichen Datenwerte werden in Schlüsselvariablen mit folgender Form gespeichert:

Ein TIniFile-Objekt erhält bei seiner Erzeugung einen Parameter FileName, der den Namen der INI-Datei für die Anwendung darstellt.

TIniFile enthält neben einer Eigenschaft zahlreiche Methoden für Lese- und Schreibvorgänge in INI-Dateien sowie für das Löschen ganzer Abschnitte. Außerdem sind die Methoden enthalten, die von TObject geerbt wurden.

Hinweis

TIniFile dient lediglich der Migration von Anwendungen und der Abwärtskompatibilität. Unter Windows 95/NT sind die INI-Dateien durch eine Registrierdatenbank ersetzt, in der alle Anwendungen ihre Einstellungen verwalten. Anwendungen, die auf Windows 95/NT zugeschnitten sind, sollten dementsprechend auf INI-Dateien verzichten. Borland C++Builder umfaßt zwei Objekte für die Pflege der Registrierdatenbank. TRegistry kapselt die Registrierung. TRegIniFile kapselt die Registrierung ebenfalls, bietet aber einen einfacheren Migrationspfad für bestehende Windows 3.1-Anwendungen, die für Windows 95/NT aufgerüstet werden.


Eigenschaften von TIniFile

TIniFile	Alphabetisch	Legende

In TIniFile

FileName


Eigenschaften von TIniFile

TIniFile	Nach Objekten	Legende

FileName


TIniFile::FileName

TIniFile	Siehe auche

Die Eigenschaft enthält den Namen der INI-Datei für die Verwaltung von anwendungsspezifischen Informationen.

__property System::AnsiString FileName;

Beschreibung

Mit FileName kann der Name der INI-Datei ermittelt werden, in der die Anwendung ihre spezifischen Einstellungen speichert. Das öffnen und Schließen der mit FileName bezeichneten Datei übernehmen die Methoden, die Daten in die INI-Datei schreiben bzw. daraus lesen.

Hinweis

Normalerweise werden INI-Dateien im Verzeichnis \WINDOWS abgelegt. Wenn sich die INI-Datei an einem anderen Ort befindet, muß der Parameter FileName, der an die Methode TIniFile::TIniFile übergeben wird, die vollständige Pfadangabe enthalten.


Methoden von TIniFile

TIniFile	Alphabetisch

In TIniFile

~TIniFile

DeleteKey

EraseSection

ReadBool

ReadInteger

ReadSection

ReadSections

ReadSectionValues

ReadString

TIniFile

WriteBool

WriteInteger

WriteString

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TIniFile

TIniFile	Nach Objekten

~TIniFile

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

DeleteKey

Dispatch

EraseSection

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance

ReadBool

ReadInteger

ReadSections

ReadSection

ReadSectionValues

ReadString

TIniFile

WriteBool

WriteInteger

WriteString


TIniFile::~TIniFile

TIniFile

Der Destruktor ~TIniFile gibt den Speicher frei, der für das TIniFile-Objekt reserviert war. Rufen Sie ~TIniFile nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TIniFile automatisch aufgerufen wird.

__fastcall virtual ~TIniFile(void);


TIniFile::DeleteKey

TIniFile	Siehe auch

Die Methode löscht den Datenwert, der einem Eintrag in der INI-Datei zugeordnet ist.

void __fastcall DeleteKey(const System::AnsiString Section, const System::AnsiString Ident);

Beschreibung

Mit DeleteKey wird ein Datenwert gelöscht, der einem Eintrag in der INI-Datei zugeordnet ist. Der String Section bezeichnet den Abschnitt der Datei. Der String Ident enthält den Namen des Schlüssels, der auf NULL gesetzt werden soll.

Hinweis

Wenn der referenzierte Abschnitt bzw. Schlüssel nicht existiert, führt dies nicht zu einem Fehler. In solchen Fällen erzeugt DeleteKey den Abschnitt bzw. Schlüssel und initialisiert ihn mit dem Wert von Value.


TIniFile::EraseSection

TIniFile	Siehe auch

Die Methode löscht einen gesamten Abschnitt aus der INI-Datei.

void __fastcall EraseSection(const System::AnsiString Section);

Beschreibung

Mit EraseSection wird ein Abschnitt zusammen mit allen seinen Schlüsseln und Datenwerten aus einer INI-Datei gelöscht. Der String Section bezeichnet den betreffenden Abschnitt. Wenn das Löschen mißlingt, wird eine Exception ausgelöst.


TIniFile::ReadBool

TIniFile	Siehe auch

Die Methode liest einen booleschen Wert aus einer INI-Datei.

bool __fastcall ReadBool(const System::AnsiString Section, const System::AnsiString Ident, bool Default );

Beschreibung

Mit ReadBool kann ein boolescher Wert aus einer INI-Datei gelesen werden. Der String Section bezeichnet den Abschnitt, der den zum Wert gehörigen Schlüssel enthält. Der String Ident ist der Name des Schlüssels mit dem booleschen Wert.

•	Der Abschnitt ist nicht vorhanden.

•	Der Schlüssel existiert nicht.

•	Dem Schlüssel ist kein Datenwert zugeordnet.


TIniFile::ReadInteger

TIniFile	Siehe auch

Die Methode liest einen Integer-Wert aus einer INI-Datei.

long __fastcall ReadInteger(const System::AnsiString Section, const System::AnsiString Ident, long  Default);

Beschreibung

Mit ReadInteger kann ein Integer-Wert aus einer INI-Datei gelesen werden. Der String Section bezeichnet den Abschnitt, der den zum Wert gehörigen Schlüssel enthält. Der String Ident ist der Name des Schlüssels mit dem Integer-Wert. Der Wert Default gibt vor, welcher Integer in folgenden Situationen zurückgeliefert werden soll:

•	Der Abschnitt ist nicht vorhanden.

•	Der Schlüssel existiert nicht.

•	Dem Schlüssel ist kein Datenwert zugeordnet.


TIniFile::ReadSection

TIniFile	Siehe auch

Die Methode liest die Namen aller Schlüssel aus einem bestimmten Bereich einer INI-Datei in eine String-Liste ein.

void __fastcall ReadSection(const System::AnsiString Section, Classes::TStrings* Strings);

Beschreibung

Mit ReadSection können die Namen aller Schlüssel innerhalb eines bestimmten Abschnitts der INI-Datei ermittelt werden. Die Namen gelangen in eine String-Liste.

Der String Section bezeichnet den betreffenden Abschnitt. Der Parameter Strings benennt das String-Objekt, in dem die ermittelten Namen gespeichert werden sollen. Der Parameter kann auf ein TString-Objekt zeigen, etwa eine String-Liste, oder auf eine Komponenteneigenschaft, wie z.B. Items für eine TListBox-Komponente, die selbst ein TString-Objekt darstellt.


TIniFile::ReadSections

TIniFile	Siehe auch

Die Methode liest die Namen aller Abschnitte einer INI-Datei in eine String-Liste ein.

void __fastcall ReadSections(Classes::TStrings* Strings);

Beschreibung

Mit ReadSections können die Namen aller Abschnitte der INI-Datei in ein String-Listenobjekt eingelesen werden.

Der Parameter Strings bezeichnet das String-Objekt, in dem die ermittelten Namen gespeichert werden sollen. Der Parameter kann auf ein TString-Objekt zeigen oder auf eine Komponenteneigenschaft, wie z.B. Items für eine TListBox-Komponente, die selbst ein TString-Objekt darstellt.


TIniFile::ReadSectionValues

TIniFile	Siehe auch

Die Methode liest die Werte aller Schlüssel innerhalb eines Abschnitts der bezeichneten INI-Datei in eine String-Liste ein.

void __fastcall ReadSectionValues(const System::AnsiString Section, Classes::TStrings* Strings);

Beschreibung

Mit ReadSectionValues können die Werte aller Schlüssel innerhalb eines Abschnitts der INI-Datei in eine String-Liste eingelesen werden. Der String Section bezeichnet den Abschnitt in der Datei, aus dem die Schlüsselwerte gelesen werden sollen. Der Parameter Strings bezeichnet das String-Listenobjekt, in das die Werte eingelesen werden sollen.

Der Parameter Strings kann auf ein TString-Objekt zeigen oder auf eine Komponenteneigenschaft, wie z.B. Items für eine TListBox-Komponente, die selbst ein TString-Objekt darstellt.


TIniFile::ReadString

TIniFile	Siehe auch

Die Methode liest einen String-Wert aus einer INI-Datei.

System::AnsiString __fastcall ReadString(const System::AnsiString Section, const System::AnsiString  Ident, const System::AnsiString Default);

Beschreibung

Mit ReadString kann ein String-Wert aus einer INI-Datei gelesen werden. Der String Section bezeichnet den Abschnitt, der den zum Wert gehörigen Schlüssel enthält. Der String Ident ist der Name des Schlüssels mit dem String-Wert. Der Wert Default gibt vor, welcher String in folgenden Situationen zurückgeliefert werden soll:

•	Der Abschnitt ist nicht vorhanden.

•	Der Schlüssel existiert nicht.

•	Dem Schlüssel ist kein Datenwert zugeordnet.


TIniFile::TIniFile

TIniFile	Siehe auch

Die Methode erzeugt ein TIniFile-Objekt für eine Anwendung.

__fastcall TIniFile(const System::AnsiString FileName);

Beschreibung

Mit TIniFile wird ein TIniFile-Objekt für eine Anwendung erzeugt.

Hinweis

Normalerweise werden INI-Dateien im Verzeichnis \WINDOWS gespeichert. Wenn sich die INI-Datei an einer anderen Position befindet, muß FileName den vollständigen Pfadnamen enthalten.


TIniFile::WriteBool

TIniFile	Siehe auch

Die Methode schreibt einen booleschen Wert in eine INI-Datei.

void __fastcall WriteBool(const System::AnsiString Section, const System::AnsiString Ident, bool Value );

Beschreibung

Mit WriteBool kann ein boolescher Wert in eine INI-Datei geschrieben werden. Der String Section bezeichnet den Dateiabschnitt, der den betreffenden Schlüssel enthält. Der String Ident enthält den Namen des Schlüssels, dessen Wert gesetzt werden soll. Der zu schreibende boolesche Wert wird in Value übergeben.

Hinweis

Wenn der referenzierte Abschnitt bzw. Schlüssel nicht existiert, führt dies nicht zu einem Fehler. In solchen Fällen erzeugt WriteBool den Abschnitt bzw. Schlüssel und initialisiert ihn mit dem Wert von Value.


TIniFile::WriteInteger

TIniFile	Siehe auch

Die Methode schreibt einen Integer-Wert in eine INI-Datei.

void __fastcall WriteInteger(const System::AnsiString Section, const System::AnsiString Ident, long  Value);

Beschreibung

Mit WriteInteger kann ein Integer-Wert in eine INI-Datei geschrieben werden. Der String Section bezeichnet den Dateiabschnitt, der den betreffenden Schlüssel enthält. Der String Ident enthält den Namen des Schlüssels, dessen Wert gesetzt werden soll. Der zu schreibende Integer wird in Value übergeben.

Hinweis

Wenn der referenzierte Abschnitt bzw. Schlüssel nicht existiert, führt dies nicht zu einem Fehler. In solchen Fällen erzeugt WriteInteger den Abschnitt bzw. Schlüssel und initialisiert ihn mit dem Wert von Value.


TIniFile::WriteString

TIniFile	Siehe auch

Die Methode schreibt einen String-Wert in eine INI-Datei.

void __fastcall WriteString(const System::AnsiString Section, const System::AnsiString Ident, const System::AnsiString  Value);

Beschreibung

Mit WriteString kann ein String-Wert in eine INI-Datei geschrieben werden. Der String Section bezeichnet den Dateiabschnitt, der den betreffenden Schlüssel enthält. Der String Ident enthält den Namen des Schlüssels, dessen Wert gesetzt werden soll. Der zu schreibende String wird in Value übergeben.

Hinweis

Wenn der referenzierte Abschnitt bzw. Schlüssel nicht existiert, führt dies nicht zu einem Fehler. In solchen Fällen erzeugt WriteString den Abschnitt bzw. Schlüssel und initialisiert ihn mit dem Wert von Value.


Zugriff

Read-only


Hierarchie

TObject


TIniFile Beispiel

TIniFile


TInplaceEdit

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/grids.hpp

TInplaceEdit enthält Textbearbeitungsfunktionen für Gitter-Steuerelemente.

Beschreibung

TInplaceEdit ist ein Hilfsobjekt, das für den Einsatz in Verbindung mit Gitter-Steuerelementen vorgesehen ist. Es bietet ein mehrzeiliges Eingabefeld, das in einer bestimmten Gitterzelle plaziert wird. TInplaceEdit bietet Möglichkeiten, die Reaktionen des Steuerelements auf Benutzereingaben über das Gitter zu steuern. Außerdem kann das Eingabefeld in Größe und Position verändert werden, wenn Zellen verschoben oder vergrößert/verkleinert werden. TInplaceEdit kann in Verbindung mit einem datensensitiven Gitter wie TDBGrid eingesetzt werden. Das Gitter kann den Inhalt des Eingabefeldes sowohl lesen als auch vorgeben und dadurch den Text so maskieren, daß er auf gültige Werte beschränkt bleibt.


Eigenschaften von TInplaceEdit

TInplaceEdit	Alphabetisch	Legende

In TInplaceEdit

Grid

Abgeleitet von TCustomMaskEdit

EditText

IsMasked

Text

Abgeleitet von TCustomEdit

Modified

SelLength

SelStart

SelText

Abgeleitet von TWinControl

Brush

ClientOrigin

ClientRect

ControlCount

Controls

Handle

HelpContext

Showing

TabOrder

TabStop

Abgeleitet von TControl

Align

BoundsRect

ClientHeight

ClientWidth

ControlState

ControlStyle

Cursor

Enabled

Height

Hint

Left

Name

Parent

ShowHint

Top

Visible

Width

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TInplaceEdit

TInplaceEdit	Nach Objekten	Legende

Align

BoundsRect

Brush

ClientHeight

ClientOrigin

ClientRect

ClientWidth

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlCount

ControlState

Controls

ControlStyle

Cursor

DesignInfo

EditText

Enabled

Grid

Handle

Height

HelpContext

Hint

IsMasked

Left

Modified

Name

Owner

Parent

SelLength

SelStart

SelText

ShowHint

Showing

TabOrder

TabStop

Tag

Text

Top

Visible

Width


TInplaceEdit::Grid

TInplaceEdit	Siehe auch

Die Eigenschaft Grid bezeichnet das Gitterobjekt, das Eigentümer des TInplaceEdit-Objekts ist und dieses steuert.

__property TCustomGrid* Grid;

Beschreibung

Über den Wert von Grid kann das Gitterobjekt ermittelt werden, für das TInplaceEdit Bearbeitungsfunktionen bereitstellt. TInplaceEdit empfängt in der Eigenschaft Grid Informationen über den bearbeiteten Text und nutzt die Eigenschaft wiederum, um relevante Ereignisse weiterzuleiten.


Methoden von TInplaceEdit

TInplaceEdit	Alphabetisch	Legende

In TInplaceEdit

~TInplaceEdit

BoundsChanged

CreateParams

DblClick

Deselect

Hide

Invalidate

KeyDown

KeyPress

KeyUp

Move

PosEqual

SetFocus

TInplaceEdit

UpdateContents

UpdateLoc

WndProc

Abgeleitet von TCustomMaskEdit

Clear

GetTextLen

ValidateEdit

Abgeleitet von TCustomEdit

ClearSelection

CopyToClipboard

CutToClipboard

GetSelTextBuf

PasteFromClipboard

SelectAll

SetSelTextBuf

Abgeleitet von TWinControl

Broadcast

CanFocus

ContainsControl

ControlAtPos

DisableAlign

EnableAlign

Focused

GetTabOrderList

HandleAllocated

HandleNeeded

InsertControl

PaintTo

Realign

RemoveControl

Repaint

ScaleBy

ScrollBy

SetBounds

Update

UpdateControlState

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

Perform

Refresh

ScreenToClient

SendToBack

SetTextBuf

Show

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TInplaceEdit

TInplaceEdit	Nach Objekten	Legende

~TInplaceEdit

Assign

BeginDrag

BoundsChanged

BringToFront

Broadcast

CanFocus

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

ClearSelection

Clear

ClientToScreen

ContainsControl

ControlAtPos

CopyToClipboard

CreateParams

CutToClipboard

DblClick

DefaultHandler

Deselect

DestroyComponents

Destroying

DisableAlign

Dispatch

DragDrop

Dragging

EnableAlign

EndDrag

FieldAddress

FindComponent

Focused

FreeInstance

FreeNotification

Free

GetParentComponent

GetSelTextBuf

GetTabOrderList

GetTextBuf

GetTextLen

HandleAllocated

HandleNeeded

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InsertControl

InstanceSize

Invalidate

KeyDown

KeyPress

KeyUp

MethodAddress

MethodName

Move

NewInstance

PaintTo

PasteFromClipboard

Perform

PosEqual

Realign

Refresh

RemoveComponent

RemoveControl

Repaint

ScaleBy

ScreenToClient

ScrollBy

SelectAll

SendToBack

SetBounds

SetFocus

SetSelTextBuf

SetTextBuf

Show

TInplaceEdit

UpdateContents

UpdateControlState

UpdateLoc

Update

ValidateEdit

WndProc


TInplaceEdit::~TInplaceEdit

TInplaceEdit

Der Destruktor ~TInplaceEdit gibt den Speicher frei, der für das TInplaceEdit-Objekt reserviert war. Rufen Sie ~TInplaceEdit nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TInplaceEdit automatisch aufgerufen wird.

__fastcall virtual ~TInplaceEdit(void);


TInplaceEdit::BoundsChanged

TInplaceEdit	Siehe auch

Die Methode BoundsChanged erzeugt im Textbereich des Feldes eine leichte Einrückung, sobald das Eingabefeld vom Gitter neu positioniert wird.

virtual void __fastcall BoundsChanged(void);

Beschreibung

BoundsChanged initialisiert das Eingabefeld erneut, nachdem dieses verschoben oder in der Größe verändert wurde. Dabei wird im Textbereich eine leichte Einrückung erzeugt, damit der Inhalt des Feldes nicht zu dicht am Rand der Zelle steht.

BoundsChanged ist eine geschützte Methode, so daß abgeleitete Objekte weitere Maßnahmen dieser Art hinzufügen können, wenn das Eingabefeld in Größe oder Position geändert wird.


TInplaceEdit::CreateParams

TInplaceEdit	Siehe auch

Die Methode CreateParams initialisiert den in Params übergebenen Datensatz zur Fenstererzeugung.

virtual void __fastcall CreateParams(Controls::TCreateParams &Params);

Beschreibung

Die Methode CreateWnd initialisiert mit einem Aufruf von CreateParams die an CreateWindowHandle übergebenen Parameter. TInplaceEdit überschreibt die geerbte Methode zur Definition eines mehrzeiligen Eingabefeldes.


TInplaceEdit::DblClick

TInplaceEdit	Siehe auch

Die Methode DblClick benachrichtigt das Gitter, wenn der Benutzer im Eingabefeld doppelklickt.

virtual void __fastcall DblClick(void);

Beschreibung

DblClick wird aufgerufen, sobald der Benutzer im Eingabefeld einen Doppelklick ausführt. Dazu wird einfach das Ereignis an das Gitter übergeben. Das Gitter muß den Doppelklick geeignet interpretieren und eine Reaktion auslösen. Wenn das Eingabefeld auf den Doppelklick reagieren muß, muß das Gitter hierzu eine Methode aufrufen oder eine Eigenschaft des TInplaceEdit-Objekts setzen.


TInplaceEdit::Deselect

TInplaceEdit	Siehe auch

Die Methode Deselect hebt die Auswahl im Eingabefeld auf.

void __fastcall Deselect(void);

Beschreibung

Mit Deselect wird die Markierung des Textes im Eingabefeld aufgehoben. Der eigentliche Textinhalt wird dabei nicht verändert.


TInplaceEdit::Hide

TInplaceEdit	Siehe auch	Beispiel

Die Methode Hide blendet das Eingabefeld aus und verlagert den Fokus auf das Gitter.

void __fastcall Hide(void);

Beschreibung

Hide macht das Eingabefeld unsichtbar, ohne es freizugeben. Außerdem wird der Eingabefokus vom Eingabefeld auf das Gitter verlagert. Im unsichtbaren Feld werden deshalb keine Tastaturereignisse verarbeitet.

Das Gitter ruft Hide einerseits auf, um das Steuerelement auszublenden, sobald der Eingabemodus verlassen wird, und andererseits, wenn sich die bearbeitete Zelle nach einem Bildlauf nicht mehr innerhalb des Gitterfensters befindet.


TInplaceEdit::Invalidate

TInplaceEdit	Siehe auch	Beispiel

Die Methode Invalidate macht das Eingabefeld und den zugehörigen Teil des Gitterfensters ungültig.

void __fastcall Invalidate(void);

Beschreibung

Mit Invalidate wird sichergestellt, daß gleichzeitig mit dem Eingabefeld auch der darunterliegende Teil des Gitterfensters ungültig wird. Dieser Vorgang muß immer dann ablaufen, wenn das Gitterfenster die vom Eingabefeld abgedeckte Zelle erneut darstellen muß, weil das Eingabefeld ausgeblendet oder freigegeben wurde.


TInplaceEdit::KeyDown

TInplaceEdit	Siehe auch

KeyDown überschreibt die geerbte Methode, um eine Folge von Tastatureingaben an das Gitter weiterzuleiten.

virtual void __fastcall KeyDown(unsigned short &Key,  Classes::TShiftState Shift);

Beschreibung

Sobald der Benutzer eine Taste drückt, überprüft die Methode KeyDown, ob das zugehörige Ereignis KeyDown vom Eingabefeld oder vom Gitter verarbeitet werden soll. Eine Betätigung der Taste EINGABE wird immer an das Gitter übergeben. Über F2 wird Deselect aufgerufen und die aktuelle Auswahl entfernt. Ereignisse, die von den Pfeiltasten (Cursortasten) stammen, werden an das Gitter weitergegeben, wenn die Cursorbewegung innerhalb des Textfeldes nicht ausgeführt werden kann. Wenn sich der Cursor beispielsweise ganz links im Eingabefeld befindet und der Benutzer die Taste LINKS drückt, wird dieses Ereignis an das Gitter übergeben. Das Gitter verlagert dann den Fokus auf die voranstehende Zelle. Befindet sich der Cursor dagegen in der Mitte einer Zeile, wird die Tastatureingabe vom Eingabefeld selbst verarbeitet, und der Cursor wird um ein Zeichen nach links bewegt.

KeyDown ruft zuerst die OnKeyDown-Ereignisbehandlungsroutine für das Gitter auf, falls eine solche vorhanden ist, und dann die geerbte Methode KeyDown für das Eingabe-Steuerelement.


TInplaceEdit::KeyPress

TInplaceEdit	Siehe auch

KeyPress überschreibt die geerbte Methode, damit zuerst das Gitter die Möglichkeit erhält, die Tastatureingabe zu bearbeiten.

virtual void __fastcall KeyPress(char &Key);

Beschreibung

KeyPress überläßt die Verarbeitung von Tastatureingaben zunächst dem Gitter und behandelt nur solche Tastatureingaben, die das Gitter nicht vollständig verarbeitet. Wenn sich das Gitter nach der Verarbeitung einer Tastatureingabe nicht im Eingabemodus befindet, wird das Tastaturereignis von KeyPress verworfen. Die Methode verarbeitet die Betätigung der Taste EINGABE und ruft für alle anderen, nicht verarbeiteten Tastatureingaben die geerbte Methode auf.

Ein Druck auf EINGABE veranlaßt KeyPress, den gesamten Text zu markieren. Falls dieser bereits markiert ist, wird die Markierung aufgehoben.


TInplaceEdit::KeyUp

TInplaceEdit	Siehe auch

KeyUp überschreibt die geerbte Methode, um alle KeyUp-Ereignisse an das Gitter zu übergeben.

virtual void __fastcall KeyUp(unsigned short &Key,  Classes::TShiftState Shift);

Beschreibung

Das Inplace-Eingabefeld selbst verarbeitet überhaupt keine KeyUp-Ereignisse, sondern übergibt diese einfach an das Gitter, dem die Verarbeitung der Ereignisse freigestellt ist.


TInplaceEdit::Move

TInplaceEdit	Siehe auch

Die Methode Move ändert die Position des Eingabefeldes und stellt dessen Inhalt erneut dar.

void __fastcall Move(const Windows::TRect &Loc);

Beschreibung

Das Gitter ruft Move auf, um das Eingabefeld in den vorgegebenen rechteckigen Bereich zu verlagern, wenn die zugehörige Zelle verschoben oder in der Größe verändert wird. Die Position Loc gilt relativ zum Client-Bereich des Gitters.


TInplaceEdit::PosEqual

TInplaceEdit	Siehe auch

Die Methode PosEqual signalisiert, ob das Eingabefeld die Größe und die Position besitzt, die im Parameter Rect übergeben wurde.

bool __fastcall PosEqual(const Windows::TRect &Rect);

Beschreibung

Mit PosEqual kann ermittelt werden, ob das Eingabefeld einen bestimmten rechteckigen Bereich belegt. Dazu wird der Parameter Rect in globalen Koordinaten übergeben. Mit der Methode läßt sich somit feststellen, ob das Inplace-Steuerelement eine bestimmte Zelle im Gitter repräsentiert, indem das Begrenzungsrechteck der Zelle als Parameter angegeben wird.


TInplaceEdit::SetFocus

TInplaceEdit	Siehe auch	Beispiel

Die Methode SetFocus verlagert den Fokus auf das Eingabefeld, wenn dieses sichtbar ist.

void __fastcall SetFocus(void);

Beschreibung

SetFocus bewirkt, daß Tastaturereignisse an das Eingabefeld weitergeleitet werden. Dieses erhält den Fokus allerdings nicht, wenn es durch einen Aufruf der Methode Hide ausgeblendet wurde.


TInplaceEdit::TInplaceEdit

TInplaceEdit	Siehe auch

TInplaceEdit ist der Konstruktor für TInplaceEdit.

__fastcall virtual TInplaceEdit(Classes::TComponent* AOwner);

Beschreibung

TInplaceEdit sorgt dafür, daß das Steuerelement einen Rahmen besitzt, der die Existenz des Steuerelements signalisiert.


TInplaceEdit::UpdateContents

TInplaceEdit	Siehe auch

Die Methode UpdateContents setzt die Eigenschaften EditMask und Text auf die vom Gitter vorgegebenen Werte.

virtual void __fastcall UpdateContents(void);

Beschreibung

UpdateContents ruft die Methoden GetEditMask und GetEditText des Gitters auf und setzt die zugehörigen Eigenschaften EditMask und Text entsprechend. Mit Hilfe von UpdateContents kann das Gitter das Inplace-Eingabefeld mit dem Inhalt einer bestimmten Zelle anzeigen und eine Maske setzen, welche die Eingaben auf gültige Werte beschränkt.


TInplaceEdit::UpdateLoc

TInplaceEdit	Siehe auch

Die Methode UpdateLoc ändert die Position des Eingabefeldes, ohne jedoch dessen Inhalt neu darzustellen.

void __fastcall UpdateLoc(const Windows::TRect &Loc);

Beschreibung

Wenn das Gitter verschoben wird, ruft es UpdateLoc auf, um das Eingabefeld mit zu verschieben. Anders als bei der Methode Move wird das Eingabefeld bei UpdateLoc nicht ungültig und deshalb auch nicht erneut gezeichnet.


TInplaceEdit::WndProc

TInplaceEdit	Siehe auch

Die Methode WndProc ergänzt die geerbte Methode so, daß die besondere Verarbeitung einiger Windows-Botschaften erfolgen kann.

virtual void __fastcall WndProc(Messages::TMessage &Message);

Beschreibung

WndProc ist die erste Methode, die Botschaften für ein Borland C++Builder-Steuerelement empfängt.

Die Methode WndProc für TInplaceEdit übergibt Fokus-Ereignisse an das Gitter. Für alle anderen Windows-Botschaften wird die geerbte Methode aufgerufen. WndProc konvertiert Mausklicks in einen Doppelklick, wenn der erste Klick innerhalb der Doppelklickzeit vom Gitter empfangen wurde.


Gültigkeitsbereich

Protected

Published

Zugriff

Read-only


Gültigkeitsbereich

Protected


Hierarchie

TObject

TPersistent

TComponent

TControl

TWinControl

TCustomEdit

TCustomMaskEdit


TInplaceEdit Beispiel

TInplaceEdit


TIntegerField

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/dbtables.hpp

Ein TIntegerField-Objekt repräsentiert ein vorzeichenbehaftetes 32-Bit-Integer-Feld in einer Datenmenge.

Beschreibung

Integer-Felder können Werte im Bereich von -2,147,483,648 bis 2,147,483,647 enthalten, also große vorzeichenbehaftete Ganzzahlen.

TIntegerField führt neue Eigenschaften ein, die eine Konvertierung zwischen Integer-Werten und anderen Datentypen ermöglichen. Gleichzeitig kann der zugelassene Wertebereich definiert werden. Als Nachkomme von TNumericField erbt TIntegerField viele Eigenschaften, Methoden und Ereignisse, die sich für die Verwaltung des Wertes und der Eigenschaften eines numerischen Feldes in einer Datenbank eignen.

TIntegerField ist der direkte Vorfahr von drei weiteren Feldtypen, die Ganzzahlen darstellen können: TAutoIncField, TSmallintField und TWordField.


Eigenschaften von TIntegerField

TIntegerField	Alphabetisch	Legende

In TIntegerField

MaxValue

MinValue

Value

Abgeleitet von TNumericField

DisplayFormat

EditFormat

Abgeleitet von TField

Alignment

AsBoolean

AsCurrency

AsDateTime

AsFloat

AsInteger

AsString

AsVariant

AttributeSet

BDECalcField

Calculated

CanModify

DataSet

DataSize

DataType

DisplayLabel

DisplayName

DisplayText

DisplayWidth

EditMask

EditMaskPtr

FieldKind

FieldName

FieldNo

Index

IsIndexField

IsNull

KeyFields

Lookup

LookupDataSet

LookupKeyFields

LookupResultField

NewValue

OldValue

ReadOnly

Required

Size

Text

Visible

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Name

Owner

Tag


Eigenschaften von TIntegerField

TIntegerField	Nach Objekten	Legende

Alignment

AsBoolean

AsCurrency

AsDateTime

AsFloat

AsInteger

AsString

AsVariant

AttributeSet

BDECalcField

Calculated

CanModify

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

DataSet

DataSize

DataType

DesignInfo

DisplayFormat

DisplayLabel

DisplayName

DisplayText

DisplayWidth

EditFormat

EditMaskPtr

EditMask

FieldKind

FieldName

FieldNo

Index

IsIndexField

IsNull

KeyFields

LookupDataSet

LookupKeyFields

LookupResultField

Lookup

MaxValue

MinValue

Name

NewValue

OldValue

Owner

ReadOnly

Required

Size

Tag

Text

Value

Visible


TIntegerField::MaxValue

TIntegerField	Siehe auch

Die Eigenschaft MaxValue definiert den maximalen Wert eines Integer-Feldes.

__property long MaxValue;

Beschreibung

Mit MaxValue wird der Maximalwert ermittelt bzw. vorgegeben, der in das Feld eingegeben werden kann. Wenn die Eingabe den Wertebereich überschreitet, wird eine EDatabaseError-Exception ausgelöst.

Wenn MaxValue den Wert 0 hat, kann das Integer-Feld einen so großen Wert aufnehmen, wie es der native Datenbanktyp zuläßt. Bei 32-Bit-Integer-Feldern beträgt das Minimum 2147483647.


TIntegerField::MinValue

TIntegerField	Siehe auch

Die Eigenschaft MinValue definiert den kleinstmöglichen Wert im Integer-Feld.

__property long MinValue;

Beschreibung

Mit MinValue wird der kleinste mögliche Feldwert ermittelt bzw. vorgegeben. Wenn die Eingabe kleiner als MinValue ist, wird eine EDatabaseError-Exception ausgelöst.

Wenn MinValue den Wert 0 hat, kann das Integer-Feld einen Wert annehmen, der so klein ist, wie es der native Datenbanktyp zuläßt. Bei 32-Bit-Integer-Feldern beträgt das Minimum -2147483648


TIntegerField::Value

TIntegerField	Siehe auch

Die Eigenschaft Value bezeichnet die eigentlichen Daten im Integer-Feld.

__property long Value;

Beschreibung

Mit Value werden Daten direkt in ein Integer-Feld geschrieben bzw. daraus gelesen. Mit der Eigenschaft Value erreichen Sie dasselbe wie mit AsInteger. Wenn Sie wissen, daß die Feldkomponente einen 32-Bit-Integer-Wert darstellt, verwenden Sie Value. In Verbindung mit generischen Feldkomponenten setzen Sie AsInteger ein.


Ereignisse von TIntegerField

TIntegerField	Alphabetisch	Legende

Abgeleitet von TField

OnChange

OnGetText

OnSetText

OnValidate


Ereignisse von TIntegerField

TIntegerField	Nach Objekten	Legende

OnChange

OnGetText

OnSetText

OnValidate


Methoden von TIntegerField

TIntegerField	Alphabetisch

In TIntegerField

~TIntegerField

IsValidChar

TIntegerField

Abgeleitet von TField

Assign

AssignValue

Clear

FocusControl

GetData

SetData

SetFieldType

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TIntegerField

TIntegerField	Nach Objekten

~TIntegerField

Assign

AssignValue

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

Clear

DefaultHandler

DestroyComponents

Destroying

Dispatch

FieldAddress

FindComponent

FocusControl

FreeInstance

FreeNotification

Free

GetData

GetParentComponent

HasParent

InheritsFrom

InitInstance

InsertComponent

InstanceSize

IsValidChar

MethodAddress

MethodName

NewInstance

RemoveComponent

SetData

SetFieldType

TIntegerField


TIntegerField::~TIntegerField

TIntegerField

Der Destruktor ~TIntegerField gibt den Speicher frei, der für das TIntegerField-Objekt reserviert war. Rufen Sie ~TIntegerField nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TIntegerField automatisch aufgerufen wird.

__fastcall virtual ~TIntegerField(void);


TIntegerField::IsValidChar

TIntegerField	Siehe auch

Die Methode IsValidChar ermittelt, ob das angegebene Zeichen in einem Integer-Feld gültig ist.

virtual bool __fastcall IsValidChar(char Ch);

Beschreibung

Mit IsValidChar kann festgestellt werden, ob das übergebene Zeichen bei der String-Darstellung eines Integer-Feldes gültig ist.

Zulässig sind die beiden Vorzeichen Plus und Minus (+/-) sowie die Ziffern 0 bis 9. Wenn das untersuchte Zeichen aus dieser Menge stammt, gibt IsValidChar den Wert True zurück. Bei allen anderen Zeichen wird False zurückgegeben.

Diese Methode wird von vielen datensensitiven Steuerelementen für eine Gültigkeitsprüfung verwendet.


TIntegerField::TIntegerField

TIntegerField	Siehe auch

TIntegerField erzeugt eine Instanz von TIntegerField.

__fastcall virtual TIntegerField(Classes::TComponent* AOwner);

Beschreibung

Mit TIntegerField wird eine Instanz von TIntegerField erzeugt. Nach dem Aufruf des geerbten Konstruktors setzt TIntegerField die Eigenschaft DataType auf ftInteger, die Eigenschaft MinValue auf -2147483648 und MaxValue auf 2147483647.

Es ist nur selten notwendig, TIntegerField direkt aufzurufen, da für alle Integer-Felder in einer Datenmenge automatisch eine entsprechende Feldkomponente instantiiert wird.


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TField

TNumericField


TIntegerField Beispiel

TIntegerField


TInternalImage

Hierarchie	Methoden	Siehe auch

Header

vcl/graphics.hpp

TInternalImage ist die abstrakte Basisklasse für Klassen, die interne Abbilder für Grafikobjekte enthalten.

Beschreibung

TInternalImage wird als Basisklasse für solche Klassen verwendet, welche eine interne Darstellung von Grafiken, wie Bitmaps und Symbole, verwalten. TInternalImage ist eine abstrakte Klasse. Ihre Nachkommen werden intern von Borland C++Builder-Grafikobjekten verwendet und automatisch von den zugehörigen Grafikobjekten erzeugt.


Methoden von TInternalImage

TInternalImage	Alphabetisch

In TInternalImage

~TInternalImage

TInternalImage

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TInternalImage

TInternalImage	Nach Objekten

~TInternalImage

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance

TInternalImage


TInternalImage::~TInternalImage

TInternalImage

Der Destruktor ~TInternalImage gibt den Speicher frei, der für das TInternalImage-Objekt reserviert war. Rufen Sie ~TInternalImage nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TInternalImage automatisch aufgerufen wird.

__fastcall virtual ~TInternalImage(void);


TInternalImage::TInternalImage

TInternalImage

Der Konstruktor TInternalImage erzeugt ein neues TInternalImage-Objekt.

__fastcall TInternalImage(void);


Hierarchie

TObject


TInternalImage Beispiel

TInternalImage


 TLabel

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/stdctrls.hpp

Die Komponente TLabel ist ein nicht fensterorientiertes Steuerelement, mit dem beliebiger Text in einem Formular angezeigt werden kann. Normalerweise dient diese Komponente als Beschriftung für andere Steuerelemente.

Der eigentliche Beschriftungstext entspricht dem Wert der Eigenschaft Caption. Optional kann im Text ein Tastenkürzel definiert werden. Sobald der Benutzer dieses Tastenkürzel verwendet, wird das Steuerelement aktiviert, das dem Wert der Eigenschaft FocusControl der TLabel-Komponente entspricht.

Die Eigenschaft Alignment steuert, wie der Text ausgerichtet wird. Mit der Eigenschaft AutoSize läßt sich festlegen, ob das Steuerelement automatisch an die Größe des enthaltenen Textes angepaßt werden soll (True). Wenn Sie statt dessen einen Zeilenumbruch bevorzugen, setzen Sie WordWrap auf True.

Wenn die Beschriftung eine eventuell darunterliegende Grafik nicht abdekken soll, setzen Sie die Eigenschaft Transparent auf True.

Die Komponente TLabel ist ein indirekter Nachkomme von TGraphicControl. Zusätzlich zu den hier beschriebenen Eigenschaften, Methoden und Ereignissen besitzt diese Komponente die Eigenschaften und Methoden, die allen Steuerelementen gemeinsam sind.


Eigenschaften von TLabel

TLabel	Alphabetisch	Legende

Abgeleitet von TCustomLabel

Alignment

AutoSize

FocusControl

ShowAccelChar

Transparent

WordWrap

Abgeleitet von TGraphicControl

Canvas

Abgeleitet von TControl

Align

BoundsRect

Caption

ClientHeight

ClientOrigin

ClientRect

ClientWidth

Color

ControlState

ControlStyle

Cursor

DragCursor

DragMode

Enabled

Font

Height

Hint

Left

Name

Parent

ParentColor

ParentFont

ParentShowHint

PopupMenu

ShowHint

Top

Visible

Width

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TLabel

TLabel	Nach Objekten	Legende

Alignment

Align

AutoSize

BoundsRect

Canvas

Caption

ClientHeight

ClientOrigin

ClientRect

ClientWidth

Color

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlState

ControlStyle

Cursor

DesignInfo

DragCursor

DragMode

Enabled

FocusControl

Font

Height

Hint

Left

Name

Owner

ParentColor

ParentFont

ParentShowHint

Parent

PopupMenu

ShowAccelChar

ShowHint

Tag

Top

Transparent

Visible

Width

WordWrap


Ereignisse von TLabel

TLabel	Alphabetisch	Legende

Abgeleitet von TControl

OnClick

OnDblClick

OnDragDrop

OnDragOver

OnEndDrag

OnMouseDown

OnMouseMove

OnMouseUp

OnStartDrag


Ereignisse von TLabel

TLabel	Nach Objekten	Legende

OnClick

OnDblClick

OnDragDrop

OnDragOver

OnEndDrag

OnMouseDown

OnMouseMove

OnMouseUp

OnStartDrag


Methoden von TLabel

TLabel	Alphabetisch

Abgeleitet von TLabel

~TLabel

TLabel

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

GetTextLen

Hide

Invalidate

Perform

Refresh

Repaint

ScreenToClient

SendToBack

SetBounds

SetTextBuf

Show

Update

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TLabel

TLabel	Nach Objekten

~TLabel

Assign

BeginDrag

BringToFront

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

ClientToScreen

DefaultHandler

DestroyComponents

Destroying

Dispatch

DragDrop

Dragging

EndDrag

FieldAddress

FindComponent

FreeInstance

FreeNotification

Free

GetParentComponent

GetTextBuf

GetTextLen

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InstanceSize

Invalidate

MethodAddress

MethodName

NewInstance

Perform

Refresh

RemoveComponent

Repaint

ScreenToClient

SendToBack

SetBounds

SetTextBuf

Show

TLabel

Update


TLabel::~TLabel

TLabel

Der Destruktor ~TLabel gibt den Speicher frei, der für das TLabel-Objekt reserviert war. Rufen Sie ~TLabel nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TLabel automatisch aufgerufen wird.

__fastcall virtual ~TLabel(void);


TLabel::TLabel

TLabel

Der Konstruktor TLabel erzeugt ein neues TLabel-Objekt.

__fastcall virtual TLabel(Classes::TComponent* AOwner);


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TControl

TGraphicControl

TCustomLabel


TLabel Beispiel

TLabel


TList

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/classes.hpp

TList verwaltet eine Liste von Zeigern auf Objekte.

Beschreibung

Mit einem TList-Objekt wird eine Liste von Objekten gespeichert und verwaltet. TList führt verschiedene Eigenschaften und Methoden ein, die folgenden Zwecken dienen:

•	Objekte zur Liste hinzufügen oder daraus entfernen.

•	Objekte in der Liste neu anordnen.

•	Objekte in der Liste finden und darauf zugreifen.

•	Objekte in der Liste sortieren.


Eigenschaften von TList

TList	Alphabetisch	Legende

In TList

Capacity

Count

Items

List


Eigenschaften von TList

TList	Nach Objekten	Legende

Capacity

Count

Items

List


TList::Capacity

TList	Siehe auch

Die Eigenschaft Capacity bezeichnet die zugewiesene Größe des Zeiger-Arrays, das vom TList-Objekt verwaltet wird.

__property int Capacity;

Beschreibung

Mit Capacity wird die Anzahl der Zeiger vorgegeben, die in der Liste enthalten sein müssen. Wenn nicht genügend Speicher vorhanden ist, um die Liste auf ihre neue Größe zu erweitern, tritt eine EOutOfMemory-Exception auf.

Capacity kann gelesen werden, um die Anzahl der Objekte zu ermitteln, die in der Liste Platz finden, ohne daß weiterer Speicher reserviert werden muß. Verwechseln Sie Capacity nicht mit der Eigenschaft Count, welche die Anzahl der verwendeten Listenelemente angibt. Der Wert von Capacity ist immer größer oder gleich Count. Wenn Capacity größer als Count ist, kann man den ungenutzten Speicher freigeben, indem Capacity auf Count gesetzt wird.

Wird ein Element zu einer Liste hinzugefügt, die bereits vollständig gefüllt ist, wird der Wert von Capacity automatisch erhöht. Sobald Count den Wert von Capacity erreicht, wird die Liste nach folgendem Schema vergrößert: Wenn Capacity größer als 8 ist, erweitert Expand das Fassungsvermögen der Liste um 16 Elemente. Ist Capacity größer als 4, aber kleiner als 9, wird Capacity um 8 erhöht. Ist Capacity kleiner als 4, wird der Wert um 4 erhöht.

Allerdings läßt sich die Anzahl der Speicherzuweisungen verringern und damit die Leistung der Anwendung erhöhen, indem die Eigenschaft Capacity mit einem größeren Wert belegt wird, bevor Objekte hinzugefügt werden. Ein Beispiel:

List->Clear;

List->Capacity = Count;

for(int i = 1; i <  Count;i++)

    List->Add(...);

Indem Capacity vor dem Eintritt in die Schleife einen neuen Wert erhält, wird verhindert, daß bei jeder der nachfolgenden Add-Operationen erneut Speicher für die Liste reserviert wird. Damit steigert sich die Leistung der Anwendung und außerdem ist sichergestellt, daß die Add-Operation keine Exception auslöst.


TList::Count

TList	Siehe auch

Die Eigenschaft Count bezeichnet die Anzahl der Listenelemente, die tatsächlich verwendet werden.

__property int Count;

Beschreibung

Mit dem Wert von Count läßt sich die Anzahl der Elemente im Array Items bestimmen.

Durch die Vergrößerung von Count wird die benötigte Anzahl von NULL -Zeigern am Ende des Arrays Item angefügt. Mit einer Verkleinerung von Count löscht man die gewünschte Anzahl von Elementen am Ende des Arrays.

Der Wert von Count stimmt nicht immer mit der Anzahl der referenzierten Objekte in der Liste überein. Einige Elemente enthalten nämlich eventuell NULL-Zeiger. Mit der Methode Pack können diese NULL-Zeiger gelöscht und Count auf die Anzahl der Elemente gesetzt werden, die Referenzen auf wirkliche Objekte enthalten.


TList::Items

TList	Siehe auch

Die Eigenschaft Items ist das Array der Objektreferenzen.

__property void * Items[int Index];

Beschreibung

Über den Wert von Items kann ein Zeiger auf ein bestimmtes Array-Objekt gebildet werden. Der Parameter Index enthält den Index auf das Objekt, wobei das erste den Index 0 hat, das zweite den Index 1 und so fort. Mit Items kann also eine bestimmte Speicherstelle referenziert werden.

Wenn eine Iteration über sämtliche Listenelemente stattfinden soll, verwenden Sie Items in Verbindung mit der Eigenschaft Count.

Einige Elemente enthalten eventuell NULL-Zeiger. Mit der Methode Pack können diese NULL-Zeiger gelöscht und die Größe des Arrays auf die tatsächliche Anzahl der Objekte verringert werden.


TList::List

TList	Siehe auch

Die Eigenschaft List ist ein Zeiger auf das Zeiger-Array, aus dem Items besteht.

__property PPointerList List;

Beschreibung

Mit List erhält man direkten Zugriff auf das Array Items.


Methoden von TList

TList	Alphabetisch

In TList

~TList

Add

Clear

Delete

Exchange

Expand

First

IndexOf

Insert

Last

Move

Pack

Remove

Sort

TList

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TList

TList	Nach Objekten

~TList

Add

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

Clear

DefaultHandler

Delete

Dispatch

Exchange

Expand

FieldAddress

First

FreeInstance

Free

IndexOf

InheritsFrom

InitInstance

Insert

InstanceSize

Last

MethodAddress

MethodName

Move

NewInstance

Pack

Remove

Sort

TList


TList::~TList

TList	Siehe auch

Die Methode ~TList gibt eine Instanz von Tlist frei.

__fastcall virtual ~TList(void);

Rufen Sie ~TList nicht direkt in einer Anwendung auf. Verwenden Sie statt dessen Free. Die Methode Free überprüft zuerst, ob der Speicher für das TList-Objekt nicht bereits freigegeben ist, und ruft ~TList nur bei Bedarf auf.

~TList gibt den Speicher frei, den die Elementliste belegt hatte.


TList::Add

TList	Siehe auch

Die Methode Add fügt am Ende der Liste ein neues Element an.

int __fastcall Add(void * Item);

Beschreibung

Mit Add wird am Ende des Arrays Items ein neues Element angefügt. Add liefert den Index des neuen Elements zurück, wobei das erste Element den Index 0 (Null) hat.

Wenn das Array Items mehr Speicher benötigt, als in der Eigenschaft Capacity des Listenobjekts vorgegeben, erhöht Add den Wert von Count.

Hinweis

Ein mit Add angefügter Zeiger gelangt immer an das Ende des Arrays, selbst wenn das Array NULL-Zeiger enthält.


TList::Clear

TList	Siehe auch

Clear löscht alle Elemente aus der Liste.

void __fastcall Clear(void);

Beschreibung

Mit Clear wird das Array Items geleert, und Count sowie Capacity werden auf 0 gesetzt. Außerdem wird der gesamte vom Array belegte Speicher freigegeben.


TList::Delete

TList	Siehe auch

Die Methode Delete löscht das Element an der mit Index bezeichneten Position.

void __fastcall Delete(int Index);

Beschreibung

Mit Delete wird das Element an der bezeichneten Position aus der Liste gelöscht. Die Numerierung von Indizes beginnt bei Null für das erste Element. Das zweite Element hat entsprechend den Index 1 und so fort. Sobald ein Element entfernt wurde, rücken alle nachfolgenden Elemente in der Indexposition um eins nach oben, und der Wert von Count wird um eins verringert.

Soll lediglich die Referenz auf ein Element gelöscht werden, ohne das Element selbst zu entfernen und den Wert von Count zu ändern, setzen Sie die Eigenschaft Items für Index auf NULL.

Hinweis

Der für das Element reservierte Speicher wird von Delete nicht freigegeben. Hierzu muß die Eigenschaft Capacity neu gesetzt werden.


TList::Exchange

TList	Siehe auch

Die Methode Exchange vertauscht die Position zweier Elemente im Array Items.

void __fastcall Exchange(int Index1, int Index2);

Beschreibung

Mit Exchange werden die Positionen der Elemente an den beiden Positionen Index1 und Index2 vertauscht. Die Numerierung von Indizes beginnt bei Null für das erste Element. Das zweite Element hat entsprechend den Index 1 und so fort.


TList::Expand

TList	Siehe auch

Die Methode Expand erweitert das Fassungsvermögen der Liste, das heißt, der Wert der Eigenschaft Capacity wird erhöht.

TList* __fastcall Expand(void);

Beschreibung

Mit Expand wird Platz für weitere Listenelemente geschaffen. Die Methode hat allerdings nur dann einen Effekt, wenn die Liste bereits bis zum Wert von Capacity gefüllt ist.

Sobald Count den Wert von Capacity erreicht, wird die Liste nach folgendem Schema vergrößert: Wenn Capacity größer als 8 ist, erweitert Expand das Fassungsvermögen der Liste um 16 Elemente. Ist Capacity größer als 4, aber kleiner als 9, wird Capacity um 8 erhöht. Ist Capacity kleiner als 4, wird der Wert um 4 erhöht.

Der Rückgabewert ist das erweiterte Listenobjekt.


TList::First

TList	Siehe auch

Die Methode gibt den Wert Items[0] zurück.

void * __fastcall First(void);

Beschreibung

Mit First kann der erste Zeiger im Array Items ermittelt werden.


TList::IndexOf

TList	Siehe auch

IndexOf bezeichnet das erste Element im Array Items, das den mit Item angegebenen Wert hat.

int __fastcall IndexOf(void * Item);

Beschreibung

Mit IndexOf kann der Index eines Zeigers im Array Items ermittelt werden. Das erste Element im Array hat den Index 0, der zweite den Index 1 und so fort. Kann das Element nicht gefunden werden, gibt IndexOf den Wert -1 zurück. Wenn ein Zeiger mehrmals im Array vorkommt, wird derjenige Index zurückgegeben, der zum ersten Auftreten des Zeigers gehört.


TList::Insert

TList	Siehe auch

Die Methode Insert fügt dem Array Items an der mit Index bezeichneten Position ein Objekt hinzu.

void __fastcall Insert(int Index, void * Item);

Beschreibung

Mit Insert wird der Zeiger Item an beliebiger Stelle im Array Items eingefügt. Die Indexnumerierung beginnt bei Null, so daß die erste Array-Position den Index 0 hat. Das Element, das vorher an der Stelle des eingefügten stand, erhält zusammen mit allen nachfolgenden Elementen eine um eins höhere Indexposition. Bei Bedarf wird die Größe der Liste erweitert (Eigenschaft Capacity). Die Eigenschaft Count wird erhöht.

Wenn ein NULL-Zeiger durch ein neues Element ersetzt werden soll, ohne das Array zu vergrößern, setzen Sie die Eigenschaft Items.


TList::Last

TList	Siehe auch

Die Methode Last gibt den Wert Items[Count - 1] zurück.

void * __fastcall Last(void);

Beschreibung

Mit Count wird der letzte Zeiger im Array Items ermittelt.


TList::Move

TList	Siehe auch

Die Methode Move ändert die Position eines Elements im Array Items.

void __fastcall Move(int CurIndex, int NewIndex);

Beschreibung

Mit Move kann ein Element von der Position CurIndex an die Position NewIndex verschoben werden. Die Numerierung der Indexangaben CurIndex und NewIndex beginnt bei Null für das erste Element.


TList::Pack

TList	Siehe auch

Die Methode Pack löscht alle NULL-Zeiger aus dem Array Items.

void __fastcall Pack(void);

Beschreibung

Mit Pack werden innerhalb des Arrays Items alle Elemente, die keine NULL-Zeiger sind, nach vorne gebracht. Dabei wird der Wert der Eigenschaft Count auf die Zahl der Elemente verringert, die tatsächlich verwendet werden. Die Methode Pack gibt allerdings den für die NULL-Zeiger verwendeten Speicher nicht frei. Hierzu muß die Eigenschaft Capacity auf den neuen Wert von Count gesetzt werden.


TList::Remove

TList	Siehe auch

Die Methode Remove löscht die erste Referenz auf den Parameter Item aus dem Array Items.

int __fastcall Remove(void * Item);

Beschreibung

Mit Remove kann ein bestimmtes Element des Arrays Items entfernt werden, wenn der Index des Elements unbekannt ist. Der Rückgabewert ist der Index des Elements vor dem Löschen. Sobald ein Element entfernt wurde, rücken alle nachfolgenden Elemente in der Indexposition um eins nach oben, und der Wert von Count wird um eins verringert.

Wenn das Array Items mehrere Kopien des Zeigers enthält, wird nur die erste Kopie gelöscht.


TList::Sort

TList	Siehe auch

Mit Sort wird für die Liste ein QuickSort-Algorithmus gestartet, der auf der Vergleichsfunktion Compare basiert.

void __fastcall Sort(TListSortCompare Compare);

Beschreibung

Mit Sort können die Elemente des Arrays Items sortiert werden. Compare ist eine Vergleichsfunktion, die anzeigt, wie die Elemente sortiert sind. Compare gibt einen Wert kleiner Null zurück, wenn Item1 kleiner ist als Item2. Der Rückgabewert ist Null, wenn beide Elemente gleich sind. Wenn Item1 größer als Item2 ist, ist der Rückgabewert größer Null.


TList::TList

TList	Siehe auch

Der Konstruktor TList erzeugt ein neues TList-Objekt.

__fastcall TList(void);


Zugriff

Read-only


Hierarchie

TObject


TList Beispiel

TList


 TListBox

Hierarchie	Eigenschaften	Methoden	Ereignisse

Header

vcl/: stdctrls.hpp

TListBox kapselt ein Listenfeld, wie es von Windows verwendet wird.

Beschreibung

TListBox implementiert das generische Verhalten, das in TCustomListbox eingeführt wurde. TListBox deklariert viele der von TCustomListBox geerbten Eigenschaften als published, ohne jedoch neues Verhalten einzuführen.

Mit TListBox können bildlauffähige Elementlisten angezeigt werden, in denen der Benutzer eine Auswahl treffen sowie Elemente löschen und hinzufügen kann. Wenn Sie spezielle Funkionalität benötigen, verwenden Sie Nachkommen dieser Klasse oder bilden selbst eine Ableitung.


Eigenschaften von TListBox

TListBox	Alphabetisch	Legende

Abgeleitet von TCustomListBox

BorderStyle

Canvas

Columns

ExtendedSelect

IntegralHeight

ItemHeight

ItemIndex

Items

MultiSelect

SelCount

Selected

Sorted

Style

TabWidth

TopIndex

Abgeleitet von TWinControl

Brush

ClientOrigin

ClientRect

ControlCount

Controls

Ctl3D

Handle

HelpContext

ParentCtl3D

Showing

TabOrder

TabStop

Abgeleitet von TControl

Align

BoundsRect

ClientHeight

ClientWidth

Color

ControlState

ControlStyle

Cursor

DragCursor

DragMode

Enabled

Font

Height

Hint

Left

Name

Parent

ParentColor

ParentFont

ParentShowHint

PopupMenu

ShowHint

Top

Visible

Width

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TListBox

TListBox	Nach Objekten	Legende

Align

BorderStyle

BoundsRect

Brush

Canvas

ClientHeight

ClientOrigin

ClientRect

ClientWidth

Color

Columns

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlCount

ControlState

Controls

ControlStyle

Ctl3D

Cursor

DesignInfo

DragCursor

DragMode

Enabled

ExtendedSelect

Font

Handle

Height

HelpContext

Hint

IntegralHeight

ItemHeight

ItemIndex

Items

Left

MultiSelect

Name

Owner

ParentColor

ParentCtl3D

ParentFont

ParentShowHint

Parent

PopupMenu

SelCount

Selected

ShowHint

Showing

Sorted

Style

TabOrder

TabStop

TabWidth

Tag

TopIndex

Top

Visible

Width


Ereignisse von TListBox

TListBox	Alphabetisch	Legende

Abgeleitet von TCustomListBox

OnDrawItem

OnMeasureItem

Abgeleitet von TWinControl

OnEnter

OnExit

OnKeyDown

OnKeyPress

OnKeyUp

Abgeleitet von TControl

OnClick

OnDblClick

OnDragDrop

OnDragOver

OnEndDrag

OnMouseDown

OnMouseMove

OnMouseUp

OnStartDrag


Ereignisse von TListBox

TListBox	Nach Objekten	Legende

OnClick

OnDblClick

OnDragDrop

OnDragOver

OnDrawItem

OnEndDrag

OnEnter

OnExit

OnKeyDown

OnKeyPress

OnKeyUp

OnMeasureItem

OnMouseDown

OnMouseMove

OnMouseUp

OnStartDrag


Methoden von TListBox

TListBox	Alphabetisch

Abgeleitet von TCustomListBox

~TCustomListBox

Clear

ItemAtPos

ItemRect

TCustomListBox

Abgeleitet von TWinControl

Broadcast

CanFocus

ContainsControl

ControlAtPos

DisableAlign

EnableAlign

Focused

GetTabOrderList

HandleAllocated

HandleNeeded

InsertControl

Invalidate

PaintTo

Realign

RemoveControl

Repaint

ScaleBy

ScrollBy

SetBounds

SetFocus

Update

UpdateControlState

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

GetTextLen

Hide

Perform

Refresh

ScreenToClient

SendToBack

SetTextBuf

Show

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TListBox

TListBox	Nach Objekten

~TCustomListBox

Assign

BeginDrag

BringToFront

Broadcast

CanFocus

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

Clear

ClientToScreen

ContainsControl

ControlAtPos

DefaultHandler

DestroyComponents

Destroying

DisableAlign

Dispatch

DragDrop

Dragging

EnableAlign

EndDrag

FieldAddress

FindComponent

Focused

FreeInstance

FreeNotification

Free

GetParentComponent

GetTabOrderList

GetTextBuf

GetTextLen

HandleAllocated

HandleNeeded

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InsertControl

InstanceSize

Invalidate

ItemAtPos

ItemRect

MethodAddress

MethodName

NewInstance

PaintTo

Perform

Realign

Refresh

RemoveComponent

RemoveControl

Repaint

ScaleBy

ScreenToClient

ScrollBy

SendToBack

SetBounds

SetFocus

SetTextBuf

Show

TCustomListBox

UpdateControlState

Update


~TListBox

Der Destruktor ~TListBox gibt den Speicher frei, der für das TListBox-Objekt reserviert war. Rufen Sie ~TListBox nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TListBox automatisch aufgerufen wird.

__fastcall virtual ~TListBox(void);


TListBox

Der Konstruktor TListBox erzeugt ein neues TListBox-Objekt.

__fastcall virtual TListBox(Classes::TComponent* AOwner);


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TControl

TWinControl

TCustomListBox


TListBox Beispiel

TListBox


TListItem

Hierarchie	Eigenschaften	Methoden

Header

vcl/comctrls.hpp

Das TListItem-Objekt repräsentiert einen einzelnen Eintrag in einem TListView-Steuerelement. Ein Listeneintrag wird durch eine Zeile der Listenansicht dargestellt.

Beschreibung

Ein Listenelement besteht aus einer Beschriftung (Eigenschaft Caption) und den Daten (Eigenschaft Data). Diese werden in der Anwendung definiert. Caption enthält einen String und Data einen Zeiger auf die Datenstruktur, die dem Listenelement zugeordnet werden soll. Mit der Methode Delete kann ein Listenelement gelöscht werden. Wenn die Eigenschaft ReadOnly auf False gesetzt wird, kann der Benutzer die Beschriftung (Caption) des Eintrags ändern.

Jedem Eintrag ist ein eindeutiger Index zugewiesen. Die Eigenschaft Index entspricht dem Index der Eigenschaft Items eines TListView-Steuerelements. Mit der Methode MakeVisible können verborgene Einträge angezeigt werden (es wird ein entsprechender Bildlauf ausgeführt). Die Eigenschaft ListView gibt die Listenansicht an, die als Eigentümer des Eintrags fungiert. Über die Eigenschaft SubItems kann auf die Untereinträge des Listenelements zugegriffen werden.

Die Eigenschaft Focused legt fest, ob ein Eintrag den Fokus besitzt. Der betreffende Eintrag ist dann von einem Standard-Fokusrechteck umgeben. Es kann immer nur ein Eintrag den Fokus besitzen. Die Eigenschaft Selected gibt an, ob das Listenelement ausgewählt ist. Mit der Eigenschaft DropTarget kann ein Eintrag zum Ziel einer Drag-and-Drop-Operation gemacht werden.

Neben den genannten Eigenschaften, Methoden und Ereignissen verfügt TListItem auch über die Methoden, die allen Objekten gemeinsam sind.


Eigenschaften von TListItem

TListItem	Alphabetisch	Legende

In TListItem

Caption

Cut

Data

DropTarget

Focused

Handle

ImageIndex

Index

Left

ListView

OverlayIndex

Owner

Selected

StateIndex

SubItems

Top


Eigenschaften von TListItem

TListItem	Nach Objekten	Legende

Caption

Cut

Data

DropTarget

Focused

Handle

ImageIndex

Index

Left

ListView

OverlayIndex

Owner

Selected

StateIndex

SubItems

Top


TListItem::Caption

TListItem	Beispiel

Die Eigenschaft Caption legt den Namen des Listeneintrags fest.

__property System::AnsiString Caption;

Beschreibung

Mit der Eigenschaft Caption wird der Name des Eintrags festgelegt. Wenn die Eigenschaft ReadOnly auf False gesetzt wird, kann der Benutzer die Beschriftung ändern.


TListItem::Cut

TListItem

Die Eigenschaft Cut gibt an, ob der Listeneintrag als Teil einer Ausschneiden-und-Einfügen-Operation ausgewählt ist.

__property bool Cut;

Beschreibung

Wenn Cut den Wert True hat, wird der Listeneintrag als Teil einer Ausschneiden-und-Einfügen-Operation markiert. Hat Cut den Wert False, ist der Eintrag nicht markiert.


TListItem::Data

TListItem

Über die Eigenschaft Data geben Sie die Daten an, die einem Listeneintrag zugewiesen werden sollen.

__property void * Data;

Beschreibung

Data enthält einen Zeiger auf die Datenstruktur, die mit dem Listeneintrag verbunden werden soll.


TListItem::DropTarget

TListItem

Mit der Eigenschaft DropTarget kann ein Element in einer Listenansicht als Ziel einer Drag-and-Drop-Operation ausgewählt werden.

__property bool DropTarget;

Beschreibung

Wenn DropTarget den Wert True hat, wird der Listeneintrag mit dem Stil gezeichnet, der auf ein Drag-and-Drop-Ziel hinweist.


TListItem::Focused

TListItem

Die Eigenschaft Fokus gibt an, ob der Listeneintrag den Fokus besitzt.

__property bool Focused;

Beschreibung

Der Eintrag, der den Fokus besitzt, ist von einem Standard-Fokusrechteck umgeben. Es kann immer nur ein Eintrag in der Listenansicht den Fokus besitzen.


TListItem::Handle

TListItem	Beispiel

Über die Eigenschaft Handle kann die Handle-Eigenschaft der Listenansicht ermittelt werden, die der Eigentümer des Listeneintrags ist.

__property HWND Handle;

Beschreibung

Über die Eigenschaft Handle haben Sie Zugriff auf ein Windows-Handle. Sie können damit auf GDI-Objekte zugreifen oder Windows-API-Funktionen aufrufen, die ein Handle als Parameter übernehmen.


TListItem::ImageIndex

TListItem

Über die Eigenschaft ImageIndex legen Sie das Bild aus einer Bilderliste fest, das angezeigt wird, wenn ein Listeneintrag nicht ausgewählt ist.

__property int ImageIndex;

Beschreibung

Eine Listenansichtkomponente benutzt eine Bilderliste, wenn LargeImages oder SmallImages gesetzt ist. Wenn LargeImages festgelegt ist, müssen Sie ViewStyle auf vsIcon setzen, damit die Bilder angezeigt werden. Ist SmallImages festgelegt, muß ViewStyle zur Anzeige der Bilder auf vsSmallIcon, vsReport oder vsList gesetzt werden.

Für einen Eintrag in der Listenansicht (der nicht ausgewählt ist) wird das erste Bild in der Bilderliste als Standardbild verwendet. Dies gilt jedoch nicht, wenn mit Hilfe von ImageIndex ein anderes Bild angegeben wurde.


TListItem::Index

TListItem

Durch die Eigenschaft Index wird jeder Eintrag in einer Listenansicht eindeutig bezeichnet.

__property int Index;

Beschreibung

Der erste Eintrag hat den Index 0, der zweite den Index 1 usw.


TListItem::Left

TListItem	Beispiel

Left gibt die horizontale Koordinate des linken Randes eines Listeneintrags relativ zur Listenansicht in Pixel an.

__property int Left;

Beschreibung

Die Eigenschaft Left legt die horizontale Koordinate des linken Randes eines Listeneintrags relativ zur Listenansicht fest. Die Angabe erfolgt in Pixel.


TListItem::ListView

TListItem

Die Eigenschaft ListView bezeichnet das Listenansicht-Steuerelement, das als Eigentümer des Eintrags fungiert.

__property TCustomListView* ListView;

Beschreibung

Mit ListView kann die Listenansicht ermittelt werden, die dem Eintrag übergeordnet ist.


TListItem::OverlayIndex

TListItem

Über die Eigenschaft OverlayIndex wird das Bild aus der Bilderliste angegeben, das als Overlay-Maske eingesetzt werden soll.

__property int OverlayIndex;

Beschreibung

Eine Overlay-Maske ist ein Bild, das transparent über ein anderes Bild in der Listenansicht gelegt wird. Beispielsweise kann ein Overlay-Bild, das ein großes X über das Bild des aktuellen Eintrags legt, anzeigen, daß dieser Eintrag nicht mehr verfügbar ist.

Eine Listenansichtkomponente benutzt eine Bilderliste, wenn LargeImages oder SmallImages gesetzt ist. Wenn LargeImages festgelegt ist, müssen Sie ViewStyle auf vsIcon setzen, damit die Bilder angezeigt werden. Ist SmallImages festgelegt, muß ViewStyle zur Anzeige der Bilder auf vsSmallIcon, vsReport oder vsList gesetzt werden.


TListItem::Owner

TListItem

Die Eigenschaft Owner bezeichnet das TListItems-Objekt, das als Eigentümer des Listeneintrags fungiert.

__property TListItems* Owner;

Beschreibung

Owner ist eine Laufzeiteigenschaft mit dem Attribut Nur-Lesen. Mit ihr kann das übergeordnete TListItems-Objekt eines Listeneintrags ermittelt werden.


TListItem::Selected

TListItem 	Beispiel

Die Eigenschaft Selected gibt an, ob ein Listeneintrag ausgewählt ist.

__property bool Selected;

Beschreibung

Ein Listeneintrag ist ausgewählt, wenn seine Selected-Eigenschaft den Wert True hat. Ist Selected auf False gesetzt, ist der Eintrag nicht ausgewählt. Die Darstellung eines ausgewählten Eintrags ist davon abhängig, ob er den Fokus besitzt und ob die Systemfarben für die Markierung benutzt werden. Durch die Auswahl eines Eintrags werden die Ereignisse OnChanging und OnChanged für die Listenansicht ausgelöst.


TListItem::StateIndex

TListItem

Über die Eigenschaft StateIndex wird festgelegt, welches Bild aus der Bilderliste StateImages für einen Listeneintrag angezeigt werden soll.

__property int StateIndex;

Beschreibung

Ein Statusbild dient zur Anzeige eines zusätzlichen Bildes links neben dem Symbol des Listeneintrags. Zum Beispiel wird mit dem folgenden Code der Statusindex des gewählten Bildes gesetzt: $$


TListItem::SubItems

TListItem

Die Eigenschaft SubItems enthält Strings, die als Untereinträge für die Einträge in einer Listenansicht angezeigt werden.

__property Classes::TStrings* SubItems;

Beschreibung

Mit der Methode Add der Eigenschaft SubItem kann ein neuer Untereintrag hinzugefügt werden. Untereinträge sind nur sichtbar, wenn die Eigenschaft ViewStyle der Listenansicht auf vsReport gesetzt ist.

Beispiel

Im folgenden Beispiel wird ein neuer Untereintrag zum ausgewählten Eintrag hinzugefügt. $$


TListItem::Top

TListItem	Beispiel

Die Eigenschaft Top dient zur Positionierung eines Eintrags in der Listenansicht.

__property int Top;

Beschreibung

Mit der Eigenschaft Top kann ein Eintrag in vertikaler Richtung an eine (in Pixel angegebene) Position innerhalb des Client-Bereichs der Listenansicht bewegt werden. Die Eigenschaft ViewStyle der Listenansicht muß auf vsIcon oder vsSmallIcons gesetzt sein.


Methoden von TListItem

TListItem	Alphabetisch

In TListItem

~TListItem

CancelEdit

Delete

DisplayRect

EditCaption

GetPosition

MakeVisible

SetPosition

TListItem

Update

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TListItem

TListItem	Nach Objekten

~TListItem

Assign

CancelEdit

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Delete

Dispatch

DisplayRect

EditCaption

FieldAddress

FreeInstance

Free

GetPosition

InheritsFrom

InitInstance

InstanceSize

MakeVisible

MethodAddress

MethodName

NewInstance

SetPosition

TListItem

Update


TListItem::~TListItem

TListItem

Der Destruktor ~TListItem gibt den Speicher frei, der für das TListItem-Objekt reserviert war. Rufen Sie ~TListItem nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TListItem automatisch aufgerufen wird.

__fastcall virtual ~TListItem(void);


TListItem::CancelEdit

TListItem

Die Methode CancelEdit beendet in einer Listenansicht die Bearbeitung des Textes eines Eintrags.

void __fastcall CancelEdit(void);

Beschreibung

Mit der Methode CancelEdit wird die Bearbeitung einer Beschriftung in einer Listenansicht beendet.


TListItem::Delete

TListItem

Die Methode Delete löscht einen Eintrag aus einer Listenansicht.

void __fastcall Delete(void);

Beschreibung

Mit der Methode Delete kann ein Listeneintrag gelöscht werden.


TListItem::DisplayRect

TListItem

Die Methode DisplayRect gibt das umgebende Begrenzungsrechteck (TRect-Datensatz) eines Eintrags in einer Listenansicht zurück.

Windows::TRect __fastcall DisplayRect(TDisplayCode Code);

Beschreibung

Der Parameter Code bestimmt beim Abrufen des umgebenden Rechtecks für einen (gesamten oder teilweisen) Eintrag in der Listenansicht den Typ des Anzeigeelements. Der Parameter Code kann folgende Werte annehmen:

Wert	Bedeutung

drBounds	Liefert das umgebende Rechteck für den gesamten Listeneintrag (einschließlich Symbol und Beschriftung) zurück.

drIcon	Liefert das umgebende Rechteck für das Symbol bzw. das kleine Symbol zurück.

drLabel	Liefert das umgebende Rechteck für den Text des Eintrags zurück.

drSelectBounds	Liefert Vereinigungsmenge des Symbol- und Beschriftungsrechtecks zurück. Spalten in der Detailansicht werden nicht berücksichtigt.


TListItem::EditCaption

TListItem

Die Methode EditCaption startet die Inplace-Bearbeitung der Beschriftung des angegebenen Listeneintrags.

bool __fastcall EditCaption(void);

Beschreibung

Diese Methode wählt den angegeben Eintrag implizit aus und übergibt ihm den Fokus.


TListItem::GetPosition

TListItem

Die Methode GetPosition liefert die Position eines Listeneintrags als Punkt zurück.

POINT __fastcall GetPosition(void);

Beschreibung

Die zurückgegebene Position bezeichnet die obere linke Koordinate des Listeneintrags.


TListItem::MakeVisible

TListItem	Siehe auch

Die Methode MakeVisible zeigt einen Eintrag in einer Listenansicht an und führt dazu gegebenenfalls einen Bildlauf durch.

void __fastcall MakeVisible(bool PartialOK);

Beschreibung

Über den Parameter PartialOK wird angegeben, ob der Eintrag vollständig angezeigt werden muß. Wird dieser Parameter auf True gesetzt, erfolgt kein weiterer Bildlauf, wenn zumindest ein Teil des Eintrags sichtbar ist. Wird PartialOK auf False gesetzt, ist immer der gesamte Eintrag in der Listenansicht sichtbar.


TListItem::SetPosition

TListItem	Siehe auch

Mit der Methode SetPosition wird die Position eines Eintrags in der Listenansicht festgelegt.

void __fastcall SetPosition(const POINT &Value);

Beschreibung

SetPosition verschiebt einen Eintrag an die angegebene Position in der Listenansicht. Die Eigenschaft ViewStyle der Listenansicht muß entweder auf vsIcon oder auf vsSmallIcon gesetzt sein. Der Punkt, an den der Eintrag verschoben werden soll, wird über den Parameter Value festgelegt. Diese Positionsangabe erfolgt durch ein Koordinatenpaar, das die obere linke Ecke des Eintrags relativ zum Listenansicht-Steuerelement angibt. Der folgende Code positioniert den ausgewählten Eintrag auf die Position 5, 5 in der Listenansicht: $$


TListItem::TListItem

TListItem

Der Konstruktor TListItem erzeugt ein neues TListItem-Objekt.

__fastcall TListItem(TListItems* AOwner);

Beschreibung

Mit TListItem wird zur Laufzeit eine TListItem-Komponente instantiiert.


TListItem::Update

TListItem	Beispiel

Die Methode Update aktualisiert die Anzeige eines Listeneintrags.

void __fastcall Update(void);

Beschreibung

Die Methode Update aktualisiert die Anzeige eines Listeneintrags und gibt nach erfolgreicher Ausführung True zurück.


Zugriff

Read-only


Hierarchie

TObject

TPersistent


TListItem Beispiel

TListItem


 TListView

Hierarchie	Eigenschaften	Methoden	Ereignisse

Header

vcl/comctrls.hpp

Eine Komponente der Klasse TListView ist eine Liste mit Einträgen, die auf verschiedene Weise angezeigt werden können. Die Eigenschaft ViewStyle legt fest, ob die Einträge spaltenweise mit Überschrift und Untereinträgen, vertikal oder horizontal oder mit kleinen oder großen Symbolen angezeigt werden.

Beschreibung

Mit der Eigenschaft Items können Sie Einträge hinzufügen, löschen und einfügen, den Titel ändern und Symbole für die Einträge festlegen. Mit der Eigenschaft Columns können Sie Spalten in die Listenansicht einfügen. Um die Kopfzeilen der Spalten anzuzeigen, setzen Sie ViewStyle auf vsReport und ShowColumnHeaders auf True. Die Eigenschaft ColumnClick legt fest, ob sich die Kopfzeile wie eine Schaltfläche verhält. Das Ereignis OnColumnClick tritt ein, wenn ColumnClick True ist und der Benutzer auf die Kopfzeile einer Spalte klickt.

Wenn die Eigenschaft ViewStyle auf vsIcon gesetzt ist, werden die Symbole der in der Eigenschaft LargeImages angegebenen Bilderliste verwendet. Die Eigenschaft IconOptions gliedert sich in drei Optionen. Mit AutoArrange können die Symbole der Liste automatisch angeordnet werden. Mit Arrangement können Sie festlegen, wie die Symbole in der Listenansicht ausgerichtet werden. WrapText legt fest, ob der Titel des Eintrags umbrochen wird, wenn er die Breite des Symbols überschreitet. Wenn die Eigenschaft ViewStyle auf vsSmallIcon gesetzt ist, werden die Symbole der in der Eigenschaft SmallImages angegebenen Bilderliste verwendet.

Um den Titel eines Eintrags der Liste bearbeiten zu können, setzen Sie ReadOnly auf False. Die Ereignisse OnEditing und OnEdited werden ausgelöst, sobald die Bearbeitung des Titels begonnen bzw. beendet wird.

Die Komponente TListView ist ein indirekter Nachkomme von TWinControl. Zusätzlich zu den folgenden Eigenschaften, Methoden und Ereignissen verfügt die Komponente über die Eigenschaften, Methoden und Ereignisse, die alle fensterorientierten Steuerelemente gemeinsam haben.


Eigenschaften von TListView

TListView	Alphabetisch	Legende

Abgeleitet von TCustomListView

AllocBy

BorderStyle

BoundingRect

Column

ColumnClick

Columns

DropTarget

HideSelection

IconOptions

ItemFocused

Items

LargeImages

MultiSelect

ReadOnly

SelCount

Selected

ShowColumnHeaders

SmallImages

SortType

StateImages

TopItem

ViewOrigin

ViewStyle

VisibleRowCount

Abgeleitet von TWinControl

Brush

ClientOrigin

ClientRect

ControlCount

Controls

Ctl3D

Handle

HelpContext

Showing

TabOrder

TabStop

Abgeleitet von TControl

Align

BoundsRect

ClientHeight

ClientWidth

Color

ControlState

ControlStyle

Cursor

DragCursor

DragMode

Enabled

Font

Height

Hint

Left

Name

Parent

ParentShowHint

PopupMenu

ShowHint

Top

Visible

Width

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TListView

TListView	Nach Objekten	Legende

Align

AllocBy

BorderStyle

BoundingRect

BoundsRect

Brush

ClientHeight

ClientOrigin

ClientRect

ClientWidth

Color

ColumnClick

Columns

Column

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlCount

ControlState

Controls

ControlStyle

Ctl3D

Cursor

DesignInfo

DragCursor

DragMode

DropTarget

Enabled

Font

Handle

Height

HelpContext

HideSelection

Hint

IconOptions

ItemFocused

Items

LargeImages

Left

MultiSelect

Name

Owner

ParentShowHint

Parent

PopupMenu

ReadOnly

SelCount

Selected

ShowColumnHeaders

ShowHint

Showing

SmallImages

SortType

StateImages

TabOrder

TabStop

Tag

TopItem

Top

ViewOrigin

ViewStyle

VisibleRowCount

Visible

Width


Ereignisse von TListView

TListView	Alphabetisch	Legende

Abgeleitet von TCustomListView

OnChange

OnChanging

OnColumnClick

OnCompare

OnDeletion

OnEdited

OnEditing

OnInsert

Abgeleitet von TWinControl

OnEnter

OnExit

OnKeyDown

OnKeyPress

OnKeyUp

Abgeleitet von TControl

OnClick

OnDblClick

OnDragDrop

OnDragOver

OnEndDrag

OnMouseDown

OnMouseMove

OnMouseUp

OnStartDrag


Ereignisse von TListView

TListView	Nach Objekten	Legende

OnChange

OnChanging

OnClick

OnColumnClick

OnCompare

OnDblClick

OnDeletion

OnDragDrop

OnDragOver

OnEdited

OnEditing

OnEndDrag

OnEnter

OnExit

OnInsert

OnKeyDown

OnKeyPress

OnKeyUp

OnMouseDown

OnMouseMove

OnMouseUp

OnStartDrag


Methoden von TListView

TListView	Alphabetisch

Abgeleitet von TCustomListView

~TCustomListView

AlphaSort

Arrange

CustomSort

FindCaption

FindData

GetItemAt

GetNearestItem

GetNextItem

GetSearchString

IsEditing

Scroll

StringWidth

TCustomListView

UpdateItems

Abgeleitet von TWinControl

Broadcast

CanFocus

ContainsControl

ControlAtPos

DisableAlign

EnableAlign

Focused

GetTabOrderList

HandleAllocated

HandleNeeded

InsertControl

Invalidate

PaintTo

Realign

RemoveControl

Repaint

ScaleBy

ScrollBy

SetBounds

SetFocus

Update

UpdateControlState

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

GetTextLen

Hide

Perform

Refresh

ScreenToClient

SendToBack

SetTextBuf

Show

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TListView

TListView	Nach Objekten

~TCustomListView

AlphaSort

Arrange

Assign

BeginDrag

BringToFront

Broadcast

CanFocus

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

ClientToScreen

ContainsControl

ControlAtPos

CustomSort

DefaultHandler

DestroyComponents

Destroying

DisableAlign

Dispatch

DragDrop

Dragging

EnableAlign

EndDrag

FieldAddress

FindCaption

FindComponent

FindData

Focused

FreeInstance

FreeNotification

Free

GetItemAt

GetNearestItem

GetNextItem

GetParentComponent

GetSearchString

GetTabOrderList

GetTextBuf

GetTextLen

HandleAllocated

HandleNeeded

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InsertControl

InstanceSize

Invalidate

IsEditing

MethodAddress

MethodName

NewInstance

PaintTo

Perform

Realign

Refresh

RemoveComponent

RemoveControl

Repaint

ScaleBy

ScreenToClient

ScrollBy

Scroll

SendToBack

SetBounds

SetFocus

SetTextBuf

Show

StringWidth

TCustomListView

UpdateControlState

UpdateItems

Update


~TListView

Der Destruktor ~TListView gibt den Speicher frei, der für das TListView-Objekt reserviert war. Rufen Sie ~TListView nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TListView automatisch aufgerufen wird.

__fastcall virtual ~TListView(void);


TListView

Der Konstruktor TListView erzeugt ein neues TListView-Objekt.

__fastcall virtual TListView(Classes::TComponent* AOwner);


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TControl

TWinControl

TCustomListView


TListView Beispiel

TListView


TListColumn

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/comctrls.hpp

Das Objekt repräsentiert eine Spalte in einer Listenansicht.

Beschreibung

Jedes TListView-Objekt verwendet ein TListColumns-Objekt für die Verwaltung einer Kollektion von TListColumn-Objekten.


Eigenschaften von TListColumn

TListColumn	Alphabetisch	Legende

In TListColumn

Alignment

Caption

Width

WidthType

Abgeleitet von TCollectionItem

Collection

Index


Eigenschaften von TListColumn

TListColumn	Nach Objekten	Legende

Alignment

Caption

Collection

Index

Width

WidthType


TListColumn::Alignment

TListColumn	Siehe auch	Beispiel

Die Eigenschaft legt fest, wie die Überschrift innerhalb einer Listenspalte ausgerichtet wird.

__property Classes::TAlignment Alignment;

Beschreibung

Die Eigenschaft Alignment kann folgende Werte annehmen:

Wert	Position der Überschrift

taLeftJustify	Links in der Spalte.

taCenter	Zentriert in der Spalte.

taRightJustify	Rechts in der Spalte.


TListColumn::Caption

TListColumn	Siehe auch	Beispiel

Die Eigenschaft Caption definiert den Text, der im Kopf einer Spalte angezeigt wird.

__property System::AnsiString Caption;

Beschreibung

Die Eigenschaft Caption enthält einen Text-String, der den Inhalt der Listenspalte beschreibt. Wenn die Eigenschaften ViewStyle und ShowColumnHeaders der Listenansicht auf vsReport bzw. True gesetzt sind, wird der Wert von Caption über der Spalte angezeigt.


TListColumn::Width

TListColumn	Siehe auch	Beispiel

Die Eigenschaft bestimmt die Breite einer Spalte.

__property TWidth Width;

Beschreibung

Mit der Eigenschaft Width wird die Breite einer Listenspalte festgelegt. Als Maßeinheit gelten Pixel.

Wenn Width den Wert -1 erhält, wird die Spalte automatisch so breit, daß der enthaltene Text darin Platz findet. Der Wert -2 bedeutet, daß die Spaltenbreite an die Überschrift angepaßt wird, das heißt an den Text in der Eigenschaft Caption. Ihr Programmcode wird besser lesbar, indem Sie statt Zahlenwerten die Konstanten ColumnTextWidth und ColumnHeaderWidth verwenden, wenn Width negative Werte annehmen soll:

Konstante	Wert	Bedeutung

ColumnTextWidth	-1	Die Spaltenbreite wird der Länge des enthaltenen Textes angepaßt.

ColumnHeaderWidth	-2	Die Spaltenbreite wird an die Überschrift angepaßt.

Die folgende Beispielanweisung bewirkt, daß die linke Spalte von ListView1 automatisch an die Länge des enthaltenen Textes angepaßt wird:

ListView1->Columns[0]->Width = ColumnTextWidth;

Im Formular-Designer wird derselbe Effekt folgendermaßen erreicht: öffnen Sie den Spalteneditor für ListView1, markieren Sie die erste Spalte, und geben Sie im Objektinspektor bei Width den Wert -1 ein.

Sobald eine Spalte automatisch in der Größe verändert wird, enthält Width die jeweils aktuelle Breite. Die Nur-Lesen-Eigenschaft WidthType behält allerdings ihren Wert von -1 oder -2 bei.


TListColumn::WidthType

TListColumn	Siehe auch

Die Eigenschaft gibt an, ob die Spaltenbreite automatisch eingestellt wird.

__property TWidth WidthType;

Beschreibung

Die Nur-Lesen-Eigenschaft WidthType erhält denselben Wert wie Width. Allerdings behält WidthType einen negativen Wert bei, wenn sich Width automatisch ändert.

Wenn WidthType den Wert -1 zurückgibt, wird die Breite der Listenspalte so eingestellt, daß der enthaltene Text Platz findet. Der Wert -2 bedeutet, daß die Breite an die Spaltenüberschrift angepaßt wird. Jeder Rückgabewert, der nicht negativ ist, gibt an, daß keine automatische Größenanpassung stattfindet. Width und WidthType haben dann dieselben Werte.

Wenn die automatische Größeneinstellung aktiviert werden soll, weisen Sie der Eigenschaft Width direkt die Werte -1 oder -2 zu.


Methoden von TListColumn

TListColumn	Alphabetisch

In TListColumn

~TListColumn

Assign

TListColumn

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TListColumn

TListColumn	Nach Objekten

~TListColumn

Assign

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance

TListColumn


TListColumn::~TListColumn

TListColumn	Siehe auch

Der Destruktor ~TListColumn gibt den Speicher frei, der für das TListColumn-Objekt reserviert war. Rufen Sie ~TListColumn nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TListColumn automatisch aufgerufen wird.

__fastcall virtual ~TListColumn(void);

TListColumn löst die Instanz von TListColumn auf und löscht bei Bedarf die Spalte aus der Listenansicht.


TListColumn::Assign

TListColumn	Siehe auch

Die Methode Assign kopiert den Inhalt einer Listenspalte in eine neue.

virtual void __fastcall Assign(Classes::TPersistent* Source);

Assign erzeugt eine neue Listenspalte mit denselben Werten für Alignment, Width und Caption wie das Quellobjekt.


TListColumn::TListColumn

TListColumn	Siehe auch

Die Methode Create erzeugt und initialisiert eine Listenspalte.

__fastcall virtual TListColumn(Classes::TCollection* Collection);

TListColumn nimmt als Argument eine Instanz von TListColumns entgegen.


Gültigkeitsbereich

Published

Zugriff

Read-only


Hierarchie

TObject

TPersistent

TCollectionItem


TListColumn Beispiel

TListColumn


TListColumns

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/comctrls.hpp

TListColumns ist ein Container für TListColumn-Objekte.

Beschreibung

Jedes TListColumns-Objekt enthält eine Kollektion von TListColumn-Objekten in einem TListView-Objekt. TListColumns verwaltet in seinem Array Items einen Index der Listenspalten. Die Eigenschaft Count enthält die Anzahl der Listenpalten in der Kollektion. Zur Entwurfszeit verwenden Sie den Spalteneditor der Listenansicht, um Spalten hinzuzufügen, zu löschen oder zu verändern.


Eigenschaften von TListColumns

TListColumns	Alphabetisch	Legende

In TListColumns

Items

Owner

Abgeleitet von TCollection

Count


Eigenschaften von TListColumns

TListColumns	Nach Objekten	Legende

Count

Items

Owner


TListColumns::Items

TListColumns	Siehe auch

Ein Index der Listenspalten in der Kollektion.

__property TListColumn* Items[int Index];

Beschreibung

Der Parameter Index entspricht in seinem Wert der Eigenschaft Index des TListColumn-Objekts. Er repräsentiert die Position der Spalte in der Listenansicht.


TListColumns::Owner

TListColumns	Siehe auch

Die Eigenschaft Owner bezeichnet die Listenansicht, die Eigentümer der TListColumns-Instanz ist.

__property TCustomListView* Owner;

Beschreibung

Die Nur-Lesen-Eigenschaft Owner bezeichnet das Listenansicht-Steuerelement, das Eigentümer des TListColumns-Objekts ist.


Methoden von TListColumns

TListColumns	Alphabetisch

In TListColumns

~TListColumns

Add

TListColumns

Abgeleitet von TCollection

Assign

BeginUpdate

Clear

EndUpdate

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TListColumns

TListColumns	Nach Objekten

~TListColumns

Add

Assign

BeginUpdate

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

Clear

DefaultHandler

Dispatch

EndUpdate

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance

TListColumns


TListColumns::~TListColumns

TListColumns

Der Destruktor ~TListColumns gibt den Speicher frei, der für das TListColumns-Objekt reserviert war. Rufen Sie ~TListColumns nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TListColumns automatisch aufgerufen wird.

__fastcall virtual ~TListColumns(void);


TListColumns::Add

TListColumns	Siehe auch

Die Methode Add erzeugt eine neue Instanz von TListColumn und fügt sie dem Array Items hinzu.

TListColumn* __fastcall Add(void);

Beschreibung

Add gibt die neue Listenspalte zurück. Zur Entwurfszeit verwenden Sie den Spalteneditor der Listenansicht, um weitere Spalten hinzuzufügen.


TListColumns::TListColumns

TListColumns	Siehe auch

Die Methode TListColumns erzeugt und initialisiert ein TListColumns-Objekt.

__fastcall TListColumns(TCustomListView* AOwner);

Beschreibung

Die Methode TListColumns nimmt eine Instanz von TListView als Parameter entgegen.


Zugriff

Read-only


Hierarchie

TObject

TPersistent

TCollection


TListColumns Beispiel

TListColumns


TListItems

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/comctrls.hpp

In einem Objekt der Klasse TListItems wird eine Liste mit Einträgen (TListItems-Objekte) verwaltet, die in einer Listenansicht angezeigt werden.

Beschreibung

Eine Listenansicht ist ein Fenster, in dem eine Kollektion von Listeneinträgen angezeigt wird. Jeder Listeneintrag besteht aus einem Symbol und einer Beschriftung. Alle in der Listenansicht angezeigten Listeneinträge werden in einem TListItems-Objekt gespeichert.


Eigenschaften von TListItems

TListItems	Alphabetisch	Legende

In TListItems

Count

Handle

Item

Owner


Eigenschaften von TListItems

TListItems	Nach Objekten	Legende

Count

Handle

Item

Owner


TListItems::Count

TListItems

Mit der Eigenschaft Count können Sie die Anzahl der Einträge in einem TListItems-Objekt ermitteln.

__property int Count;

Beschreibung

Mit der Eigenschaft Count können Sie die Anzahl der Einträge in einem TListItems-Objekt ermitteln.


TListItems::Handle

TListItems	Beispiel

Mit der Eigenschaft Handle können Sie auf das Windows-Handle des Eigentümers der Listenansicht zugreifen.

__property HWND Handle;

Beschreibung

Mit der Eigenschaft Handle können Sie auf das Windows-Handle der Listenansicht zugreifen, die den Listeneinträgen übergeordnet ist. So können Sie auf GDI-Objekte zugreifen oder die Funktionen der Windows-API aufrufen, denen ein Handle als Parameter übergeben wird.


TListItems::Item

TListItems

Mit der Eigenschaft Items können Sie auf einen Listeneintrag eines TListItems-Objekts zugreifen.

__property TListItem* Item[int Index];

Beschreibung

Die Eigenschaft Item enthält ein Array, mit dem Sie über einen Index auf einen Eintrag (ein TListItem-Objekt) der Listenansicht zugreifen können. Der erste Eintrag hat den Index 0, der zweite 1 usw.


TListItems::Owner

TListItems

Die Eigenschaft Owner gibt die Listenansicht an, die den Listeneinträgen übergeordnet ist.

__property TCustomListView* Owner;

Beschreibung

Die Eigenschaft Owner gibt die Listenansicht an, die dem TListItem-Objekt übergeordnet ist.


Methoden von TListItems

TListItems	Alphabetisch

In TListItems

~TListItems

Add

Assign

BeginUpdate

Clear

Delete

EndUpdate

IndexOf

Insert

TListItems

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TListItems

TListItems	Nach Objekten

~TListItems

Add

Assign

BeginUpdate

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

Clear

DefaultHandler

Delete

Dispatch

EndUpdate

FieldAddress

FreeInstance

Free

IndexOf

InheritsFrom

InitInstance

Insert

InstanceSize

MethodAddress

MethodName

NewInstance

TListItems


TListItems::~TListItems

TListItems

Der Destruktor ~TListItems gibt den Speicher frei, der für das TListItems-Objekt reserviert war. Rufen Sie ~TListItems nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TListItems automatisch aufgerufen wird.

__fastcall virtual ~TListItems(void);

Beschreibung

~TListItems setzt OnStateChange auf NULL und gibt die Liste frei. Dann wird der geerbte Destruktor für die Komponente aufgerufen.


TListItems::Add

TListItems

Die Methode Add fügt einen neuen Eintrag in eine Listenansicht ein.

TListItem* __fastcall Add(void);

Beschreibung

Die Methode Add fügt einen neuen Eintrag in eine Listenansicht ein.


TListItems::Assign

TListItems

Die Methode Assign verknüpft einen Listeneintrag mit einem Objekt.

virtual void __fastcall Assign(Classes::TPersistent* Source);

Beschreibung

Handelt es sich bei Source um ein anderes TListItems-Objekt, verwirft Assign alle aktuellen Eigenschaftswerte und ersetzt sie durch die Daten von Source. Ist Source ein beliebiges anderes Objekt, ruft Assign die geerbte Methode auf. Mit dieser Methode können Sie die Daten von einem TListItem-Objekt zu einem anderen kopieren.


TListItems::BeginUpdate

TListItems

Die Methode BeginUpdate verhindert die Aktualisierung des TListItem-Objekts, bis die Methode EndUpdate aufgerufen wird.

void __fastcall BeginUpdate(void);

Beschreibung

Mit BeginUpdate können Sie verhindern, daß die Bildschirmanzeige aktualisiert wird, wenn Einträge angehängt, gelöscht und eingefügt werden.


TListItems::Clear

TListItems

Die Methode Clear löscht alle Einträge aus einem TListItems-Objekt.

void __fastcall Clear(void);

Beschreibung

Die Methode Clear löscht alle Einträge  aus einem TListItems-Objekt.


TListItems::Delete

TListItems

Die Methode Delete löscht den Eintrag der Listenansicht, der im Parameter Index angegeben ist.

void __fastcall Delete(int Index);

Beschreibung

Die Methode Delete löscht den Eintrag der Listenansicht, der im Parameter Index angegeben ist. Der Index beginnt bei 0. Der erste Eintrag hat also den Index 0, der zweite 1 usw.


TListItems::EndUpdate

TListItems

Die Methode EndUpdate ermöglicht die Aktualisierung der Bildschirmanzeige, die zuvor mit BeginUpdate deaktiviert wurde.

void __fastcall EndUpdate(void);

Beschreibung

Die Methode EndUpdate ermöglicht die Aktualisierung der Bildschirmanzeige, die zuvor mit BeginUpdate deaktiviert wurde.


TListItems::IndexOf

TListItems

Die Methode IndexOf gibt die Position (den Index) eines Listeneintrags in einem TListItem-Objekt zurück.

int __fastcall IndexOf(TListItem* Value);

Beschreibung

Die Methode IndexOf gibt den Index des im Parameter Value übergebenen Listeneintrags zurück.


TListItems::Insert

TListItems

Die Methode Insert fügt einen Listeneintrag (ein TListItem-Objekt) in die Listenansicht ein.

TListItem* __fastcall Insert(int Index);

Beschreibung

Die Methode Insert eines TListItem-Objekts fügt nach dem im Parameter Index übergebenen Eintrag einen Listeneintrag (ein TListItem-Objekt) in die Listenansicht ein. Die Methode gibt den eingefügten Listeneintrag zurück.


TListItems::TListItems

TListItems

TListItems erzeugt eine Instanz der Klasse TListItems.

__fastcall TListItems(TCustomListView* AOwner);

Beschreibung

Mit TListItems können Sie zur Laufzeit eine Komponente der Klasse TListItems erzeugen.


Zugriff

Read-only


Hierarchie

TObject

TPersistent


TListItems Beispiel

TListItems


TListSourceLink

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/dbctrls.hpp

TListSourceLink ist ein Hilfsobjekt. Es vereinfacht die Verknüpfung zur ListSource-Komponente eines TDBLookupControl-Objekts.

Beschreibung

TListSourceLink ist ausschließlich für die Verwendung durch die Klasse TDBLookupControl vorgesehen.


Eigenschaften von TListSourceLink

TListSourceLink	Alphabetisch	Legende

Abgeleitet von TDataLink

Active

ActiveRecord

BufferCount

DataSet

DataSource

DataSourceFixed

Editing

ReadOnly

RecordCount


Eigenschaften von TListSourceLink

TListSourceLink	Nach Objekten	Legende

ActiveRecord

Active

BufferCount

DataSet

DataSourceFixed

DataSource

Editing

ReadOnly

RecordCount


Methoden von TListSourceLink

TListSourceLink	Alphabetisch	Legende

In TListSourceLink

~TListSourceLink

ActiveChanged

DataSetChanged

TListSourceLink

Abgeleitet von TDataLink

Edit

UpdateRecord

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TListSourceLink

TListSourceLink	Nach Objekten	Legende

~TListSourceLink

ActiveChanged

Assign

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DataSetChanged

DefaultHandler

Dispatch

Edit

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance

TListSourceLink

UpdateRecord


TListSourceLink::~TListSourceLink

TListSourceLink

Der Destruktor ~TListSourceLink gibt den Speicher frei, der für das TListSourceLink-Objekt reserviert war. Rufen Sie ~TListSourceLink nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TListSourceLink automatisch aufgerufen wird.

__fastcall virtual ~TListSourceLink(void);


TListSourceLink::ActiveChanged

TListSourceLink	Siehe auch

Die Methode ActiveChanged informiert das TDBLookupControl-Objekt über Änderungen der Eigenschaft Active derjenigen Datenmenge, die für das ListSource-Objekt verwaltet wird.

virtual void __fastcall ActiveChanged(void);

Beschreibung

Anwendungen sollten die Prozedur ActiveChanged nicht direkt aufrufen. Der Aufruf wird automatisch ausgelöst, sobald sich die Eigenschaft Active derjenigen Datenmenge ändert, mit der das TDBLookupControl-Objekt seine Liste füllt. ActiveChanged wiederum ruft die Methode ListLinkActiveChanged desjenigen TDBLookupControl-Objekts auf, das Eigentümer dieses TListSourceLink-Objekts ist.


TListSourceLink::DataSetChanged

TListSourceLink	Siehe auch

DataSetChanged informiert das TDBLookupControl-Objekt über Änderungen an derjenigen Datenmenge, mit der TDBLookupControl seine Liste füllt.

virtual void __fastcall DataSetChanged(void);

Beschreibung

Anwendungen sollten die Prozedur DataSetChanged nicht direkt aufrufen. Die Datenmenge löst diesen Aufruf aus. DataSetChanged informiert das TListSourceLink-Objekt über Änderungen an der Datenmenge, indem es dessen Methode ListLinkDataChanged aufruft.


TListSourceLink::TListSourceLink

TListSourceLink

Die Methode TListSourceLink erzeugt ein neues TListSourceLink-Objekt.

__fastcall TListSourceLink(void);


Zugriff

Read-only


Gültigkeitsbereich

Protected


Hierarchie

TObject

TPersistent

TDataLink


TListSourceLink Beispiel

TListSourceLink


 TMainMenu

Hierarchie	Eigenschaften	Methoden

Header

vcl/menus	palette

Die Klasse TMainMenu kapselt die Menüleiste eines Formulars und ihre Dropdown-Menüs.

Beschreibung

Um ein Menü zu entwerfen, fügen Sie ein TMainMenu-Objekt in Ihr Formular ein und klicken es mit der Maus doppelt an.

Die Einträge der Menüleiste und der Dropdown-Menüs werden in der Eigenschaft Items des Hauptmenüs festgelegt. Items ist vom Typ TMenuItem. In Ihrer Anwendung können Sie mit der Eigenschaft Items auf einen bestimmten Eintrag des Menüs zugreifen. Mit Menu::Items::Count können Sie die Anzahl der Einträge ermitteln, die ein Hauptmenü oder ein Dropdown-Menü enthält.

Mit der Eigenschaft AutoMerge und den Methoden Merge und Unmerge können Sie die Menüs eines Formulars mit denen eines anderen Formulars mischen.

Eine TMainMenu-Komponente ist ein indirekter Nachkomme von TComponent. Zusätzlich zu den folgenden Eigenschaften und Methoden enthält die Komponente auch die Eigenschaften und Methoden, die alle Komponenten gemeinsam haben.


Eigenschaften von TMainMenu

TMainMenu	Alphabetisch	Legende

In TMainMenu

AutoMerge

Handle

Abgeleitet von TMenu

Items

WindowHandle

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Name

Owner

Tag


Eigenschaften von TMainMenu

TMainMenu	Nach Objekten	Legende

AutoMerge

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

DesignInfo

Handle

Items

Name

Owner

Tag

WindowHandle


TMainMenu::AutoMerge

TMainMenu	Siehe auch

Die Eigenschaft AutoMerge legt fest, ob die Hauptmenüs von Formularen, die keine Hauptformulare sind, zur Laufzeit mit dem Hauptmenü des Hauptformulars einer Nicht-MDI-Anwendung kombiniert werden können.

__property bool AutoMerge;

Beschreibung

Um die Menüs des Formulars mit dem Hauptmenü des Hauptformulars zu kombinieren, setzen Sie die Eigenschaft AutoMerge der entsprechenden Hauptmenüs auf True. Die Eigenschaft AutoMerge des Hauptmenüs, mit dem die anderen Menüs kombiniert werden sollen, muß dabei auf False gesetzt sein. Wie die Menüs kombiniert werden, hängt vom Wert der Eigenschaft GroupIndex der einzelnen Einträge ab.

Bei einer MDI-Anwendung (bei der die Eigenschaft FormStyle so gesetzt wird, daß das Hauptformular ein übergeordnetes Formular ist und alle weiteren Formulare untergeordnete Formulare sind) werden die Menüs automatisch kombiniert. Die Eigenschaft AutoMerge wird hier nicht benötigt.


TMainMenu::Handle

TMainMenu	Beispiel

Die Eigenschaft Handle gibt das Fenster-Handle des Menüs zurück. Dadurch können Sie Funktionen der Windows-API aufrufen, für die ein solches Handle erforderlich ist.

void __fastcall SetOle2MenuHandle(HMENU Handle);

Beschreibung

Mit der Eigenschaft Handle können Sie eine Funktion der Windows-API aufrufen, für die ein solches Handle erforderlich ist.

Beispiel

Der folgende Code stellt mit Hilfe der API-Funktion HiliteMenuItem die erste Option von MainMenu1 des Formulars Form1 hervorgehoben dar.$$


Methoden von TMainMenu

TMainMenu	Alphabetisch

In TMainMenu

~TMainMenu

GetOle2AcceleratorTable

Merge

PopulateOle2Menu

SetOle2MenuHandle

TMainMenu

Unmerge

Abgeleitet von TMenu

DispatchCommand

DispatchPopup

FindItem

GetHelpContext

IsShortCut

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TMainMenu

TMainMenu	Nach Objekten

~TMainMenu

Assign

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

DestroyComponents

Destroying

DispatchCommand

DispatchPopup

Dispatch

FieldAddress

FindComponent

FindItem

FreeInstance

FreeNotification

Free

GetHelpContext

GetOle2AcceleratorTable

GetParentComponent

HasParent

InheritsFrom

InitInstance

InsertComponent

InstanceSize

IsShortCut

Merge

MethodAddress

MethodName

NewInstance

PopulateOle2Menu

RemoveComponent

SetOle2MenuHandle

TMainMenu

Unmerge


TMainMenu::~TMainMenu

TMainMenu

Der Destruktor ~TMainMenu gibt den Speicher frei, der für das TMainMenu-Objekt reserviert war. Rufen Sie ~TMainMenu nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TMainMenu automatisch aufgerufen wird.

__fastcall virtual ~TMainMenu(void);


TMainMenu::GetOle2AcceleratorTable

TMainMenu

Die Methode GetOle2AcceleratorTable gibt die Tastenkürzel-Tabelle des Hauptmenüs und die dazugehörigen Daten zurück.

void __fastcall GetOle2AcceleratorTable(HACCEL &AccelTable, int &AccelCount, const int *Groups, const  int Groups_Size);

Beschreibung

GetOle2AcceleratorTable implementiert die OLE-Unterstützung, die intern von der VCL verwendet wird (Funktion TOleInPlaceSite::GetWindowContext).


TMainMenu::Merge

TMainMenu	Siehe auch

Die Methode Merge kombiniert das Hauptmenü eines Formulars einer Nicht-MDI-Anwendung mit dem Hauptmenü eines anderen Formulars.

void __fastcall Merge(TMainMenu* Menu);

Beschreibung

Wenn Ihre Anwendung beispielsweise das Hauptmenü des ersten Formulars als Hauptmenü verwendet und ein zweites Formular anzeigt, können Sie mit Merge das Hauptmenü des zweiten Formulars mit dem Hauptmenü der Anwendung kombinieren.

Im Parameter Menu geben Sie das Menü an, das mit diesem Menü kombiniert werden soll.

Abhängig vom Wert der Eigenschaft GroupIndex der Einträge des Hauptmenüs können Einträge ersetzt oder neu hinzugefügt werden. In der Beschreibung von GroupIndex finden Sie dazu detaillierte Informationen.

Wenn die Kombination von Menüs bei der Anzeige eines weiteren Formulars automatisch durchgeführt oder aufgehoben werden soll, setzen Sie AutoMerge auf True.


TMainMenu::PopulateOle2Menu

TMainMenu	Siehe auch

Die Methode PopulateOle2Menu belegt das Menü OLE des Hauptmenüs.

void __fastcall PopulateOle2Menu(HMENU SharedMenu, const int *Groups, const int Groups_Size, long * Widths, const int Widths_Size);

Beschreibung

PopulateOle2Menu implementiert die OLE-Unterstützung, die intern von der VCL verwendet wird (Funktion TOleInPlaceSite::InsertMenus).


TMainMenu::SetOle2MenuHandle

TMainMenu	Siehe auch

Die Methode SetOle2MenuHandle setzt das Handle für das Menü OLE des Hauptmenüs.

void __fastcall SetOle2MenuHandle(HMENU Handle);

Beschreibung

SetOle2MenuHandle implementiert die OLE-Unterstützung, die intern von der VCL verwendet wird (Funktion TOleInPlaceSite::SetMenu).


TMainMenu::TMainMenu

TMainMenu

TMainMenu erzeugt ein neues TMainMenu-Objekt.

__fastcall virtual TMainMenu(Classes::TComponent* AOwner);


TMainMenu::Unmerge

TMainMenu	Siehe auch

Die Methode Unmerge macht die Kombination zweier Menüs in einer Nicht-MDI-Anwendung rückgängig.

void __fastcall Unmerge(TMainMenu* Menu);

Beschreibung

Der Parameter Menu gibt das Menü an, dessen Kombination aufgehoben werden soll.


Gültigkeitsbereich

Published

Zugriff

Read-only


Hierarchie

TObject

TPersistent

TComponent

TMenu


TMainMenu Beispiel

TMainMenu


 TMaskEdit

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/mask.hpp

Das Objekt TMaskEdit implementiert ein generisches maskiertes Eingabefeld.

Beschreibung

Mit einem TMaskEdit-Objekt plazieren Sie in einem Formular ein maskiertes Eingabefeld. Bei Eingabefeldern dieser Art wird der vom Benutzer eingegebene Text auf seine Gültigkeit geprüft, das heißt, er wird mit einer Maske verglichen, die vorgibt, welche Struktur der Text haben muß. Die Maske kann außerdem Text formatieren, der angezeigt wird.

TMaskEdit implementiert das generische Verhalten, das in TCustomMaskEdit eingeführt wurde. Viele der von TCustomMaskEdit geerbten Eigenschaften und Methoden werden als published deklariert. Neues Verhalten wird jedoch nicht eingeführt.


Eigenschaften von TMaskEdit

TMaskEdit	Alphabetisch	Legende

In TMaskEdit

Abgeleitet von TCustomMaskEdit

EditMask

EditText

IsMasked

MaxLength

Text

Abgeleitet von TCustomEdit

AutoSelect

AutoSize

BorderStyle

CharCase

Modified

PasswordChar

ReadOnly

SelLength

SelStart

SelText

Abgeleitet von TWinControl

Brush

ClientOrigin

ClientRect

ControlCount

Controls

Ctl3D

Handle

HelpContext

ParentCtl3D

Showing

TabOrder

TabStop

Abgeleitet von TControl

Align

BoundsRect

ClientHeight

ClientWidth

Color

ControlState

ControlStyle

Cursor

DragCursor

DragMode

Enabled

Font

Height

Hint

Left

Name

Parent

ParentColor

ParentFont

ParentShowHint

PopupMenu

ShowHint

Top

Visible

Width

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TMaskEdit

TMaskEdit	Nach Objekten	Legende

Align

AutoSelect

AutoSize

BorderStyle

BoundsRect

Brush

CharCase

ClientHeight

ClientOrigin

ClientRect

ClientWidth

Color

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlCount

ControlState

Controls

ControlStyle

Ctl3D

Cursor

DesignInfo

DragCursor

DragMode

EditMask

EditText

Enabled

Font

Handle

Height

HelpContext

Hint

IsMasked

Left

MaxLength

Modified

Name

Owner

ParentColor

ParentCtl3D

ParentFont

ParentShowHint

Parent

PasswordChar

PopupMenu

ReadOnly

SelLength

SelStart

SelText

ShowHint

Showing

TabOrder

TabStop

Tag

Text

Top

Visible

Width


Ereignisse von TMaskEdit

TMaskEdit	Alphabetisch	Legende

Abgeleitet von TCustomEdit

OnChange

Abgeleitet von TWinControl

OnEnter

OnExit

OnKeyDown

OnKeyPress

OnKeyUp

Abgeleitet von TControl

OnClick

OnDblClick

OnDragDrop

OnDragOver

OnEndDrag

OnMouseDown

OnMouseMove

OnMouseUp

OnStartDrag


Ereignisse von TMaskEdit

TMaskEdit	Nach Objekten	Legende

OnChange

OnClick

OnDblClick

OnDragDrop

OnDragOver

OnEndDrag

OnEnter

OnExit

OnKeyDown

OnKeyPress

OnKeyUp

OnMouseDown

OnMouseMove

OnMouseUp

OnStartDrag


 Methoden von TMaskEdit

TMaskEdit	Alphabetisch

In TMaskEdit

~TMaskEdit

TMaskEdit

Abgeleitet von TCustomMaskEdit

Clear

GetTextLen

ValidateEdit

Abgeleitet von TCustomEdit

ClearSelection

CopyToClipboard

CutToClipboard

GetSelTextBuf

PasteFromClipboard

SelectAll

SetSelTextBuf

Abgeleitet von TWinControl

Broadcast

CanFocus

ContainsControl

ControlAtPos

DisableAlign

EnableAlign

Focused

GetTabOrderList

HandleAllocated

HandleNeeded

InsertControl

Invalidate

PaintTo

Realign

RemoveControl

Repaint

ScaleBy

ScrollBy

SetBounds

SetFocus

Update

UpdateControlState

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

Hide

Perform

Refresh

ScreenToClient

SendToBack

SetTextBuf

Show

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TMaskEdit

TMaskEdit	Nach Objekten

~TMaskEdit

Assign

BeginDrag

BringToFront

Broadcast

CanFocus

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

ClearSelection

Clear

ClientToScreen

ContainsControl

ControlAtPos

CopyToClipboard

CutToClipboard

DefaultHandler

DestroyComponents

Destroying

DisableAlign

Dispatch

DragDrop

Dragging

EnableAlign

EndDrag

FieldAddress

FindComponent

Focused

FreeInstance

FreeNotification

Free

GetParentComponent

GetSelTextBuf

GetTabOrderList

GetTextBuf

GetTextLen

HandleAllocated

HandleNeeded

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InsertControl

InstanceSize

Invalidate

MethodAddress

MethodName

NewInstance

PaintTo

PasteFromClipboard

Perform

Realign

Refresh

RemoveComponent

RemoveControl

Repaint

ScaleBy

ScreenToClient

ScrollBy

SelectAll

SendToBack

SetBounds

SetFocus

SetSelTextBuf

SetTextBuf

Show

TMaskEdit

UpdateControlState

Update

ValidateEdit


TMaskEdit::~TMaskEdit

TMaskEdit

Der Destruktor ~TMaskEdit gibt den Speicher frei, der für das TMaskEdit-Objekt reserviert war. Rufen Sie ~TMaskEdit nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TMaskEdit automatisch aufgerufen wird.

__fastcall virtual ~TMaskEdit(void);


TMaskEdit::TMaskEdit

TMaskEdit

Der Konstruktor TMaskEdit erzeugt ein neues TMaskEdit-Objekt.

__fastcall virtual TMaskEdit(Classes::TComponent* AOwner);


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TControl

TWinControl

TCustomEdit

TCustomMaskEdit


TMaskEdit Beispiel

TMaskEdit


 TMediaPlayer

Hierarchie	Eigenschaften	Methoden	Ereignisse

Header

vcl/mplayer.hpp

TMediaPlayer steuert Geräte, die einen Media Control Interface (MCI)-Treiber besitzen.

Beschreibung

Die Komponente TMediaPlayer besteht aus einer Reihe von Schaltflächen (Play, Stop, Eject usw.) über die ein Multimediagerät (z.B. ein CD-ROM-Laufwerk, ein MIDI-Sequenzer oder ein Videorecorder) gesteuert werden kann. Bei dem Multimediagerät kann es sich um Hardware oder um Software handeln.

Schaltfläche	Wert	Aktion

Play	btPlay	Startet den Media-Player.

Pause	btPause	Unterbricht das Abspielen oder Aufzeichnen. Wenn bereits unterbrochen ist, wird durch Anklicken das Abspielen bzw. Aufzeichnen wieder gestartet.

Stop	btStop	Stoppt das Abspielen oder Aufzeichnen.

Next	btNext	Spult zur nächsten Spur bzw. zum Ende, wenn das Medium keine Spuren unterstützt.

Prev	btPrev	Spult zur vorhergehenden Spur bzw. zum Anfang, wenn das Medium keine Spuren unterstützt.

Step	btStep	Spult um eine bestimmte Anzahl von Frames nach vorne.

Back	btBack	Spult um eine bestimmte Anzahl von Frames zurück.

Record	btRecord	Startet das Aufzeichnen.

Eject	btEject	Wirft das Medium aus.

Das Multimediagerät wird gestartet, unterbrochen, gestoppt usw., sobald der Benutzer auf die entsprechende Schaltfläche der TMediaPlayer-Komponente klickt. Das Gerät läßt sich auch über die Steuermethoden, die den Schaltflächen entsprechen (Play, Pause, Stop, Next, Previous, Step, Back, StartRecording und Eject), bedienen.

Der Typ des Multimediageräts (wie beispielsweise dtWaveAudio oder dtVideodisc) wird in der Eigenschaft DeviceType angegeben. Wenn das Gerät seine Medien in einer Datei speichert, wird der Name der Mediendatei in der Eigenschaft FileName festgelegt. Hat DeviceType den Wert dtAutoSelect, versucht der Media-Player, den Gerätetyp über die Namenserweiterung der Datei festzustellen, die in FileName angegeben ist.

Setzen Sie die Eigenschaft AutoOpen auf True, wenn der Media-Player versuchen soll, das mit DeviceType angegebene Gerät automatisch zu öffnen, sobald die Media-Player-Komponente zur Laufzeit erstellt wird.


Eigenschaften von TMediaPlayer

TMediaPlayer	Alphabetisch	Legende

In TMediaPlayer

AutoEnable

AutoOpen

AutoRewind

Capabilities

ColoredButtons

DeviceID

DeviceType

Display

DisplayRect

EnabledButtons

EndPos

Error

ErrorMessage

FileName

Frames

Length

Mode

Notify

NotifyValue

Position

Shareable

Start

StartPos

TimeFormat

TrackLength

TrackPosition

Tracks

Visible

VisibleButtons

Wait

Abgeleitet von TWinControl

Brush

ClientOrigin

ClientRect

ControlCount

Controls

Handle

HelpContext

Showing

TabOrder

TabStop

Abgeleitet von TControl

Align

BoundsRect

ClientHeight

ClientWidth

ControlState

ControlStyle

Cursor

Enabled

Height

Hint

Left

Name

Parent

ParentShowHint

PopupMenu

ShowHint

Top

Width

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TMediaPlayer

TMediaPlayer	Nach Objekten	Legende

Align

AutoEnable

AutoOpen

AutoRewind

BoundsRect

Brush

Capabilities

ClientHeight

ClientOrigin

ClientRect

ClientWidth

ColoredButtons

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlCount

ControlState

Controls

ControlStyle

Cursor

DesignInfo

DeviceID

DeviceType

DisplayRect

Display

EnabledButtons

Enabled

EndPos

ErrorMessage

Error

FileName

Frames

Handle

Height

HelpContext

Hint

Left

Length

Mode

Name

Notify

NotifyValue

Owner

ParentShowHint

Parent

PopupMenu

Position

Shareable

ShowHint

Showing

StartPos

Start

TabOrder

TabStop

Tag

TimeFormat

Top

TrackLength

TrackPosition

Tracks

VisibleButtons

Visible

Wait

Width


TMediaPlayer::AutoEnable

TMediaPlayer	Siehe auch

Die Eigenschaft AutoEnable bestimmt, ob der Media-Player automatisch die einzelnen Schaltflächen in der Komponente aktiviert bzw. deaktiviert.

__property bool AutoEnable;

Beschreibung

Mit Hilfe von AutoEnable können die Schaltflächen des Media-Players automatisch aktiviert bzw. deaktiviert werden. Wenn AutoEnable den Wert True hat, aktiviert oder deaktiviert der Media-Player seine Schaltflächen automatisch. Der Media-Player legt fest, welche Schaltflächen aufgrund des aktuellen Modus (angegeben in der Eigenschaft Mode) und des aktuellen Typs des Multimediageräts (angegeben in der Eigenschaft DeviceTyp) aktiviert bzw. deaktiviert werden müssen.

AutoEnable setzt die Eigenschaft EnabledButtons außer Kraft. Die vom Media-Player vorgenommene Aktivierung bzw. Deaktivierung von Schaltflächen hat gegenüber der Aktivierung bzw. Deaktivierung der Schaltflächen durch EnabledButtons Vorrang.

Hat AutoEnable den Wert False, aktiviert oder deaktiviert der Media-Player die Schaltflächen nicht. Dies muß dann mit Hilfe der Eigenschaft EnabledButtons ausgeführt werden.

Der folgenden Tabelle können Sie entnehmen, für welchen Geräte-Modus die Schaltflächen aktiviert oder deaktiviert sind:

Schaltfläche	Play	Record	Pause	Stop	Nicht geöffnet

Back	Aktiviert	Aktiviert	Aktiviert	Aktiviert	Deaktiviert

Eject	Aktiviert	Aktiviert	Aktiviert	Aktiviert	Deaktiviert

Next	Aktiviert	Aktiviert	Aktiviert	Aktiviert	Deaktiviert

Pause	Aktiviert	Aktiviert	Aktiviert	Deaktiviert	Deaktiviert

Play	Deaktiviert	Deaktiviert	Aktiviert	Aktiviert	Deaktiviert

Prev	Aktiviert	Aktiviert	Aktiviert	Aktiviert	Deaktiviert

Record	Deaktiviert	Deaktiviert	Aktiviert	Aktiviert	Deaktiviert

Step	Aktiviert	Aktiviert	Aktiviert	Aktiviert	Deaktiviert

Stop	Aktiviert	Aktiviert	Deaktiviert	Deaktiviert	Deaktiviert


TMediaPlayer::AutoOpen

TMediaPlayer	Siehe auch

Die Eigenschaft AutoOpen legt fest, ob der Media-Player bei Ausführung der Anwendung automatisch geöffnet wird.

__property bool AutoOpen;

Beschreibung

Mit Hilfe von AutoOpen kann der Media-Player zur Laufzeit automatisch geöffnet werden.

Wenn AutoOpen True ist, versucht der Media-Player, das Multimediagerät (angegeben in der Eigenschaft DeviceType bzw. in FileName, falls DeviceType den Wert dtAutoSelect hat) zu öffnen, sobald das Formular, in dem sich die Media-Player-Komponente befindet, zur Laufzeit erstellt wird.

Hat AutoOpen den Wert False, muß das Gerät über einen Aufruf der Methode Open geöffnet werden.

Kommt es beim öffnen des Gerätes zu einem Fehler, tritt eine Exception vom Typ EMCIDeviceError auf, welche die Fehlermeldung enthält. Nach Beendigung der Ausführung wird in der Eigenschaft Error ein numerischer Fehlercode gespeichert und in der Eigenschaft ErrorMessage die entsprechende Fehlermeldung abgelegt.

Die Eigenschaft Wait bestimmt, ob die Steuerung vor dem öffnen des Multimediageräts wieder an die Anwendung zurückgegeben wird. Die Eigenschaft Notify gibt an, ob durch das öffnen des Geräts ein OnNotify-Ereignis erzeugt wird.


TMediaPlayer::AutoRewind

TMediaPlayer	Siehe auch

 Die Eigenschaft AutoRewind setzt die aktuelle Position auf den Beginn der vorhergehenden Spur.

__property bool AutoRewind;

Beschreibung

AutoRewind gibt an, ob das Media-Player-Steuerelement vor dem Abspielen oder Aufzeichnen zurückspult.

Wenn AutoRewind den Wert True hat und das Ende des Mediums erreicht ist, wird mit Play oder StartRecording die aktuelle Position an den Anfang des Mediums verlagert und anschließend mit dem Abspielen bzw. Aufzeichnen begonnen. Ist AutoRewind dagegen False, muß die aktuelle Position an den Anfang des Mediums gesetzt werden. Dies kann entweder durch Klicken auf die Schaltfläche Prev oder über einen Aufruf der Methode Previous erfolgen.

Hinweis

Wenn StartPos oder EndPos Werte zugewiesen wurden oder wenn das Multimediagerät Spuren unterstützt, hat AutoRewind keine Auswirkung auf das Abspielen oder Aufzeichnen. Bei einem Aufruf von Play oder StartRecording bleibt die aktuelle Position am Ende des Mediums.


TMediaPlayer::Capabilities

TMediaPlayer	Siehe auch

Die Eigenschaft Capabilities legt die Fähigkeiten des geöffneten Multimediageräts fest.

__property TMPDevCapsSet Capabilities;

Beschreibung

Die verschiedenen, in Capabilities angegebenen Fähigkeiten werden festgelegt, sobald das Gerät mit der Methode Open geöffnet wird. Die folgende Tabelle enthält die Fähigkeiten, über die ein Gerät verfügen kann:

Wert	Fähigkeit

mpCanEject	Medien können ausgeworfen werden.

mpCanPlay	Medien können wiedergegeben werden.

mpCanRecord	Medien können beschrieben werden.

mpCanStep	Medien können vor- und zurückgespult werden.

mpUsesWindows	Zur Anzeige von Ausgaben wird ein Fenster verwendet.

Hinweis

Im Augenblick gibt es keine Möglichkeit zu überprüfen, ob ein Gerät vorwärts oder rückwärts spulen kann. Capabilities enthält nur dann mpCanStep, wenn der Gerätetyp (angegeben in der Eigenschaft DeviceType) Animation, AVI Video, Digital Video, Overlay oder VCR lautet.


TMediaPlayer::ColoredButtons

TMediaPlayer	Siehe auch

ColoredButtons legt fest, welche Schaltflächen des Media-Players farbig sind.

__property TButtonSet ColoredButtons;

Beschreibung

Mit der Eigenschaft ColoredButtons können sie steuern, welche Schaltlfächen des Media-Player-Steuerelements farbig angezeigt werden.

Schaltflächen, denen mit ColoredButtons keine Farbe zugewiesen wurde, erscheinen schwarz/weiß, wenn sie sichtbar sind. Alle Schaltflächen des Media-Players werden per Vorgabe farbig angezeigt.

Schaltfläche	Wert	Aktion

Play	btPlay	Startet den Media-Player.

Record	btRecord	Startet eine Aufzeichnung.

Stop	btStop	Stoppt das Abspielen oder Aufzeichnen.

Next	btNext	Spult zur nächsten Spur bzw. zum Ende, wenn das Medium keine Spuren unterstützt.

Prev	btPrev	Spult zur vorhergehenden Spur bzw. zum Anfang, wenn das Medium keine Spuren unterstützt.

Step	btStep	Spult um eine bestimmte Anzahl von Frames nach vorne.

Back	btBack	Spult um eine bestimmte Anzahl von Frames zurück.

Pause	btPause	Unterbricht das Abspielen oder Aufzeichnen. Wenn bereits unterbrochen ist, wird durch Anklicken das Abspielen bzw. Aufzeichnen wieder gestartet.

Eject	btEject	Wirft das Medium aus.


TMediaPlayer::DeviceID

TMediaPlayer	Siehe auch

Die Eigenschaft DeviceID gibt die Geräte-ID für das momentan geöffnete Mulitmediagerät an.

__property unsigned short DeviceID;

Beschreibung

Der Wert von DeviceID wird festgestellt, sobald ein Gerät mit der Methode Open geöffnet wird. Ist kein Gerät geöffnet, hat DeviceID den Wert 0.


TMediaPlayer::DeviceType

TMediaPlayer	Siehe auch

Die Eigenschaft DeviceType gibt den Typ des Multimediageräts an, das vom Media-Player geöffnet werden soll.

__property TMPDeviceTypes DeviceType;

Beschreibung

DeviceType gibt den Typ des Multimediageräts an, das mit der Methode Open geöffnet werden soll.

TMPDeviceTypes enthält die Typen der Multimediageräte, die von einer TMediaPlayer-Komponente geöffnet werden können. Folgende Werte sind für TMPDeviceTypes gültig: dtAutoSelect, dtAVIVideo, dtCDAudio, dtDAT, dtDigitalVideo, dtMMMovie, dtOther, dtOverlay, dtScanner, dtSequencer, dtVCR, dtVideodisc und dtWaveAudio. Voreingestellt ist dtAutoSelect.

Wenn DeviceType den Wert dtAutoSelect hat, wird der Gerätetyp anhand der in der Eigenschaft FileName angegebenen Dateinamenserweiterung festgestellt. Ist kein Gerätetyp mit der Namenserweiterung verbunden, muß der entsprechende Gerätetyp explizit angegeben werden. Dazu belegen Sie DeviceType mit einem Wert, der allerdings nicht dtAutoSelect sein darf.

Einem Mulitmediagerät wird normalerweise bei seiner Installation eine entsprechende Dateinamenserweiterung zugewiesen. Die Verbindungen werden in der Registrierdatenbank von Win95 bzw. in der Datei SYSTEM.INI von Win31 gespeichert. In der Dokumentation zu dem jeweiligen Gerät finden Sie Anweisungen für die Zuordnung einer Dateinamenserweiterung zu einem jeweiligen Gerät.


TMediaPlayer::Display

TMediaPlayer

Die Eigenschaft Display legt das Anzeigefenster für ein Multimediagerät fest, das zur Ausgabe ein Fenster benutzt.

__property Controls::TWinControl* Display;

Beschreibung

Wenn Sie die Eigenschaft Display einsetzen wollen, weisen sie ihr den Namen eines fensterorientierten Steuerelements zu (z.B. eines Formulars oder einer Tafel). Die Anzeige erfolgt dann in diesem Steuerelement.

Der voreingestellte Wert von Display ist NULL, d.h. das Gerät erzeugt ein eigenes Fenster zur Ausgabe. Wird das an Display zugewiesene Steuerelement nach dem öffnen des Geräts freigegeben, erfolgt die Bildschirmausgabe ebenfalls im Standardfenster.

Animation, AVI Video, Digital Video, Overlay und VCR sind Beispiele für Multimediageräte, die zur Anzeige der Ausgabe ein Fenster benutzen.


TMediaPlayer::DisplayRect

TMediaPlayer	Siehe auch

Die Eigenschaft DisplayRect legt den rechteckigen Bereich innerhalb des in Display angegebenen Formulars fest, in dem die Ausgabe eines Multimediageräts angezeigt wird.

Beschreibung

Wenn die Eigenschaft Display NULL ist, wird DisplayRect ignoriert.

Soll die Anzeige in einem speziellen Rechteckbereich eines Formulars erfolgen, weisen Sie DisplayRect einen TRect-Datensatz zu. Ein TRect-Datensatz kann mit der Funktion Rect erstellt werden.

Animation, AVI Video, Digital Video, Overlay und VCR sind Beispiele für Multimediageräte, die zur Anzeige der Ausgabe ein Fenster benutzen.

In der Regel erzielen Sie bei Medien, deren Ausgabe in einem rechteckigen Bereich erfolgt, mit der Standardgröße von DisplayRect die besten Ergebnisse. Geben Sie das Wertepaar 0,0 für die rechte untere Ecke des Bereichs an, um DisplayRect auf die Standardgröße zu setzen. Über die linke obere Ecke können Sie das Rechteck positionieren.

Hinweis

DisplayRect kann nur gesetzt werden, wenn das Multimediagerät geöffnet ist.


TMediaPlayer::EnabledButtons

TMediaPlayer	Siehe auch

In der Eigenschaft EnabledButtons wird festgelegt, welche Schaltflächen des Media-Players benutzt werden können.

__property TButtonSet EnabledButtons;

Beschreibung

EnabledButtons legt fest, welche Schaltflächen des Media-Players aktiviert sind und benutzt werden können.

Eine aktivierte Schaltfläche wird farbig angezeigt und kann benutzt werden. Deaktivierte Schaltflächen sind abgedunkelt und können nicht ausgewählt werden. Eine Schaltfläche, die nicht mit EnabledButtons aktiviert wurde, ist deaktiviert. Per Vorgabe sind alle Schaltflächen aktiviert.

Wenn die Eigenschaft AutoEnable den Wert True hat, setzt sie die Einstellung von EnabledButtons außer Kraft. Die vom Media-Player vorgenommene automatische Aktivierung bzw. Deaktivierung von Schaltflächen hat gegenüber der Aktivierung bzw. Deaktivierung der Schaltflächen durch EnabledButtons Vorrang.

Schaltfläche	Wert	Aktion

Play	btPlay	Startet den Media-Player.

Record	btRecord	Startet die Aufzeichnung.

Stop	btStop	Stoppt das Abspielen oder Aufzeichnen.

Next	btNext	Spult zur nächsten Spur bzw. zum Ende, wenn das Medium keine Spuren unterstützt.

Prev	btPrev	Spult zur vorhergehenden Spur bzw. zum Anfang, wenn das Medium keine Spuren unterstützt.

Step	btStep	Spult um eine bestimmte Anzahl von Frames nach vorne.

Back	btBack	Spult um eine bestimmte Anzahl von Frames zurück.

Pause	btPause	Unterbricht das Abspielen oder Aufzeichnen. Wenn bereits unterbrochen ist, wird durch Anklicken das Abspielen bzw. Aufzeichnen wieder gestartet.

Eject	btEject	Wirft das Medium aus.


TMediaPlayer::EndPos

TMediaPlayer	Siehe auch

Die Eigenschaft EndPos gibt die Position im aktuell geladenen Medium an, an der die Wiedergabe bzw. die Aufzeichnung angehalten werden soll.

__property long EndPos;

Beschreibung

Die Angabe von EndPos erfolgt im aktuellen Zeitformat, das in der Eigenschaft TimeFormat festgelegt ist.

Die Eigenschaft EndPos wirkt sich nur auf die Play- oder StartRecording-Methode aus, die direkt nach dem Setzen von EndPos aufgerufen wird. Soll die Eigenschaft EndPos auch für weitere Aufrufe von Play oder StartRecording gelten, muß sie nach jedem Aufruf neu gesetzt werden.


TMediaPlayer::Error

TMediaPlayer	Siehe auch

Die Eigenschaft Error bezeichnet den MCI-Fehlercode, der von der Methode zur Steuerung des Media-Players zurückgegeben wird.

__property long Error;

Beschreibung

Die Eigenschaft Error enthält den MCI-Fehlercode, der von der zuletzt aufgerufenen Methode zur Steuerung des Media-Players (Back, Close, Eject, Next, Open, Pause, PauseOnly, Play, Previous, StartRecording, Resume, Rewind, Step oder Stop) zurückgegeben wurde. Die Eigenschaft ErrorMessage beschreibt den Fehler.

Verursachte die zuletzt aufgerufene Methode zur Steuerung des Media-Players keinen Fehler, hat Error den Wert Null. Falls ein Fehler aufgetreten ist, enthält Error einen Wert ungleich Null. Tritt beim öffnen des Geräts ein Fehler auf, führt dies zu einer EMCIDeviceError-Exception.


TMediaPlayer::ErrorMessage

TMediaPlayer	Siehe auch

Die Eigenschaft ErrorMessage beschreibt den in der Error-Eigenschaft gespeicherten Fehler.

__property System::AnsiString ErrorMessage;

Beschreibung

Die Eigenschaft ErrorMessages enthält die Fehlermeldung für den Fehlercode, der von der zuletzt aufgerufen Methode zur Steuerung des Media-Players (Back, Close, Eject, Next, Open, Pause, PauseOnly, Play, Previous, StartRecording, Resume, Rewind, Step oder Stop) zurückgegeben wurde.

Der zugehörige Fehlercode wird ist der Eigenschaft Error gespeichert.


TMediaPlayer::FileName

TMediaPlayer	Siehe auch

Die Eigenschaft FileName bezeichnet die geöffnete bzw. die gespeicherte Mediendatei.

__property System::AnsiString FileName;

Beschreibung

FileName bezeichnet die Mediendatei, die von der Methode Open geöffnet werden soll bzw. in die von der Methode Save gespeichert werden soll.

Sie können zur Entwurfszeit die Eigenschaft FileName in einem Dialogfeld zur Dateiauswahl festlegen. Klicken Sie dazu im Objektinspektor auf die Ellipsenschaltfläche (...).


TMediaPlayer::Frames

TMediaPlayer	Siehe auch

Die Eigenschaft Frames legt die Anzahl der Frames fest, um die vor- oder zurückgespult wird.

__property long Frames;

Beschreibung

In der Eigenschaft Frames legen Sie die Anzahl der Frames fest, um die mit der Methode Step nach vorne bzw. mit der Methode Back zurückgespult werden soll.

Frames ist standardmäßig auf zehn Prozent der gesamten Länge des aktuell geladenen Mediums gesetzt. Diese Gesamtlänge wird mit der Eigenschaft Length festgelegt.

Hinweis

Die Definition eines Frame ist von dem verwendeten Multimediagerät abhängig. Bei Anzeigemedien ist ein Frame mit einem einzelnen Bild identisch.


TMediaPlayer::Length

TMediaPlayer	Siehe auch

Die Eigenschaft Length legt die Länge des Mediums im geöffneten Multimediagerät fest.

__property long Length;

Beschreibung

Die Angabe von Length erfolgt im aktuellen Zeitformat, das in der Eigenschaft TimeFormat festgelegt ist.


TMediaPlayer::Mode

TMediaPlayer

Die Eigenschaft Mode bestimmt den Status des aktuell geöffneten Multimediageräts.

__property TMPModes Mode;

Beschreibung

Die Eigenschaft Mode legt den aktuellen Status (Modus) des momentan geöffneten Multimediageräts fest.

Der Typ TMPModes bestimmt die Modi für ein Multimediagerät, das mit einer TMediaPlayer-Komponente verwendet wird.

Die folgende Tabelle enthält die möglichen Werte für den Typ TMPModes:

Wert	Modus

mpNotReady	Nicht bereit

mpStopped	Angehalten

mpPlaying	Wiedergabe

mpRecording	Aufzeichnung

mpSeeking	Suchen

mpPaused	Pause

mpOpen	Geöffnet


TMediaPlayer::Notify

TMediaPlayer	Siehe auch

Die Eigenschaft Notify legt fest, ob ein OnNotify-Ereignis erzeugt wird.

__property bool Notify;

Beschreibung

Die Eigenschaft Notify bestimmt, ob nach Abschluß der nächsten Methode zur Steuerung des Media-Players (Back, Close, Eject, Next, Open, Pause, PauseOnly, Play, Previous, StartRecording, Resume, Rewind, Step oder Stop) ein OnNotify-Ereignis generiert wird.

Wenn Notify den Wert True hat, erzeugt die nächste Methode zur Steuerung des Media-Players nach ihrer Beendigung ein OnNotify-Ereignis und speichert die Benachrichtigungsbotschaft in der Eigenschaft NotifyValue. Ist Notify dagegen False, generiert die Methode kein OnNotify-Ereignis, und NotifyValue wird nicht verändert.

Notify wirkt sich nur auf den Aufruf der nächsten Methode zur Steuerung des Media-Players aus. Soll die Eigenschaft OnNotify auch für weitere Methodenaufrufe gelten, muß sie nach jedem Aufruf neu gesetzt werden.

Per Vorgabe agieren die Methoden Play und StartRecording so, als wäre Notify auf True gesetzt. Um zu verhindern, daß nach Beendigung des Abspiel- oder Aufzeichnungsvorgangs ein OnNotify-Ereignis erzeugt wird, setzen Sie Notify vor dem Aufruf der Methode Play bzw. StartRecording auf False. Alle anderen Methoden zur Steuerung des Media-Players agieren so, als wäre Notify auf False gesetzt.

Hinweis

Setzen Sie Notify auf True, wenn anzunehmen ist, daß die nächste Methode zur Steuerung des Media-Players länger dauert. Die Anwendung wird dann benachrichtigt, wenn die Ausführung der Methode beendet ist. Wenn Notify den Wert True hat, sollte Wait auf False gesetzt werden, damit die Steuerung bereits vor dem Abschluß der Methode an die Anwendung zurückkehren kann.

Hinweis

Wenn Sie versuchen, einen Abspiel- oder Aufzeichnungsvorgang auf dem Multimediagerät wiederaufzunehmen, das die Methode Resume nicht unterstützt, verhält sich das Gerät wie bei einem Aufruf von Play. Wurde Notify vor dem Aufruf von Resume (oder einer anderen Methode zur Steuerung des Media-Players) auf den Wert True gesetzt, hat diese keine Auswirkungen auf den Aufruf von Resume. 	Die Methode Resume erzeugt nach ihrer Beendigung kein OnNotify-Ereignis, und NotifyValue wird nicht verändert.


TMediaPlayer::NotifyValue

TMediaPlayer

Die Eigenschaft NotifyValue zeigt das Ergebnis der letzten Methode zur Steuerung des Media-Players an, die eine Benachrichtigung angefordert hat.

__property TMPNotifyValues NotifyValue;

Beschreibung

NotifyValue meldet das Ergebnis der letzten Methode zur Steuerung des Media-Players (Back, Close, Eject, Next, Open, Pause, PauseOnly, Play, Previous, StartRecording, Resume, Rewind, Step oder Stop), die eine Benachrichtigung angefordert hat.

Um eine Benachrichtigung anzufordern, muß Notify vor dem Aufruf der Methode auf True gesetzt werden.

Der Typ TMPNotifyValues legt die Benachrichtigungswerte für ein Multimediagerät fest, das mit einer TMediaPlayer-Komponente verwendet wird. Die zulässigen Werte für den Typ TMPNotifyValues lauten wie folgt:

Wert	Result

nvSuccessful	Der Befehl wurde erfolgreich ausgeführt.

nvSuperseded	Ein anderer Befehl hatte Vorrang vor diesem Befehl.

nvAborted	Der Befehl wurde vom Benutzer abgebrochen.

nvFailure	Der Befehl ist fehlgeschlagen.


TMediaPlayer::Position

TMediaPlayer	Siehe auch	Beispiel

Die Eigenschaft Position legt die aktuelle Position im geladenen Medium fest.

__property long Position;

Beschreibung

Die Angabe von Position erfolgt im aktuellen Zeitformat, das in der Eigenschaft TimeFormat festgelegt ist.

Position wird standardmäßig auf den Anfang des Mediums gesetzt. Wenn das Medium mehrere Spuren unterstützt, wird Position per Vorgabe auf den Anfang der ersten Spur gesetzt.


TMediaPlayer::Shareable

TMediaPlayer	Siehe auch

Die Eigenschaft Shareable legt fest, ob ein Multimediagerät von mehreren Anwendungen genutzt werden kann.

__property bool Shareable;

Beschreibung

Wenn Shareable auf False gesetzt ist, können keine weiteren Komponenten oder Anwendungen auf das Gerät zugreifen. Hat Shareable dagegen den Wert True, kann das Gerät von mehreren Komponenten oder Anwendungen benutzt werden. Shareable hat standardmäßig den Wert False.

Shareable muß vor dem öffnen eines Geräts gesetzt werden. Bestimmte Geräte unterstützen die gemeinsame Nutzung durch mehrere Anwendungen nicht. Wenn Sie Shareable für ein derartiges Gerät auf True setzen und versuchen, es zu öffnen, schlägt die Methode Open fehl, und es wird ein Fehlercode in der Eigenschaft Error zurückgegeben.


TMediaPlayer::Start

TMediaPlayer	Siehe auch

Die Eigenschaft Start legt die Startposition im aktuell geladenen Medium fest.

__property long Start;

Beschreibung

Start bezeichnet den Anfang des Mediums, bzw. den Anfang der ersten Spur (bei Multimediageräten, die Spuren unterstützen). Die Festlegung von Start erfolgt, wenn ein Multimediagerät mit der Methode Open geöffnet wird. Start wird unter Verwendung des aktuellen Zeitformats angegeben, das in der Eigenschaft TimeFormat festgelegt ist. Start hat zur Laufzeit den Status Nur-Lesen und ist zur Entwurfszeit nicht verfügbar.


TMediaPlayer::StartPos

TMediaPlayer	Siehe auch

Die Eigenschaft StartPos gibt die Position im aktuell geladenen Medium an, an der die Wiedergabe bzw. die Aufzeichung beginnen soll.

__property long StartPos;

Beschreibung

Die Angabe von StartPos erfolgt im aktuellen Zeitformat, das in der Eigenschaft TimeFormat festgelegt ist.

Die Eigenschaft StartPos wirkt sich nur auf die Play- oder StartRecording-Methode aus, die direkt nach dem Setzen von StartPos aufgerufen wird. Soll die Eigenschaft StartPos auch für weitere Aufrufe von Play oder StartRecording gelten, muß sie nach jedem Aufruf neu gesetzt werden.

StartPos wirkt sich erst dann auf die (in der Eigenschaft Position angegebene) aktuelle Position des Mediums aus, wenn der nächste Aufruf von Play bzw. StartRecording erfolgt.


TMediaPlayer::TimeFormat

TMediaPlayer	Siehe auch

Die Eigenschaft TimeFormat legt das Format für die Angabe von Positionsinformationen fest.

__property TMPTimeFormats TimeFormat;

Beschreibung

TimeFormat bestimmt, wie die Eigenschaften StartPos, Length, Position, Start und EndPos interpretiert werden. Ist beispielsweise Position auf 180 und TimeFormat auf tfMilliseconds gesetzt, befindet sich die aktuelle Position 180 Millisekunden vom Anfang des Mediums entfernt. Wenn dagegen Position auf 180 und TimeFormat auf tfMSF gesetzt ist, befindet sich die aktuelle Position 180 Minuten vom Anfang des Mediums entfernt.

Die möglichen Formate werden nicht von allen Multimediageräten unterstützt. Wenn Sie versuchen, ein nicht unterstütztes Format zu setzen, wird die Zuweisung ignoriert.

Die aktuelle Zeitinformation wird immer in einem 4-Byte-Integer übergeben. Bei einigen Formaten wird die Zeitinformation nicht als ein einzelner Integer zurückgegeben, sondern in Form eines langen Integers, der Informationen aus einzelnen Bytes enthält.

Der Typ TMPTimeFormats legt die Zeitformate für ein Multimediagerät fest, das mit einer TMediaPlayer-Komponente verwendet wird. Die folgende Tabelle enthält die möglichen Wert für den Typ TMPTimeFormats:

Wert	Zeitformat

tfMilliseconds	Millisekunden werden als 4-Byte-Integervariable gespeichert.

tfHMS	Stunden, Minuten und Sekunden werden in einem 4-Byte-Integer gespeichert. Die Datenwerte lauten (vom niederwertigsten zum höherwertigsten Byte):

  Stunden (niederwertigstes Byte)

  Minuten

  Sekunden

  Nicht benutzt (höherwertigstes Byte)

tfMSF	Minuten, Sekunden und Frames werden in einem 4-Byte-Integer gespeichert. Die Datenwerte lauten (vom niederwertigsten zum höherwertigsten Byte):

  Minuten (niederwertigstes Byte)

  Sekunden

  Frames

  Nicht benutzt (höherwertigstes Byte)

tfFrames	Frames werden als 4-Byte-Integervariable gespeichert.

tfSMPTE24	24-Frame-SMPTE speichert Werte in einer 4-Byte-Variablen. Die Datenwerte lauten (vom niederwertigsten zum höherwertigsten Byte):

  Stunden (niederwertigstes Byte)

  Minuten

  Sekunden

  Frames (höherwertigstes Byte)

SMPTE (Society of Motion Picture and Television Engineers) ist ein absolutes Zeitformat, das in Stunden, Minuten, Sekunden und Frames ausgedrückt wird. Die Standardunterteilungstypen von SMPTE sind 24, 25 und 30 Frames pro Sekunde.

tfSMPTE25	25-Frame-SMPTE speichert Daten in der gleichen Reihenfolge wie 24-Frame-SMPTE in einer 4-Byte-Variablen.

tfSMPTE30	30-Frame-SMPTE speichert Daten in der gleichen Reihenfolge wie 24-Frame-SMPTE in einer 4-Byte-Variablen.

tfSMPTE30Drop	30-Drop-Frame-SMPTE speichert Daten in der gleichen Reihenfolge wie 24-Frame-SMPTE in einer 4-Byte-Variablen.

tfBytes	Bytes werden als 4-Byte-Integervariable gespeichert.

tfSamples	Samples werden als 4-Byte-Integervariable gespeichert.

tfTMSF	Spuren, Minuten, Sekunden und Frames werden in der 4-Byte-Variablen gespeichert. Die Datenwerte lauten (vom niederwertigsten zum höherwertigsten Byte):

  Spuren (niederwertigstes Byte)

  Minuten

  Sekunden

  Frames (höherwertigstes Byte)

Beachten Sie, daß MCI eine fortlaufende Spurzählung durchführt.

Hinweis

Die Funktionen von MCI zur Dekodierung des 4-Byte-Integers für die einzelnen Zeitformate sind in der Hilfedatei MMSYSTEM.HLP.


TMediaPlayer::TrackLength

TMediaPlayer	Siehe auch

Die Eigenschaft TrackLength gibt die Länge der Spur an.

__property long TrackLength[int TrackNum];

Beschreibung

TrackLength gibt die Länge der Spur an, die im Index TrackNum festgelegt ist.

Die Angabe von TrackLength erfolgt im aktuellen Zeitformat, das in der Eigenschaft TimeFormat festgelegt ist.


TMediaPlayer::TrackPosition

TMediaPlayer	Siehe auch

Die Eigenschaft TrackPosition meldet die Startposition der Spur.

__property long TrackPosition[int TrackNum];

Beschreibung

TrackPosition gibt die Startposition derjenigen Spur an, die im Index TrackNum festgelegt ist.

Die Angabe von TrackPosition erfolgt im aktuellen Zeitformat, das in der Eigenschaft TimeFormat festgelegt ist.


TMediaPlayer::Tracks

TMediaPlayer

Die Eigenschaft Tracks gibt die Anzahl der Spuren auf dem geöffneten Mulitmediagerät an.

__property long Tracks;

Beschreibung

Tracks gibt die Anzahl der Spuren an, die auf dem geöffneten Mulitmediagerät verfügbar sind.

Diese Eigenschaft wird ignoriert, wenn das Gerät keine Spuren unterstützt.


TMediaPlayer::Visible

TMediaPlayer	Beispiel

Die Eigenschaft Visible bestimmt, ob die Komponente auf dem Bildschirm angezeigt wird.

__property Visible;

Beschreibung

Visible legt fest, ob der Media-Player auf dem Bildschirm sichtbar ist.

Wenn Visible den Wert True hat, wird die Komponente angezeigt. Hat Visible den Wert False, ist die Komponente nicht sichtbar. Durch einen Aufruf der Methode Show kann die Eigenschaft Visible des Steuerelements auf True gesetzt werden. Show führt aber noch weitere Aktionen aus, die sicherstellen, daß das Steuerelement für den Benutzer sichtbar ist.


TMediaPlayer::VisibleButtons

TMediaPlayer	Siehe auch

Die Eigenschaft VisibleButtons legt fest, welche Schaltflächen des Media-Players sichtbar sind.

__property TButtonSet VisibleButtons;

Beschreibung

In der Eigenschaft VisibleButtons wird festgelegt, welche Schaltflächen des Media-Players sichtbar sind. Schaltflächen, die nicht mit dieser Eigenschaft sichtbar gemacht werden, werden im Media-Player nicht angezeigt. Per Voreinstellung sind alle Schaltflächen sichtbar, wenn eine Media-Player-Komponente zu einem Formular hinzugefügt wird.

Schaltfläche	Wert	Aktion

Play	btPlay	Startet den Media-Player.

Record	btRecord	Startet die Aufzeichnung.

Stop	btStop	Stoppt das Abspielen oder Aufzeichnen.

Next	btNext	Spult zur nächsten Spur bzw. zum Ende, wenn das Medium keine Spuren unterstützt.

Prev	btPrev	Spult zur vorhergehenden Spur bzw. zum Anfang, wenn das Medium keine Spuren unterstützt.

Step	btStep	Spult um eine bestimmte Anzahl von Frames nach vorne.

Back	btBack	Spult um eine bestimmte Anzahl von Frames zurück.

Pause	btPause	Unterbricht das Abspielen oder Aufzeichnen. Wenn bereits unterbrochen ist, wird durch Anklicken das Abspielen bzw. Aufzeichnen wieder gestartet.

Eject	btEject	Wirft das Medium aus.


TMediaPlayer::Wait

TMediaPlayer

Die Eigenschaft Wait legt fest, ob eine Methode zur Steuerung des Media-Players nach ihrer Ausführung die Steuerung wieder an die Anwendung übergibt.

__property bool Wait;

Beschreibung

Wait bestimmt, ob eine Methode zur Steuerung des Media-Players (Back, Close, Eject, Next, Open, Pause, PauseOnly, Play, Previous, StartRecording, Resume, Rewind, Step oder Stop) die Steuerung erst dann an die Anwendung zurückgibt, wenn ihre Ausführung abgeschlossen ist.

Wait ist zur Laufzeit nicht verfügbar.

Wenn Wait den Wert True hat, wartet die Media-Player-Komponente, bis die nächste Methode zur Steuerung des Media-Players vollständig ausgeführt ist. Erst dann gibt sie die Steuerung an die Anwendung zurück. Hat Wait den Wert False, wartet die Anwendung nicht, bis die Ausführung der nächsten Methode zur Steuerung des Media-Players abgeschlossen ist.

Wait wirkt sich nur auf diejenige Methode zur Steuerung des Media-Players aus, die nach dem Setzen von Wait aufgerufen wird. Soll die Eigenschaft Wait auch für weitere Methodenaufrufe gelten, muß sie nach jedem Aufruf neu gesetzt werden.

Per Vorgabe agieren die Methoden Play und StartRecording so, als wäre Wait auf False gesetzt. Damit die Steuerung vor dem Ende des Abspiel- oder Aufzeichnungsvorgangs an die Anwendung zurückgegeben wird, muß Wait vor dem Aufruf von Play bzw. StartRecording auf True gesetzt werden. Alle anderen Methoden zur Steuerung des Media-Players agieren so, als wäre Wait auf True gesetzt.

Hinweis

Wait wird normalerweise nur dann auf False gesetzt, wenn anzunehmen ist, daß die nächste Methode zur Steuerung des Media-Players länger dauert. Die Anwendung kann dann weiteren Code ausführen, während die Ausführung der Methode noch läuft. Wenn Wait den Wert False hat, sollte Notify auf True gesetzt werden, damit die Anwendung von der Beendigung der Media-Player-Methode in Kenntnis gesetzt wird.


Ereignisse von TMediaPlayer

TMediaPlayer	Alphabetisch	Legende

In TMediaPlayer

OnClick

OnNotify

OnPostClick

Abgeleitet von TWinControl

OnEnter

OnExit


Ereignisse von TMediaPlayer

TMediaPlayer	Nach Objekten	Legende

OnClick

OnEnter

OnExit

OnNotify

OnPostClick


TMediaPlayer::OnClick

TMediaPlayer	Siehe auch	Beispiel

Das Ereignis OnClick wird ausgelöst, wenn der Benutzer die Maustaste drückt und wieder losläßt, während sich der Mauszeiger auf einer Schaltfläche des Media-Players befindet. Das Drücken der LEERTASTE, während der Media-Player den Fokus hat, führt ebenfalls zu einem OnClick-Ereignis.

__property EMPNotify OnClick;

Beschreibung

Wenn der Media-Player den Fokus besitzt und der Benutzer die LEERTASTE drückt, kann er mit den Tasten LINKS bzw. RECHTS eine Schaltfläche auswählen.

Der Typ EMPNotify ist ein Methodenzeiger, der beim Eintreten eines OnClick-Ereignisses für eine TMediaPlayer-Komponente aufgerufen wird. Das Argument Button kann einen der folgenden Werte annehmen: btBack, btEject, btNext, btPause, btPlay, btPrev, btRecord, btStep oder btStop.

Der Standardwert für das Argument DoDefault lautet True. Wenn diese Einstellung beibehalten wird, ruft der Media-Player die Methode auf, die der angeklickten Schaltfläche entspricht. Beispielsweise führt ein Klick auf die Schaltfläche Play (btPlay) zum Aufruf der Methode Play.

Hat DoDefault den Wert False, muß in der Ereignisbehandlungsroutine OnClick ein Code bereitgestellt werden, der beim Klicken auf eine Schaltfläche des Media-Players ausgeführt wird. Die folgende Tabelle enthält die Standardmethoden, die den Schaltflächen des Media-Players entsprechen:

Schaltfläche	Schaltflächenwert	Aufgerufene Methode

Play	btPlay	Play

Record	btRecord	StartRecording

Stop	btStop	Stop

Next	btNext	Next

Prev	btPrev	Previous

Step	btStep	Step

Back	btBack	Back

Pause	btPause	Pause

Eject	btEject	Eject


TMediaPlayer::OnNotify

TMediaPlayer	Siehe auch

Das Ereignis OnNotify wird ausgelöst, wenn die Ausführung einer Methode zur Steuerung des Media-Players beendet ist.

__property Classes::TNotifyEvent OnNotify;

Beschreibung

OnNotify tritt ein, sobald die Ausführung einer Methode zur Steuerung des Media-Players (Back, Close, Eject, Next, Open, Pause, PauseOnly, Play, Previous, Resume, Rewind, StartRecording, Step oder Stop) beendet ist. Voraussetzung dafür ist allerdings, daß die Eigenschaft vor dem Aufruf der Methode auf True gesetzt wurde. Nach einem OnNotify-Ereignis muß die Eigenschaft Notify erneut auf True gesetzt werden, damit das nächste OnNotify-Ereignis eintreten kann.


TMediaPlayer::OnPostClick

TMediaPlayer	Siehe auch

Das Ereignis OnPostClick tritt nach einem Aufruf der Ereignisbehandlungsroutine für OnClick ein.

__property EMPPostNotify OnPostClick;

Beschreibung

Das Ereignis OnPostClick wird generiert, nachdem der Code der Ereignisbehandlungsroutine für OnClick aufgerufen wurde. Wenn beim Anklicken der Media-Player-Schaltfläche die Eigenschaft Wait den Wert True hat, erfolgt der Aufruf von OnPostClick erst nach der vollständigen Ausführung des OnClick-Codes. Ist Wait auf False gesetzt, kann die Steuerung auch dann zur Anwendung zurückkehren, wenn der OnClick-Code noch nicht vollständig ausgeführt wurde. Aus diesem Grund ist es möglich, daß die durch das OnClick-Ereignis ausgelösten Aktionen noch nicht beendet sind, wenn das Ereignis OnPostClick eintritt.

Klickt der Benutzer zum Beispiel auf die Schaltfläche Play und ist der DoDefault-Parameter der OnClick-Ereignisbehandlungsroutine für den Media-Player auf True gesetzt, wird das Medium abgespielt. Hat Wait den Wert True, wird ein langes Medium bei der Generierung des OnPostClick-Ereignisses weiter abgespielt. Wenn Wait dagegen auf False gesetzt ist, kann OnPostClick erst eintreten, wenn das Medium vollständig abgespielt ist.

Der Typ EMPPostNotify ist eine Methode, die beim Eintreten eines OnPostClick-Ereignisses für eine TMediaPlayer-Komponente aufgerufen wird. Das Argument Button kann einen der folgenden Werte annehmen: btBack, btEject, btNext, btPause, btPlay, btPrev, btRecord, btStep oder btStop.


Methoden von TMediaPlayer

TMediaPlayer	Alphabetisch	Legende

In TMediaPlayer

~TMediaPlayer

AutoButtonSet

Back

Click

Close

DoNotify

Eject

Loaded

MMNotify

Next

Notification

Open

Paint

Pause

PauseOnly

Play

PostClick

Previous

Resume

Rewind

Save

StartRecording

Step

Stop

TMediaPlayer

Updated

Abgeleitet von TWinControl

Broadcast

CanFocus

ContainsControl

ControlAtPos

DisableAlign

EnableAlign

Focused

GetTabOrderList

HandleAllocated

HandleNeeded

InsertControl

Invalidate

PaintTo

Realign

RemoveControl

Repaint

ScaleBy

ScrollBy

SetBounds

SetFocus

Update

UpdateControlState

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

GetTextLen

Hide

Perform

Refresh

ScreenToClient

SendToBack

SetTextBuf

Show

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TMediaPlayer

TMediaPlayer	Nach Objekten	Legende

~TMediaPlayer

Assign

AutoButtonSet

Back

BeginDrag

BringToFront

Broadcast

CanFocus

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

Click

ClientToScreen

Close

ContainsControl

ControlAtPos

DefaultHandler

DestroyComponents

Destroying

DisableAlign

Dispatch

DoNotify

DragDrop

Dragging

Eject

EnableAlign

EndDrag

FieldAddress

FindComponent

Focused

FreeInstance

FreeNotification

Free

GetParentComponent

GetTabOrderList

GetTextBuf

GetTextLen

HandleAllocated

HandleNeeded

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InsertControl

InstanceSize

Invalidate

Loaded

MethodAddress

MethodName

MMNotify

NewInstance

Next

Notification

Open

Paint

PaintTo

PauseOnly

Pause

Perform

Play

PostClick

Previous

Realign

Refresh

RemoveComponent

RemoveControl

Repaint

Resume

Rewind

Save

ScaleBy

ScreenToClient

ScrollBy

SendToBack

SetBounds

SetFocus

SetTextBuf

Show

StartRecording

Step

Stop

TMediaPlayer

UpdateControlState

Updated

Update


TMediaPlayer::~TMediaPlayer

TMediaPlayer	Siehe auch

Der Destruktor ~TMediaPlayer gibt den Speicher frei, der für das TMediaPlayer-Objekt reserviert war. Rufen Sie ~TMediaPlayer nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TMediaPlayer automatisch aufgerufen wird.

__fastcall virtual ~TMediaPlayer(void);

Beschreibung

~TMediaPlayer überprüft, daß kein Gerät geöffnet ist und gibt dann die Bitmaps der Schaltflächen frei. Zulsetzt wird der Destruktor des übergeordneten Objekts aufgerufen.


TMediaPlayer::AutoButtonSet

TMediaPlayer	Siehe auch

Die Methode AutoButtonSet steuert die Aktivierung der Schaltflächen des Media-Players.

virtual void __fastcall AutoButtonSet(TMPBtnType Btn);

Beschreibung

AutoButtonSet implementiert die automatische Aktivierung und Deaktivierung der Schaltflächen des Media-Players. Voraussetzung dafür ist, daß die Eigenschaft AutoEnable den Wert True hat. Der Parameter Btn gibt an, welche Schaltfläche des Media-Players vom Benutzer betätigt wurde.

TMPBtnType ist der Typ des Parameters Btn. Die Werte für TMPBtnType lauten wie folgt:

Schaltfläche	Wert	Aktion

Play	btPlay	Startet den Media-Player.

Record	btRecord	Startet die Aufzeichnung.

Stop	btStop	Stoppt das Abspielen oder Aufzeichnen.

Next	btNext	Spult zur nächsten Spur bzw. zum Ende, wenn das Medium keine Spuren unterstützt.

Prev	btPrev	Spult zur vorhergehenden Spur bzw. zum Anfang, wenn das Medium keine Spuren unterstützt.

Step	btStep	Spult um eine bestimmte Anzahl von Frames nach vorne.

Back	btBack	Spult um eine bestimmte Anzahl von Frames zurück.

Pause	btPause	Unterbricht das Abspielen oder Aufzeichnen. Wenn bereits unterbrochen ist, wird durch Anklicken das Abspielen bzw. Aufzeichnen wieder gestartet.

Eject	btEject	Wirft das Medium aus.


TMediaPlayer::Back

TMediaPlayer	Siehe auch

Die Methode Back spult im aktuell geladenen Medium um die Anzahl von Frames zurück, die in der Frames-Eigenschaft angegeben ist.

void __fastcall Back(void);

Beschreibung

Der Aufruf von Back erfolgt, wenn zur Laufzeit auf die Schaltfläche Back des Media-Players geklickt wird.

Nach Beendigung der Ausführung speichert Back in der Eigenschaft Error einen numerischen Fehlercode. Die entsprechende Fehlermeldung wird in der Eigenschaft ErrorMessage abgelegt.

Die Eigenschaft Wait bestimmt, ob die Steuerung an die Anwendung zurückgegeben wird, bevor die Methode Back vollständig ausgeführt ist. Die Eigenschaft Notify gibt an, ob Back ein OnNotify-Ereignis erzeugt.


TMediaPlayer::Click

TMediaPlayer	Siehe auch

Die Methode Click legt die Aktion fest, die beim Eintreten eines OnClick-Ereignisses ausgeführt wird.

virtual void __fastcall Click(TMPBtnType Button, bool &DoDefault);

Beschreibung

Click ist die Implementierungsmethode für das Ereignis OnClick von Media-Player-Komponenten. Per Vorgabe besteht die einzige Aktion von Click im Aufruf von Behandlungsroutinen, die mit dem OnClick-Ereignis des Media-Players verbunden sind.


TMediaPlayer::Close

TMediaPlayer	Siehe auch

Die Methode Close schließt das geöffnete Multimediagerät.

void __fastcall Close(void);

Beschreibung

Nach Beendigung der Ausführung speichert Close in der Eigenschaft Error einen numerischen Fehlercode. Die entsprechende Fehlermeldung wird in der Eigenschaft ErrorMessage abgelegt.

Die Eigenschaft Wait bestimmt, ob die Steuerung an die Anwendung zurückgegeben wird, bevor die Methode Close vollständig ausgeführt ist. Die Eigenschaft Notify gibt an, ob Close ein OnNotify-Ereignis erzeugt.

Close wird bei Beendigung der Anwendung automatisch aufgerufen.


TMediaPlayer::DoNotify

TMediaPlayer	Siehe auch

 Die Methode DoNotify legt die Aktion fest, die beim Eintreten eines OnNotify-Ereignisses ausgeführt wird.

virtual void __fastcall DoNotify(void);

Beschreibung

DoNotify ist die Implementierungsmethode für das Ereignis OnNotify einer Media-Player-Komponente. Die -Methode MMNotify des Media-Players ruft DoNotify auf, nachdem die Aktivierung bzw. Deaktivierung der Schaltflächen geändert und interne Flags aufgrund der in den Benachrichtigungsparametern übergebenen Werte gesetzt wurden.

Die einzige Aktion von DoNotify besteht im Aufruf von Behandlungsroutinen, die mit dem OnNotify-Ereignis des Media-Players verbunden sind. Durch Überschreiben von DoNotify können Sie weitere Antworten definieren, die zusätzlich zum Aufruf der geerbten Ereignisbehandlungsroutine ausgeführt werden.


TMediaPlayer::Eject

TMediaPlayer	Siehe auch

Die Methode Eject wirft das Medium aus, das im geöffneten Multimediagerät geladen ist.

void __fastcall Eject(void);

Beschreibung

Die Methode Eject wirft das Medium aus, das im geöffneten Multimediagerät geladen ist.

Der Aufruf von Eject erfolgt, wenn zur Laufzeit auf die Schaltfläche Eject des Media-Players geklickt wird.

Nach Beendigung der Ausführung speichert Eject in der Eigenschaft Error einen numerischen Fehlercode. Die entsprechende Fehlermeldung wird in der Eigenschaft ErrorMessage abgelegt.

Die Eigenschaft Wait bestimmt, ob die Steuerung an die Anwendung zurückgegeben wird, bevor die Methode Eject vollständig ausgeführt ist. Die Eigenschaft Notify gibt an, ob Eject ein OnNotify-Ereignis erzeugt.


TMediaPlayer::Loaded

TMediaPlayer	Siehe auch

Loaded ermöglicht eine Initialisierung, nachdem der Media-Player aus einem Stream geladen wurde.

virtual void __fastcall Loaded(void);

Beschreibung

Die Methode ermöglicht es einer Komponente, sich selbst zu initialisieren, nachdem alle ihre Bestandteile aus einem Stream geladen wurden. Wenn beispielsweise in einer Borland C++Builder-Anwendung ein Formular aus der zugehörigen Formulardatei geladen wird, erfolgt zunächst die Konstruktion der Formularkomponente durch einen Aufruf des Konstruktors Create. Anschließend werden die Eigenschaftswerte aus der Formulardatei (die einen Stream darstellt) gelesen. Sobald die Eigenschaftswerte aller Komponenten übernommen wurden, ruft Borland C++Builder die Loaded-Methoden für die einzelnen Komponenten auf. Die Reihenfolge dieser Aufrufe ist von der Erstellungsreihenfolge der Komponenten abhängig. Die Komponenten können dann alle Daten initialisieren, die von eigenen Bestandteilen oder von den Werten anderer Komponenten abhängig sind.


TMediaPlayer::Next

TMediaPlayer	Siehe auch

Die Methode Next führt einen Sprung zum Anfang der nächsten Spur auf dem aktuell geladenen Medium aus.

void __fastcall Next(void);

Beschreibung

Ist beim Aufruf der Methode Next bereits auf die letzte Spur positioniert, wird die aktuelle Position auf den Beginn dieser letzten Spur gesetzt. Falls das Multimediagerät keine Spuren unterstützt, positioniert Next auf das Ende des Mediums. Der Aufruf von Next erfolgt, wenn zur Laufzeit auf die Schaltfläche Next des Media-Players geklickt wird.

Nach Beendigung der Ausführung speichert Next in der Eigenschaft Error einen numerischen Fehlercode. Die entsprechende Fehlermeldung wird in der Eigenschaft ErrorMessage abgelegt.

Die Eigenschaft Wait bestimmt, ob die Steuerung an die Anwendung zurückgegeben wird, bevor die Methode Next vollständig ausgeführt ist. Die Eigenschaft Notify gibt an, ob Next ein OnNotify-Ereignis erzeugt.


TMediaPlayer::MMNotify

TMediaPlayer	Siehe auch

Die Methode MMNotify reagiert auf die Benachrichtigung, daß das MCI-Gerät eine Operation beendet hat.

MESSAGE void __fastcall MMNotify(Messages::TMessage &Message);

Beschreibung

MMNotify antwortet auf eine Benachrichtigungsbotschaft von Windows, die signalisiert, daß ein Multimediabefehl abgeschlossen ist. Wenn die Eigenschaft AutoEnabled auf True gesetzt ist, wird der Status der Schaltflächen aktualisiert, und die internen Flags werden entsprechend des Befehlsergebnisses gesetzt. Anschließend werden durch einen Aufruf der Methode DoNotify das DoNotify-Ereignis und weitere spezielle Aktionen ausgelöst.


TMediaPlayer::Notification

TMediaPlayer	Siehe auch

Die Methode Notification benachrichtigt die Komponente, daß die in AComponent angegebene Komponente, wie mit Operation festgelegt, eingefügt oder entfernt wird.

virtual void __fastcall Notification(Classes::TComponent* AComponent, Classes::TOperation Operation );

Beschreibung

Per Voreinstellung benachrichtigen alle Komponenten ihre übergeordneten Komponenten (falls vorhanden).


TMediaPlayer::Open

TMediaPlayer	Siehe auch

Die Methode Open öffnet ein Multimediagerät.

void __fastcall Open(void);

Beschreibung

Verwenden Sie die Methode Open zum öffnen eines Multimediageräts. Der Typ dieses Geräts muß vor dem Aufruf von Open in der Eigenschaft DeviceType festgelegt werden. Nach Beendigung der Ausführung speichert Open in der Eigenschaft Error einen numerischen Fehlercode. Die entsprechende Fehlermeldung wird in der Eigenschaft ErrorMessage abgelegt.

Die Eigenschaft Wait bestimmt, ob die Steuerung an die Anwendung zurückgegeben wird, bevor die Methode Open vollständig ausgeführt ist. Die Eigenschaft Notify gibt an, ob Open ein OnNotify-Ereignis erzeugt.


TMediaPlayer::Paint

TMediaPlayer

Die Methode Paint antwortet auf eine WM_PAINT-Botschaft von Windows.

virtual void __fastcall Paint(void);

Beschreibung

Paint zeichnet das Bild für den Media-Player. Benutzerdefinierte Steuerelemente wie Media-Player-Komponenten beantworten WM_PAINT-Botschaften durch die Initialisierung der zugehörigen Zeichenfläche und einen Aufruf von Paint.

Wenn Sie eine abgeleitete Media-Player-Klasse erstellen, können Sie Paint so überschreiben, daß das Bild des entsprechenden Media-Player-Objekts gezeichnet wird.


TMediaPlayer::PostClick

TMediaPlayer	Siehe auch

Die Methode PostClick legt die Aktion fest, die beim Eintreten eines OnPostClick-Ereignisses ausgeführt wird.

virtual void __fastcall PostClick(TMPBtnType Button);

Beschreibung

PostClick ist die Implementierungsmethode für das OnPostClick-Ereignis. Die einzige Aktion von PostClick besteht im Aufruf von Behandlungsroutinen, die mit dem Ereignis OnPostClick des Media-Players verbunden sind. In abgeleiteten Typen können Sie PostClick überschreiben, um spezielle Antworten auf Mausklicks zu implementieren.


TMediaPlayer::Pause

TMediaPlayer	Siehe auch

Die Methode Pause hält das geöffnete Multimediagerät an.

void __fastcall Pause(void);

Beschreibung

Wenn sich das Gerät beim Aufruf von Pause bereits im Pausezustand befindet, erfolgt ein Aufruf der Methode Resume, und das Abspielen bzw. Aufzeichnen wird fortgesetzt. Der Aufruf von Pause erfolgt, wenn zur Laufzeit auf die Schaltfläche Pause des Media-Players geklickt wird.

Nach Beendigung der Ausführung speichert Pause in der Eigenschaft Error einen numerischen Fehlercode. Die entsprechende Fehlermeldung wird in der Eigenschaft ErrorMessage abgelegt.

Die Eigenschaft Wait bestimmt, ob die Steuerung an die Anwendung zurückgegeben wird, bevor die Methode Pause vollständig ausgeführt ist. Die Eigenschaft Notify gibt an, ob Pause ein OnNotify-Ereignis erzeugt.


TMediaPlayer::PauseOnly

TMediaPlayer	Siehe auch

Die Methode PauseOnly hält das geöffnete Multimediagerät an.

void __fastcall PauseOnly(void);

Beschreibung

Wenn sich das Gerät beim Aufruf von PauseOnly bereits im Pausezustand befindet, wird dieser beibehalten.

Nach Beendigung der Ausführung speichert PauseOnly in der Eigenschaft Error einen numerischen Fehlercode. Die entsprechende Fehlermeldung wird in der Eigenschaft ErrorMessage abgelegt.

Die Eigenschaft Wait bestimmt, ob die Steuerung an die Anwendung zurückgegeben wird, bevor die Methode PauseOnly vollständig ausgeführt ist. Die Eigenschaft Notify gibt an, ob PauseOnly ein OnNotify-Ereignis erzeugt.


TMediaPlayer::Play

TMediaPlayer	Siehe auch

Die Methode Play spielt das Medium ab, das im geöffneten Multimediagerät geladen ist.

void __fastcall Play(void);

Beschreibung

Der Aufruf von Play erfolgt, wenn zur Laufzeit auf die Schaltfläche Play des Media-Players geklickt wird.

Nach Beendigung der Ausführung speichert Play in der Eigenschaft Error einen numerischen Fehlercode. Die entsprechende Fehlermeldung wird in der Eigenschaft ErrorMessage abgelegt.

Die Eigenschaft Wait bestimmt, ob die Steuerung an die Anwendung zurückgegeben wird, bevor die Methode Play vollständig ausgeführt ist. Die Eigenschaft Notify gibt an, ob Play ein OnNotify-Ereignis erzeugt.

Wenn die Eigenschaft StartPos gesetzt wird, wird mit dem Abspielen an der entsprechenden Position begonnen. Andernfalls beginnt der Abspielvorgang an der aktuellen Position, die in der Eigenschaft Position festgelegt ist. Entsprechendes gilt für die Eigenschaft EndPos. Wenn diese Eigenschaft gesetzt ist, wird der Abspielvorgang an der entsprechenden Position gestoppt. Ist EndPos nicht gesetzt, endet der Abspielvorgang, sobald das Ende des Mediums erreicht ist.

Ob das Medium vor dem Start des Abspielvorgangs zurückgespult wird, ist vom Wert der Eigenschaft AutoRewind abhängig.


TMediaPlayer::Previous

TMediaPlayer	Siehe auch

Die Methode Previous setzt die aktuelle Position auf den Beginn der vorherigen Spur. Voraussetzung dafür ist allerdings, daß sich die Position beim Aufruf von Previous am Beginn einer Spur befand.

void __fastcall Previous(void);

Beschreibung

Befindet sich die aktuelle Position beim Aufruf von Previous nicht am Anfang einer Spur oder in der ersten Spur, wird die aktuelle Position auf den Beginn der aktuellen Spur gesetzt. Falls das Gerät keine Spuren unterstützt, setzt Previous die aktuelle Position an den Anfang des Mediums. Dieser ist in der Eigenschaft Start festgelegt. Der Aufruf von Previous erfolgt, wenn zur Laufzeit auf die Schaltfläche Previous des Media-Players geklickt wird.

Nach Beendigung der Ausführung speichert Previous in der Eigenschaft Error einen numerischen Fehlercode. Die entsprechende Fehlermeldung wird in der Eigenschaft ErrorMessage abgelegt.

Die Eigenschaft Wait bestimmt, ob die Steuerung an die Anwendung zurückgegeben wird, bevor die Methode Previous vollständig ausgeführt ist. Die Eigenschaft Notify gibt an, ob Previous ein OnNotify-Ereignis erzeugt.


TMediaPlayer::Resume

TMediaPlayer	Siehe auch

Resume nimmt einen unterbrochenen Abspiel- oder Aufzeichnungsvorgang auf dem Multimediagerät wieder auf.

void __fastcall Resume(void);

Beschreibung

Der Aufruf von Resume erfolgt, wenn zur Laufzeit auf die Pause-Schaltfläche des Media-Players geklickt wird, und sich dieser im Pausezustand befindet.

Nach Beendigung der Ausführung speichert Resume in der Eigenschaft Error einen numerischen Fehlercode. Die entsprechende Fehlermeldung wird in der Eigenschaft ErrorMessage abgelegt.

Die Eigenschaft Wait bestimmt, ob die Steuerung an die Anwendung zurückgegeben wird, bevor die Methode Resume vollständig ausgeführt ist. Die Eigenschaft Notify gibt an, ob Resume ein OnNotify-Ereignis erzeugt.


TMediaPlayer::Rewind

TMediaPlayer	Siehe auch

Die Methode Rewind setzt die aktuelle Position an den Anfang des Mediums, das in der Eigenschaft Start festgelegt ist.

void __fastcall Rewind(void);

Beschreibung

Nach Beendigung der Ausführung speichert Rewind in der Eigenschaft Error einen numerischen Fehlercode. Die entsprechende Fehlermeldung wird in der Eigenschaft ErrorMessage abgelegt.

Die Eigenschaft Wait bestimmt, ob die Steuerung an die Anwendung zurückgegeben wird, bevor die Methode Rewind vollständig ausgeführt ist. Die Eigenschaft Notify gibt an, ob Rewind ein OnNotify-Ereignis erzeugt.


TMediaPlayer::Save

TMediaPlayer	Siehe auch

Save speichert das aktuelle geladene Medium in der Datei, die in der Eigenschaft FileName angegeben ist.

void __fastcall Save(void);

Beschreibung

Save wird für Geräte ignoriert, deren Medien nicht in Dateien gespeichert sind (dies ist z.B. bei Bildplatten der Fall).

Nach Beendigung der Ausführung speichert Save in der Eigenschaft Error einen numerischen Fehlercode. Die entsprechende Fehlermeldung wird in der Eigenschaft ErrorMessage abgelegt.

Die Eigenschaft Wait bestimmt, ob die Steuerung an die Anwendung zurückgegeben wird, bevor die Methode Save vollständig ausgeführt ist. Die Eigenschaft Notify gibt an, ob Save ein OnNotify-Ereignis erzeugt.


TMediaPlayer::StartRecording

TMediaPlayer	Siehe auch

Die Methode StartRecording beginnt an der aktuellen Position oder der in StartPos angegebenen Position mit der Aufzeichnung.

void __fastcall StartRecording(void);

Beschreibung

Der Aufruf von StartRecording erfolgt, wenn zur Laufzeit auf die Schaltfläche Record des Media-Players geklickt wird.

Nach Beendigung der Ausführung speichert StartRecording in der Eigenschaft Error einen numerischen Fehlercode. Die entsprechende Fehlermeldung wird in der Eigenschaft ErrorMessage abgelegt.

Die Eigenschaft Wait bestimmt, ob die Steuerung an die Anwendung zurückgegeben wird, bevor die Methode StartRecording vollständig ausgeführt ist. Die Eigenschaft Notify gibt an, ob StartRecording ein OnNotify-Ereignis erzeugt.

Wenn die Ausführung der Methode StartRecording abgeschlossen ist, hat die Eigenschaft Notify standardmäßig den Wert True und die Eigenschaft Wait den Wert False. Wurden diese Eigenschaften aber vor dem Aufruf von StartRecording auf einen bestimmten Wert gesetzt, wird dieser beibehalten.


TMediaPlayer::Step

TMediaPlayer	Siehe auch

Die Methode Step spult im aktuell geladenen Medium um die in der Eigenschaft Frames angegebene) Anzahl von Frames nach vorne.

void __fastcall Step(void);

Beschreibung

Der Aufruf von Step erfolgt, wenn zur Laufzeit auf die Schaltfläche Step des Media-Players geklickt wird.

Nach Beendigung der Ausführung speichert Step in der Eigenschaft Error einen numerischen Fehlercode. Die entsprechende Fehlermeldung wird in der Eigenschaft ErrorMessage abgelegt.

Die Eigenschaft Wait bestimmt, ob die Steuerung an die Anwendung zurückgegeben wird, bevor die Methode Step vollständig ausgeführt ist. Die Eigenschaft Notify gibt an, ob Step ein OnNotify-Ereignis erzeugt.


TMediaPlayer::Stop

TMediaPlayer	Siehe auch

Die Methode Stop hält den Abspiel- oder Aufzeichnungsvorgang an.

void __fastcall Stop(void);

Beschreibung

Der Aufruf von Stop erfolgt, wenn zur Laufzeit auf die Schaltfläche Stop des Media-Players geklickt wird.

Nach Beendigung der Ausführung speichert Stop in der Eigenschaft Error einen numerischen Fehlercode. Die entsprechende Fehlermeldung wird in der Eigenschaft ErrorMessage abgelegt.

Die Eigenschaft Wait bestimmt, ob die Steuerung an die Anwendung zurückgegeben wird, bevor die Methode Stop vollständig ausgeführt ist. Die Eigenschaft Notify gibt an, ob Stop ein OnNotify-Ereignis erzeugt.


TMediaPlayer::TMediaPlayer

TMediaPlayer	Siehe auch

Der Konstruktor TMediaPlayer instantiiert einen Media-Player.

__fastcall virtual TMediaPlayer(Classes::TComponent* AOwner);

Beschreibung

Mit TMediaPlayer wird zur Laufzeit ein Media-Player instantiiert. Für Komponenten dieser Art, die während des Entwurfs erzeugt wurden, wird TMediaPlayer automatisch aufgerufen.

TMediaPlayer reserviert den nötigen Speicher und ruft den Konstruktor des übergeordneten Objekts auf.

Dann werden die Bitmap-Symbole für die Schaltflächen geladen und einige Initialisierungen vorgenommen: Die Eigenschaften AutoEnable, AutoRewind, Colored, Enabled und Visible werden auf True gesetzt, AutoOpen auf False und DeviceType auf dtAutoSelect.


TMediaPlayer::Updated

TMediaPlayer	Siehe auch

Die Methode Updated zeigt an, daß der Media-Player die Aktualisierung beendet hat.

virtual void __fastcall Updated(void);

Beschreibung

Updated bewirkt durch einen Aufruf der geerbten Methode Updated ein Neuzeichnen, bevor das Layout der Media-Player-Schaltflächen geändert wird.


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Protected


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TControl

TWinControl

TCustomControl


TMediaPlayer Beispiel

TMediaPlayer


 TMemo

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/stdctrls.hpp

Das Objekt TMemo kapselt ein mehrzeiliges Eingabefeld von Windows.

Beschreibung

Mit einem TMemo-Objekt plazieren Sie in einem Formular ein mehrzeiliges Windows-Eingabefeld. In Felder dieser Art kann der Benutzer mehrere Zeilen Text eingeben. Damit eigenen sich diese Komponenten gut für umfangreichere Informationen.

TMemo implementiert das generische Verhalten, das in TCustomMemo eingeführt wurde, und deklariert viele der von TCustomMemo geerbten Eigenschaften als published. Neues Verhalten wird jedoch nicht eingeführt.


Eigenschaften von TMemo

TMemo	Alphabetisch	Legende

In TMemo

Abgeleitet von TCustomMemo

Alignment

Lines

ScrollBars

WantReturns

WantTabs

WordWrap

Abgeleitet von TCustomEdit

BorderStyle

HideSelection

MaxLength

Modified

OEMConvert

ReadOnly

SelLength

SelStart

SelText

Abgeleitet von TWinControl

Brush

ClientOrigin

ClientRect

ControlCount

Controls

Ctl3D

Handle

HelpContext

ParentCtl3D

Showing

TabOrder

TabStop

Abgeleitet von TControl

Align

BoundsRect

ClientHeight

ClientWidth

Color

ControlState

ControlStyle

Cursor

DragCursor

DragMode

Enabled

Font

Height

Hint

Left

Name

Parent

ParentColor

ParentFont

ParentShowHint

PopupMenu

ShowHint

Text

Top

Visible

Width

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TMemo

TMemo	Nach Objekten	Legende

Alignment

Align

BorderStyle

BoundsRect

Brush

ClientHeight

ClientOrigin

ClientRect

ClientWidth

Color

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlCount

ControlState

Controls

ControlStyle

Ctl3D

Cursor

DesignInfo

DragCursor

DragMode

Enabled

Font

Handle

Height

HelpContext

HideSelection

Hint

Left

Lines

MaxLength

Modified

Name

OEMConvert

Owner

ParentColor

ParentCtl3D

ParentFont

ParentShowHint

Parent

PopupMenu

ReadOnly

ScrollBars

SelLength

SelStart

SelText

ShowHint

Showing

TabOrder

TabStop

Tag

Text

Top

Visible

WantReturns

WantTabs

Width

WordWrap


Ereignisse von TMemo

TMemo	Alphabetisch	Legende

Abgeleitet von TCustomEdit

OnChange

Abgeleitet von TWinControl

OnEnter

OnExit

OnKeyDown

OnKeyPress

OnKeyUp

Abgeleitet von TControl

OnClick

OnDblClick

OnDragDrop

OnDragOver

OnEndDrag

OnMouseDown

OnMouseMove

OnMouseUp

OnStartDrag


Ereignisse von TMemo

TMemo	Nach Objekten	Legende

OnChange

OnClick

OnDblClick

OnDragDrop

OnDragOver

OnEndDrag

OnEnter

OnExit

OnKeyDown

OnKeyPress

OnKeyUp

OnMouseDown

OnMouseMove

OnMouseUp

OnStartDrag


Methoden von TMemo

TMemo	Alphabetisch

Abgeleitet von TCustomMemo

~TCustomMemo

TCustomMemo

Abgeleitet von TCustomEdit

Clear

ClearSelection

CopyToClipboard

CutToClipboard

GetSelTextBuf

PasteFromClipboard

SelectAll

SetSelTextBuf

Abgeleitet von TWinControl

Broadcast

CanFocus

ContainsControl

ControlAtPos

DisableAlign

EnableAlign

Focused

GetTabOrderList

HandleAllocated

HandleNeeded

InsertControl

Invalidate

PaintTo

Realign

RemoveControl

Repaint

ScaleBy

ScrollBy

SetBounds

SetFocus

Update

UpdateControlState

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

GetTextLen

Hide

Perform

Refresh

ScreenToClient

SendToBack

SetTextBuf

Show

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TMemo

TMemo	Nach Objekten

~TCustomMemo

Assign

BeginDrag

BringToFront

Broadcast

CanFocus

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

ClearSelection

Clear

ClientToScreen

ContainsControl

ControlAtPos

CopyToClipboard

CutToClipboard

DefaultHandler

DestroyComponents

Destroying

DisableAlign

Dispatch

DragDrop

Dragging

EnableAlign

EndDrag

FieldAddress

FindComponent

Focused

FreeInstance

FreeNotification

Free

GetParentComponent

GetSelTextBuf

GetTabOrderList

GetTextBuf

GetTextLen

HandleAllocated

HandleNeeded

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InsertControl

InstanceSize

Invalidate

MethodAddress

MethodName

NewInstance

PaintTo

PasteFromClipboard

Perform

Realign

Refresh

RemoveComponent

RemoveControl

Repaint

ScaleBy

ScreenToClient

ScrollBy

SelectAll

SendToBack

SetBounds

SetFocus

SetSelTextBuf

SetTextBuf

Show

TCustomMemo

UpdateControlState

Update


~TMemo

Der Destruktor ~TMemo gibt den Speicher frei, der für das TMemo-Objekt reserviert war. Rufen Sie ~TMemo nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TMemo automatisch aufgerufen wird.

__fastcall virtual ~TMemo(void);


TMemo

Der Konstruktor TMemo erzeugt ein neues TMemo-Objekt.

__fastcall virtual TMemo(Classes::TComponent* AOwner);


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TControl

TWinControl

TCustomEdit

TCustomMemo


TMemo Beispiel

TMemo


TMemoField

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/dbtables.hpp

Die Komponente TMemoField repräsentiert ein Memofeld in einer Datenmenge.

Beschreibung

Memofelder gehören zur Gruppe der BLOB-Felder (BLOB = Binary Large OBject) und können daher einen beliebig langen Text-String enthalten. TMemoField unterscheidet sich von seinem direkten Vorfahren TBlobField nur durch die Einführung der Eigenschaft Transliterate (für die Sprachtreiberkonvertierung) und im Wert der Eigenschaft DataType. Als Nachkomme von TBlobField enthält TMemoField viele Eigenschaften, Methoden und Ereignisse, die sich für die Verwaltung von Wert und Eigenschaften eines BLOB-Feldes in einer Datenbank eigenen.


Eigenschaften von TMemoField

TMemoField	Alphabetisch	Legende

In TMemoField

Transliterate

Abgeleitet von TBlobField

BlobType

Value

Abgeleitet von TField

Alignment

AsBoolean

AsCurrency

AsDateTime

AsFloat

AsInteger

AsString

AsVariant

AttributeSet

BDECalcField

Calculated

CanModify

DataSet

DataSize

DataType

DisplayLabel

DisplayName

DisplayText

DisplayWidth

EditMask

EditMaskPtr

FieldKind

FieldName

FieldNo

Index

IsIndexField

IsNull

KeyFields

Lookup

LookupDataSet

LookupKeyFields

LookupResultField

NewValue

OldValue

ReadOnly

Required

Size

Text

Visible

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Name

Owner

Tag


Eigenschaften von TMemoField

TMemoField	Nach Objekten	Legende

Alignment

AsBoolean

AsCurrency

AsDateTime

AsFloat

AsInteger

AsString

AsVariant

AttributeSet

BDECalcField

BlobType

Calculated

CanModify

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

DataSet

DataSize

DataType

DesignInfo

DisplayLabel

DisplayName

DisplayText

DisplayWidth

EditMaskPtr

EditMask

FieldKind

FieldName

FieldNo

Index

IsIndexField

IsNull

KeyFields

LookupDataSet

LookupKeyFields

LookupResultField

Lookup

Name

NewValue

OldValue

Owner

ReadOnly

Required

Size

Tag

Text

Transliterate

Value

Visible


TMemoField::Transliterate

TMemoField	Siehe auch

Die Eigenschaft Transliterate legt fest, ob beim Lesen aus bzw. Schreiben in physikalische Tabellen der Text im Memofeld zwischen dem ANSI-Zeichensatz und demjenigen Zeichensatz konvertiert werden soll, der von der Datenmenge vorgegeben ist.

__property Transliterate;

Beschreibung

Wenn die physikalische Tabelle, die von der Datenmenge bezeichnet wird, keinen ANSI-Sprachtreiber unterstüzt oder ASCII-Sonderzeichen enthält, wird die Eigenschaft Transliterate entsprechend gesetzt.

Der Wert True bewirkt, daß die Funktion AnsiToNative die ANSI-Zeichen in den Zeichensatz überführt, der von der Datenmenge beim Schreiben in das Memofeld verwendet wird. Wenn das Memofeld gelesen wird, wandelt NativeToAnsi die Zeichen in der Tabelle in den ANSI-Zeichensatz um.


Ereignisse von TMemoField

TMemoField	Alphabetisch	Legende

Abgeleitet von TField

OnChange

OnGetText

OnSetText

OnValidate


Ereignisse von TMemoField

TMemoField	Nach Objekten	Legende

OnChange

OnGetText

OnSetText

OnValidate


Methoden von TMemoField

TMemoField	Alphabetisch

In TMemoField

~TMemoField

TMemoField

Abgeleitet von TBlobField

Assign

Clear

LoadFromFile

LoadFromStream

SaveToFile

SaveToStream

SetFieldType

SetText

Abgeleitet von TField

AssignValue

FocusControl

GetData

IsValidChar

SetData

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TMemoField

TMemoField	Nach Objekten

~TMemoField

Assign

AssignValue

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

Clear

DefaultHandler

DestroyComponents

Destroying

Dispatch

FieldAddress

FindComponent

FocusControl

FreeInstance

FreeNotification

Free

GetData

GetParentComponent

HasParent

InheritsFrom

InitInstance

InsertComponent

InstanceSize

IsValidChar

LoadFromFile

LoadFromStream

MethodAddress

MethodName

NewInstance

RemoveComponent

SaveToFile

SaveToStream

SetData

SetFieldType

SetText

TMemoField


TMemoField::~TMemoField

TMemoField

Der Destruktor ~TMemoField gibt den Speicher frei, der für das TMemoField-Objekt reserviert war. Rufen Sie ~TMemoField nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TMemoField automatisch aufgerufen wird.

__fastcall virtual ~TMemoField(void);


TMemoField::TMemoField

TMemoField	Siehe auch

Die Methode TMemoField erzeugt eine Instanz von TMemoField.

__fastcall virtual TMemoField(Classes::TComponent* AOwner);

Beschreibung

Mit TMemoField wird ein TMemoField-Objekt zur Laufzeit instantiiert. Für TMemoField-Objekte, die zur Laufzeit in Formularen oder Datenmodulen plaziert werden, wird TMemoField automatisch aufgerufen.

Nach dem Aufruf des geerbten Konstruktors setzt TMemoField die Eigenschaft DataType auf ftMemo.


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TField

TBlobField


TMemoField Beispiel

TMemoField


TMemoryStream

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/classes.hpp

TMemoryStream ist ein Stream-Objekt, das seine Daten im dynamischen Speicher ablegt.

Beschreibung

Mit TMemoryStream können Daten in einem dynamischen Speicherpuffer abgelegt werden, der über erweiterte E/A-Funktionalität verfügt. TMemoryStream umfaßt die allgemeinen E/A-Merkmale eines Stream-Objekts, führt aber Methoden und Eigenschaften ein, die speziell für die Verwaltung eines dynamischen Speicherpuffers vorgesehen sind.

Speicher-Streams eignen sich gut als temporäre Informationsablage, weil sie Daten speichern können, aber auch Lese- und Schreibvorgänge in/aus anderen Speichermedien zulassen. Sie bieten eine praktikable Möglichkeit, die Inhalte verschiedener Streams zu vergleichen oder gespeicherte Daten auf solchen Medien zu bearbeiten, die nur indirekt zugreifbar sind.


Eigenschaften von TMemoryStream

TMemoryStream	Alphabetisch	Legende

In TMemoryStream

Capacity

Abgeleitet von TCustomMemoryStream

Memory

Abgeleitet von TStream

Position

Size


Eigenschaften von TMemoryStream

TMemoryStream	Nach Objekten	Legende

Capacity

Memory

Position

Size


TMemoryStream::Capacity

TMemoryStream	Siehe auch

Die Eigenschaft Capacity bezeichnet die Größe des Speicherbereichs, der aktuell vom TMemoryStream-Objekt reserviert ist.

__property long Capacity;

Beschreibung

Mit Capacity kann ermittelt werden, wieviel Platz im Speicherpuffer vorhanden ist. Ebenso kann der Speicherpuffer erneut reserviert und damit mehr oder weniger Speicher bereitgestellt werden.

Capacity ist die tatsächliche Anzahl von Bytes im Speicherpuffer. Dagegen bezeichnet die Eigenschaft Size die Anzahl der verwendeten Bytes. Deshalb ist Capacity immer größer oder gleich Size. Wenn die Eigenschaft Size einen neuen Wert erhält, wird Capacity entsprechend angepaßt, umgekehrt gilt dies aber nicht. Setzen Sie Capacity nie auf einen Wert kleiner als Size, sonst gehen Daten verloren, und Size signalisiert eine höhere Speicherbelegung als die tatsächliche.

Wenn der Platz für den Speicher-Stream angepaßt werden soll, setzen Sie die Eigenschaft Capacity. Verwenden Sie keinesfalls die Methode Realloc, weil diese die Eigenschaft Memory nicht aktualisiert, wodurch sich ein Zeiger auf eine ungültige Speicherposition ergeben könnte.

Capacity ist eine geschützte Eigenschaft. In Anwendungen kann das Fassungsvermögen eines Speicher-Streams mit der Methode SetSize geändert werden.


Methoden von TMemoryStream

TMemoryStream	Alphabetisch	Legende

In TMemoryStream

~TMemoryStream

LoadFromFile

LoadFromStream

Realloc

SetSize

TMemoryStream

Write

Abgeleitet von TCustomMemoryStream

Read

SaveToFile

SaveToStream

Seek

Abgeleitet von TStream

CopyFrom

ReadBuffer

ReadComponent

ReadComponentRes

ReadResHeader

WriteBuffer

WriteComponent

WriteComponentRes

WriteDescendent

WriteDescendentRes

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TMemoryStream

TMemoryStream	Nach Objekten	Legende

~TMemoryStream

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

CopyFrom

DefaultHandler

Dispatch

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

LoadFromFile

LoadFromStream

MethodAddress

MethodName

NewInstance

ReadBuffer

ReadComponentRes

ReadComponent

ReadResHeader

Read

Realloc

SaveToFile

SaveToStream

Seek

SetSize

TMemoryStream

WriteBuffer

WriteComponentRes

WriteComponent

WriteDescendentRes

WriteDescendent

Write


TMemoryStream::~TMemoryStream

TMemoryStream	Siehe auch

Die Methode ~TMemoryStream gibt eine Instanz von TMemoryStream frei.

__fastcall virtual ~TMemoryStream(void);

Beschreibung

Rufen Sie ~TMemoryStream nicht direkt in einer Anwendung auf. Verwenden Sie statt dessen Free. Die Methode Free überprüft zuerst, ob das TMemoryStream-Objekt nicht bereits freigegeben wurde, und ruft ~TMemoryStream nur bei Bedarf auf.

Ein TMemoryStream-Objekt sollte immer dann freigegeben werden, wenn es nicht mehr zum Speichern oder Schreiben von Daten benötigt wird. ~TMemoryStream ruft Clear auf und gibt damit den Speicherpuffer vor dem Aufruf des geerbten Destruktors frei.


Clear

Die Methode Clear gibt den Speicherpuffer frei. Dabei werden alle Daten verworfen, die dem Speicher-Stream zugeordnet sind.

void __fastcall Clear(void);

Beschreibung

Mit Clear wird der Speicherpuffer für den Stream geleert. Alle belegten Speicher-Ressourcen werden freigegeben. Zusätzlich führt Clear die folgenden Operationen aus:

•	Die Eigenschaft Memory wird auf NULL gesetzt.

•	Die Eigenschaft Position wird auf 0 gesetzt.

•	Die Eigenschaft Size wird auf 0 gesetzt.

•	Die Eigenschaft Capacity wird auf 0 gesetzt.


TMemoryStream::LoadFromFile

TMemoryStream	Siehe auch

Die Methode LoadFromFile stellt sicher, daß genügend Speicher für den gesamten Inhalt der angegebenen Datei reserviert ist. Anschließend wird die ganze Datei in den Speicherpuffer geladen.

void __fastcall LoadFromFile(const System::AnsiString FileName);

Beschreibung

Über LoadFromFile wird der Speicher-Stream mit dem Inhalt einer Datei gefüllt. Anwendungen können so den kompletten Inhalt einer Datei erfassen, ohne explizit ein Datei-Stream-Objekt erzeugen und freigeben zu müssen.

LoadFromFile paßt die Größe des Speicherpuffers exakt an den Inhalt der Datei an. Die Eigenschaften Size und Capacity werden entsprechend gesetzt, bevor die gesamte Datei in den Speicherpuffer gelangt. Deshalb verwirft LoadFromFile alle Daten, die sich bereits vorher im Speicher-Stream befanden.


TMemoryStream::LoadFromStream

TMemoryStream	Siehe auch

Die Methode LoadFromStream stellt sicher, daß genügend Speicher für den gesamten Inhalt eines anderen Streams reserviert ist. Anschließend wird der ganze Stream in den Speicherpuffer geladen.

void __fastcall LoadFromStream(TStream* Stream);

Beschreibung

Über LoadFromStream wird der Speicher-Stream mit dem Inhalt eines anderen Stream-Objekts gefüllt. LoadFromStream setzt die Eigenschaft Position des Quell-Streams auf 0 und liest dann die Anzahl von Bytes ein, die in der Eigenschaft Size des Quell-Streams vorgegeben ist.

LoadFromStream paßt die Größe des Speicherpuffers exakt an den Inhalt des Quell-Streams an. Die Eigenschaften Size und Capacity werden entsprechend gesetzt, bevor der gesamte Quell-Stream in den Speicherpuffer gelangt. Deshalb verwirft LoadFromStream alle Daten, die sich bereits vorher im Speicher-Stream befanden.

Wenn der Quell-Stream ein TFileStream-Objekt ist, hat LoadFromStream denselben Effekt wie LoadFromFile, mit dem Unterschied, daß die Anwendung das TFileStream-Objekt erzeugen und freigeben muß. LoadFromStream ermöglicht es Anwendungen außerdem, ein Speicher-Stream-Objekt aus anderen Typen von Stream-Objekten zu füllen.


TMemoryStream::Realloc

TMemoryStream	Siehe auch

Die Methode Realloc weist dem Speicherpuffer eine neue Größe zu und gibt einen Zeiger darauf zurück. Die neue Größe wird im Parameter NewCapacity festgelegt. Die Daten des vorherigen Speicherpuffers werden übernommen, soweit es die neue Kapazität zuläßt.

virtual void * __fastcall Realloc(long &NewCapacity);

Beschreibung

Rufen Sie Realloc nicht direkt auf, um den Speicherpuffer neu zu dimensionieren. Realloc setzt nämlich die Eigenschaft Memory nicht neu, so daß diese einen ungültigen Zeiger enthält. Verwenden Sie statt dessen die Eigenschaft Capacity. Durch eine Wertzuweisung an Capacity wird Realloc aufgerufen, und die Eigenschaften des Speicher-Stream-Objekts werden den Änderungen entsprechend angepaßt.

Hinweis

Die Methode LoadFromStream dimensioniert den Speicherpuffer ebenfalls neu, allerdings gehen dabei alle Daten verloren, die sich bereits im Speicher-Stream befinden.


TMemoryStream::SetSize

TMemoryStream	Siehe auch

Die Methode SetSize setzt die Eigenschaft Size des Speicher-Streams.

void __fastcall SetSize(long NewSize);

Beschreibung

Mit SetSize legt man die Größe eines Speicher-Streams fest, bevor dieser mit Daten gefüllt wird. Maßgebend ist der Wert des Parameters NewSize. Vor der Reservierung wird der aktuelle Inhalt von Memory verworfen. Der Speicherpuffer muß somit nicht freigegeben werden. SetSize aktualisiert die Eigenschaften Capacity und Size.

SetSize wird aufgerufen, bevor der Speicher-Stream mit Daten aus verschiedenen Quellen oder mit dem Teilinhalt eines anderen Streams gefüllt wird. Wenn der vorgesehene Inhalt des Streams exakt mit dem Inhalt eines anderen Streams oder einer Datei übereinstimmt, verwenden Sie statt dessen die Methoden LoadFromStream oder LoadFromFile.


TMemoryStream::TMemoryStream

TMemoryStream

TMemoryStream erzeugt ein neues TMemoryStream-Objekt.

__fastcall TMemoryStream(void);


TMemoryStream::Write

TMemoryStream	Siehe auch

Die Methode Write schreibt die mit Count vorgegebene Anzahl von Bytes aus dem Puffer (Buffer) an die aktuelle Position im Speicherpuffer und aktualisiert dann die Position auf Basis von Count.

__property long Capacity;

Beschreibung

Mit Write werden, beginnend an der aktuellen Position, so viele Bytes in den Speicherpuffer des Streams geschrieben, wie in Count vorgegeben. Falls nötig, wird der Speicherpuffer dabei vergrößert. Alle Daten, die nach der aktuellen Position (Startposition) stehen, werden überschrieben, wenn der Vorgang nicht am Ende des Speicherpuffers startet.

Write aktualisiert die Eigenschaft Capacity, wenn für die neuen Daten zusätzlicher Speicher belegt werden mußte. Die Eigenschaft Size wird mit dem Wert Position + Count aktualisiert, und Position wiederum erhält den neuen Wert von Size. Somit gehen bei einem Aufruf von Write alle Daten verloren, die im Speicher-Stream nach der aktuellen Position gespeichert waren.

Write schreibt immer die in Count festgelegte Anzahl von Bytes in den Puffer, wenn kein Speicherfehler auftritt. Demnach ist Write für ein TMemoryStream-Objekt das Äquivalent zur Methode WriteBuffer.

Alle anderen Methoden eines Speicher-Streams zum Schreiben von Daten (WriteBuffer, WriteComponent) rufen Write für den eigentlichen Schreibvorgang auf.


Gültigkeitsbereich

Protected

Zugriff

Read-only


Gültigkeitsbereich

Protected


Hierarchie

TObject

TStream

TCustomMemoryStream


TMemoryStream Beispiel

TMemoryStream


TMenu

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/menus.hpp

Eine Komponente der Klasse TMenu ist der abstrakte Basistyp für Menükomponenten wie TMainMenu und TPopupMenu.

Beschreibung

Zusätzlich zu den Merkmalen, die von der übergeordneten Klasse TComponent geerbt wurden, führt TMenu drei Eigenschaften und mehrere Methoden ein.


Eigenschaften von TMenu

TMenu	Alphabetisch	Legende

In TMenu

Handle

Items

WindowHandle

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Name

Owner

Tag


Eigenschaften von TMenu

TMenu	Nach Objekten	Legende

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

DesignInfo

Handle

Items

Name

Owner

Tag

WindowHandle


TMenu::Handle

TMenu	Siehe auch

Die Eigenschaft Handle bezeichnet das Handle für das Menü.

__property HMENU Handle;

Beschreibung

Mit der Eigenschaft Handle können Sie auf das Fenster-Handle des Menüs oder des Menüeintrags zugreifen. Somit können die Funktionen der Windows-API aufgerufen werden, für die ein Menü-Handle erforderlich ist.

Handle ist eine Nur-Lesen-Eigenschaft.


TMenu::Items

TMenu	Siehe auch

Die Eigenschaft bezeichnet einen Eintrag in einem Menü.

__property TMenuItem* Items;

Beschreibung

Bei Menüeinträgen können Sie mit der Array-Eigenschaft Items auf einen Eintrag (TMenuItem) anhand der Position in der Liste der Einträge zugreifen. Der Wert von Index bezeichnet die Position des Eintrags im Array Items. Enthält beispielsweise das Dropdown-Menü Datei in einer Anwendung die Einträge Neu, öffnen und Speichern in dieser Reihenfolge, bezieht sich MenüDatei.Items[2] auf den Eintrag Speichern. Bei Menüeinträgen gilt die Eigenschaft Items nur während der Laufzeit.

Bei Hauptmenüs können Sie mit der Eigenschaft Items auf einen Eintrag der Hauptmenüleiste zugreifen. Die Eigenschaft ist sowohl während der Entwurfszeit als auch während der Laufzeit verfügbar.

Bei Popup-Menüs können Sie mit der Eigenschaft Items auf einen Eintrag des Popup-Menüs zugreifen. Die Eigenschaft ist sowohl während der Entwurfszeit als auch zur Laufzeit verfügbar.


TMenu::WindowHandle

TMenu	Siehe auch

Mit der Eigenschaft WindowHandle können Sie auf dasselbe Fenster-Handle wie mit der Eigenschaft Handle zugreifen. Diese Eigenschaft ist jedoch geschützt und deshalb nur für den Code in der Komponente zugänglich.

__property HWND WindowHandle;

Beschreibung

Der Vorteil von WindowHandle ist, daß die Eigenschaft geändert werden kann, während Handle nur gelesen werden kann. Über WindowHandle können Sie somit einem bestehenden fensterorientierten Steuerelement ein neues Handle zuweisen. Außerdem wird durch einen Lesezugriff auf WindowHandle nicht automatisch ein gültiges Handle erstellt. Von der Zugriffsmethode für Handle wird mit HandleNeeded immer ein Handle erstellt, falls noch keines vorhanden ist. Ein Lesezugriff auf WindowHandle kann den Rückgabewert Null liefern.


Methoden von TMenu

TMenu	Alphabetisch

In TMenu

~TMenu

DispatchCommand

DispatchPopup

FindItem

GetHelpContext

IsShortCut

TMenu

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TMenu

TMenu	Nach Objekten

~TMenu

Assign

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

DestroyComponents

Destroying

DispatchCommand

DispatchPopup

Dispatch

FieldAddress

FindComponent

FindItem

FreeInstance

FreeNotification

Free

GetHelpContext

GetParentComponent

HasParent

InheritsFrom

InitInstance

InsertComponent

InstanceSize

IsShortCut

MethodAddress

MethodName

NewInstance

RemoveComponent

TMenu


TMenu::~TMenu

TMenu	Siehe auch

Der Destruktor ~TMenu gibt den Speicher frei, der für das TMenu-Objekt reserviert war. Rufen Sie ~TMenu nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TMenu automatisch aufgerufen wird.

__fastcall virtual ~TMenu(void);

Beschreibung

Mit ~TMenu wird die Eigenschaft Items freigegeben. Anschließend wird der Destruktor des übergeordneten Objekts aufgerufen.


TMenu::DispatchCommand

TMenu	Siehe auch

Die Methode DispatchCommand leitet die Auswahl eines Menüeintrags weiter.

bool __fastcall DispatchCommand(unsigned short ACommand);

Beschreibung

Die Methode DispatchCommand durchsucht das Menü nach dem Eintrag, dem der Befehl zugeordnet ist, der im Parameter ACommand übergeben wurde. Existiert ein solcher Eintrag, wird die Methode Click aufgerufen und der Wert True zurückgegeben. Andernfalls gibt DispatchCommand den Wert False zurück.


TMenu::DispatchPopup

TMenu	Siehe auch

Die Methode DispatchPopup leitet die Befehlsauswahl in einem Popup-Menü weiter.

bool __fastcall DispatchPopup(HMENU AHandle);

Beschreibung

Die Methode DispatchPopup durchsucht das Menü nach einem Eintrag, dessen Handle mit dem übereinstimmt, das in AHandle übergeben wurde. Existiert ein solcher Eintrag, wird die Methode Click aufgerufen und der Wert True zurückgegeben. Andernfalls gibt DispatchPopup den Wert False zurück.


TMenu::FindItem

TMenu	Siehe auch

Die Methode FindItem gibt einen Menüeintrag zurück.

TMenuItem* __fastcall FindItem(int Value, TFindItemKind Kind);

Beschreibung

Bei dem zurückgegebenen Menüeintrag handelt es sich entweder um ein Menü-Handle, einen Menübefehl oder um ein Tastenkürzel, das mit dem Wert des Parameters Value übereinstimmt. Der Parameter Kind kann einen der folgenden Werte annehmen:

Wert	Bedeutung

fkCommand	Nummer des Menüeintrags, der von der Windows-Botschaft WM_COMMAND verwendet wird

fkHandle	Menü-Handle

fkShortCut	Menü-Tastenkürzel


TMenu::GetHelpContext

TMenu	Siehe auch

Die Methode GetHelpContext gibt die Kontextnummer zurück, die dem Menü zugeordnet ist.

Classes::THelpContext __fastcall GetHelpContext(unsigned short Value, bool ByCommand);

Beschreibung

Geben Sie das zu suchende Menü als den Wert der Eigenschaft Value an. Hat ByCommand den Wert True, handelt es sich bei Value um die Eigenschaft Command eines Objekts der Klasse TMenuItem. Andernfalls ist Value der Wert der Eigenschaft Handle.


TMenu::IsShortCut

TMenu	Siehe auch

Die Methode IsShortCut ermittelt, ob eine von der Tastatur stammende Botschaft ein Tastenkürzel für einen Eintrag im Menü enthält.

bool __fastcall IsShortCut(Messages::TWMKey &Message);

Beschreibung

Die Methode IsShortCut decodiert die im Parameter Message übergebene Botschaft. Falls es sich um ein Tastenkürzel für einen Eintrag des Menüs handelt, wird die Methode Click dieses Eintrags aufgerufen und der Wert True zurückgegeben. Wurde keinem Eintrag ein der Meldung entsprechendes Tastenkürzel zugewiesen, gibt IsShortCut den Wert False zurück.


TMenu::TMenu

TMenu	Siehe auch

Erzeugt eine Instanz von TMenu.

__fastcall virtual TMenu(Classes::TComponent* AOwner);

Beschreibung

TMenu ruft die geerbte Version von TMenu auf. Anschließend werden die Anfangswerte der neuen Komponente eingestellt und das Array Items aufgebaut.


Gültigkeitsbereich

Published

Zugriff

Read-only


Hierarchie

TObject

TPersistent

TComponent


TMenu Beispiel

TMenu


TMenuItem

Hierarchie	Eigenschaften	Methoden	Ereignisse

Header

vcl/menus.hpp

Eine TMenuItem-Komponente enthält die Eigenschaften, Methoden und Ereignisse für jeden einzelnen Eintrag in einem Menü (TMainMenu oder TPopupMenu).

Beschreibung

Jede TMainMenu- oder TPopupMenu-Komponente kann mehrere Menüeinträge enthalten. Während der Entwicklung eines Menüs im Menü-Designer erstellen Sie für jeden Befehl im Menü ein Menüeintragobjekt.

Wenn der Benutzer einen Befehl aus einem Menü wählt, wird das Ereignis OnClick für den betreffenden Menüeintrag ausgelöst.

Der im Menü angezeigte Text wird als Titel (Eigenschaft Caption) eines Menüeintrags bezeichnet. Über den Titel kann ein Tastenkürzel für den Menüeintrag definiert oder eine Trennlinie zur Unterteilung des Menüs eingefügt werden. Mit Hilfe der Eigenschaft ShortCut können Sie einem Menüeintrag ein Tastenkürzel zuweisen.

Die Eigenschaft Items ermöglicht den Zugriff auf einen Untereintrag des aktuellen Menüeintrags.

Mit Hilfe der Eigenschaft Checked kann, entsprechend der Auswahl des Benutzers, neben einem Menüeintrag ein Häkchen ein- und ausgeblendet werden. Zur Deaktivierung eines Menüeintrags setzen Sie seine Eigenschaft Enabled auf False. Der Eintrag wird dann grau angezeigt und kann vom nicht Benutzer ausgewählt werden. Mit der Methode Click kann ein Klick des Benutzers auf einen Menüeintrag simuliert werden. Wenn Sie ein Menü mit sehr vielen Optionen erstellen, können Sie es mit Hilfe der Eigenschaft Break in zwei oder mehr Spalten aufgliedern.

Es besteht die Möglichkeit, die Menüs mehrerer Formulare miteinander zu kombinieren. Verwenden Sie dazu die Eigenschaft GroupIndex der Menüeinträge zusammen mit der Eigenschaft AutoMerge oder den Methoden Merge und Unmerge eines Hauptmenüs (TMainMenu).

Mit den Methoden Insert und Remove können Menüeinträge zur Laufzeit eingefügt und entfernt werden.

Neben den genannten Eigenschaften, Methoden und Ereignissen verfügt TMenuItem auch über die Eigenschaften und Methoden, die allen Komponenten gemeinsam sind.


Eigenschaften von TMenuItem

TMenuItem	Alphabetisch	Legende

In TMenuItem

Break

Caption

Checked

Command

Count

Default

Enabled

GroupIndex

Handle

HelpContext

Hint

Items

MenuIndex

Parent

RadioItem

ShortCut

Visible

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Name

Owner

Tag


Eigenschaften von TMenuItem

TMenuItem	Nach Objekten	Legende

Break

Caption

Checked

Command

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

Count

Default

DesignInfo

Enabled

GroupIndex

Handle

HelpContext

Hint

Items

MenuIndex

Name

Owner

Parent

RadioItem

ShortCut

Tag

Visible


TMenuItem::Break

TMenuItem

Die Eigenschaft Break teilt ein langes Menü in mehrere Spalten auf.

__property TMenuBreak Break;

Beschreibung

Die Eigenschaft Break kann folgende Werte annehmen:

Wert	Bedeutung

mbNone	Das Menü wird nicht in Spalten aufgeteilt.

mbBarBreak	Das Menü wird in eine weitere Spalte umbrochen. Der Menüeintrag erscheint am oberen Rand der neuen Spalte. Die beiden Spalten werden durch eine Linie voneinander abgetrennt.

mbBreak	Das Menü wird in eine weitere Spalte umbrochen. Der Menüeintrag erscheint am oberen Rand der neuen Spalte. Die beiden Spalten sind nur durch eine Leerraum voneinander getrennt.

Die Voreinstellung für Break lautet mbNone.


TMenuItem::Caption

TMenuItem	Beispiel

Die Eigenschaft Caption enthält den Text für den Menüeintrag.

__property System::AnsiString Caption;

Beschreibung

Wenn ein Zeichen im angegebenen String unterstrichen werden soll, stellen Sie ihm ein kaufmännisches Und (&) voran. Das unterstrichene Zeichen in einem Menüeintrag wird als Tastenkürzel bezeichnet. Der Benutzer kann den Menüeintrag auswählen, indem er die ALT-Taste gedrückt hält und das unterstrichene Zeichen eingibt. Als Vorgabe für Caption wird der Name der Komponente verwendet.

Mit Hilfe der Eigenschaft Caption kann eine Linie eingefügt werden, die das Menü in mehrere Teile zerlegt. Geben Sie dazu einfach einen Bindestrich (-) als Wert für die Eigenschaft Caption des betreffenden Menüeintrags an.


TMenuItem::Checked

TMenuItem	Beispiel

Die Eigenschaft Checked gibt an, ob ein Menüeintrag ausgewählt ist.

__property bool Checked;

Beschreibung

Wenn Checked auf True gesetzt wird, wird durch ein Häkchen neben dem Menüeintrag angezeigt, daß dieser ausgewählt ist. Hat Checked den Wert False, erscheint kein Häkchen neben dem Eintrag.


TMenuItem::Command

TMenuItem

Die Eigenschaft Command enthält die Befehlsnummer, die an Windows übergeben wird, sowie die Nummer, die in der von Windows an das Formular gesendeten Botschaft WM_COMMAND eintrifft, wenn der Benutzer den Menüeintrag auswählt.

__property unsigned short Command;

Beschreibung

Die Eigenschaft Command ist nur dann von Bedeutung, wenn WM_COMMAND-Botschaften direkt verarbeitet werden.

Beispiel

Die folgende Prozedur ist eine Routine zur Behandlung einer WM_COMMAND-Botschaft. Sie stellt durch eine Überprüfung des Feldes ItemID von Msg fest, ob die Botschaft von einem Menüeintrag namens MenuThink generiert wurde. Ist dies der Fall, wird ein Meldungsfeld eingeblendet. Denken Sie beim Schreiben von Botschaftsbehandlungsroutinen daran, daß ein abschließender Aufruf von Inherited erforderlich sein kann, um Windows die Standardverarbeitung von Botschaften zu ermöglichen.

__fastcall TForm1::WMCommand(TWMCommand &Msg) {

    if(Msg->ItemID == MenuThink->Command)

        MessageDlg("This is the Think command", mtInformation, TMsgDlgButtons() << mbOK, 0);

    TForm::WMCommand(Msg);

}


TMenuItem::Count

TMenuItem	Siehe auch

Die Eigenschaft Count enthält die Anzahl der Einträge in einem Menü.

__property int Count;

Beschreibung

In der Eigenschaft Count ist die Zahl der Einträge in einem Menü enthalten. Diese Eigenschaft zählt die Untereinträge, die zu einem Eintrag existieren. Bei den Untereinträgen kann es sich um Menüeinträge in einem Dropdown- oder Popup-Menü handeln, oder um die Einträge eines Untermenüs.

Angenommen, eine Menüleiste enthält den Eintrag Datei. Da dem Datei-Menü aber noch keine Befehle zugewiesen wurden, hat die Eigenschaft Count dieses Menüs den Wert 0. Wenn Sie nun die Befehle Neu und öffnen zum Menü Datei hinzufügen, hat die Eigenschaft Count den Wert 2. Da Neu und öffnen ebenfalls Menüeinträge darstellen, verfügen auch sie über eine Count-Eigenschaft. Solange ihnen aber keine Untermenüs zugeordnet werden, ist der Wert ihrer Count-Eigenschaft 0.


TMenuItem::Default

TMenuItem	Siehe auch

Mit der Eigenschaft Default kann ein Menüeintrag zum voreingestellten Eintrag gemacht werden. Dieser wird fett dargestellt und automatisch aufgerufen, wenn der Benutzer doppelt auf den übergeordneten Menüeintrag klickt.

__property TMenuItem* Items[int Index];

Beschreibung

Die Voreinstellung für Default lautet False.

Die Eigenschaft Default wird unter Windows 95 und Windows NT 3.51 nur dann wirksam, wenn die neue Benutzeroberfläche installiert ist.


TMenuItem::Enabled

TMenuItem	Siehe auch	Beispiel

Die Eigenschaft Enabled gibt an, ob ein Menüeintrag aktiviert ist und ausgewählt werden kann.

__property bool Enabled;

Beschreibung

Wenn Enabled den Wert True hat, ist der Menüeintrag aktiviert. Ist Enabled auf False gesetzt, wird der Eintrag grau dargestellt und kann vom Benutzer nicht ausgewählt werden.


TMenuItem::GroupIndex

TMenuItem	Siehe auch

Die Eigenschaft GroupIndex legt fest, wie Menüs miteinander kombiniert werden.

__property unsigned char GroupIndex;

Beschreibung

Bei Anwendungen mit mehreren Formularen ist es oft wünschenswert, daß sich das Hauptmenü in Abhängigkeit vom aktiven Formular ändert. Anstatt die Eigenschaft GroupIndex einzusetzen, könnten Sie auch für jedes Formular ein eigenes Menü entwerfen. MDI-Anwendungen kombinieren die Menüs untergeordneter Fenster immer mit dem Hauptmenü des übergeordneten Fensters. Über die Eigenschaft GroupIndex der einzelnen Menüeinträge kann festgelegt werden, auf welche Weise die Menüs miteinander kombiniert werden. Sie können wählen, ob die Menüeinträge in die Menüleiste eingefügt werden, oder ob bereits vorhandene ersetzt werden.

Jedem Menüeintrag ist ein eigener Wert für die Eigenschaft GroupIndex zugeordnet. Per Vorgabe haben alle Einträge innerhalb einer Menüleiste denselben GroupIndex-Wert. Dieser kann allerdings geändert werden. Der GroupIndex-Wert eines Menüeintrags, der in der Menüleiste auf einen anderen folgt, muß größer oder gleich dem des vorhergehenden Eintrags sein.

Menüeinträge in einer Menüleiste ersetzen

Besitzt ein Menüeintrag in der Menüleiste eines Formulars, das nicht das Hauptformular ist, denselben GroupIndex-Wert wie ein Eintrag in der Menüleiste des Hauptformulars, wird bei der Aktivierung des Formulars der betreffende Eintrag in der Menüleiste des Hauptformulars ersetzt.

Falls mehrere Einträge in der Menüleiste des Hauptformulars denselben GroupIndex-Wert aufweisen, und alle Einträge des anderen Formulars ebenfalls denselben GroupIndex-Wert haben, werden alle Einträge in der Menüleiste des Hauptformulars durch die Einträge des zweiten Formulars ersetzt, sobald dieses aktiviert wird.

Angenommen, die Menüleiste von Formular1 enthält drei Einträge: Eins, Zwei und Drei. Allen ist ein GroupIndex-Wert von 0 zugeordnet. Formular2 besitzt eine Menüleiste mit einen Menüeintrag namens Vier, der ebenfalls den GroupIndex-Wert 0 hat. Wird nun Formular2 aktiviert, erscheint nur der Menüeintrag Vier in der Menüleiste von Formular1.

Menüeinträge in eine Menüleiste einfügen

Besitzen ein oder mehrere Menüeinträge in der Menüleiste eines Formulars, das nicht das Hauptformular ist, einen GroupIndex-Wert, der größer ist als der eines Eintrags in der Menüleiste des Hauptformulars, werden diese Einträge bei einer Kombination der Menüs in die Menüleiste des Hauptformulars eingefügt. Ist der GroupIndex-Wert des Eintrags größer als der GroupIndex-Wert aller Einträge in der Menüleiste des Hauptformulars, erscheint der Eintrag am Ende des Menüs. Liegt der GroupIndex-Wert eines Eintrags zwischen dem anderer Einträge in der Menüleiste des Hauptformulars, wird der Eintrag (in Abhängigkeit von seinem Wert) zwischen die anderen Einträge eingefügt.

Beispielsweise wird ein Menüeintrag mit einem GroupIndex-Wert von 2 zwischen die Einträge mit den GroupIndex-Werten 1 und 3 eingefügt. Ein Eintrag mit dem GroupIndex-Wert 4 erscheint in diesem Fall nach allen anderen Einträgen.

Hinweis

Der GroupIndex-Wert des einzufügenden Menüeintrags darf nicht mit dem der anderen Einträge in der Menüleiste des Hauptformulars identisch sein. Ist dies doch der Fall, werden alle Einträge mit demselben GroupIndex-Wert durch den neuen Eintrag ersetzt.

Menüs in OLE-Anwendungen

Wenn Sie ein Objekt aktivieren, das von einer OLE 2.0-Server-Anwendung erstellt wurde, versucht der Server möglicherweise, seine eigenen Menüs mit denen der Container-Anwendung zu kombinieren. Die GroupIndex-Eigenschaften der einzelnen Menüs in der Container-Anwendung bestimmen, an welcher Stelle der Container-Menüleiste die eingefügten Menüeinträge erscheinen. Menüeinträge, die vom OLE-Server übernommen werden, können die Einträge in der Hauptmenüleiste ersetzen oder zusätzlich zu diesen angezeigt werden.

Hinweis

Lesen Sie in der Dokumentation des verwendeten OLE-Servers nach, ob dieser versucht, Menüs während der Inplace-Aktivierung zu kombinieren.

Der OLE-Server kann bis zu drei Gruppen von Menüeinträgen miteinander kombinieren. Jede Gruppe verfügt über einen eindeutigen Index und kann eine beliebige Anzahl von Menübefehlen enthalten. Die folgende Tabelle faßt diese Menüeintragsgruppen zusammen:

Gruppe	Index	Beschreibung

Bearbeiten	1	Einer oder mehrere Menüeinträge des Servers zur Bearbeitung des aktiven OLE-Objekts.

Ansicht	3	Einer oder mehrere Menüeinträge des Servers zur Änderung der Ansicht des OLE-Objekts.

Hilfe	5	Einer oder mehrere Menüeinträge des Servers zum Zugriff auf die Hilfefunktionen des Servers.

Menüeinträge der Container-Anwendung, deren Werte für die GroupIndex-Eigenschaft 1, 3 oder 5 lauten, werden durch Menüeinträge aus der OLE-Server-Anwendung ersetzt, welche dieselben Indexwerte aufweisen. Alle Menüeinträge des OLE-Containers, die keinen GroupIndex-Wert von 1, 3 oder 5 aufweisen, werden nicht durch die entsprechenden Menüeinträge des Servers ersetzt.

Hinweis

TMenuItem-Objekte, deren Eigenschaft RadioItem auf True gesetzt ist, verhalten sich wie Optionsfelder. Die Aktivierung eines Optionsfeldes hat zur Folge, daß die Markierung von allen anderen Optionsfeldern derselben GroupIndex-Gruppe entfernt wird. In Windows 95 und in Windows NT mit der Windows 95-Shell wird zur Darstellung dieser Menüeinträge nicht das Häkchen, sondern ein Punkt verwendet. Diese gilt allerdings nur für TMenuItem-Objekte, die Bestandteil eines TPopupMenu-Objekts oder ein Untermenü eines TMainMenu-Objekts sind.


TMenuItem::Handle

TMenuItem	Beispiel

Die Eigenschaft Handle ermöglicht den Zugriff auf das Windows-Handle des Menüeintrags.

__property HMENU Handle;

Beschreibung

Verwenden Sie Handle bei einem Aufruf einer Windows-API-Funktion, die ein Handle erfordert.

Beispiel

Der folgende Code sorgt mit Hilfe der Windows-API-Funktion HiliteMenuItem für die Hervorhebung des ersten Menüeintrags in MainMenu1 von Form1.$$


TMenuItem::HelpContext

TMenuItem	Siehe auch

Die Eigenschaft HelpContext stellt eine Kontextnummer für einen Menüeintrag bereit. Über diese Nummer kann kontextsensitive Hilfe aufgerufen werden.

__property Classes::THelpContext HelpContext;

Beschreibung

Jedem Bildschirm des Hilfesystems sollte eine eindeutige Kontextnummer zugewiesen werden. Wenn eine Komponente in der Anwendung ausgewählt ist, führt das Drücken von F1 zur Anzeige eines Hilfebildschirms. Der Wert der Eigenschaft HelpContext bestimmt, welcher Hilfebildschirm eingeblendet wird.


TMenuItem::Hint

TMenuItem	Siehe auch	Beispiel

Die Eigenschaft Hint legt den String fest, der beim Eintreten des Ereignisses OnHint einer Anwendung eingeblendet wird. Dieses Ereignis tritt ein, wenn der Benutzer den Mauszeiger über einen Menüeintrag bewegt.

__property System::AnsiString Hint;

Beschreibung

Der Code in der Behandlungsroutine für das Ereignis OnHint legt fest, wie der String angezeigt wird. Weitere Informationen finden Sie bei der Eigenschaft TControl::Hint.


TMenuItem::Items

TMenuItem	Siehe auch

Die Eigenschaft Items ermöglicht den Zugriff auf den Untereintrag eines Menüeintrags.

__property TMenuItem* Items[int Index];

Beschreibung

Mit Hilfe der Array-Eigenschaft Items kann auf einen Untereintrag eines Menüeintrags (TMenuItem) zugegriffen werden. Dieser Zugriff erfolgt über die Position des Untereintrags in der Liste der Untereinträge. Der Wert von Index bezeichnet die Position des Untereintrags im Items-Array. Wenn eine Anwendung beispielsweise ein Dropdown-Menü für den Eintrag Datei besitzt, das die Menüeinträge Neu, öffnen und Speichern (in dieser Reihenfolge) enthält, bezieht sich FileMenu::Items[2] auf den Befehl Speichern.

Beispiel

Der folgende Code deaktiviert alle Untereinträge von MenuItem1:

for(int i = 0;i < MenuItem1->ItemCount-1;i++)

    MenuItem1->Items[i]->Enabled = False;


TMenuItem::MenuIndex

TMenuItem	Siehe auch

Die Eigenschaft MenuIndex bezeichnet den Index des Menüeintrags, den dieser innerhalb seines übergeordneten Menüs besitzt.

__property int MenuIndex;

Beschreibung

Durch die Änderung dieses Wertes kann die Position eines Eintrags in seinem übergeordneten Menü geändert werden.


TMenuItem::Parent

TMenuItem	Siehe auch	Beispiel

Die Eigenschaft Parent bezeichnet das Menü, das dem Menüeintrag übergeordnet ist.

__property TMenuItem* Parent;

Beschreibung

Mit Hilfe von Parent legen Sie das Menü fest, in dem der Menüeintrag enthalten ist.


TMenuItem::RadioItem

TMenuItem	Siehe auch

Die Eigenschaft RadioItem legt fest, wie das Zeichen aussieht, mit dem ein ausgewählter Menüeintrag kenntlich gemacht wird.

__property bool RadioItem;

Beschreibung

Wenn RadioItem den Wert True hat, wird zur Anzeige eines ausgewählten (markierten) Menüeintrags nicht das Häkchen, sondern ein Punkt verwendet. Die Auswahl eines Eintrags führt dazu, daß die Markierung (der Punkt) von allen anderen Einträgen mit demselben GroupIndex-Wert entfernt wird.

Hinweis

Der Punkt wird unter Windows 95 und Windows NT 3.51 nur dann angezeigt, wenn die neue Benutzeroberfläche installiert ist.


TMenuItem::ShortCut

TMenuItem	Siehe auch

Mit der Eigenschaft ShortCut werden die Tastenanschläge festgelegt, über die der Benutzer direkt auf einen Menüeintrag zugreifen kann.

__property TShortCut ShortCut;

Beschreibung

Die Tastenkombination zum Aufruf des Befehls wird rechts neben dem Eintrag im Menü angezeigt. Das Borland C++Builder-Menü Bearbeiten enthält beispielsweise einige Menütastenkürzel. Wenn Sie das Menü öffnen, sehen Sie rechts neben einigen Bearbeitungsbefehlen die betreffenden Tastenkombinationen.

Normalerweise legen Sie die Tastenkürzel für Menüeinträge im Objektinspektor fest. Dort wird Ihnen eine längere Liste zur Auswahl angeboten. Sie können aber auch Tastenkürzel für Menüeinträge definieren, die zur Laufzeit erstellt werden. Wenn Sie die folgenden Funktionen oder Routinen auswählen, erhalten Sie weitere Informationen über die Verwendung von Tastenkürzeln zur Laufzeit:

Routine	Zweck

ShortCut
(Routine)	Erzeugt ein Tastenkürzel für einen Menüeintrag im Programm.

ShortCutToKey (Routine)	Ermittelt den virtuellen Tastencode und den Umschalt-Status für ein vorhandenes Tastenkürzel.

ShortCutToText (Routine)	Liefert den Text-String eines vorhandenen Tastenkürzels zurück. Mit dieser Funktion können Sie ein Tastenkürzel anzeigen, das zur Laufzeit für einen Menüeintrag erstellt wurde.

TextToShortCut (Routine)	Konvertiert einen String in ein Tastenkürzel. Mit dieser Funktion ermöglichen Sie dem Benutzer die Festlegung der Tastenkombination.

Beispiel

Der folgende Code erzeugt zur Laufzeit das Tastenkürzel STRG+C und weist es dem Befehl Schließen im Menü Datei zu.

CloseCommand->ShortCut = ShortCut(Word('C'), TShiftState() << ssCtrl);


TMenuItem::Visible

TMenuItem	Siehe auch	Beispiel

Die Eigenschaft Visible bestimmt, ob ein Menüeintrag in einem Menü sichtbar ist.

__property bool Visible;

Beschreibung

Wenn Visible den Wert True hat, wird der Menüeintrag angezeigt. Ist Visible False, wird der Eintrag ausgeblendet und kann vom Benutzer nicht ausgewählt werden.


Ereignisse von TMenuItem

TMenuItem	Alphabetisch	Legende

In TMenuItem

OnClick


Ereignisse von TMenuItem

TMenuItem	Nach Objekten	Legende

OnClick


TMenuItem::OnClick

TMenuItem	Siehe auch	Beispiel

Das Ereignis OnClick tritt ein, wenn der Benutzer auf einen Menüeintrag klickt.

__property Classes::TNotifyEvent OnClick;

Beschreibung

Dieses Ereignis kann auch ausgelöst werden, wenn die Methode Click aufgerufen wird.


Methoden von TMenuItem

TMenuItem	Alphabetisch

In TMenuItem

~TMenuItem

Add

Click

Delete

IndexOf

Insert

Remove

TMenuItem

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TMenuItem

TMenuItem	Nach Objekten

~TMenuItem

Add

Assign

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

Click

DefaultHandler

Delete

DestroyComponents

Destroying

Dispatch

FieldAddress

FindComponent

FreeInstance

FreeNotification

Free

GetParentComponent

HasParent

IndexOf

InheritsFrom

InitInstance

InsertComponent

Insert

InstanceSize

MethodAddress

MethodName

NewInstance

RemoveComponent

Remove

TMenuItem


TMenuItem::~TMenuItem

TMenuItem	Siehe auch

Der Destruktor ~TMenuItem gibt den Speicher frei, der für das TMenuItem-Objekt reserviert war. Rufen Sie ~TMenuItem nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TMenuItem automatisch aufgerufen wird.

__fastcall virtual ~TMenuItem(void);

Beschreibung

~TMenuItem gibt die Liste der Menüeinträge (Eigenschaft Items) frei und ruft dann den Destruktor des übergeordneten Objekts auf.


TMenuItem::Add

TMenuItem	Siehe auch

Die Methode Add fügt einen Menüeintrag an das Ende eines Menüs an.

void __fastcall Add(TMenuItem* Item);

Beschreibung

Der einzufügende Menüeintrag muß als Wert des Parameters Item angegeben werden.

Beispiel

Der folgende Code fügt einen Eintrag zum Menü Datei hinzu:

__fastcall Form1::Button1Click(TSender *Sender) {

  TMenuItem *NewItem=new TMenuItem();

  NewItem->Caption = "New item";

  File->Add(NewItem);

  delete NewItem;

}


TMenuItem::Click

TMenuItem	Siehe auch

Die Methode Click simuliert einen Mausklick.

virtual void __fastcall Click(void);

Beschreibung

Mit der Methode Click kann ein Mausklick simuliert werden. Dies entspricht dem Klicken des Benutzers auf einen Menüeintrag und führt zur Ausführung des Codes, der mit dem Ereignis OnClick verbunden ist.


TMenuItem::Delete

TMenuItem	Siehe auch

Die Methode Delete entfernt einen Menüeintrag.

void __fastcall Delete(int Index);

Beschreibung

Die Methode Delete entfernt den im Parameter Index übergebenen Eintrag aus einem Menü.

Die Indexnumerierung beginnt bei 0, d.h. der erste Eintrag hat den Wert 0, der zweite den Wert 1 usw.

Falls zu dem entfernten Eintrag ein Untermenü gehört, werden die darin enthaltenen Einträge ebenfalls entfernt.

Beispiel

Im folgenden Code ist FileMenu ein Menü mit vier Einträgen (Menübefehlen). Sie lauten Neu, öffnen, Speichern und Speichern unter und sind in dieser Reihenfolge angeordnet. Die folgende Ereignisbehandlungsroutine löscht den Befehl Speichern aus dem Menü:

__fastcall TForm1::Button1Click(TObject *Sender) {

  FileMenu->Delete(2);

}


TMenuItem::IndexOf

TMenuItem

Die Methode IndexOf liefert die Position eines Eintrags in einem Menü zurück.

int __fastcall IndexOf(TMenuItem* Item);

Beschreibung

Die erste Position in einem Menü ist 0. Wenn der angegebene Menüeintrag nicht in dem Menü enthalten ist, gibt IndexOf -1 zurück.


TMenuItem::Insert

TMenuItem	Siehe auch

Die Methode Insert fügt einen Eintrag in ein Menü ein.

void __fastcall Insert(int Index, TMenuItem* Item);

Beschreibung

Mit der Methode Insert kann ein Menüeintrag an der mit Index angegebenen Position in ein Menü eingefügt werden.

Beispiel

In diesem Beispiel wird nach dem ersten Eintrag des Menüs FileMenu ein neuer Eintrag eingefügt:

__fastcall TForm1::Button1Click(TObject *Sender) {

    auto_ptr<TMenuItem> NewItem(new TMenuItem(Sender));

    NewItem->Create(FileMenu);

    NewItem->Caption = "Do this";

    FileMenu->Insert(1, NewItem);

}


TMenuItem::Remove

TMenuItem	Siehe auch

Remove entfernt einen Menüeintrag aus der Eigenschaft Items.

Beschreibung

void __fastcall Remove(TMenuItem* Item);

Der zu entfernende Menüeintrag muß als Wert des Parameters Item angegeben werden.


TMenuItem::TMenuItem

TMenuItem	Siehe auch

Der Konstruktor TMenuItem erzeugt ein neues TMenuItem-Objekt.

__fastcall virtual TMenuItem(Classes::TComponent* AOwner);

Beschreibung

TMenuItem ruft den Konstruktor des übergeordneten Objekts auf und initialisiert anschließend den Menüeintrag.


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent


TMenuItem Beispiel

TMenuItem


TMetafile

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/graphics.hpp

TMetafile kapselt Win32 Enhanced Metafile-Grafiken.

Beschreibung

TMetafile enthält eine Metafile-Grafik (Dateiformat EMF).

Die Angabe der Höhe und Breite der Metafile-Grafik erfolgt (in Pixel) in den Eigenschaften Height und Width.

Wenn Sie eine Metafile-Grafik auf einer Zeichenfläche zeichnen wollen, rufen Sie die Methode Draw bzw. StretchDraw eines TCanvas-Objekts auf und übergeben ein TMetafile-Objekt als Parameter. Die Eigenschaft Enhanced legt fest, wie die Metafile-Grafik auf dem Datenträger gespeichert wird. Wenn Enhanced den Wert True hat, wird die Metafile-Grafik als EMF-Datei (Win32 Enhanced Metafile) gespeichert. Ist Enhanced False, wird sie als WMF-Datei (Windows 3.1 Metafile mit Aldus-Header) gespeichert.

Breite und Höhe des Metafile-Bildes werden in den Eigenschaften MMWidth bzw. MMHeight angegeben. Die Angabe erfolgt in Einheiten von 0,01 Millimeter (der ursprünglichen Maßeinheit für Enhanced Metafiles). Die Eigenschaft Inch gibt die Einheiten pro Zoll an, die in einer WMF-Datei verwendet werden. Sie wird verwendet, um die Skalierung bei der Speicherung als WMF-Datei zu ändern, ist sonst aber nicht mehr gebräuchlich. Enhanced Metafiles verwalten die Skalierungsinformationen intern.

Die Eigenschaft CreatedBy enthält optional den Namen des Erstellers der Datei. Die Eigenschaft Description enthält eine optionale, in die Metafile-Grafik eingebettete Beschreibung. Mit Hilfe der Methode CreateWithComment von TMetafileCanvas können Sie die CreatedBy- und Description-Strings für eine neue Metafile-Grafik festlegen.

Wenn die Metafile-Grafik geändert wird, tritt ein OnChange-Ereignis ein.


Eigenschaften von TMetafile

TMetafile	Alphabetisch	Legende

In TMetafile

CreatedBy

Description

Empty

Enhanced

Handle

Height

Inch

MMHeight

MMWidth

Palette

Abgeleitet von TGraphic

Modified

Width


Eigenschaften von TMetafile

TMetafile	Nach Objekten	Legende

CreatedBy

Description

Empty

Enhanced

Handle

Height

Inch

MMHeight

MMWidth

Modified

Palette

Width


TMetafile::CreatedBy

TMetafile	Siehe auch

Die Eigenschaft CreatedBy ermittelt den optionalen Namen des Autors der Metafile-Grafik bzw. der Anwendung, mit der sie erstellt wurde. Diese Information ist in die Metafile-Grafik eingebettet.

__property System::AnsiString CreatedBy;

Beschreibung

Durch einen Aufruf der Methode CreateWithComment von TMetafileCanvas können Sie den CreatedBy-String für eine neue Metafile-Grafik festlegen.


TMetafile::Description

TMetafile	Siehe auch

Die Eigenschaft Description enthält eine optionale, in die Metafile-Grafik eingebettete Beschreibung.

__property System::AnsiString Description;

Beschreibung

Durch einen Aufruf der Methode CreateWithComment von TMetafileCanvas können Sie den Description-String für eine neue Metafile-Grafik festlegen.


TMetafile::Empty

TMetafile

Die Eigenschaft Empty gibt an, ob das Metafile-Objekt eine Metafile-Grafik enthält.

Beschreibung

Wenn keine Metafile-Grafik in das Metafile-Objekt geladen wurde, hat Empty den Wert True. Enthält das Metafile-Objekt eine Metafile-Grafik, ist Empty False.


TMetafile::Enhanced

TMetafile

Die Eigenschaft Enhanced legt fest, wie die Metafile-Grafik auf dem Datenträger gespeichert wird.

__property bool Enhanced;

Beschreibung

Wenn Enhanced den Wert True hat (Standard), wird die Metafile-Grafik im EMF-Format (Win32 Enhanced Metafile) gespeichert. Ist Enhanced False, wird sie als WMF-Datei (Windows 3.1 Metafile mit Aldus-Header) gespeichert. Im Speicher besitzt die Datei immer das Format EMF.  Die Möglichkeiten des WMF-Formats sind sehr beschränkt. Beim Speichern in diesem Format gehen Informationen verloren, die im EMF-Format erhalten bleiben. Beim Laden einer Metafile-Grafik aus einem Stream bzw. einer Datei wird die Eigenschaft Enhanced auf den Wert des Metafile-Typs gesetzt. Dadurch ist für 16-Bit-C++Builder die Kompatibilität mit Formulardateien gewährleistet. Eine Datei, die im WMF-Format geladen wird, muß auch wieder in diesem Format gespeichert werden.

Wenn Enhanced den Wert True hat, wird die Metafile-Grafik als EMF-Datei (Win32 Enhanced Metafile) gespeichert. Ist Enhanced False, wird sie als WMF-Datei (Windows 3.1 Metafile mit Aldus-Header) gespeichert.


TMetafile::Handle

TMetafile	Beispiel

Die Eigenschaft Handle stellt ein Windows-GDI-Metafile-Handle zur Verfügung und ermöglicht damit den Zugriff auf das GDI-Metafile-Objekt.

__property int Handle;

Beschreibung

Verwenden Sie Handle bei einem Aufruf einer Windows-API-Funktion, für die das Handle eines Metafile-Objekts benötigt wird. Das Handle muß von der Eigenschaft Handle des Metafile-Objekts an die Funktion übergeben werden.


TMetafile::Height

TMetafile	Siehe auch	Beispiel

Die Eigenschaft Height gibt das vertikale Maß der Metafile-Grafik in Pixel an.

Beschreibung

Mit der Eigenschaft Height kann die Höhe einer Metafile-Grafik ermittelt oder festgelegt werden.


TMetafile::Inch

TMetafile

Die Eigenschaft Inch gibt die Anzahl der Pixel pro Zoll zurück, die für die Koordinatenzuordnung in der Metafile-Grafik verwendet wird.

__property unsigned short Inch;

Beschreibung

Verwenden Sie die Eigenschaft Inch, um die Koordinatenzuordnung der Metafile-Grafik in Pixel pro Zoll zu ermitteln.

Wenn die Metafile-Grafik beispielsweise in einem Twips-Koordinatensystem erstellt wurde (MM_TWIPS-Zuordnung), hat Inch den Wert 1440.


TMetafile::MMHeight

TMetafile	Siehe auch

Die Eigenschaft MMHeight enthält die Höhe der Metafile-Grafik in Einheiten von 0,01 Millimeter. Dies ist die ursprüngliche Maßeinheit für Enhanced Metafiles.

__property int MMHeight;

Beschreibung

Die Angabe der Eigenschaft MMHeight erfolgt immer in Pixeleinheiten für Bildschirmgeräte. Verwenden Sie MMHeight zum Festlegen oder Lesen der Maße in Millimeter, um Präzisionsverluste bei einer Konvertierung zwischen Pixeleinheiten für Bildschirmgeräte und Millimeter zu vermeiden.

Breite und Höhe der Metafile-Grafik werden in den Eigenschaften MMWidth bzw. MMHeight angegeben. Die Angabe erfolgt in Einheiten von 0,01 Millimeter (der ursprünglichen Maßeinheit für Enhanced Metafiles). Die Eigenschaft Inch gibt die Einheiten pro Zoll an, die in einer WMF-Datei verwendet werden. Sie wird verwendet, um die Skalierung beim Speichern als WMF-Datei zu ändern, ist sonst aber nicht mehr gebräuchlich. Enhanced Metafiles verwalten die Skalierungsinformationen intern.


TMetafile::MMWidth

TMetafile	Siehe auch

Die Eigenschaft MMWidth enthält die Breite der Metafile-Grafik in Einheiten von 0,01 Millimeter. Dies ist die ursprüngliche Maßeinheit für Enhanced Metafiles.

__property int MMWidth;

Beschreibung

Die Angabe der Eigenschaft MMWidth erfolgt immer in Pixeleinheiten für Bildschirmgeräte. Verwenden Sie MMWidth zum Festlegen oder Lesen der Maße in Millimeter, um Präzisionsverluste bei einer Konvertierung zwischen Pixeleinheiten für Bildschirmgeräte und Millimeter zu vermeiden.

Breite und Höhe der Metafile-Grafik werden in den Eigenschaften MMWidth bzw. MMHeight angegeben. Die Angabe erfolgt in Einheiten von 0,01 Millimeter (der ursprünglichen Maßeinheit für Enhanced Metafiles). Die Eigenschaft Inch gibt die Einheiten pro Zoll an, die in einer WMF-Datei verwendet werden. Sie wird verwendet, um die Skalierung beim Speichern als WMF-Datei zu ändern, ist sonst aber nicht mehr gebräuchlich. Enhanced Metafiles verwalten die Skalierungsinformationen intern.


TMetafile::Palette

TMetafile

Die Eigenschaft Palette steuert die Farbzuordnung einer Metafile-Grafik.

__property HPALETTE Palette;

Beschreibung

Die Eigenschaft Palette einer Metafile-Grafik enthält bis zu 256 Farben, die zur Anzeige der Metafile-Grafik auf dem Bildschirm eingesetzt werden können.

Wenn ein Bildschirmmodus mit 256 Farben verwendet und die Metafile-Grafik von einer Abbildung gezeichnet wird, die im Vordergrund läuft, werden alle Farben in der Eigenschaft Palette der Systempalette von Windows hinzugefügt. Wird die Metafile-Grafik von einer Anwendung gezeichnet, die im Hintergrund läuft, und hat eine andere Anwendung eigene Farben in die Systempalette eingefügt, werden die Farben der Metafile-Grafik Farben in der Systempalette zugeordnet. Wenn die Metafile-Grafik keine Palette besitzt, hat Palette den Wert 0. Sie können der Eigenschaft Palette auch eine selbstdefinierte Palette zuweisen, die mit CreatePalette erstellt wurde.


Ereignisse von TMetafile

TMetafile	Alphabetisch

Abgeleitet von TGraphic

OnChange


Ereignisse von TMetafile

TMetafile	Nach Objekten

OnChange


Methoden von TMetafile

TMetafile	Alphabetisch

In TMetafile

~TMetafile

Assign

Clear

LoadFromClipboardFormat

LoadFromStream

SaveToClipboardFormat

SaveToFile

SaveToStream

TMetafile

Abgeleitet von TGraphic

LoadFromFile

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TMetafile

TMetafile	Nach Objekten

~TMetafile

Assign

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

Clear

DefaultHandler

Dispatch

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

LoadFromClipboardFormat

LoadFromFile

LoadFromStream

MethodAddress

MethodName

NewInstance

SaveToClipboardFormat

SaveToFile

SaveToStream

TMetafile


TMetafile::~TMetafile

TMetafile

Der Destruktor ~TMetafile gibt den Speicher frei, der für das TMetafile-Objekt reserviert war. Rufen Sie ~TMetafile nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TMetafile automatisch aufgerufen wird.

__fastcall virtual ~TMetafile(void);


TMetafile::Assign

TMetafile

Diese Methode weist der Metafile-Grafik ein Objekt zu.

virtual void __fastcall Assign(Classes::TPersistent* Source);

Beschreibung

Mit der Methode Assign kann ein Objekt einem anderen Objekt zugewiesen werden. Die allgemeine Syntax für einen Aufruf von Assign sieht folgendermaßen aus:

Destination->Assign(Source);

Das Objekt Destination wird angewiesen, sich selbst den Inhalt des Objekts Source zuzuweisen:

Button1->Font = Button2->Font;

ListBox1->Items = Memo1->Lines;

Table1->Fields[0] = Query1->Fields[2];

Diese Anweisungen korrespondieren mit den folgenden:

Button1->Font->Assign(Button2->Font);

ListBox1->Items->Assign(Memo1->Lines);

Table1->Fields[0]->Assign(Query1->Fields[2]);

Welche Aktionen von der Methode Assign ausgeführt werden, hängt vom Typ von Destination und Source ab. Handelt es sich beispielsweise bei Destination und Source um Stringobjekte (TString), werden die in Source enthaltenen Strings in Destination kopiert. Sind Destination und Source Bitmap-Objekte (TBitmap), wird das in Source enthaltene Bitmap in Destination kopiert.

Zwar erlaubt es der Compiler, daß in einem Aufruf von Assign zwei beliebige TPersistent-Objekte verwendet werden, der Aufruf ist aber zur Laufzeit nur dann erfolgreich, wenn die betreffenden Objekte „wissen“, wie die Zuweisung durchgeführt werden muß. Ist Destination z.B. ein Schaltflächenobjekt (TButton) und Source ein Eingabefeld (TEdit), führt der Aufruf von Assign für diese Objekte zur Laufzeit zu einer EConvertError-Exception.

Es ist immer möglich, ein Objekt einem anderen Objekt desselben Typs zuzuweisen. Außerdem darf Source vom Typ TPicture sein, wenn die Eigenschaft Graphic des Bildes eine Metafile-Grafik bezeichnet.


TMetafile::Clear

TMetafile	Siehe auch

Die Methode Clear löscht die alte Metafile-Grafik.

void __fastcall Clear(void);

Beschreibung

Clear gibt die alte Metafile-Grafik frei, erzeugt ein neues Bild und erhöht den Referenzzähler.


TMetafile::LoadFromClipboardFormat

TMetafile

Die Methode LoadFromClipboardFormat lädt eine Metafile-Grafik aus der Zwischenablage.

virtual void __fastcall LoadFromClipboardFormat(unsigned short AFormat, int AData, HPALETTE APalette );

Beschreibung

LoadFromClipboardFormat ersetzt das aktuelle Bild durch die Daten, auf die der Parameter AData zeigt. Die Palette für die Metafile-Grafik wird im Parameter APalette angegeben. LoadFromClipboardFormat wird aufgerufen, wenn das TMetafile-Objekt mit Hilfe der Methode RegisterClipboardFormat für das TPicture-Objekt registriert wurde.


TMetafile::LoadFromStream

TMetafile

Die Methode LoadFromStream lädt eine Metafile-Grafik aus einem Stream.

virtual void __fastcall LoadFromStream(Classes::TStream* Stream);

Beschreibung

Geben Sie den Stream, aus dem die Metafile-Grafik kopiert werden soll, als Wert des Parameters Stream an.


TMetafile::SaveToClipboardFormat

TMetafile	Siehe auch

Die Methode SaveToClipboardFormat speichert eine Metafile-Grafik in einem Zwischenablageformat.

virtual void __fastcall SaveToClipboardFormat(unsigned short &AFormat, int &AData, HPALETTE &APalette );

Beschreibung

Die Palette wird im Parameter APalette angegeben, das Format im Parameter AFormat und die zu speichernden Daten im Parameter AData. Die Metafile-Grafik kann nur gespeichert werden, wenn die Anwendung das Format mit Hilfe der Methode RegisterClipboardFormat für das Metafile-Objekt registriert hat.

Verwenden Sie SaveToFile, wenn die Metafile-Grafik in einer Datei gespeichert werden soll.


TMetafile::SaveToFile

TMetafile	Siehe auch

Die Methode SaveToFile speichert die Metafile-Grafik in einer Datei.

virtual void __fastcall SaveToFile(const System::AnsiString Filename);

Beschreibung

Mit der Methode LoadFromFile können Sie eine Metafile-Grafik aus einer Datei laden.


TMetafile::SaveToStream

TMetafile

Die Methode SaveToStream speichert die Metafile-Grafik in einem Stream.

virtual void __fastcall SaveToStream(Classes::TStream* Stream);

Beschreibung

Geben Sie den Stream, in dem die Metafile-Grafik gespeichert werden soll, als Wert des Parameters Stream an.


TMetafile::TMetafile

TMetafile	Siehe auch

TMetafile ist der Konstruktor für ein Metafile-Objekt.

__fastcall virtual TMetafile(void);

Wenn Sie eine Metafile-Grafik neu erstellen wollen, zeichnen Sie sie auf einer Metafile-Zeichenfläche. Bei der Freigabe der Zeichenfläche wird das Bild in das Metafile-Objekt übertragen, das dem Konstruktor der Zeichenfläche übergeben wurde. Nach dem Zeichnen des Bildes und der anschließenden Freigabe der Zeichenfläche kann das Bild aus dem Metafile-Objekt abgerufen werden.


Zugriff

Read-only


Hierarchie

TObject

TPersistent

TGraphic


TMetafile Beispiel

TMetafile


TMetaFileCanvas

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/graphics.hpp

Mit dem TMetafileCanvas-Objekt können Anwendungen ein Metadatei-Bild von Grund auf erstellen.

Beschreibung

Das Objekt TMetafileCanvas wird als Oberfläche für das Zeichnen eines Metadatei-Bildes verwendet. Sobald die Zeichenfläche freigegeben wird, überträgt das Objekt das Bild in eine Metadatei, auf die der Konstruktor der Zeichenfläche zugreifen kann. Nachdem das Bild auf der Zeichenfläche dargestellt und diese freigegeben wurde, steht das Bild im Metadatei-Objekt bereit. Ein Beispiel:

TMetafile* MyMetafile;

TMetafileCanvas* MyCanvas;

MyMetafile = new TMetafile;

MyCanvas = new TMetafileCanvas(MyMetafile, 0);

MyCanvas->Brush->Color = clRed;

MyCanvas->Ellipse(0,0,100,100);

delete MyCanvas;

Form1->Canvas->Draw(0,0,MyMetafile);  // ein roter Kreis

Wenn zu einem bestehenden Metadatei-Bild etwas hinzugefügt werden soll, erzeugen Sie eine Metadatei-Zeichenfläche und stellen die Quell-Metadatei auf der Metadatei-Zeichenfläche dar:

MyCanvas = new TMetafileCanvas(MyMetafile, 0);

MyCanvas->Draw(0,0,MyMetafile);

MyCanvas->Brush->Color = clBlue;

MyCanvas->Ellipse(100,100,200,200);

delete MyCanvas;

Form1->Canvas->Draw(0,0,MyMetafile);  // ein roter und ein blauer Kreis

delete MyMetafile; // am Ende aufräumen


Eigenschaften von TMetaFileCanvas

TMetaFileCanvas	Alphabetisch	Legende

Abgeleitet von TCanvas

Brush

ClipRect

CopyMode

Font

Handle

Pen

PenPos

Pixels


Eigenschaften von TMetaFileCanvas

TMetaFileCanvas	Nach Objekten	Legende

Brush

ClipRect

CopyMode

Font

Handle

PenPos

Pen

Pixels


Ereignisse von TMetaFileCanvas

TMetaFileCanvas	Alphabetisch

Abgeleitet von TCanvas

OnChange

OnChanging


Ereignisse von TMetaFileCanvas

TMetaFileCanvas	Nach Objekten

OnChange

OnChanging


Methoden von TMetaFileCanvas

TMetaFileCanvas	Alphabetisch

Abgeleitet von TMetafileCanvas

~TMetafileCanvas

TMetafileCanvas

Abgeleitet von TCanvas

Arc

BrushCopy

Chord

CopyRect

Draw

DrawFocusRect

Ellipse

FillRect

FloodFill

FrameRect

LineTo

MoveTo

Pie

Polygon

Polyline

Rectangle

Refresh

RoundRect

StretchDraw

TextHeight

TextOut

TextRect

TextWidth

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TMetaFileCanvas

TMetaFileCanvas	Nach Objekten

~TMetafileCanvas

Arc

Assign

BrushCopy

Chord

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

CopyRect

DefaultHandler

Dispatch

DrawFocusRect

Draw

Ellipse

FieldAddress

FillRect

FloodFill

FrameRect

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

LineTo

MethodAddress

MethodName

MoveTo

NewInstance

Pie

Polygon

Polyline

Rectangle

Refresh

RoundRect

StretchDraw

TextHeight

TextOut

TextRect

TextWidth

TMetafileCanvas


TMetaFileCanvas::~TMetaFileCanvas
~TMetaFileCanvas

Der Destruktor ~TMetaFileCanvas gibt den Speicher frei, der für das TMetaFileCanvas-Objekt reserviert war. Rufen Sie ~TMetaFileCanvas nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TMetaFileCanvas automatisch aufgerufen wird.

__fastcall virtual ~TMetafileCanvas(void);

Beschreibung

~TMetafileCanvas setzt die Eigenschaft Handle des TMetaFile-Objekts, das dem Konstruktor übergeben wurde,. bevor der für das Objekt reservierte Speicher freigegeben wird.


TMetaFileCanvas::TMetaFileCanvas
TMetaFileCanvas

Die Methode TMetafileCanvas erzeugt eine Instanz von TMetafileCanvas und fordert ein Handle zu einem Metadatei-Gerätekontext an.

__fastcall TMetafileCanvas(TMetafile* AMetafile, HDC ReferenceDevice);

-oder-

__fastcall TMetafileCanvas(TMetafile* AMetafile, HDC ReferenceDevice, const System::AnsiString CreatedBy, const System::AnsiString Description);

Beschreibung

Mit TMetafileCanvas wird ein TMetafileCanvas-Objekt erzeugt und instantiiert. Die Größe des TMetafile-Objekts wird dabei vom Parameter ReferenceDevice übernommen, wenn die Eigenschaften MMHeight und MMWidth nicht bereits gesetzt sind. Anschließend erzeugt TMetafileCanvas einen Metadatei-Gerätekontext und setzt die Eigenschaft Handle entsprechend.

TMetafileCanvas kann auch einen Metadatei-Gerätekontext erzeugen, wobei die Strings CreatedBy und Description als Beschreibung dienen.

Alle nachfolgenden Zeichenmethoden richten ihre Ausgabe dann an diesen Metadatei-Gerätekontext.


Gültigkeitsbereich

Published

Zugriff

Read-only


Hierarchie

TObject

TPersistent

TCanvas


TMetaFileCanvas Beispiel

TMetaFileCanvas


TMetafileImage

Hierarchie	Methoden	Siehe auch

Header

vcl/graphics.hpp

TMetafileImage repräsentiert intern ein Metadateibild für ein TMetafile-Objekt.

Beschreibung

TMetafileImage wird nur in Borland C++Builder zu internen Implementierungszwecken verwendet. Sie stellt das das vom TMetafile-Objekt gekapselte, interne Bild der Metadatei dar. Alle Daten und Methoden, die im TMetafileImage-Objekt eingeführt werden, sind als private deklariert. Sie enthalten neben Informationen über das Metadateibild auch Zeiger auf die in Windows definierten Standardstrukturen HENHMETAFILE (erweitertes Metadatei-Handle) und HPALETTE (Paletten-Handle).


Methoden von TMetafileImage

TMetafileImage	Alphabetisch

In TMetafileImage

~TMetafileImage

TMetafileImage

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TMetafileImage

TMetafileImage	Nach Objekten

~TMetafileImage

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance

TMetafileImage


TMetafileImage::~TMetafileImage

TMetafileImage

Der Destruktor ~TMetafileImage gibt den Speicher frei, der für das TMetafileImage-Objekt reserviert war. Rufen Sie ~TMetafileImage nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TMetafileImage automatisch aufgerufen wird.

__fastcall virtual ~TMetafileImage(void);


TMetafileImage::TMetafileImage

TMetafileImage

Der Konstruktor TMetafileImage erzeugt ein neues TMetafileImage-Objekt.

__fastcall TMetafileImage(void);


Hierarchie

TObject


TMetafileImage Beispiel

TMetafileImage


TNavDataLink

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/dbctrls.hpp

TNavDataLink ist ein Hilfsobjekt. Es vereinfacht die Verknüpfung zur Datenmenge, die von einem TDBNavigator-Objekt benutzt wird.

Beschreibung

TNavDataLink ist ausschließlich für die Verwendung durch die Klasse TDBNavigator vorgesehen.


Eigenschaften von TNavDataLink

TNavDataLink	Alphabetisch	Legende

Abgeleitet von TDataLink

Active

ActiveRecord

BufferCount

DataSet

DataSource

DataSourceFixed

Editing

ReadOnly

RecordCount


Eigenschaften von TNavDataLink

TNavDataLink	Nach Objekten	Legende

ActiveRecord

Active

BufferCount

DataSet

DataSourceFixed

DataSource

Editing

ReadOnly

RecordCount


Methoden von TNavDataLink

TNavDataLink	Alphabetisch	Legende

In TNavDataLink

~TNavDataLink

ActiveChanged

DataSetChanged

EditingChanged

TNavDataLink

Abgeleitet von TDataLink

Edit

UpdateRecord

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TNavDataLink

TNavDataLink	Nach Objekten	Legende

~TNavDataLink

ActiveChanged

Assign

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DataSetChanged

DefaultHandler

Dispatch

EditingChanged

Edit

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance

TNavDataLink

UpdateRecord


TNavDataLink::~TNavDataLink

TNavDataLink	Siehe auch

Der Destruktor ~TNavDataLink gibt den Speicher frei, der für das TNavDataLink-Objekt reserviert war. Rufen Sie ~TNavDataLink nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TNavDataLink automatisch aufgerufen wird.

__fastcall virtual ~TNavDataLink(void);


TNavDataLink::ActiveChanged

TNavDataLink	Siehe auch

Die Methode ActiveChanged informiert das TDBNavigator-Objekt über Änderungen in der Eigenschaft Active.

virtual void __fastcall ActiveChanged(void);

Beschreibung

Anwendungen sollten die Prozedur ActiveChanged nicht direkt aufrufen. Der Aufruf wird automatisch ausgelöst, sobald sich die Eigenschaft Active ändert. Dadurch wiederum wird die ActiveChanged-Version des TDBNavigator-Objekts aufgerufen, das Eigentümer dieses TNavDataLink-Objekts ist.


TNavDataLink::DataSetChanged

TNavDataLink	Siehe auch

Die Methode DataSetChanged informiert das TDBNavigator-Objekt über Änderungen an der Datenmenge.

virtual void __fastcall DataSetChanged(void);

Beschreibung

DataSetChanged braucht in Anwendungen nicht explizit aufgerufen zu werden. Der Aufruf wird automatisch ausgelöst, sobald sich der Inhalt der Datenmenge ändert. TNavDataLink informiert das TDBNavigator-Objekt über die Änderungen, indem dessen Methode DataChanged aufgerufen wird.


TNavDataLink::EditingChanged

TNavDataLink	Siehe auch

Die Methode EditingChanged informiert das TDBNavigator-Objekt über Änderungen am Bearbeitungsmodus des DataSource-Objekts.

virtual void __fastcall EditingChanged(void);

Beschreibung

Anwendungen sollten die Prozedur EditingChanged nicht direkt aufrufen. Änderungen am Bearbeitungsmodus der Datenmenge lösen diese Prozedur aus, die wiederum die Methode EditingChanged des TDBNavigator-Objekts aufruft, das Eigentümer dieses TNavDataLink-Objekts ist.


TNavDataLink::TNavDataLink

TNavDataLink	Siehe auch

TNavDataLink erzeugt eine Instanz von of TNavDataLink.

__fastcall TNavDataLink(TDBNavigator* ANav);

Beschreibung

Anwendungen sollten die Methode TNavDataLink nicht direkt aufrufen. Das TDBNavigator-Objekt, das Eigenütmer des TNavDataLink-Objekts ist, ruft TNavDataLink in seinem eigenen Konstruktor auf.


Zugriff

Read-only


Gültigkeitsbereich

Protected


Hierarchie

TObject

TPersistent

TDataLink


TNavDataLink Beispiel

TNavDataLink


TNotebook

Hierarchie	Eigenschaften	Methoden	Ereignisse

Mit der Komponente TNotebook kann ein Satz von Registerkarten erzeugt werden, die jeweils eine Gruppe von Steuerelementen enthalten.

Header

vcl/extctrls.hpp

Beschreibung

TNotebook wird in der Regel zusammen mit TTabSet-Objekten eingesetzt. Damit läßt sich eine Komponente erzeugen, die in der grafischen Gestaltung einem Notizbuch mit eingelegtem Register ähnelt. Die einzelnen Seiten können mit einem Klick auf einen der Registerreiter geöffnet werden. TNotebook ist aus Gründen der Abwärtskompatibilität in C++Builder enthalten.

Die Gesamtheit der im Notizbuch verfügbaren Seiten werden als Strings in der Eigenschaft Pages definiert. Der Zugriff auf eine bestimmte Seite erfolgt entweder über die Eigenschaft PageIndex oder ActivePage.

Normalerweise werden Sie das TTabSet-Objekt (Registerreiter) unten im Formular anordnen und den verbleibenden Platz für das TNotebook-Objekt (Registerkarten) verwenden. Diese Ausrichtung der beiden Komponenten zueinander steuern Sie mit den Align-Eigenschaften.

TNotebook ist ein indirekter Nachkomme von TWinControl. Zusätzlich zu den hier beschriebenen Eigenschaften, Methoden und Ereignissen besitzt die Komponente die Eigenschaften, Methoden und Ereignisse, die allen fensterorientierten Steuerelementen gemeinsam sind.


Eigenschaften von TNotebook

TNotebook	Alphabetisch	Legende

In TNotebook

ActivePage

PageIndex

Pages

Abgeleitet von TWinControl

Brush

ClientOrigin

ClientRect

ControlCount

Controls

Ctl3D

Handle

HelpContext

ParentCtl3D

Showing

TabOrder

TabStop

Abgeleitet von TControl

Align

BoundsRect

ClientHeight

ClientWidth

Color

ControlState

ControlStyle

Cursor

DragCursor

DragMode

Enabled

Font

Height

Hint

Left

Name

Parent

ParentColor

ParentFont

ParentShowHint

PopupMenu

ShowHint

Top

Visible

Width

Abgeleitet TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TNotebook

TNotebook	Nach Objekten	Legende

ActivePage

Align

BoundsRect

Brush

ClientHeight

ClientOrigin

ClientRect

ClientWidth

Color

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlCount

ControlState

Controls

ControlStyle

Ctl3D

Cursor

DesignInfo

DragCursor

DragMode

Enabled

Font

Handle

Height

HelpContext

Hint

Left

Name

Owner

PageIndex

Pages

ParentColor

ParentCtl3D

ParentFont

ParentShowHint

Parent

PopupMenu

ShowHint

Showing

TabOrder

TabStop

Tag

Top

Visible

Width


TNotebook::ActivePage

TNotebook	Siehe auch

Die Eigenschaft ActivePage bestimmt, welche Seite des Notizbuchs sichtbar ist.

__property System::AnsiString ActivePage;

Beschreibung

ActivePage bezeichnet die Seite, die aktuell im Notizbuch sichtbar ist. Der Wert von ActivePage muß einem String der Eigenschaft Pages entsprechen.


TNotebook::PageIndex

TNotebook	Siehe auch

Die Eigenschaft PageIndex bestimmt, welche Seite des Notizbuchs sichtbar ist.

__property int PageIndex;

Beschreibung

Der Wert von PageIndex bestimmt die sichtbare Seite im Notizbuch. Wenn der Wert geändert wird, ist eine andere Seite sichtbar.

Jeder String in der Eigenschaft Pages erhält automatisch einen Wert PageIndex, während die Seite erzeugt wird. Die erste Seite hat den Index 0, die zweite den Index 1 und so fort. Wenn aus der Eigenschaft Pages ein String gelöscht wird, wird PageIndex neu aufgebaut, so daß der Index immer bei 0 beginnt und keine Lücken aufweist.


TNotebook::Pages

TNotebook	Siehe auch

Die Eigenschaft Pages enthält die Strings, welche die einzelnen Eigenschaften des Notizbuchs identifizieren.

__property Classes::TStrings* Pages;

Beschreibung

Pages enthält eine Liste von Strings, die jeweils eine einzelne Notizbuchseite bezeichnen. Jeder hinzugefügte String erzeugt eine neue Seite. Wenn Page beispielsweise die Strings Eins, Zwei und Drei enthält, wird eine Notizbuch-Komponente mit drei getrennten Seiten gebildet.

Der Zugriff auf die einzelnen Seiten erfolgt über die Eigenschaften ActivePage oder PageIndex.


Ereignisse von TNotebook

TNotebook	Alphabetisch	Legende

In TNotebook

OnPageChanged

Abgeleitet von TWinControl

OnEnter

OnExit

Abgeleitet von TControl

OnClick

OnDblClick

OnDragDrop

OnDragOver

OnEndDrag

OnMouseDown

OnMouseMove

OnMouseUp

OnStartDrag


Ereignisse von TNotebook

TNotebook	Nach Objekten	Legende

OnClick

OnDblClick

OnDragDrop

OnDragOver

OnEndDrag

OnEnter

OnExit

OnMouseDown

OnMouseMove

OnMouseUp

OnPageChanged

OnStartDrag


TNotebook::OnPageChanged

TNotebook

Das Ereignis wird ausgelöst, wenn der Benutzer im Notizbuch eine neue Seite anklickt.

__property Classes::TNotifyEvent OnPageChanged;

Beschreibung

In einer Ereignisbehandlungsroutine für OnPageChanged können Sie spezielle Bearbeitungsschritte definieren, die ausgeführt werden sollen, wenn der Benutzer eine andere Seite wählt.


Methoden von TNotebook

TNotebook	Alphabetisch

In TNotebook

~TNotebook

TNotebook

Abgeleitet von TWinControl

Broadcast

CanFocus

ContainsControl

ControlAtPos

DisableAlign

EnableAlign

Focused

GetTabOrderList

HandleAllocated

HandleNeeded

InsertControl

Invalidate

PaintTo

Realign

RemoveControl

Repaint

ScaleBy

ScrollBy

SetBounds

SetFocus

Update

UpdateControlState

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

GetTextLen

Hide

Perform

Refresh

ScreenToClient

SendToBack

SetTextBuf

Show

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TNotebook

TNotebook	Nach Objekten

~TNotebook

Assign

BeginDrag

BringToFront

Broadcast

CanFocus

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

ClientToScreen

ContainsControl

ControlAtPos

DefaultHandler

DestroyComponents

Destroying

DisableAlign

Dispatch

DragDrop

Dragging

EnableAlign

EndDrag

FieldAddress

FindComponent

Focused

FreeInstance

FreeNotification

Free

GetParentComponent

GetTabOrderList

GetTextBuf

GetTextLen

HandleAllocated

HandleNeeded

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InsertControl

InstanceSize

Invalidate

MethodAddress

MethodName

NewInstance

PaintTo

Perform

Realign

Refresh

RemoveComponent

RemoveControl

Repaint

ScaleBy

ScreenToClient

ScrollBy

SendToBack

SetBounds

SetFocus

SetTextBuf

Show

TNotebook

UpdateControlState

Update


TNotebook::~TNotebook

TNotebook	Siehe auch

Der Destruktor gibt die TNotebook-Komponente frei.

__fastcall virtual ~TNotebook(void);

Beschreibung

TNotebook gibt die zum Notizbuch gehörige Seitenliste frei und ruft dann den Destruktor des übergeordneten Objekts auf.


TNotebook::TNotebook

TNotebook	Siehe auch

Der Konstruktor erzeugt eine Instanz von TNotebook.

__fastcall virtual TNotebook(Classes::TComponent* AOwner);

Beschreibung

TNotebook ruft den Konstruktor des übergeordneten Objekts auf und initialisiert die Größe, die Seitenliste sowie andere Standardparameter des Steuerelements.


Gültigkeitsbereich

Published

Zugriff

Nur Lesen


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TControl

TWinControl

TCustomControl


Beispiel für TNotebook

TNotebook


TNumericField

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/dbtables.hpp

Die Komponente TNumericField ist der gemeinsame Vorfahr aller numerischen Felder in einer Datenmenge.

Beschreibung

TNumericField ist eine abstrakte Basisklasse, die das grundlegende Verhalten kapselt, das allen numerischen Feldkomponenten gemeinsam ist. Zusätzlich zu den von TField eingeführten Eigenschaften, Ereignissen und Methoden, die allen Feldkomponenten gemeinsam sind, führt TNumericField neue Eigenschaften ein, mit denen sich numerische Daten flexibel anzeigen und bearbeiten lassen.


Eigenschaften von TNumericField

TNumericField	Alphabetisch	Legende

In TNumericField

DisplayFormat

EditFormat

Abgeleitet von TField

Alignment

AsBoolean

AsCurrency

AsDateTime

AsFloat

AsInteger

AsString

AsVariant

AttributeSet

BDECalcField

Calculated

CanModify

DataSet

DataSize

DataType

DisplayLabel

DisplayName

DisplayText

DisplayWidth

EditMask

EditMaskPtr

FieldKind

FieldName

FieldNo

Index

IsIndexField

IsNull

KeyFields

Lookup

LookupDataSet

LookupKeyFields

LookupResultField

NewValue

OldValue

ReadOnly

Required

Size

Text

Value

Visible

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Name

Owner

Tag


Eigenschaften von TNumericField

TNumericField	Nach Objekten	Legende

Alignment

AsBoolean

AsCurrency

AsDateTime

AsFloat

AsInteger

AsString

AsVariant

AttributeSet

BDECalcField

Calculated

CanModify

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

DataSet

DataSize

DataType

DesignInfo

DisplayFormat

DisplayLabel

DisplayName

DisplayText

DisplayWidth

EditFormat

EditMaskPtr

EditMask

FieldKind

FieldName

FieldNo

Index

IsIndexField

IsNull

KeyFields

LookupDataSet

LookupKeyFields

LookupResultField

Lookup

Name

NewValue

OldValue

Owner

ReadOnly

Required

Size

Tag

Text

Value

Visible


TNumericField::DisplayFormat

TNumericField	Siehe auch

Die Eigenschaft DisplayFormat legt fest, in welchem Format der Wert eines numerischen Feldes in einem datensensitiven Steuerelement angezeigt wird.

__property System::AnsiString DisplayFormat;

Beschreibung

Mit Hilfe der Eigenschaft DisplayFormat kann die standardmäßig automatische Feldformatierung außer Kraft gesetzt werden, um eine individuelle Darstellung zu erreichen.

Der Wert von DisplayFormat ist ein String, der in codierter Form die Formatierung numerischer Daten beschreibt. Die gültigen Bezeichner finden Sie in dieser Tabelle:

Bezeichner	Bedeutung

  0	Platzhalter für Ziffer. Wenn der formatierte Wert an der Stelle eine Ziffer enthält, an der im Format-String das Zeichen 0 (Null) steht, wird die betreffende Ziffer in den Ausgabe-String übernommen. Andernfalls erscheint im Ausgabe-String an dieser Position eine Null.

  #	Platzhalter für Ziffer. Wenn der formatierte Wert an der Stelle eine Ziffer enthält, an der im Format-String das Zeichen # steht, dann wird diese Ziffer in den Ausgabe-String übernommen. Andernfalls wird an der betreffenden Position im Ausgabe-String nichts gespeichert.

  .	Dezimalpunkt. Der erste Punkt im Format-String bestimmt die Position des Dezimaltrennzeichens im formatierten Wert. Alle weiteren Punktzeichen werden ignoriert. Das Zeichen, das im Ausgabe-String tatsächlich als Dezimaltrennzeichen erscheint, wird von der globalen Variablen DecimalSeparator bestimmt. Der Standardwert von DecimalSeparator wird in der Windows-Systemsteuerung unter Ländereinstellungen definiert (Register Eigenschaften von Ländereinstellungen, Registerkarte Zahlen).

  ,	Tausendertrennzeichen. Wenn der Format-String ein oder mehrere Kommazeichen enthält, werden im Ausgabe-String alle Stellen links vom Dezimaltrennzeichen in Dreiergruppen gegliedert, die jeweils durch ein Tausendertrennzeichen getrennt sind. Um zu kennzeichnen, daß ein Tausendertrennzeichen gewünscht wird, ist es nicht von Bedeutung, wieviele Kommas der Format-String enthält. Auch die Position ist beliebig. Das Zeichen, das im Ausgabe-String tatsächlich als Tausendertrennzeichen erscheint, wird von der globalen Variablen ThousandSeparator bestimmt. Der Standardwert von ThousandSeparator wird in der Windows-Systemsteuerung unter Ländereinstellungen definiert (Register Eigenschaften von Ländereinstellungen, Registerkarte Zahlen).

  E+	Wissenschaftliche Notation. Sobald der Format-String einen der Bezeichner "E+", "E-", "e+" oder "e-" enthält, wird die formatierte Zahl in wissenschaftlicher Notation dargestellt. Unmittelbar nach "E+", "E-", "e+" oder "e-" kann eine Gruppe von bis zu vier Nullen folgen, mit denen die minimale Stellenzahl im Exponenten festgelegt wird. Die beiden Kürzel "E+" und "e+" bewirken, daß sowohl positive als auch negative Exponenten mit einem Vorzeichen versehen werden. Die Kürzel "E-" und "e-" bewirken, daß nur negative Exponenten ein Vorzeichen erhalten.

  'xx'/"xx"	Alle Zeichen, die in halbe oder ganze Anführungszeichen eingeschlossen sind, werden unverändert in den Ausgabe-String übernommen und beeinflussen die Formatierung nicht.

  ;	Ein Semikolon trennt im Format-String die Bereiche für positive und negative Zahlen.

Innerhalb des Format-Strings bestimmt die Position des am weitesten links stehenden Nullzeichens zusammen mit der Position des am weitesten rechts stehenden Nullzeichens (bezogen auf das Dezimaltrennzeichen) die Anzahl der Stellen, die immer im Ausgabe-String angezeigt werden.

Die darzustellende Zahl wird bei der Formatierung stets auf die Anzahl von Nachkommastellen gerundet, die durch die Anzahl der Ziffern-Platzhalter ("0" oder "#") rechts vom Dezimaltrennzeichen vorgegeben ist. Fehlt im Format-String ein Dezimaltrennzeichen, wird der formatierte Wert auf die nächste ganze Zahl gerundet.

Wenn die festgelegte Anzahl von Vorkommastellen nicht ausreicht, um eine Zahl darzustellen, werden vor dem ersten Ziffern-Platzhalter zusätzliche Stellen eingefügt.

Das Semikolon gliedert den Format-String in bis zu drei Teile, in denen jeweils eine eigene Formatierung für positive und negative Zahlen sowie für Nullen definiert werden kann.

•	Ein Abschnitt: Der Format-String gilt für alle Werte.

•	Zwei Abschnitte: Der erste Abschnitt gilt für positive Werte, der zweite für negative.

•	Drei Abschnitte: Der erste Abschnitt gilt für positive Werte, der zweite für negative und der dritte für Nullen.

Wenn der Abschnitt für negative Werte oder der Abschnitt für Nullen leer ist, wenn also zwischen den Semikolons nichts steht, wird statt dessen der Abschnitt für positive Werte verwendet.

Wenn der Abschnitt für positive Zahlen leer ist oder der gesamte Format-String leer ist, erfolgt eine standardisierte Gleitkommaformatierung mit 15 signifikanten Stellen. Das gleiche gilt, wenn der Wert mehr als 18 Vorkommastellen besitzt und im Format-String keine wissenschaftliche Notation festgelegt wurde.

Hinweis

Die Eigenschaft DisplayFormat wirkt sich nur auf die Anzeige der Felddaten aus. Es besteht kein Zusammenhang mit der Gültigkeit von Strings, die einem numerischen Feld mit der Eigenschaft AsString zugewiesen werden.


TNumericField::EditFormat

TNumericField	Siehe auch

Die Eigenschaft EditFormat legt fest, in welchem Format der Wert eines numerischen Feldes erscheint, während er in einem datensensitiven Steuerelement angezeigt wird.

__property System::AnsiString EditFormat;

Beschreibung

Mit Hilfe der Eigenschaft EditFormat kann die Formatierung eines Feldes gesteuert werden, wenn in einem datensensitiven Steuerelement ein Wert bearbeitet wird.

Wenn keine Zuweisung an EditFormat erfolgt, aber die Eigenschaft DisplayFormat einen Wert besitzt, wird der String in DisplayFormat verwendet.

Der Wert von EditFormat ist ein String, der in codierter Form die Formatierung numerischer Daten beschreibt. Die gültigen Bezeichner finden Sie in dieser Tabelle:

Bezeichner	Bedeutung

  0	Platzhalter für Ziffer. Wenn der formatierte Wert an der Stelle eine Ziffer enthält, an der im Format-String das Zeichen 0 (Null) steht, wird die betreffende Ziffer in den Ausgabe-String übernommen. Andernfalls erscheint im Ausgabe-String an dieser Position eine Null.

  #	Platzhalter für Ziffer. Wenn der formatierte Wert an der Stelle eine Ziffer enthält, an der im Format-String das Zeichen # steht, dann wird diese Ziffer in den Ausgabe-String übernommen. Andernfalls wird an der betreffenden Position im Ausgabe-String nichts gespeichert.

  .	Dezimalpunkt. Der erste Punkt im Format-String bestimmt die Position des Dezimaltrennzeichens im formatierten Wert. Alle weiteren Punktzeichen werden ignoriert. Das Zeichen, das im Ausgabe-String tatsächlich als Dezimaltrennzeichen erscheint, wird von der globalen Variablen DecimalSeparator bestimmt. Der Standardwert von DecimalSeparator wird in der Windows-Systemsteuerung unter Ländereinstellungen definiert (Register Eigenschaften von Ländereinstellungen, Registerkarte Zahlen).

  ,	Tausendertrennzeichen. Wenn der Format-String ein oder mehrere Kommazeichen enthält, werden im Ausgabe-String alle Stellen links vom Dezimaltrennzeichen in Dreiergruppen gegliedert, die jeweils durch ein Tausendertrennzeichen getrennt sind. Um zu kennzeichnen, daß ein Tausendertrennzeichen gewünscht wird, ist es nicht von Bedeutung, wieviele Kommas der Format-String enthält. Auch die Position ist beliebig. Das Zeichen, das im Ausgabe-String tatsächlich als Tausendertrennzeichen erscheint, wird von der globalen Variablen ThousandSeparator bestimmt. Der Standardwert von ThousandSeparator wird in der Windows-Systemsteuerung unter Ländereinstellungen definiert (Register Eigenschaften von Ländereinstellungen, Registerkarte Zahlen).

  E+	Wissenschaftliche Notation. Sobald der Format-String einen der Bezeichner "E+", "E-", "e+" oder "e-" enthält, wird die formatierte Zahl in wissenschaftlicher Notation dargestellt. Unmittelbar nach "E+", "E-", "e+" oder "e-" kann eine Gruppe von bis zu vier Nullen folgen, mit denen die minimale Stellenzahl im Exponenten festgelegt wird. Die beiden Kürzel "E+" und "e+" bewirken, daß sowohl positive als auch negative Exponenten mit einem Vorzeichen versehen werden. Die Kürzel "E-" und "e-" bewirken, daß nur negative Exponenten ein Vorzeichen erhalten.

  'xx'/"xx"	Alle Zeichen, die in halbe oder ganze Anführungszeichen eingeschlossen sind, werden unverändert in den Ausgabe-String übernommen und beeinflussen die Formatierung nicht.

  ;	Ein Semikolon trennt im Format-String die Bereiche für positive und negative Zahlen.

Innerhalb des Format-Strings bestimmt die Position des am weitesten links stehenden Nullzeichens zusammen mit der Position des am weitesten rechts stehenden Nullzeichens (bezogen auf das Dezimaltrennzeichen) die Anzahl der Stellen, die immer im Ausgabe-String angezeigt werden.

Die darzustellende Zahl wird bei der Formatierung stets auf die Anzahl von Nachkommastellen gerundet, die durch die Anzahl der Ziffern-Platzhalter ("0" oder "#") rechts vom Dezimaltrennzeichen vorgegeben ist. Fehlt im Format-String ein Dezimaltrennzeichen, wird der formatierte Wert auf die nächste ganze Zahl gerundet.

Wenn die festgelegte Anzahl von Vorkommastellen nicht ausreicht, um eine Zahl darzustellen, werden vor dem ersten Ziffern-Platzhalter zusätzliche Stellen eingefügt.

Das Semikolon gliedert den Format-String in bis zu drei Teile, in denen jeweils eine eigene Formatierung für positive und negative Zahlen sowie für Nullen definiert werden kann.

•	Ein Abschnitt: Der Format-String gilt für alle Werte.

•	Zwei Abschnitte: Der erste Abschnitt gilt für positive Werte, der zweite für negative.

•	Drei Abschnitte: Der erste Abschnitt gilt für positive Werte, der zweite für negative und der dritte für Nullen.

Wenn der Abschnitt für negative Werte oder der Abschnitt für Nullen leer ist, wenn also zwischen den Semikolons nichts steht, wird statt dessen der Abschnitt für positive Werte verwendet.

Wenn der Abschnitt für positive Zahlen leer ist oder der gesamte Format-String leer ist, erfolgt eine standardisierte Gleitkommaformatierung mit 15 signifikanten Stellen. Das gleiche gilt, wenn der Wert mehr als 18 Vorkommastellen besitzt und im Format-String keine wissenschaftliche Notation festgelegt wurde.

Hinweis

Die Eigenschaft EditFormat wirkt sich nur auf die reine Anzeige der Felddaten während einer Bearbeitung aus. Es besteht kein Zusammenhang mit der Gültigkeit von Strings, die einem numerischen Feld mit der Eigenschaft AsString zugewiesen werden. EditFormat betrifft auch nicht das Anzeigeformat, wenn keine Bearbeitung stattfindet.


Ereignisse von TNumericField

TNumericField	Alphabetisch	Legende

Abgeleitet von TField

OnChange

OnGetText

OnSetText

OnValidate


Ereignisse von TNumericField

TNumericField	Nach Objekten	Legende

OnChange

OnGetText

OnSetText

OnValidate


Methoden von TNumericField

TNumericField	Alphabetisch

In TNumericField

~TNumericField

TNumericField

Abgeleitet von TField

Assign

AssignValue

Clear

FocusControl

GetData

IsValidChar

SetData

SetFieldType

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TNumericField

TNumericField	Nach Objekten

~TNumericField

Assign

AssignValue

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

Clear

DefaultHandler

DestroyComponents

Destroying

Dispatch

FieldAddress

FindComponent

FocusControl

FreeInstance

FreeNotification

Free

GetData

GetParentComponent

HasParent

InheritsFrom

InitInstance

InsertComponent

InstanceSize

IsValidChar

MethodAddress

MethodName

NewInstance

RemoveComponent

SetData

SetFieldType

TNumericField


TNumericField::~TNumericField

TNumericField

Der Destruktor ~TNumericField gibt den Speicher frei, der für das TNumericField-Objekt reserviert war. Rufen Sie ~TNumericField nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TNumericField automatisch aufgerufen wird.

__fastcall virtual ~TNumericField(void);


TNumericField::TNumericField

TNumericField	Siehe auch

Die Methode TNumericField erzeugt eine Instanz eines TNumericField-Objekts.

__fastcall virtual TNumericField(Classes::TComponent* AOwner);

Beschreibung

Rufen Sie die Methode TNumericField für TNumericField nicht direkt auf. TNumericField ist eine abstrakte Klasse, deren Konstruktor nur vom Konstruktor einer abgeleiteten Klasse als geerbte Methode aufgerufen werden sollte.

Nach dem Aufruf des geerbten Konstruktors ändert TNumericField die Eigenschaft Alignment in taRightJustify.


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TField


TNumericField Beispiel

TNumericField


TObject

Methoden	Siehe auch

Header

vcl/system.hpp

TObject ist der Ausgangspunkt der Klassenhierarchie, sozusagen der Urahn für alle anderen Objekte und Komponenten in Borland C++Builder.

Beschreibung

TObject kapselt das grundlegende Verhalten, das allen Objekten in Borland C++Builder gemeinsam ist. Dazu werden Schnittstellen zu Methoden eingeführt, die folgendes ermöglichen:

•	Objektinstanzen erzeugen, verwalten und auflösen. Dies geschieht durch Zuweisen, Initialisieren und Freigeben von Speicher für das Objekt.

•	Zugreifen auf objektspezifische Informationen zu Klassentyp und Instanz. Verwaltung von Laufzeitinformationen zu Eigenschaften, die als published deklariert sind.

•	Botschaften individuell verarbeiten.

TObject wird als direkte Basis für einfache abgeleitete Objekte verwendet, die keine Komponenten sind und keine Stream- oder Zuweisungsfunktionen benötigen. Wenn bei der Deklaration eines neuen Objekttyps kein Vorfahr angegeben wird, setzt Borland C++Builder die Klasse TObject automatisch als Vorfahren ein.

Borland C++Builder-Objekte erhalten ihre Leistungsfähigkeit zu einem großen Teil durch die Methoden, die mit TObject eingeführt wurden. Viele dieser Methoden sind für die interne Verwendung in der Borland C++Builder-Umgebung vorgesehen und nicht für einen direkten Aufruf durch den Anwender. Andere Methoden wiederum müssen in abgeleiteten Objekten und Komponenten überschrieben werden, die komplexeres Verhalten zeigen.

Hinweis

TObject ist zwar technisch gesehen keine abstrakte Klasse, trotzdem werden Objekte dieses Typs normalerweise nicht instantiiert.


Methoden von TObject

TObject	Alphabetisch

In TObject

~TObject

AfterConstructionTObject_AfterConstruction>Main

BeforeDestruction

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance

TObject


Methoden von TObject

TObject	Nach Objekten

~TObject

AfterConstruction

BeforeDestruction

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance

TObject


TObject::~TObject

TObject	Siehe auch

Der Destruktor ~TObject gibt den Speicher frei, der für das TObject-Objekt reserviert war. Rufen Sie ~TObject nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TObject automatisch aufgerufen wird.

virtual __fastcall ~TObject()


TObject::AfterConstruction

TObject

Die Methode AfterConstruction führt spezielle Aktionen durch, nachdem ein Objekt erzeugt wurde.

virtual void __fastcall AfterConstruction();


TObject::BeforeDestruction

TObject

Die Methode BeforeConstruction führt spezielle Aktionen durch, bevor ein Objekt freigegeben wird.

virtual void __fastcall BeforeDestruction();


TObject::ClassInfo

TObject	Siehe auch

Die Methode ClassInfo gibt für den Objekttyp einen Zeiger auf die RTTI-Tabelle mit den Laufzeitinformationen zurück (RTTI = Run Time Type Information).

static void * __fastcall ClassInfo(TClass cls);

Beschreibung

Über ClassInfo erfolgt der Zugriff auf die RTTI-Tabelle mit Informationen über den Objekttyp, dessen Vorfahren und alle als published deklarierten Eigenschaften.

Die RTTI wird intern von Borland C++Builder genutzt, weshalb ClassInfo nur selten direkt in einer Anwendung aufgerufen wird. TObject beinhaltet weitere Methoden, die speziell für den einfachen Zugriff auf die RTTI vorgesehen sind. Details hierzu finden Sie in der Unit TypInfo.


TObject::ClassName

TObject	Siehe auch 	Beispiel

Die Methode ClassName gibt einen String mit dem Namen des Typs der Objektinstanz zurück, die von einer Variablen referenziert wird, und nicht den Typ dieser Variablen.

static ShortString __fastcall ClassName(TClass cls);

Beschreibung

Mit ClassName kann der eigentliche Typ eines Objekts als String ermittelt werden, ähnlich wie dies bei der Übergabe eines Strings als Parameter an eine andere Routine der Fall ist. Beispielsweise könnte eine Variable eines Vorfahrentyps auf die Instanz eines beliebigen Nachkommen verweisen. In diesem Fall liefert ClassName einen String, der den eigentlichen Typ des Objekts angibt, und keinen String mit dem Typ der deklarierten Variablen.

ClassName ermöglicht objektspezifischen Informationsaustausch über verschiedene Module hinweg und läßt sich damit sehr gut für die Behandlung von Exceptions einsetzen.


TObject::ClassNameIs

TObject	Siehe auch

Die Methode ClassNameIs ermittelt, ob ein Objekt einen bestimmten Typ besitzt.

static bool __fastcall ClassNameIs(TClass cls, const AnsiString string);

Beschreibung

ClassNameIs kann in Verzweigungsstrukturen eingesetzt werden, wenn der Typ eines Objekts als Bedingung fungiert. Außerdem lassen sich Objekte über verschiedene Module oder DLLs hinweg abfragen.

ClassNameIs gibt True zurück, wenn der String im Parameter Name mit dem Namen der Klasse übereinstimmt. Andernfalls lautet der Rückgabewert False.


TObject::ClassParent

TObject	Siehe auch 	Beispiel

Die Methode ClassParent gibt den Typ des direkten Vorfahren einer Klasse zurück.

static TClass __fastcall ClassParent(TClass cls);

Beschreibung

ClassParent gibt für den Typ TObject den Wert NULL zurück, weil es zu TObject keinen Vorfahren gibt.

ClassParent wird in Borland C++Builder intern sowohl für die Zusammenstellung der RTTI verwendet als auch von den Operatoren „is“ und „as“ sowie von der Methode InheritsFrom. Da es sich um eine Klassenmethode handelt, kann sie dazu verwendet werden, den Typ einer Klassenreferenz zu bestimmen.

Hinweis

In Anwendungen wird ClassParent nur sehr selten direkt aufgerufen.


TObject::ClassType

TObject	Siehe auch 	Beispiel

ClassType gibt einen Zeiger auf die Laufzeitinformationen einer Objektinstanz zurück.

TClass __fastcall ClassType();

Beschreibung

ClassType ermittelt dynamisch den Typ eines Objekts. ClassType wird in Borland C++Builder intern von den Operatoren „is“ und „as“ verwendet. Rufen Sie ClassType nicht direkt auf.


TObject::CleanupInstance

TObject

Die Methode CleanupInstance übernimmt in einer Klasse die Instanzauflösung von langen Strings und von Varianten.

void __fastcall CleanupInstance();

Beschreibung

Rufen Sie CleanupInstance nicht direkt auf. Der Aufruf erfolgt indirekt über die Methode Free.

CleanupInstance gibt alle langen Strings und Varianten frei. Lange Strings erhalten einen leeren Wert, und Varianten werden in den Status Unassigned versetzt.


TObject::DefaultHandler

TObject	Siehe auch

Die Methode DefaultHandler führt eine Schnittstelle ein, welche die Verarbeitung eines übergebenen Datensatzes mit Botschaften ermöglicht.

virtual void __fastcall DefaultHandler(void* Message);

Beschreibung

DefaultHandler wird von Dispatch aufgerufen, wenn für die Verarbeitung einer bestimmten Botschaft keine Methode existiert. Klassen, die von TObject abgeleitet sind und Botschaften verarbeiten, definieren normalerweise eigene DefaultHandler-Methoden entsprechend dem Typ der verarbeiteten Botschaften. Beispielsweise überschreibt TWinControl die Methode DefaultHandler für den Aufruf von DefWindowProc.

Ein Aufruf der geerbten Version dieser Methode führt nur dann zu einem Aufruf der DefaultHandler-Methode des Vorfahren, wenn dieser für die verarbeitete Botschaft keine besondere Methode bereithält. Andernfalls wird über die geerbte Methode die zur Botschaft gehörige Behandlungsroutine aufgerufen.


TObject::Dispatch

TObject	Siehe auch

Dispatch ruft Methoden zur Botschaftenverarbeitung auf. Grundlage ist der Parameter Message.

virtual void __fastcall Dispatch(void *Message);

Beschreibung

Mit Dispatch werden Botschaften automatisch an die aktuelle Ereignisbehandlungsroutine eines Objekts übergeben.

Dispatch ermittelt, ob für eine Botschaft in der objekteigenen Liste die entsprechende Behandlungsroutine existiert. Ist dies nicht der Fall, wird die Liste des Vorfahren untersucht. Wenn auch diese Liste keine Behandlungsroutine enthält, wird der nächste Vorfahr untersucht. Dieser Vorgang bricht ab, sobald eine spezielle Behandlungsroutine gefunden wird oder die oberste Ebene der Hierarchie erreicht ist. Im letzten Fall wird DefaultHandler aufgerufen.

Der Parameter Message ist untypisiert, so daß grundsätzlich jede Art von Daten an Dispatch übergeben werden kann. Es empfiehlt sich jedoch die Verwendung eines Botschaften-Datensatzes wie beispielsweise TMessage. Die einzige Voraussetzung ist, daß die ersten beiden Bytes in Message eine Botschaften-ID enthalten. Diese ID ist ein Integer, der die Routine bezeichnet, die Dispatch zur Verarbeitung der Botschaft aufruft.


TObject::FieldAddress

TObject

Die Methode FieldAddress liefert die Adresse eines als published deklarierten Objektfeldes.

void * __fastcall FieldAddress(const ShortString &Name);

Beschreibung

FieldAddress wird intern vom Borland C++Builder-Stream-System verwendet, um auf ein als published deklariertes Objektfeld zugreifen zu können. Wenn das Feld existiert, wird ein Zeiger darauf zurückgegeben, andernfalls ein NULL -Zeiger.

Als Programmierer sollten Sie für die Bearbeitung von Feldern nicht diese Methode, sondern Eigenschaften verwenden.


TObject::Free

TObject

Die Methode Free löst die Instanz eines Objekts auf und gibt nötigenfalls den zugehörigen Speicher frei.

__fastcall Free();

Beschreibung

Mit Free wird ein Objekt freigegeben. Wenn die Objektinstanz nicht NULL ist, wird der Destruktor aufgerufen. Alle mit dem Konstruktor erzeugten Objektinstanzen sollten mit einem Aufruf von Free aufgelöst werden, damit sowohl das Objekt als auch der zugehörige Speicher korrekt freigegeben werden. Free ist selbst dann erfolgreich, wenn das Objekt NULL ist. Es ist also kein Fehler, die Methode für ein Objekt aufzurufen, das niemals initialisiert war.


TObject::FreeInstance

TObject	Siehe auch

FreeInstance gibt den Speicherbereich frei, der mit einem vorangegangenen Aufruf der Methode NewInstance reserviert wurde.

virtual void __fastcall FreeInstance();

Beschreibung

Alle Destruktoren rufen FreeInstance automatisch auf und geben so den Speicher frei, der mit einer überschriebenen Version von NewInstance belegt wurde.

Rufen Sie FreeInstance nicht direkt auf. FreeInstance sollte allerdings überschrieben werden, wenn NewInstance überschrieben wurde, um das Reservierungsverfahren für die Instanzdaten des Objekts zu ändern.

Ebenso wie NewInstance verwendet FreeInstance bei der Freigabe des Objektspeichers den von InstanceSize gelieferten Wert.


TObject::InheritsFrom

TObject	Siehe auch

InheritsFrom ist eine Klassenmethode, mit der die Art der Beziehung zwischen zwei Objekttypen festgestellt werden kann.

static bool __fastcall InheritsFrom(TClass cls, TClass aClass);

Beschreibung

Mit InheritsFrom kann ermittelt werden, ob ein bestimmter Klassentyp der Vorfahr eines Objekts ist. InheritsFrom gibt den Wert True zurück, wenn der im Parameter AClass übergebene Objekttyp ein Vorfahr des Objekttyps oder der Objekttyp selbst ist. Andernfalls wird False zurückgegeben.

Hinweis

Die Operatoren „is“ und „as“ verwenden InheritsFrom. Der Operator „is“ kann allerdings nur die Vererbungsbeziehung einer Instanz bestimmen. InheritsFrom kann als Klassenmethode die Beziehung von Klassenreferenzen bestimmen.


TObject::InitInstance

TObject	Siehe auch

Die Methode InitInstance setzt alle Speicherzellen in dem für ein neues Objekt reservierten Bereich auf Null und initialisiert den Zeiger auf die Tabelle der virtuellen Methoden der Instanz.

static TObject * __fastcall InitInstance(TClass cls, void *instance);

Beschreibung

Rufen Sie InitInstance niemals direkt auf, dies geschieht automatisch bei der Erzeugung eines Objekts mit NewInstance. Wenn Sie NewInstance überschreiben, muß InitInstance als letzte Anweisung aufgerufen werden.

InitInstance ist keine virtuelle Methode und kann deshalb nicht überschrieben werden. Initialisieren Sie alle Daten für ein Objekt im Konstruktor. Überschreiben Sie NewInstance nur für eine spezialisierte Form der Speicherzuweisung, wie etwa die Einrichtung eines gemeinsamen Speicher-Pools für alle Instanzen einer Klasse.


TObject::InstanceSize

TObject	Siehe auch

Die Methode InstanceSize gibt für jede Instanz des Objekttyps die Größe in Byte zurück.

static long __fastcall InstanceSize(TClass cls);

Beschreibung

Mit InstanceSize wird ermittelt, wieviel Speicher eine Klasseninstanz benötigt. Borland C++Builder verwendet InstanceSize intern für Methoden, die Speicher reservieren und freigeben. InstanceSize ist keine virtuelle Methode und kann deshalb nicht überschrieben werden. Methoden, die InstanceSize verwenden, können dagegen schon überschrieben werden.


TObject::MethodAddress

TObject	Siehe auch

Die Methode gibt die Adresse einer als published deklarierten Methode zurück.

static void * __fastcall MethodAddress(TClass cls, const ShortString &Name);

Beschreibung

MethodAddress wird in Borland C++Builder intern vom Stream-System verwendet. Während des Lesens aus einem Stream wird der im Parameter Name übergebene Methodenname in einen Zeiger mit der Methodenadresse konvertiert. Rufen Sie die Methode nicht direkt auf.

Wenn der Parameter Name nicht auf eine als published deklarierte Methode verweist, gibt MethodAddress einen NULL-Zeiger zurück.


TObject::MethodName

TObject	Siehe auch

Die Methode MethodName gibt einen String mit dem Namen der Methode zurück, auf die der übergebene Zeiger Address verweist.

static ShortString __fastcall MethodName(TClass cls, void *Address);

Beschreibung

MethodName wird in Borland C++Builder intern vom Stream-System verwendet. Während Ereigniseigenschaften in einen Stream geschrieben werden, wird ein Zeiger auf die Speicheradresse der Methode in einen String konvertiert, der den Methodennamen enthält. MethodName ist damit das Gegenstück zu MethodAddress. Rufen Sie die Methode nicht direkt auf.

Wenn der Zeiger Address nicht auf eine als published deklarierte Methode verweist, gibt MethodName einen leeren String zurück.


TObject::NewInstance

TObject	Siehe auch

Die Methode NewInstance besorgt die Speicherzuweisung für jede Instanz eines Objekttyps und gibt einen Zeiger auf die neue Instanz zurück.

virtual TObject* __fastcall NewInstance(TClass cls);

Beschreibung

Alle Konstruktoren rufen NewInstance automatisch auf. NewInstance ruft wiederum InstanceSize auf und ermittelt so den Platzbedarf einer Instanz auf dem Heap. Rufen Sie NewInstance nicht direkt auf.

Wenn Sie NewInstance überschreiben, um die Speicherzuweisung für einen Objekttyp zu ändern, müssen Sie eventuell auch FreeInstance überschreiben, um diesen Speicherbereich wieder freizugeben. Wenn beispielsweise viele identische Objekte gleichzeitig im Speicher gehalten werden müssen, könnte eines dieser Objekte einen großen Speicherblock für die ganze Gruppe belegen und dann NewInstance so überschreiben, daß jeweils ein Teil des Blocks für die einzelnen Instanzen verwendet wird. Rufen Sie beim Überschreiben von NewInstance die Methode InitInstance als letzte Anweisung auf, und nicht die geerbte Methode.

Abgeleitete Klassen können NewInstance überschreiben und dadurch individuell steuern, in welcher Form Speicher reserviert wird.

Hinweis

Per Voreinstellung ruft NewInstance die Methode InitInstance auf.


TObject::TObject

TObject	Siehe auch

TObject erzeugt ein Objekt und initialisiert dessen Daten, bevor es zum ersten Mal verwendet wird.

__fastcall TObject();

Beschreibung

TObject erzeugt eine korrekt initialisierte Instanz eines Objekts. Die Objekte in Borland C++Builder unterschieden sich sehr in ihrem Zweck, Verhalten und in der Größe. TObject besitzt keine spezielle Funktion, das heißt es werden keine Daten initialisiert. Lediglich die Speicherreservierung erfolgt automatisch, wenn TObject aufgerufen wird.


Hierarchie


TObject Beispiel

TObject


TOleClientSite

Hierarchie	Methoden	Siehe auch

Header

vcl/olectrls.hpp

TOleClientSite ist ein Objekt, das die Schnittstelle IOleClientSite kapselt.

Beschreibung

TOleClientSite wird in Verbindung mit einem OLE-Objekt eingesetzt.

Weitere Informationen über die Schnittstelle IOleClientSite finden Sie in der Datei OLE.HLP unter IOleClientSite.


Methoden von TOleClientSite

TOleClientSite	Alphabetisch

In TOleClientSite

~TOleClientSite

AddRef

GetContainer

GetMoniker

OnShowWindow

QueryInterface

Release

RequestNewObjectLayout

SaveObject

ShowObject

TOleClientSite

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TOleClientSite

TOleClientSite	Nach Objekten

~TOleClientSite

AddRef

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

FreeInstance

Free

GetContainer

GetMoniker

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance

OnShowWindow

QueryInterface

Release

RequestNewObjectLayout

SaveObject

ShowObject

TOleClientSite


TOleClientSite::~TOleClientSite

TOleClientSite

Der Destruktor ~TOleClientSite gibt den Speicher frei, der für das TOleClientSite-Objekt reserviert war. Rufen Sie ~TOleClientSite nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TOleClientSite automatisch aufgerufen wird.

__fastcall virtual ~TOleClientSite(void);


TOleClientSite::AddRef

TOleClientSite	Siehe auch

Die Methode AddRef inkrementiert den Referenzzähler für das TOleClientSite-Objekt.

virtual long __stdcall AddRef(void);

Beschreibung

Mit AddRef wird der Referenzzähler für das TOleClientSite-Objekt erhöht. Das Objekt wird erst freigegeben, wenn dessen Referenzzähler auf Null steht.

AddRef gibt den neuen Zählerwert zurück.


TOleClientSite::GetContainer

TOleClientSite	Siehe auch

Die Methode GetContainer ermittelt den OLE-Container eines OLE-Objekts.

virtual long __stdcall GetContainer(Ole2::IOleContainer* &container);

Beschreibung

Mit GetContainer kann der OLE-Container für ein bestimmtes OLE-Objekt bestimmt werden.

Die Variable Container speichert den OLE-Container.

GetContainer gibt einen der folgenden Werte zurück:

Wert	Bedeutung

S_OK	Der Container konnte erfolgreich ermittelt werden.

OLE_E_NOT_SUPPORTED	Die Client-Anwendung entspricht der OLE-Version 1.

E_NOINTERFACE	Der Container implementiert die Schnittstelle IOleContainer nicht.


TOleClientSite::GetMoniker

TOleClientSite	Siehe auch

Die Methode GetMoniker ermittelt den Moniker für das OLE-Objekt.

virtual long __stdcall GetMoniker(long dwAssign, long dwWhichMoniker, Ole2::IMoniker* &mk);

Beschreibung

Mit GetMoniker kann der Moniker für ein OLE-Objekt bestimmt werden. Weitere Informationen zum Begriff Moniker finden Sie in der Datei OLE.HLP.

Der Parameter dwAssign legt fest, in welcher Form der Moniker zugewiesen wird. Dazu stehen die OLEGETMONIKER-Aufzählungswerte zur Verfügung. Weitere Informationen finden Sie in der Datei OLE.HLP unter OLEGETMONIKER.

Der Parameter dwWhichMoniker definiert, welcher Moniker zugewiesen wird. dwWhichMoniker kann einer der OLEWHICHMK-Aufzählungswerte sein. Weitere Informationen finden Sie in der Datei OLE.HLP unter OLEWHICHMK.

Die Variable mk speichert den Moniker.

GetMoniker gibt einen der folgenden Werte zurück:

Wert	Bedeutung

S_OK	Der Moniker wurde erfolgreich bestimmt.

E_FAIL	Unbekannter Fehler aufgetreten.

E_UNEXPECTED	Schwerwiegender, unerwarteter Fehler aufgetreten.

E_NOTIMPL	Der Container kann Objekten keinen Moniker zuweisen. Der Rückgabewert tritt dann auf, wenn der Container der OLE-Version 1 entspricht.


TOleClientSite::OnShowWindow

TOleClientSite	Siehe auch

Die Methode OnShowWindow wird aufgerufen, sobald das Objekt in der OLE-Client-Anwendung seinen Sichtbarkeitsstatus ändert.

virtual long __stdcall OnShowWindow(DWORD fShow);

Beschreibung

Überschreiben Sie OnShowWindow so, daß bestimmte Aktionen eingeleitet werden, sobald das OLE-Objekt entweder sichtbar oder unsichtbar wird. Typischerweise reagiert der Container durch Hinzufügen bzw. Entfernen einer Schraffur oder Schattierung.

OnShowWindow wird von einem Objekt nicht aufgerufen, wenn dieses in der Container-Anwendung aktiviert wird, weil das Objekt kein vom Container getrenntes Fenster besitzt.

Der Parameter fShow zeigt an, ob das Objektfenster geöffnet ist (True) oder geschlossen (False).

OnShowWindow gibt den Wert S_OK zurück, wenn Schraffur oder Schattierung erfolgreich hinzugefügt bzw. entfernt wurden. Andernfalls lautet der Rückgabewert S_FALSE.


TOleClientSite::QueryInterface

TOleClientSite

Die Methode QueryInterface ermittelt eine Schnittstelle des OLE-Objekts.

virtual long __stdcall QueryInterface(const GUID &iid, void *obj);

Beschreibung

Mit QueryInterface wird eine Schnittstelle ermittelt, die das OLE-Objekt unterstützt.

Mit iid wird die IID der Schnittstelle bezeichnet. Eine IID ist die spezialisierte Form einer GUID-Struktur, die einen Schnittstellenbezeichner enthält. Weitere Informationen finden Sie in der Datei OLE.HLP unter GUID.

Die Variable obj speichert die Schnittstelle.

QueryInterface gibt den Wert S_OK zurück, wenn das Objekt die Schnittstelle unterstützt, andernfalls den Wert S_FALSE.

Weitere Informationen zu QueryInterface finden Sie in der Datei OLE.HLP.


TOleClientSite::Release

TOleClientSite	Siehe auch

Die Methode Release dekrementiert den Referenzzähler für das TOleClientSite-Objekt.

virtual long __stdcall Release(void);

Beschreibung

Mit Release wird der Referenzzähler für das TOleClientSite-Objekt dekrementiert. Sobald der Zählerstand den Wert Null erreicht, wird das Objekt freigegeben.

Release gibt den neuen Wert des Referenzzählers zurück.


TOleClientSite::RequestNewObjectLayout

TOleClientSite

Die Methode RequestNewObjectLayout benachrichtigt den Container, mehr oder weniger Speicher für das OLE-Objekt verfügbar zu machen.

virtual long __stdcall RequestNewObjectLayout(void);

Beschreibung

Mit RequestNewObjectLayout wird der Container veranlaßt, den Speicher für ein OLE-Objekt in der Größe anzupassen.

RequestNewObjectLayout gibt nach erfolgreicher Ausführung den Wert S_OK zurück, andernfalls E_NOTIMPL.


TOleClientSite::SaveObject

TOleClientSite	Siehe auch

Die Methode SaveObject speichert das OLE-Objekt.

virtual long __stdcall SaveObject(void);

Beschreibung

Mit SaveObject wird das OLE-Objekt gespeichert.

SaveObject gibt den Wert S_OK zurück, wenn das Objekt gespeichert wurde, andernfalls lautet der Rückgabewert E_FAIL.


TOleClientSite::ShowObject

TOleClientSite	Siehe auch

Die Methode ShowObject veranlaßt den Container, das OLE-Objekt anzuzeigen.

virtual long __stdcall ShowObject(void);

Beschreibung

Mit ShowObject wird der Container benachrichtigt, daß das OLE-Objekt angezeigt werden soll.

ShowObject gibt den Wert S_OK zurück, wenn der Container diese Aktion versucht hat, andernfalls wird der Wert OLE_E_NOT_SUPPORTED zurückgegeben und damit angezeigt, daß es sich um einen Container der OLE-Version 1 handelt.


TOleClientSite::TOleClientSite

TOleClientSite	Siehe auch

Der Konstruktor TOleClientSite erzeugt ein neues TOleClientSite-Objekt.

__fastcall TOleClientSite(TOleControl* Control);

Beschreibung

Mit TOleClientSite können Sie eine neue Instanz eines TOleClientSite-Objekts erzeugen.

Control ist das OLE-Steuerelement, das der Client-Anwendung zugeordnet ist.


Hierarchie

TObject

IUnknown

IOleClientSite


TOleClientSite Beispiel

TOleClientSite


TOleControlSite

Hierarchie	Methoden	Siehe auch

Header

vcl/olectrls.hpp

TOleControlSite ist ein Objekt, das die Schnittstelle IOleControlSite kapselt.

Beschreibung

Setzen Sie TOleControlSite in Verbindung mit einem OLE-Steuerelement ein.

Weitere Informationen über diese Schnittstelle finden Sie auf der neuesten CD ãMicrosoft Developer Network„ oder in den WWW-Seiten von Microsoft unter http://www.microsoft.com.


Methoden von TOleControlSite

TOleControlSite	Alphabetisch

In TOleControlSite

~TOleControlSite

AddRef

GetExtendedControl

LockInPlaceActive

OnControlInfoChanged

OnFocus

QueryInterface

Release

ShowPropertyFrame

TOleControlSite

TransformCoords

TranslateAccelerator

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TOleControlSite

TOleControlSite	Nach Objekten

~TOleControlSite

AddRef

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

FreeInstance

Free

GetExtendedControl

InheritsFrom

InitInstance

InstanceSize

LockInPlaceActive

MethodAddress

MethodName

NewInstance

OnControlInfoChanged

OnFocus

QueryInterface

Release

ShowPropertyFrame

TOleControlSite

TransformCoords

TranslateAccelerator


TOleControlSite::~TOleControlSite

TOleControlSite

Der Destruktor ~TOleControlSite gibt den Speicher frei, der für das TOleControlSite-Objekt reserviert war. Rufen Sie ~TOleControlSite nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TOleControlSite automatisch aufgerufen wird.

__fastcall virtual ~TOleControlSite(void);


TOleControlSite::AddRef

TOleControlSite	Siehe auch

AddRef inkrementiert den Referenzzähler für das TOleControlSite-Objekt.

virtual long __stdcall AddRef(void);

Beschreibung

Mit AddRef wird der Referenzzähler für das TOleControlSite-Objekt erhöht. Das Objekt wird erst dann freigegeben, wenn dieser Zähler auf Null steht.

AddRef gibt den neuen Stand des Referenzzählers zurück.


TOleControlSite::GetExtendedControl

TOleControlSite

Die Methode GetExtendedControl ermittelt die Schnittstelle für das Extended-Control-Objekt des Containers.

virtual long __stdcall GetExtendedControl(Ole2::IDispatch* &disp);

Beschreibung

Mit GetExtendedControl kann die Schnittstelle für das Extended-Control-Objekt des Containers bestimmt werden. Informationen über das Extended-Control-Objekt finden Sie auf den Microsoft-WWW-Seiten (http://www.microsoft.com) oder auf der aktuellen CD ãMicrosoft Developer Network„.


TOleControlSite::LockInPlaceActive

TOleControlSite

Die Methode LockInPlaceActive sorgt dafür, daß ein OLE-Steuerelement aktiv bleibt.

virtual long __stdcall LockInPlaceActive(DWORD fLock);

Beschreibung

Das OLE-Steuerelement bleibt auch nach solchen Ereignissen aktiv, die es normalerweise deaktivieren würden.


TOleControlSite::OnControlInfoChanged

TOleControlSite	Siehe auch

Die Methode OnControlInfoChanged wird aufgerufen, sobald sich die Signalisierungsbits MiscStatus des OLE-Steuerelements ändern.

virtual long __stdcall OnControlInfoChanged(void);

Beschreibung

OnControlInfoChanged wird so überschrieben, daß ein bestimmter Vorgang startet, sobald sich die MiscStatus-Informationsbits des OLE-Steurelements ändern. Informationen zu den MiscStatus-Bits finden Sie auf den Microsoft-WWW-Seiten (http://www.microsoft.com) oder auf der aktuellen CD ãMicrosoft Developer Network„.

Per Vorgabe liefert OnControlInfoChanged den Wert E_NOTIMPL zurück und zeigt damit an, daß das Ereignis OnControlInfoChanged nicht verarbeitet wird.


TOleControlSite::OnFocus

TOleControlSite	Siehe auch

Die Methode OnFocus wird aufgerufen, sobald das OLE-Steuerelement den Fokus erhält.

virtual long __stdcall OnFocus(DWORD fGotFocus);

Beschreibung

Überschreiben Sie OnFocus so, daß ein bestimmter Vorgang startet, sobald das OLE-Steuerelement in der zugehörigen Anwendung den Fokus erhält.

Per Vorgabe liefert OnFocus den Wert E_NOTIMPL zurück und zeigt damit an, daß das Ereignis OnFocus nicht verarbeitet wird.


TOleControlSite::QueryInterface

TOleControlSite

Die Methode QueryInterface ermittelt eine Schnittstelle des OLE-Steuerlements.

virtual long __stdcall QueryInterface(const GUID &iid, void *obj);

Beschreibung

Mit QueryInterface kann eine Schnittstelle des OLE-Steuerlements identifiziert werden.

Der Parameter iid bezeichnet die IID für die Schnittstelle. Eine IID ist eine Sonderform einer GUID-Struktur, die einen Schnittstellenbezeichner enthält. Weitere Informationen finden Sie in der Datei OLE.HLP unter GUID.

Die Variable obj speichert die Schnittstelle.

QueryInterface liefert den Wert S_OK zurück, wenn das Objekt die Schnittstelle unterstützt, andernfalls lautet der Rückgabewert S_FALSE.

Weitere Informationen über QueryInterface finden Sie in der Datei OLE.HLP.


TOleControlSite::Release

TOleControlSite	Siehe auch

Die Methode Release dekrementiert den Referenzzähler des TOleControlSite-Objekts.

virtual long __stdcall Release(void);

Beschreibung

Mit Release wird der Referenzzähler für das TOleControlSite-Objekt dekrementiert. Ein Objekt wird erst dann freigegeben, wenn dessen Referenzzähler auf Null steht.

Release gibt den neuen Zählerwert zurück.


TOleControlSite::ShowPropertyFrame

TOleControlSite	Siehe auch

Die Methode ShowPropertyFrame benachrichtigt das Steuerelement, daß dessen Eigenschaftsfenster angezeigt werden soll.

virtual long __stdcall ShowPropertyFrame(void);

Beschreibung

Mit ShowPropertyFrame wird das Steuerelement veranlaßt, dessen Eigenschaftsfenster anzuzeigen.

Wenn ShowPropertyFrame den Standardwert E_NOTIMPL zurückgibt, zeigt der Container sein eigenes Eigenschaftsfenster an.


TOleControlSite::TOleControlSite

TOleControlSite	Siehe auch

Der Konstruktor TOleControlSite erzeugt ein neues TOleControlSite-Objekt.

__fastcall TOleControlSite(TOleControl* Control);

Beschreibung

Mit TOleControlSite können Sie eine neue Instanz eines TOleControlSite-Objekts erzeugen.

Control ist das OLE-Steuerelement, das der OLE-Containeranwendung zugeordnet ist.


TOleControlSite::TransformCoords

TOleControlSite	Siehe auch

TransformCoords transformiert einen Punkt aus dem Koordinatensystem des Containers in das Koordinatensystem des OLE-Steuerlements.

virtual long __stdcall TransformCoords(POINT &ptlHimetric, POINTF &ptfContainer, long flags);

Beschreibung

Mit TransformCoords werden die Koordinaten eines Punktes aus dem Koordinatensystem des Containers in das Koordinatensystem des Steuerelements eingerechnet.


TOleControlSite::TranslateAccelerator

TOleControlSite	Siehe auch

Die Methode TranslateAccelerator interpretiert Tastenkürzel, die an den Container gerichtet sind.

virtual long __stdcall TranslateAccelerator(Windows::PMsg msg, long grfModifiers);

Beschreibung

Mit TranslateAccelerator werden Tastenkürzel für den Container übersetzt.

Der Parameter msg ist eine MSG-Struktur mit der Tastenkürzel-Botschaft.

Der Parameter grfModifiers enthält den Befehlsbezeichner, welcher der Tastenfolge in der Tabelle des Containers entspricht. Die Container-Anwendung sollten diesen Wert verwenden, anstatt eine erneute Umwandlung vorzunehmen.

TranslateAccelerator gibt einen der folgenden Werte zurück:

Wert	Bedeutung

S_OK	Das Tastenkürzel wurde verwendet.

S_FALSE	Das Tastenkürzel wurde nicht verwendet.

E_INVALIDARG	Ein oder mehrere Argumente waren ungültig.

E_UNEXPECTED	Unerwarteter Fehler aufgetreten.


Hierarchie

TObject

IUnknown

IOleControlSite


TOleControlSite Beispiel

TOleControlSite


 TOleContainer

Hierarchie	Eigenschaften	Methoden	Ereignisse

Header

vcl/olecntnrs.hpp

Mit der Komponente TOleContainer können in einer C++Builder-Anwendung OLE-Objekte eingebettet oder verknüpft werden. TOleContainer implementiert viele komplexe Funktionen von OLE 2.0 und erleichtert Ihnen dadurch spürbar die Arbeit. Das Anzeigen eines Dialogfeldes, in dem der Benutzer ein OLE-Objekt auswählen kann, wird beispielsweise einfach durch einen Aufruf der Methode InsertObjectDialog bewerkstelligt. Mit den Methoden CreateObject bzw. CreateObjectFromFile können Sie eingebettete, mit CreateLinkToFile dagegen verknüpfte OLE-Objekte erzeugen.

TOleContainer sorgt außerdem für die automatische Kombination der Menüs, d.h. für die Vermischung des Menüs des Container-Formulars mit dem Menü der Server-Anwendung eines aktivierten OLE-Objekts. Die Eigenschaft GroupIndex bestimmt, wie mit den einzelnen Menüeinträgen verfahren wird. Die Hauptmenüeinträge mit den GroupIndex-Werten 0, 2 und 4 bleiben erhalten. Die Einträge mit den GroupIndex-Werten von 1, 3 oder 5 (falls vorhanden) werden durch die Einträge der Server-Anwendung ersetzt. Bei einem MDI-Formular mit einem traditionellen Hauptmenü könnten Sie der Eigenschaft GroupIndex der Menüs beispielsweise folgende Werte zuweisen:

Menü	GroupIndex

Datei	0

Bearbeiten	1

Objekt	2

Fenster	4

Hilfe	5

In diesem Fall werden die Menüs Datei, Objekt und Fenster beibehalten, während die Menüs Bearbeiten und Hilfe durch die entsprechenden Menüs der Server-Anwendung ersetzt werden.

Beachten Sie, daß das Fehlen eines Menüs mit dem GroupIndex-Wert 3 keinerlei Problem verursacht.

Wenn ein OLE-Objekt aktiviert wird, werden die Werkzeugleisten seines Servers direkt in das Anwendungsfenster übernommen. Normalerweise werden alle als Werkzeugleisten verwendeten Tafeln durch die Werkzeugleisten des OLE-Servers ersetzt. Sie können dies verhindern, indem Sie die Eigenschaft Locked der Tafel auf True setzen. In diesem Fall entfernt TOleContainer die Tafel nicht, um für die Werkzeugleiste des Servers Platz zu schaffen.

Beachten Sie, daß die Werkzeugleisten Ihrer Anwendung am Rand des Formulars ausgerichtet sein müssen (d.h. die Eigenschaft Align der Tafel muß auf alTop, alBottom, alLeft oder alRight gesetzt sein).

Wenn Sie eine TOleContainer-Komponente in einer SDI-Anwendung einsetzen wollen (die Eigenschaft FormStyle des Hauptformulars ist in diesem Fall nicht fsMDIForm, sondern fsNormal), sollten Sie sie in einer Tafel plazieren, deren Eigenschaft Align auf alClient gesetzt ist. Die Werkzeugleisten des SDI-Formulars werden von TOLEContainer wie oben beschrieben ersetzt, und durch die Verwendung einer Tafel wird der für den OLE-Container verfügbare Raum automatisch eingeschränkt.


Eigenschaften von TOleContainer

TOleContainer	Alphabetisch	Legende

In TOleContainer

AllowInPlace

AutoActivate

AutoVerbMenu

BorderStyle

CanPaste

CopyOnSave

Iconic

Linked

Modified

NewInserted

ObjectVerbs

OleClassName

OleObject

OleObjectInterface

PrimaryVerb

SizeMode

SourceDoc

State

StorageInterface

Abgeleitet von TWinControl

Brush

ClientOrigin

ClientRect

ControlCount

Controls

Ctl3D

Handle

HelpContext

ParentCtl3D

Showing

TabOrder

TabStop

Abgeleitet von TControl

Align

BoundsRect

Caption

ClientHeight

ClientWidth

Color

ControlState

ControlStyle

Cursor

DragCursor

DragMode

Enabled

Height

Hint

Left

Name

Parent

ParentColor

ParentShowHint

PopupMenu

ShowHint

Top

Visible

Width

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TOleContainer

TOleContainer	Nach Objekten	Legende

Align

AllowInPlace

AutoActivate

AutoVerbMenu

BorderStyle

BoundsRect

Brush

CanPaste

Caption

ClientHeight

ClientOrigin

ClientRect

ClientWidth

Color

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlCount

ControlState

Controls

ControlStyle

CopyOnSave

Ctl3D

Cursor

DesignInfo

DragCursor

DragMode

Enabled

Handle

Height

HelpContext

Hint

Iconic

Left

Linked

Modified

Name

NewInserted

ObjectVerbs

OleClassName

OleObjectInterface

OleObject

Owner

ParentColor

ParentCtl3D

ParentShowHint

Parent

PopupMenu

PrimaryVerb

ShowHint

Showing

SizeMode

SourceDoc

State

StorageInterface

TabOrder

TabStop

Tag

Top

Visible

Width


TOleContainer::AllowInPlace

TOleContainer

Die Eigenschaft AllowInPlace bestimmt, ob ein OLE-Objekt an Ort und Stelle aktiviert werden kann.

__property bool AllowInPlace;

Wenn AllowInPlace True und Iconic False ist, kann das Objekt an Ort und Stelle aktiviert werden. Andernfalls wird es in einem separaten Fenster aktiviert. Die Vorgabe für AllowInPlace ist True.


TOleContainer::AutoActivate

TOleContainer

Die Eigenschaft AutoActivate legt fest, wie ein Objekt in einem OLE-Container aktiviert werden kann.

__property TAutoActivate AutoActivate;

AutoActivate kann einen der folgenden Werte annehmen:

Wert	Bedeutung

aaManual	Die Aktivierung des Objekts durch den Benutzer ist nicht möglich. Programmseitig können Sie das OLE-Objekt durch einen Aufruf von DoVerb(ovShow) aktivieren.

aaGetFocus	Das OLE-Objekt wird aktiviert, sobald der OLE-Container den Fokus erhält (durch einen Mausklick oder durch Drücken der TAB-Taste).

aaDoubleClick	Das OLE-Objekt kann durch einen Doppelklick oder durch Drücken der EINGABE-Taste aktiviert werden, wenn der Container den Fokus hat. Dies ist der Vorgabewert.


TOleContainer::AutoVerbMenu

TOleContainer

Die Eigenschaft AutoVerbMenu legt fest, ob TOleContainer automatisch ein Popup-Menü für das OLE-Objekt anlegt.

__property bool AutoVerbMenu;

Wenn AutoVerbMenu True ist (Vorgabe), ersetzt TOleContainer die vorhandene Eigenschaft PopupMenu. Bei False wird das Popup-Menü nicht automatisch erzeugt.


TOleContainer::BorderStyle

TOleContainer	Beispiel

Die Eigenschaft BorderStyle, ob  über einen Rahmen verfügen.

__property Forms::TBorderStyle BorderStyle;

Die Eigenschaft BorderStyle kann folgende Werte annehmen:

Wert	Bedeutung

bsNone	Kein sichtbarer Rahmen.

bsSingle	Einfacher Rahmen.

Eingabefelder, deren Eigenschaft AutoSize True ist, ändern automatisch ihre Größe, wenn sich die Schriftgröße des enthaltenen Textes ändert. AutoSize ist jedoch nur wirksam, wenn BorderStyle bsSingle ist.


TOleContainer::CanPaste

TOleContainer

Die Eigenschaft CanPaste gibt an, ob sich die Daten in der Zwischenablage von Windows zum Einfügen als eingebettetes Objekt eignen.

__property bool CanPaste;


TOleContainer::CopyOnSave

TOleContainer

Die Eigenschaft CopyOnSave bestimmt, ob bei einem Aufruf der Methoden SaveToFile und SaveToStream eine temporäre OLE-Objektablage angelegt wird, um redundante Daten zu komprimieren und Speicherplatz zu sparen.

__property bool CopyOnSave;

Setzen Sie CopyOnSave auf False, wenn der Container sehr große eingebettete Objekte enthält und möglicherweise nicht genügend Speicher zum Anlegen der temporären Kopie verfügbar ist. Die Vorgabe für CopyOnSave ist True.


TOleContainer::Iconic

TOleContainer

Die Eigenschaft Iconic legt fest, wie das OLE-Objekt angezeigt wird.

__property bool Iconic;

Wenn Iconic True ist, wird das Objekt als Symbol angezeigt. Bei False wird es angezeigt wie in der Server-Anwendung.


TOleContainer::Linked

TOleContainer

Die Eigenschaft Linked gibt an, ob es sich um ein verknüpftes OLE-Objekt handelt. Wenn Linked True ist, ist das Objekt verknüpft. Ist Linked False, handelt es sich um ein eingebettetes Objekt.

__property bool Linked;

Der Zugriff auf diese Eigenschaft ist nur möglich, wenn das Objekt bereits in den Container geladen wurde.


TOleContainer::Modified

TOleContainer	Beispiel

Die Eigenschaft Modified gibt an, ob das OLE-Objekt verändert wurde (es kann auch gelöscht oder durch ein anderes OLE-Objekt ersetzt worden sein).

__property bool Modified;

Indem Sie die Eigenschaft Modified auf False setzen und sie zu einem späteren Zeitpunkt erneut überprüfen, können Sie feststellen, ob das OLE-Objekt geändert wurde. Wenn kein OLE-Objekt in den Container geladen wurde, gibt Modified False zurück.


TOleContainer::NewInserted

TOleContainer

Die Eigenschaft NewInserted gibt an, ob das OLE-Objekt neu erzeugt wurde (durch einen Aufruf von InsertObjectDialog), oder ob es eingefügt bzw. als Verknüpfung mit einer Datei erzeugt wurde.

__property bool NewInserted;

Wenn kein OLE-Objekt in den Container geladen wurde, liefert NewInserted False zurück. Hat NewInserted nach einem Aufruf der Methode InsertObjectDialog den Wert True, können Sie DoVerb(ovShow) aufrufen, um dem Benutzer die Bearbeitung des Objekts zu ermöglichen.


TOleContainer::ObjectVerbs

TOleContainer

Die Eigenschaft ObjectVerbs gibt eine String-Liste mit den Namen der Verben zurück, die vom OLE-Objekt unterstützt werden.

__property Classes::TStrings* ObjectVerbs;

In den Verben enthaltene &-Zeichen stellen Tastenkürzel dar. Der Zugriff auf die Eigenschaft ObjectVerbs ist nur möglich, wenn das Objekt bereits in den Container geladen wurde.


TOleContainer::OleClassName

TOleContainer

Die Eigenschaft OleClassName gibt den Klassennamen des OLE-Objekts zurück. Der Zugriff auf die Eigenschaft OleClassName ist nur möglich, wenn das Objekt bereits in den Container geladen wurde.

__property System::AnsiString OleClassName;


TOleContainer::OleObject

TOleContainer

Bei TAutoObject stellt die Eigenschaft OleObject eine Variante bereit, die das Automatisierungsobjekt enthält.

__property System::Variant OleObject;

Wenn Ihr Server ein OLE-Objekt an einen Controller übergeben muß, erwartet dieser die Übergabe einer Variante. Deshalb sollten Sie ein Automatisierungsobjekt nie direkt referenzieren, sondern immer über die Eigenschaft OleObject.

Bei TOleContainer gibt die Eigenschaft OleObject (schreibgeschützt und nur zur Laufzeit) ein OLE-Automatisierungsobjekt zurück. Wenn das OLE-Objekt keine OLE-Automatisierung unterstützt, wird eine Exception ausgelöst. Der Zugriff auf die Eigenschaft OleObject ist nur möglich, wenn das Objekt bereits in den Container geladen wurde.


TOleContainer::OleObjectInterface

TOleContainer

Die Eigenschaft OleObjectInterface gibt die IOleObject-Schnittstelle für das OLE-Objekt zurück. Diese Schnittstelle kann für Low-Level-Zugriffe auf die OLE-API benutzt werden.

__property Ole2::IOleObject* OleObjectInterface;

Wenn kein OLE-Objekt in den Container geladen wurde, liefert OleObjectInterface NULL zurück.


TOleContainer::PrimaryVerb

TOleContainer

Die Eigenschaft PrimaryVerb gibt den Index des primären (voreingestellten) Verbs zurück. Dieser Index kann der Methode DoVerb übergeben werden.

__property int PrimaryVerb;

DoVerb(ovPrimary) ist identisch mit DoVerb(PrimaryVerb). Sie können den Index auch zusammen mit der Eigenschaft ObjectVerbs verwenden, um den Namen des primären Verbs anzuzeigen. Der Zugriff auf die Eigenschaft PrimaryVerb ist nur möglich, wenn das Objekt bereits in den Container geladen wurde.


TOleContainer::SizeMode

TOleContainer

Die Eigenschaft SizeMode legt fest, in welcher Größe das OLE-Objekt im Container angezeigt wird.

__property TSizeMode SizeMode;

Die möglichen Werte für SizeMode finden Sie bei der Beschreibung von TSizeMode.


TOleContainer::SourceDoc

TOleContainer

Die Eigenschaft SourceDoc gibt den Namen des Quelldokuments eines verknüpften OLE-Objekts zurück.

__property System::AnsiString SourceDoc;

Der Zugriff auf diese Eigenschaft nur möglich, wenn das Objekt bereits in den Container geladen wurde. Wenn das OLE-Objekt nicht verknüpft ist, gibt SourceDoc einen leeren String zurück.


TOleContainer::State

TOleContainer	Beispiel

Die Eigenschaft State gibt den Status des OLE-Objekts zurück

__property TObjectState State;

Der Aufzählungstyp TObjectState definiert die möglichen Werte für diese Eigenschaft.

Wert	Bedeutung

osEmpty	Der Container enthält kein OLE-Objekt.

osLoaded	Der Container enthält zwar ein OLE-Objekt, die Server-Anwendung des Objekts wird aber momentan nicht ausgeführt.

osRunning	Die Server-Anwendung des OLE-Objekts wird ausgeführt.

osOpen	Das OLE-Objekt ist in einem separaten Fenster geöffnet.

osInPlaceActive	Das OLE-Objekt ist zwar aktiviert, die zugehörigen Menüs bzw. Werkzeugleisten wurden aber noch nicht kombiniert. Dieser Status stellt eine Zwischenstufe dar. State wird auf osUIActive gesetzt, sobald die Menüs und Werkzeugleisten kombiniert wurden.

osUIActive	Das OLE-Objekt ist aktiviert, und die Menüs und Werkzeugleisten wurden kombiniert.


TOleContainer::StorageInterface

TOleContainer

Die Eigenschaft StorageInterface gibt die IStorage-Schnittstelle für das OLE-Objekt zurück. Diese Schnittstelle kann für Low-Level-Zugriffe auf die OLE-API benutzt werden.

__property Ole2::IStorage* StorageInterface;

Wenn kein OLE-Objekt in den Container geladen wurde, gibt StorageInterface NULL zurück.


Ereignisse von TOleContainer

TOleContainer	Alphabetisch	Legende

In TOleContainer

OnActivate

OnDeactivate

OnObjectMove

OnResize

Abgeleitet von TWinControl

OnEnter

OnExit

OnKeyDown

OnKeyPress

OnKeyUp

Abgeleitet von TControl

OnDragDrop

OnDragOver

OnEndDrag

OnMouseDown

OnMouseMove

OnMouseUp

OnStartDrag


Ereignisse von TOleContainer

TOleContainer	Nach Objekten	Legende

OnActivate

OnDeactivate

OnDragDrop

OnDragOver

OnEndDrag

OnEnter

OnExit

OnKeyDown

OnKeyPress

OnKeyUp

OnMouseDown

OnMouseMove

OnMouseUp

OnObjectMove

OnResize

OnStartDrag


TOleContainer::OnActivate

TOleContainer

Dieses Ereignis tritt ein, wenn der Container aktiviert wird.

typedef void __fastcall (__closure *TNotifyEvent)(System::TObject* Sender);

__property Classes::TNotifyEvent OnActivate;


TOleContainer::OnDeactivate

TOleContainer

Dieses Ereignis tritt ein, wenn der Container deaktiviert wird.

typedef void __fastcall (__closure *TNotifyEvent)(System::TObject* Sender);

__property Classes::TNotifyEvent OnDeactivate;


OnDragDrop

Dieses Ereignis tritt ein, wenn der Container das Ziel einer Drag-and-Drop-Operation ist.

__property OnDragDrop;


OnDragOver

Dieses Ereignis tritt ein, wenn ein Objekt über den Container gezogen wird.

__property OnDragOver;


OnEndDrag

Dieses Ereignis tritt ein, wenn eine Drag-and-Drop-Operation über dem Container beendet wird.

__property OnEndDrag;


OnEnter

Dieses Ereignis tritt ein, wenn der Benutzer die EINGABE-Taste drückt, während der Container fokussiert ist.

__property OnEnter;


OnExit

Dieses Ereignis tritt ein, wenn der Container geschlossen wird.

__property OnExit;


OnKeyDown

Dieses Ereignis tritt ein, wenn eine Taste gedrückt ist, während der Container fokussiert ist.

__property OnKeyDown;


OnKeyPress

Dieses Ereignis tritt ein, wenn eine Taste gedrückt wird, während der Container fokussiert ist.

__property OnKeyPress;


OnKeyUp

Dieses Ereignis tritt ein, wenn eine Taste losgelassen wird, während der Container fokussiert ist.

__property OnKeyUp;


OnMouseDown

Dieses Ereignis tritt ein, wenn eine Maustaste gedrückt wird, während der Container fokussiert ist.

__property OnMouseDown;


OnMouseMove

Dieses Ereignis tritt ein, wenn der Mauszeiger bewegt wird, während der Container fokussiert ist.

__property OnMouseMove;


OnMouseUp

Dieses Ereignis tritt ein, wenn eine Maustaste losgelassen wird, während der Container fokussiert ist.

__property OnMouseUp;


TOleContainer::OnObjectMove

TOleContainer

Dieses Ereignis tritt ein, wenn ein Objekt innerhalb des Containers bewegt wird.

typedef void __fastcall (__closure *TObjectMoveEvent)(TOleContainer* OleContainer, const Windows::TRect &Bounds);

__property TObjectMoveEvent OnObjectMove;


TOleContainer::OnResize

TOleContainer

Dieses Ereignis tritt ein, wenn die Größe des Containers verändert wird.

typedef void __fastcall (__closure *TNotifyEvent)(System::TObject* Sender);

__property Classes::TNotifyEvent OnResize;


OnStartDrag

Dieses Ereignis tritt ein, wenn über dem Container eine Drag-and-Drop-Operation beginnt.

__property OnStartDrag;


Methoden von TOleContainer

TOleContainer	Alphabetisch

In TOleContainer

~TOleContainer

ChangeIconDialog

Close

CreateLinkToFile

CreateObject

CreateObjectFromFile

CreateObjectFromInfo

DestroyObject

DoVerb

GetIconMetaPict

InsertObjectDialog

LoadFromFile

LoadFromStream

ObjectPropertiesDialog

Paste

PasteSpecialDialog

Run

SaveToFile

SaveToStream

TOleContainer

UpdateObject

UpdateVerbs

Abgeleitet von TWinControl

Broadcast

CanFocus

ContainsControl

ControlAtPos

DisableAlign

EnableAlign

Focused

GetTabOrderList

HandleAllocated

HandleNeeded

InsertControl

Invalidate

PaintTo

Realign

RemoveControl

Repaint

ScaleBy

ScrollBy

SetBounds

SetFocus

Update

UpdateControlState

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

GetTextLen

Hide

Perform

Refresh

ScreenToClient

SendToBack

SetTextBuf

Show

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TOleContainer

TOleContainer	Nach Objekten

~TOleContainer

Assign

BeginDrag

BringToFront

Broadcast

CanFocus

ChangeIconDialog

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

ClientToScreen

Close

ContainsControl

ControlAtPos

CreateLinkToFile

CreateObjectFromFile

CreateObjectFromInfo

CreateObject

DefaultHandler

DestroyComponents

Destroying

DestroyObject

DisableAlign

Dispatch

DoVerb

DragDrop

Dragging

EnableAlign

EndDrag

FieldAddress

FindComponent

Focused

FreeInstance

FreeNotification

Free

GetIconMetaPict

GetParentComponent

GetTabOrderList

GetTextBuf

GetTextLen

HandleAllocated

HandleNeeded

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InsertControl

InsertObjectDialog

InstanceSize

Invalidate

LoadFromFile

LoadFromStream

MethodAddress

MethodName

NewInstance

ObjectPropertiesDialog

PaintTo

PasteSpecialDialog

Paste

Perform

Realign

Refresh

RemoveComponent

RemoveControl

Repaint

Run

SaveToFile

SaveToStream

ScaleBy

ScreenToClient

ScrollBy

SendToBack

SetBounds

SetFocus

SetTextBuf

Show

TOleContainer

UpdateControlState

UpdateObject

Update

UpdateVerbs


TOleContainer::~TOleContainer

TOleContainer

Der Destruktor ~TOleContainer gibt den Speicher frei, der für das TOleContainer-Objekt reserviert war. Rufen Sie ~TOleContainer nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TOleContainer automatisch aufgerufen wird.

__fastcall virtual ~TOleContainer(void);


TOleContainer::ChangeIconDialog

TOleContainer

Die Methode ChangeIconDialog führt ein Dialogfeld aus, in dem der Benutzer (aus ICO-, DLL- und EXE-Dateien) das Symbol auswählen kann, das bei der Anzeige des OLE-Objekts verwendet wird.

bool __fastcall ChangeIconDialog(void);

ChangeIconDialog kann erst aufgerufen werden, wenn ein OLE-Objekt in den Container geladen wurde. ChangeIconDialog gibt True zurück, wenn das Dialogfeld angezeigt wurde und der Benutzer OK gewählt hat, ansonsten False. Indem Sie Iconic auf True setzen, können Sie den Container dazu veranlassen, das OLE-Objekt als Symbol anzuzeigen.


TOleContainer::Close

TOleContainer

Die Methode Close deaktiviert das OLE-Objekt und beendet seine Server-Anwendung. Das Objekt wird aber nicht aus dem Container entfernt.

void __fastcall Close(void);

Die Methode Close deaktiviert das OLE-Objekt und beendet seine Server-Anwendung. Das Objekt wird aber nicht aus dem Container entfernt.

Alle Änderungen, die der Benutzer an dem Objekt vorgenommen hat, werden automatisch gespeichert. Damit Close aufgerufen werden kann, muß sich ein OLE-Objekt im Container befinden. Nach dem Aufruf von Close hat die Eigenschaft State des Containers den Wert osLoaded.


Copy

Die Methode Copy kopiert das OLE-Objekt in die Zwischenablage von Windows

void __fastcall Copy(void);

Damit Copy aufgerufen werden kann, muß sich ein OLE-Objekt im Container befinden.


TOleContainer::CreateLinkToFile

TOleContainer

Die Methode CreateLinkToFile erzeugt aus dem Inhalt der angegebenen Datei ein verknüpftes OLE-Objekt.

void __fastcall CreateLinkToFile(const System::AnsiString FileName, bool Iconic);

Iconic gibt an, ob das Objekt als Symbol (True) oder in der gleichen Form wie in der Server-Anwendung (False) angezeigt wird. Wenn sich bereits ein OLE-Objekt im Container befindet, wird dieses freigeben. Alle Änderungen, die der Benutzer daran vorgenommen hat, werden verworfen.


TOleContainer::CreateObject

TOleContainer

Die Methode CreateObject erzeugt ein eingebettetes OLE-Objekt mit dem angegebenen Klassennamen (auch Programm-ID genannt).

void __fastcall CreateObject(const System::AnsiString OleClassName, bool Iconic);

Iconic gibt an, ob das Objekt als Symbol (True) oder in der gleichen Form wie in der Server-Anwendung (False) angezeigt wird. Wenn sich bereits ein OLE-Objekt im Container befindet, wird dieses freigeben. Alle Änderungen, die der Benutzer daran vorgenommen hat, werden verworfen.


TOleContainer::CreateObjectFromFile

TOleContainer

Die Methode CreateObjectFromFile erzeugt aus dem Inhalt der angegebenen Datei ein eingebettetes OLE-Objekt.

void __fastcall CreateObjectFromFile(const System::AnsiString FileName, bool Iconic);

Iconic gibt an, ob das Objekt als Symbol (True) oder in der gleichen Form wie in der Server-Anwendung (False) angezeigt wird. Wenn sich bereits ein OLE-Objekt im Container befindet, wird dieses freigeben. Alle Änderungen, die der Benutzer daran vorgenommen hat, werden verworfen.


TOleContainer::CreateObjectFromInfo

TOleContainer

Die Methode CreateObjectFromInfo erzeugt ein OLE-Objekt, das auf den Angaben in einer TCreateInfo-Struktur basiert.

void __fastcall CreateObjectFromInfo(const TCreateInfo &CreateInfo);

Informationen über die Felder des TCreateInfo-Records finden Sie in der Beschreibung von TCreateInfo und TCreateType. Wenn sich bereits ein OLE-Objekt im Container befindet, wird dieses freigeben. Alle Änderungen, die der Benutzer daran vorgenommen hat, werden verworfen. Die einfachste Möglichkeit, die gängigen OLE-Objekttypen zu erzeugen, stellen die Methoden CreateLinkToFile, CreateObject und CreateObjectFromFile dar, denn bei ihnen brauchen Sie keinen TCreateInfo-Struktur auszufüllen.


TOleContainer::DestroyObject

TOleContainer

Die Methode DestroyObject gibt das OLE-Objekt des Containers frei.

void __fastcall DestroyObject(void);

Alle Änderungen, die der Benutzer an dem Objekt vorgenommen hat, werden verworfen.


TOleContainer::DoVerb

TOleContainer

Die Methode DoVerb veranlaßt das OLE-Objekt zur Ausführung einer Aktion.

void __fastcall DoVerb(int Verb);

OLE definiert verschiedene Verben, unter anderem ovShow (zeigt das OLE-Objekt an) und ovPrimary (führt die Standardaktion aus, normalerweise die Anzeige des OLE-Objekts). OLE-Objekte können auch ihre eigenen Verben definieren. Über die Eigenschaft ObjectVerbs erhalten Sie eine Liste dieser benutzerdefinierten Verben.


TOleContainer::GetIconMetaPict

TOleContainer

Die Methode GetIconMetaPict gibt das globale Speicher-Handle der Metadatei zurück, die das Symbol des OLE-Objekts enthält.

int __fastcall GetIconMetaPict(void);

Damit GetIconMetaPict aufgerufen werden kann, muß sich ein OLE-Objekt im Container befinden. Zur Freigabe des Handles verwenden Sie die Prozedur DestroyMetaPict.


TOleContainer::InsertObjectDialog

TOleContainer

Die Methode InsertObjectDialog führt ein Dialogfeld aus, mit dem der Benutzer ein eingebettetes oder ein verknüpftes OLE-Objekt erzeugen kann.

bool __fastcall InsertObjectDialog(void);

InsertObjectDialog gibt True zurück, wenn das Dialogfeld angezeigt wurde und der Benutzer OK gewählt hat, ansonsten False. Wenn der Benutzer auf OK klickt und sich bereits ein OLE-Objekt im Container befindet, wird dieses freigeben. Alle Änderungen, die daran vorgenommen wurden, werden verworfen.


TOleContainer::LoadFromFile

TOleContainer

Die Methode LoadFromFile lädt ein OLE-Objekt aus der angegebenen Datei.

void __fastcall LoadFromFile(const System::AnsiString FileName);

Wenn sich bereits ein OLE-Objekt im Container befindet, wird dieses freigeben. Alle Änderungen, die der Benutzer daran vorgenommen hat, werden verworfen. Wenn OldStreamFormat den Wert False hat, lädt LoadFromFile nur Dateien, die mit der TOleContainer-Komponente von Borland C++Builder gespeichert wurden. Ist OldStreamFormat True, können Dateien geladen werden, die mit der TOLEContainer-Komponente von Borland C++Builder 2.0 gespeichert wurden.


TOleContainer::LoadFromStream

TOleContainer

Die Methode LoadFromStream lädt ein OLE-Objekt aus dem angegebenen Stream.

void __fastcall LoadFromStream(Classes::TStream* Stream);


TOleContainer::ObjectPropertiesDialog

TOleContainer

Die Methode ObjectPropertiesDialog ruft ein Dialogfeld auf, in dem der Benutzer verschiedene Eigenschaften des OLE-Objekts anzeigen und bearbeiten kann.

bool __fastcall ObjectPropertiesDialog(void);

Alle Änderungen, die der Benutzer in diesem Dialogfeld vornimmt, werden automatisch in das OLE-Objekt übernommen. Damit ObjectPropertiesDialog aufgerufen werden kann, muß sich ein OLE-Objekt im Container befinden. Wenn das Dialogfeld angezeigt wurde und der Benutzer OK gewählt hat, gibt ObjectPropertiesDialog True zurück, ansonsten False.


TOleContainer::Paste

TOleContainer

Die Methode Paste fügt den Inhalt der Windows-Zwischenablage als eingebettetes Objekt ein.

void __fastcall Paste(void);

Wenn sich bereits ein OLE-Objekt im Container befindet, wird dieses freigeben. Alle Änderungen, die der Benutzer daran vorgenommen hat, werden verworfen.


TOleContainer::PasteSpecialDialog

TOleContainer

Die Methode PasteSpecialDialog ruft ein Dialogfeld auf, in dem der Benutzer festlegen kann, wie der Inhalt der Windows-Zwischenablage in den Container eingefügt wird.

bool __fastcall PasteSpecialDialog(void);

So kann er beispielsweise das Format der Daten auswählen und angeben, ob das OLE-Objekt eingebettet oder verknüpft werden soll. Außerdem kann er festlegen, ob das Objekt als Symbol angezeigt werden soll und, wenn dies der Fall ist, ein neues Symbol auswählen. PasteSpecialDialog gibt True zurück, wenn das Dialogfeld angezeigt wurde und der Benutzer OK gewählt hat, ansonsten False. Wenn der Benutzer auf OK klickt und sich bereits ein OLE-Objekt im Container befindet, wird dieses freigeben. Alle Änderungen, die daran vorgenommen wurden, werden verworfen.


TOleContainer::Run

TOleContainer

Die Methode Run startet die Server-Anwendung des OLE-Objekts.

void __fastcall Run(void);

Das OLE-Objekt selbst wird weder geöffnet noch aktiviert. Wenn die Server-Anwendung läuft, läßt sich das OLE-Objekt bedeutend schneller öffnen und aktivieren. Vor dem Aufruf von Run muß ein OLE-Objekt in den Container geladen werden.


TOleContainer::SaveToFile

TOleContainer

Die Methode SaveToFile speichert das OLE-Objekt in der angegebenen Datei.

void __fastcall SaveToFile(const System::AnsiString FileName);

Vor dem Aufruf von SaveToFile muß ein OLE-Objekt in den Container geladen werden. Wenn CopyOnSave True ist, erzeugt SaveToFile eine temporäre OLE-Objektablage und komprimiert redundante Daten, wodurch Speicherplatz gespart wird.


TOleContainer::SaveToStream

TOleContainer

Die Methode SaveToStream speichert das OLE-Objekt in dem angegebenen Stream.

void __fastcall SaveToStream(Classes::TStream* Stream);

Vor dem Aufruf von SaveToStream muß ein OLE-Objekt in den Container geladen werden. Wenn CopyOnSave True ist, erzeugt SaveToStream eine temporäre OLE-Objektablage und komprimiert redundante Daten, wodurch Speicherplatz gespart wird.


TOleContainer::TOleContainer

TOleContainer

TOleContainer erzeugt ein neues TOleContainer-Objekt.

__fastcall virtual TOleContainer(Classes::TComponent* AOwner);


TOleContainer::UpdateObject

TOleContainer

UpdateObject aktualisiert ein OLE-Objekt.

void __fastcall UpdateObject(void);

Verknüpfte OLE-Objekte und eingebettete Objekte, die verknüpfte OLE-Objekte enthalten, sind nicht mehr auf dem aktuellen Stand, sobald in der Quelle der Verknüpfung eine Änderung vorgenommen wird. UpdateObject liest die Daten der Quelle und stellt damit sicher, daß das OLE-Objekt die aktuellen Daten enthält. Wenn kein OLE-Objekt in den Container geladen wurde, hat UpdateObject keine Wirkung.


TOleContainer::UpdateVerbs

TOleContainer

Die Methode UpdateVerbs aktualisiert die Liste der Verben, auf die das OLE-Objekt reagiert.

void __fastcall UpdateVerbs(void);

TOleContainer ruft UpdateVerbs automatisch auf, wenn Sie zum ersten Mal auf die Eigenschaft ObjectVerbs zugreifen. Es besteht aber die Möglichkeit, daß bestimmte OLE-Objekte ihre Verben während der Ausführung einer Aktion ändern. Das OLE-Objekt Media Clip ändert beispielsweise sein Verb "Start" in "Stop", wenn es ausgeführt wird. Vor dem Aufruf von UpdateVerbs muß ein OLE-Objekt in den Container geladen werden.


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TControl

TWinControl

TCustomControl


TOleContainer Beispiel

TOleContainer


TOleControl

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/olectrls.hpp

TOleControl ist die Basisklasse, aus der OCX-Steuerelemente abgeleitet werden.

Beschreibung

TOleControl ist von TWinControl abgeleitet und übernimmt die Interaktion mit OLE, die nötig ist, um OCX-Steuerelemente in der Borland C++Builder-Umgebung einzusetzen. Normalerweise werden Sie von dieser Klasse keine Komponente ableiten müssen.


Eigenschaften von TOleControl

TOleControl	Alphabetisch	Legende

In TOleControl

OleObject

Abgeleitet von TWinControl

Brush

ClientOrigin

ClientRect

ControlCount

Controls

Handle

HelpContext

Showing

TabOrder

TabStop

Abgeleitet von TControl

Align

BoundsRect

ClientHeight

ClientWidth

ControlState

ControlStyle

Cursor

Enabled

Height

Hint

Left

Name

Parent

ShowHint

Top

Visible

Width

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TOleControl

TOleControl	Nach Objekten	Legende

Align

BoundsRect

Brush

ClientHeight

ClientOrigin

ClientRect

ClientWidth

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlCount

ControlState

Controls

ControlStyle

Cursor

DesignInfo

Enabled

Handle

Height

HelpContext

Hint

Left

Name

OleObject

Owner

Parent

ShowHint

Showing

TabOrder

TabStop

Tag

Top

Visible

Width


TOleControl::OleObject

TOleControl

OleObject ist das OCX-Steuerlement, das dem TOleControl-Objekt zugeordnet ist.

__property System::Variant OleObject;


Methoden von TOleControl

TOleControl	Alphabetisch

In TOleControl

~TOleControl

BrowseProperties

DoObjectVerb

GetEnumPropDesc

GetHelpContext

GetObjectVerbs

GetPropDisplayString

GetPropDisplayStrings

IsCustomProperty

SetBounds

SetPropDisplayString

ShowAboutBox

TOleControl

Abgeleitet von TWinControl

Broadcast

CanFocus

ContainsControl

ControlAtPos

DisableAlign

EnableAlign

Focused

GetTabOrderList

HandleAllocated

HandleNeeded

InsertControl

Invalidate

PaintTo

Realign

RemoveControl

Repaint

ScaleBy

ScrollBy

SetFocus

Update

UpdateControlState

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

GetTextLen

Hide

Perform

Refresh

ScreenToClient

SendToBack

SetTextBuf

Show

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TOleControl

TOleControl	Nach Objekten

~TOleControl

Assign

BeginDrag

BringToFront

Broadcast

BrowseProperties

CanFocus

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

ClientToScreen

ContainsControl

ControlAtPos

DefaultHandler

DestroyComponents

Destroying

DisableAlign

Dispatch

DoObjectVerb

DragDrop

Dragging

EnableAlign

EndDrag

FieldAddress

FindComponent

Focused

FreeInstance

FreeNotification

Free

GetEnumPropDesc

GetHelpContext

GetObjectVerbs

GetParentComponent

GetPropDisplayStrings

GetPropDisplayString

GetTabOrderList

GetTextBuf

GetTextLen

HandleAllocated

HandleNeeded

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InsertControl

InstanceSize

Invalidate

IsCustomProperty

MethodAddress

MethodName

NewInstance

PaintTo

Perform

Realign

Refresh

RemoveComponent

RemoveControl

Repaint

ScaleBy

ScreenToClient

ScrollBy

SendToBack

SetBounds

SetFocus

SetPropDisplayString

SetTextBuf

ShowAboutBox

Show

TOleControl

UpdateControlState

Update


TOleControl::~TOleControl

TOleControl	Siehe auch

Der Destruktor ~TOleControl gibt den Speicher frei, der für das TOleControl-Objekt reserviert war. Rufen Sie ~TOleControl nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TOleControl automatisch aufgerufen wird.

__fastcall virtual ~TOleControl(void);


TOleControl::BrowseProperties

TOleControl

BrowseProperties veranlaßt das OCX-Steuerelement, dessen Dialogfeld zur Bearbeitung von Eigenschaften anzuzeigen.

void __fastcall BrowseProperties(void);

Beschreibung

Mit BrowseProperties kann das OCX-Steuerelement veranlaßt werden, sein Dialogfeld zur Bearbeitung von Eigenschaften anzuzeigen. Das Dialogfeld enthält Registerkarten für die einzelnen Eigenschaften.


TOleControl::DoObjectVerb

TOleControl

Die Methode DoObjectVerb veranlaßt das OCX-Steuerelement, eine bestimmte Aktion auszuführen.

void __fastcall DoObjectVerb(int Verb);

Beschreibung

Mit DoObjectVerb wird das OCX-Steuerelement veranlaßt, eine bestimmte Aktion auszuführen.

Der Parameter Verb ist ein Integer, der die Aktion bezeichnet.

Weitere Informationen über Parameter dieser Art (sogenannte Verben) finden Sie in der Datei OLE.HLP und auf der aktuellen CD ãMicrosoft Developer Network„.


TOleControl::GetEnumPropDesc

TOleControl

Die Methode GetEnumPropDesc gibt Beschreibungen der Eigenschaften des OCX-Steuerelements zurück.

TEnumPropDesc* __fastcall GetEnumPropDesc(int DispID);

Beschreibung

Die Methode GetEnumPropDesc gibt in einem TEnumPropDesc-Objekt Beschreibungen der Eigenschaften des OCX-Steuerelements zurück.

Details zum Objekt TEnumPropDesc finden Sie in der Datei OLECTRLS.PAS.


TOleControl::GetHelpContext

TOleControl

Die Methode GetHelpContext liefert für ein bestimmtes Element des OCX-Steuerelements den Hilfekontext zurück.

bool __fastcall GetHelpContext( System::AnsiString Member, int &HelpCtx,  System::AnsiString &HelpFile );

Beschreibung

Mit GetHelpContext kann der Hilfekontext für ein Element des OCX-Steuerelements ermittelt werden.

Der Parameter Member ist der Name einer Eigenschaft, Methode oder eines Ereignisses des OCX-Steuerelements. Wenn der Hilfekontext des OCX-Steuerelements selbst benötigt wird, setzen Sie Member auf NULL.

HelpCtx ist eine Variable, die den Hilfekontext-Bezeichner von Member speichert.

HelpFile ist eine Variable für den Namen der Hilfedatei, in der HelpCtx enthalten ist.

Die Informationen über das OCX-Steuerelement werden aus dessen ITypeInfo-Schnittstellen gewonnen. Weitere Informationen finden Sie in der Datei OLE.HLP unter ITypeInfo.

GetHelpContext gibt den Wert False zurück, wenn Member nicht gefunden werden kann, andernfalls True.


TOleControl::GetObjectVerbs

TOleControl

GetObjectVerbs liefert die Namen der Verben, die vom OCX-Steuerelement implementiert werden.

void __fastcall GetObjectVerbs(Classes::TStrings* List);

Beschreibung

Mit GetObjectVerbs kann der Name der Verben ermittelt werden, die vom OCX-Steuerelement implementiert werden.

Der Parameter List gibt an, wo die Verben gespeichert werden.


TOleControl::GetPropDisplayString

TOleControl	Siehe auch

Die Methode GetPropDisplayString gibt den Anzeige-String für eine Schnittstelle zum OCX-Steuerelement zurück.

System::AnsiString __fastcall GetPropDisplayString(int DispID);

Beschreibung

GetPropDisplayString liefert den Anzeige-String für eine Schnittstelle zum OCX-Steuerelement.

DispID ist der Bezeichner für die Schnittstelle. Weitere Informationen finden Sie in der Datei OLE.HLP unter DISPID.

Details zu GetPropDisplayStrings finden Sie auf der aktuellen CD ãMicrosoft Developer Network„ unter GetDisplayStrings.


TOleControl::GetPropDisplayStrings

TOleControl	Siehe auch

GetPropDisplayStrings liefert die Anzeige-Strings für eine OCX-Steuerelementschnittstelle.

void __fastcall GetPropDisplayStrings(int DispID, Classes::TStrings* List);

Beschreibung

GetPropDisplayString gibt für eine Schnittstelle zum OCX-Steuerelement die Anzeige-Strings zurück.

DispID ist der Bezeichner der Schnittstelle. Details finden Sie in der Datei OLE.HLP unter DISPID.

Der Parameter List legt fest, wo die Strings gespeichert werden.

Weitere Informationen über GetPropDisplayStrings finden Sie auf der aktuellen CD ãMicrosoft Developer Network„ unter GetDisplayStrings.


TOleControl::IsCustomProperty

TOleControl

Die Methode IsCustomProperty zeigt an, ob es sich bei einer Schnittstelle für das OCX-Steuerelement um eine benutzerdefinierte Eigenschaft handelt.

bool __fastcall IsCustomProperty(int DispID);

Beschreibung

Mit IsCustomProperty kann festgestellt werden, ob eine Schnittstelle für das OCX-Steuerelement eine benutzerdefinierte Eigenschaft ist.

Der Parameter DispID ist der Bezeichner der Schnittstelle. Weitere Informationen finden Sie in der Datei OLE.HLP unter DISPID.

IsCustomProperty gibt True zurück, wenn eine Schnittstelle eine benutzerdefinierte Eigenschaft darstellt, andernfalls lautet der Rückgabewert False.


TOleControl::SetBounds

TOleControl	Beispiel

Die Methode SetBounds legt die Begrenzung des OCX-Steuerelements fest.

virtual void __fastcall SetBounds(int ALeft, int ATop, int AWidth, int AHeight);

Beschreibung

Mit SetBounds werden die Grenzen des OCX-Steuerelements definiert.

Die Parameter ALeft, ATop, AWidth und AHeight enthalten die Koordinaten für die linke Kante, die obere Kante sowie für die Breite und die Höhe des OCX-Steuerelements.


TOleControl::SetPropDisplayString

TOleControl	Siehe auch

Die Methode SetPropDisplayString definiert den Anzeige-String einer Schnittstelle für das OCX-Steuerelement.

void __fastcall SetPropDisplayString(int DispID, const System::AnsiString Value);

Beschreibung

Mit SetPropDisplayString wird der Anzeige-String einer Schnittstelle für das OCX-Steuerelement festgelegt.

DispID ist der Bezeichner für die Schnittstelle. Weitere Informationen finden Sie in der Datei OLE.HLP unter DISPID.

Der Parameter Value enthält den neuen Anzeige-String.


TOleControl::ShowAboutBox

TOleControl

Die Methode ShowAboutBox veranlaßt das OCX-Steuerelement, dessen Fenster Info anzuzeigen.

void __fastcall ShowAboutBox(void);

Beschreibung

Mit ShowAboutBox wird das OCX-Steuerelement veranlaßt, sein Fenster Info anzuzeigen.


TOleControl::TOleControl

TOleControl	Siehe auch

Der Konstruktor TOleControl erzeugt ein neues TOleControl-Objekt.

__fastcall virtual TOleControl(Classes::TComponent* AOwner);

Beschreibung

Mit TOleControl können Sie eine neue Instanz des TOleControl-Objekts erzeugen. TOleControl ruft den geerbten Konstruktor auf und erzeugt und initialisiert interne Objekte.


Gültigkeitsbereich

Published

Zugriff

Read-only


Hierarchie

TObject

TPersistent

TComponent

TControl

TWinControl


TOleControl Beispiel

TOleControl


TOleFormObject

Hierarchie	Methoden	Siehe auch

Header

vcl/forms.hpp

TOleFormObject ist eine Basisklasse für benutzerdefinierte OLE-Objekte.

Beschreibung

TOleFormObject dient als Basisklasse für benutzerdefinierte OLE-Objekte.

Die Klasse besteht lediglich aus zwei geschützten, virtuellen abstrakten Methoden: OnDestroy und OnResize.

TOleForm ist das einzige Objekt in der VCL, das von TOleFormObject abgeleitet ist.


Methoden von TOleFormObject

TOleFormObject	Alphabetisch

In TOleFormObject

~TOleFormObject

TOleFormObject

Abgeleitet von TObject

~TOleFormObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TOleFormObject

TOleFormObject	Nach Objekten

~TOleFormObject

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance

TOleFormObject


TOleFormObject::~TOleFormObject

TOleFormObject

Der Destruktor ~TOleFormObject gibt den Speicher frei, der für das TOleFormObject-Objekt reserviert war. Rufen Sie ~TOleFormObject nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TOleFormObject automatisch aufgerufen wird.

__fastcall virtual ~TOleFormObject(void);


TOleFormObject::TOleFormObject

TOleFormObject

Der Konstruktor TOleFormObject erzeugt ein neues TOleFormObject-Objekt.

__fastcall TOleFormObject(void);


Hierarchie

TObject


TOleFormObject Beispiel

TOleFormObject


TOleForm

Hierarchie	Methoden

Header

vcl/olectnrs.hpp

Das Objekt TOleForm bietet für ein TForm-Objekt die Unterstützung von OLE-Funktionen.

Beschreibung

TOleForm wird in Konstruktoren und Methoden verwendet, denen TOleForm-Objekte als Parameter übergeben werden.

Die Implementierung des TOleForm-Objekts wird intern von der VCL verwendet.


Methoden von TOleForm

TOleForm	Alphabetisch

In TOleForm

~TOleForm

TOleForm

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TOleForm

TOleForm	Nach Objekten

~TOleForm

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance

TOleForm


TOleForm::~TOleForm

TOleForm	Siehe auch

Der Destruktor ~TOleForm gibt den Speicher frei, der für das TOleForm-Objekt reserviert war. Rufen Sie ~TOleForm nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TOleForm automatisch aufgerufen wird.

__fastcall virtual ~TOleForm(void);

Beschreibung

~TOleForm gibt als private deklarierte Objekte frei, die von dieser Instanz des TOleForm-Objekts verwendet wurden.


TOleForm::TOleForm

TOleForm	Siehe auch

Die Methode TOleForm erzeugt eine neue Instanz von TOleForm.

__fastcall TOleForm(Forms::TForm* Form);

Beschreibung

Mit TOleForm wird eine neue Instanz von TOleForm erzeugt.

Der Parameter Form bezeichnet das Formular, auf dem das neue TOleForm-Objekt basieren soll.


Hierarchie

TObject

TOleFormObject


TOleForm Beispiel

TOleForm


TOleInPlaceFrame

Hierarchie	Methoden	Siehe auch

Header

vcl/olectrls.hpp

Das Objekt TOleInPlaceFrame kapselt die Schnittstelle IOleInPlaceFrame.

Beschreibung

TOleInPlaceFrame wird als Bindeglied zum Rahmenfenster des Containers eingesetzt.

Weitere Informationen über die Schnittstelle IOleInPlaceFrame finden Sie in der Datei OLE.HLP unter IOleInPlaceFrame.


Methoden von TOleInPlaceFrame

TOleInPlaceFrame	Alphabetisch

In TOleInPlaceFrame

~TOleInPlaceFrame

AddRef

ContextSensitiveHelp

EnableModeless

GetBorder

GetWindow

InsertMenus

QueryInterface

Release

RemoveMenus

RequestBorderSpace

SetActiveObject

SetBorderSpace

SetMenu

SetStatusText

TOleInPlaceFrame

TranslateAccelerator

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TOleInPlaceFrame

TOleInPlaceFrame	Nach Objekten

~TOleInPlaceFrame

AddRef

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

ContextSensitiveHelp

DefaultHandler

Dispatch

EnableModeless

FieldAddress

FreeInstance

Free

GetBorder

GetWindow

InheritsFrom

InitInstance

InsertMenus

InstanceSize

MethodAddress

MethodName

NewInstance

QueryInterface

Release

RemoveMenus

RequestBorderSpace

SetActiveObject

SetBorderSpace

SetMenu

SetStatusText

TOleInPlaceFrame

TranslateAccelerator


TOleInPlaceFrame::~TOleInPlaceFrame

TOleInPlaceFrame

Der Destruktor ~TOleInPlaceFrame gibt den Speicher frei, der für das TOleInPlaceFrame-Objekt reserviert war. Rufen Sie ~TOleInPlaceFrame nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TOleInPlaceFrame automatisch aufgerufen wird.

__fastcall virtual ~TOleInPlaceFrame(void);


TOleInPlaceFrame::AddRef

TOleInPlaceFrame	Siehe auch

Die Methode AddRef inkrementiert den Referenzzähler für das TOleInPlaceFrame-Objekt.

virtual long __stdcall AddRef(void);

Beschreibung

Mit AddRef wird der Referenzzähler für das TOleInPlaceFrame-Objekt inkrementiert. Das Objekt wird erst dann freigegeben, wenn dessen Referenzzähler auf Null steht.

AddRef gibt den neuen Stand des Referenzzählers zurück.


TOleInPlaceFrame::ContextSensitiveHelp

TOleInPlaceFrame	Siehe auch

Die Methode ContextSensitiveHelp steuert, ob bei Aktivierung des eingebetteten OLE-Objekts in den kontextsensitiven Hilfemodus gewechselt werden.

virtual long __stdcall ContextSensitiveHelp(DWORD fEnterMode);

Beschreibung

Setzen Sie fEnterMode auf True, wenn beim Aktivieren des eingebetteten OLE-Objekts der Hilfemodus aktiviert werden soll. Andernfalls setzen Sie fEnterMode auf False.

ContextSensitiveHelp gibt einen der folgenden Werte zurück:

Wert	Bedeutung

S_OK	Der Hilfemodus wurde erfolgreich aktiviert oder verlassen.

E_INVALIDARG	Das Argument war ungültig.

E_OUTOFMEMORY	Speicherüberlauf.

E_UNEXPECTED	Unerwarteter Fehler aufgetreten.


TOleInPlaceFrame::EnableModeless

TOleInPlaceFrame

Die Methode EnableModeless aktiviert oder deaktiviert die nicht modalen Dialogfelder des Rahmens.

virtual long __stdcall EnableModeless(DWORD fEnable);

Beschreibung

Wenn fEnable den Wert True erhält, werden die nicht modalen Dialogfelder des Rahmens aktiviert. Der Wert False deaktiviert diese.

EnableModeless gibt einen der folgenden Werte zurück:

Wert	Bedeutung

S_OK	Die nicht modalen Dialogfelder wurden erfolgreich aktiviert bzw. deaktiviert.

E_UNEXPECTED	Unerwarteter Fehler aufgetreten.


TOleInPlaceFrame::GetBorder

TOleInPlaceFrame

Die Methode GetBorder ermittelt den rechteckigen Bereich, der dem OLE-Objekt für die Plazierung von Werkzeugleisten zur Verfügung steht, wenn es innerhalb des Containers aktiviert wird.

virtual long __stdcall GetBorder(Windows::TRect &rectBorder);

Beschreibung

Mit GetBorder kann der rechteckförmige Bereich bestimmt werden, der dem aktiven OLE-Objekt für Werkzeugleisten zur Verfügung steht, wenn es eingebettet in den Container aktiviert wird.

rectBorder ist die Variable zur Speicherung des Bereichs.

GetBorder kann einen der folgenden Werte zurückgeben:

Wert	Bedeutung

S_OK	Das Rechteck wurde erfolgreich abgerufen.

S_NOTOOLSPACE	Das Steuerelement kann in diesem Fenster keine Werkzeugleiste installieren.

E_INVALIDARG	Das Argument war ungültig.

E_OUTOFMEMORY	Speicherüberlauf.

E_UNEXPECTED	Unerwarteter Fehler aufgetreten.


TOleInPlaceFrame::GetWindow

TOleInPlaceFrame

Die Methode GetWindow gibt das Fenster-Handle des Containers zurück.

virtual long __stdcall GetWindow(HWND &wnd);

Beschreibung

Mit GetWindow kann das Fenster-Handle des Containers zurückgegeben werden.

GetWindow liefert einen der folgenden Werte:

Wert	Bedeutung

S_OK	Das Fenster-Handle wurde erfolgreich abgerufen.

E_FAIL	Für den Container gibt es kein Fenster-Handle.

E_INVALIDARG	Das Argument war ungültig.

E_OUTOFMEMORY	Speicherüberlauf.

E_UNEXPECTED	Unerwarteter Fehler aufgetreten.


TOleInPlaceFrame::InsertMenus

TOleInPlaceFrame	Siehe auch

Die Methode InsertMenus ermöglicht es dem Container, seine Menügruppen in das zusammengesetzte Menü einzufügen, das bei Aktivierung des eingebetteten OLE-Objekts verwendet wird.

virtual long __stdcall InsertMenus(HMENU hmenuShared, OLEMENUGROUPWIDTHS &menuWidths);

Beschreibung

Mit Hilfe von InsertMenus kann der Container seine Menügruppen in das zusammengesetzte Menü einbinden.

Der Parameter hmenuShared ist das Handle zu einem leeren Menüobjekt, das als zusammengesetztes Menü verwendet werden soll.

Der Parameter menuWidths enthält eine OLEMENUGROUPWIDTHS-Struktur (ein Array von sechs LONG-Werten), das der Anzahl von Menübefehlen entspricht, die der Container in den Menügruppen  Datei, Ansicht und Fenster anbietet.


TOleInPlaceFrame::QueryInterface

TOleInPlaceFrame	Siehe auch

Die Methode QueryInterface liefert eine Schnittstelle für das aktive OLE-Objekt.

virtual long __stdcall QueryInterface(const GUID &iid, void *obj);

Beschreibung

Mit QueryInterface kann eine Schnittstelle für das aktive OLE-Objekt ermittelt werden.

Der Parameter iid bezeichnet die IID für die Schnittstelle. Eine IID ist eine spezialisierte GUID-Struktur, die den Schnittstellenbezeichner enthält. Details finden Sie in der Datei OLE.HLP unter GUID.

Die Variable obj speichert die Schnittstelle.

QueryInterface gibt den Wert S_OK zurück, wenn das OLE-Objekt die Schnittstelle unterstützt, andernfalls lautet der Rückgabewert S_FALSE.

Details zu QueryInterface finden Sie in der Datei OLE.HLP unter QueryInterface.


TOleInPlaceFrame::Release

TOleInPlaceFrame	Siehe auch

Die Methode Release dekrementiert den Referenzzähler für das TOleInPlaceFrame-Objekt.

virtual long __stdcall Release(void);

Beschreibung

Mit Release wird der Referenzzähler für das TOleInPlaceFrame-Objekt dekrementiert. Das Objekt wird erst dann freigegeben, wenn der Referenzzähler auf Null steht.

Der neue Zählerstand wird zurückgegeben.


TOleInPlaceFrame::RemoveMenus

TOleInPlaceFrame	Siehe auch

Die Methode RemoveMenus veranlaßt den Container, seine Menüelemente aus dem zusammengesetzten Menü zur entfernen, das bei einer Aktivierung des eingebetteten OLE-Objekts verwendet wird.

virtual long __stdcall RemoveMenus(HMENU hmenuShared);

Beschreibung

Mit RemoveMenus wird der Container veranlaßt, seine Menüelemente aus dem zusammengesetzten Menü zu entfernen.

Der Parameter hmenuShared ist das Handle auf das zusammengesetzte Menü. (Das Handle wurde in einem vorausgegangenen Aufruf von InsertMenus bestimmt.)


TOleInPlaceFrame::RequestBorderSpace

TOleInPlaceFrame	Siehe auch

Die Methode RequestBorderSpace fordert beim Container einen Bereich an, in dem bei Aktivierung des eingebetteten OLE-Objekts Werkzeuge installiert werden können.

virtual long __stdcall RequestBorderSpace(const Windows::TRect &borderwidths);

Beschreibung

Mit RequestBorderSpace kann vom Container Platz für die Installation von Werkzeugen angefordert werden.

Der Parameter borderwidths gibt die Größe des Bereichs an.

RequestBorderSpace gibt einen der folgenden Werte zurück:

Wert	Bedeutung

S_OK	Der angeforderte Platz wurde zugewiesen.

S_NOTOOLSPACE	Das Steuerelement kann in diesem Fenster keine Werkzeugleiste installieren.

E_INVALIDARG	Das Argument war ungültig.

E_UNEXPECTED	Ein unerwarteter Fehler ist aufgetreten.


TOleInPlaceFrame::SetActiveObject

TOleInPlaceFrame

Die Methode SetActiveObject bestimmt das aktive OLE-Objekt.

virtual long __stdcall SetActiveObject(Ole2::IOleInPlaceActiveObject* activeObject, wchar_t * pszObjName );

Beschreibung

Mit SetActiveObject wird das aktive OLE-Objekt bestimmt. Die Methoden von TOleInPlaceFrame arbeiten mit dem aktiven OLE-Objekt.

Der Parameter activeObject bezeichnet die IOleInPlaceActive-Schnittstelle für das aktive OLE-Objekt. Details zur IOleInPlaceActive-Schnittstelle finden Sie in der Datei OLE.HLP.

Der Parameter pszObjName ist der Name des aktiven OLE-Objekts. Der Container kann diesen Namen im Fenstertitel verwenden. Wenn pszObjName auf NULL zeigt, ändert der Container seinen Fenstertitel nicht.

SetActiveObject gibt einen der folgenden Werte zurück:

Wert	Bedeutung

S_OK	Die Methode wurde erfolgreich aufgerufen.

E_INVALIDARG	Das Argument war ungültig.

E_UNEXPECTED	Ein unerwarteter Fehler ist aufgetreten.


TOleInPlaceFrame::SetBorderSpace

TOleInPlaceFrame	Siehe auch

Die Methode SetBorderSpace reserviert Platz, der in einem vorangegangenen Aufruf von RequestBorderSpace angefordert wurde.

virtual long __stdcall SetBorderSpace(Windows::PRect pborderwidths);

Beschreibung

Mit SetBorderSpace wird der Platz für einen Rahmen zugewiesen, der in einem vorangegangenen Aufruf von RequestBorderSpace angefordert wurde.

Der Parameter pborderwidths ist die angeforderte Breite der Werkzeugleiste. Wenn das Steuerelement keinen Platz benötigt, setzen Sie PRect auf NULL.

SetBorderSpace gibt einen der folgenden Werte zurück:

Wert	Bedeutung

OLE_E_INVALIDRECT	Das Steuerelement kann in diesem Fenster keine Werkzeugleisten installieren.

S_OK	Der angeforderte Platz wurde zugewiesen.

E_INVALIDARG	Der zugewiesene Bereich liegt nicht innerhalb der Grenzen, die von der Methode RequestBorderSpace ermittelt wurden.

E_UNEXPECTED	Ein unerwarteter Fehler ist aufgetreten.


TOleInPlaceFrame::SetMenu

TOleInPlaceFrame	Siehe auch

Die Methode SetMenu installiert das zusammengesetzte Menü im Rahmen, wenn das aktive OLE-Objekt innerhalb des Containers aktiviert wurde. Diese Form der Aktivierung wird als In-Place-Aktivierung bezeichnet.

virtual long __stdcall SetMenu(HMENU hmenuShared, HMENU holemenu, HWND hwndActiveObject);

Beschreibung

Mit SetMenu wird das zusammengesetzte Menü im Rahmenfenster installiert, sobald eine In-Place-Aktivierung des eingebetteten OLE-Objekts erfolgt.

Der Parameter hmenuShared bezeichnet das zusammengesetzte Menü, das mit Aufrufen der Methoden InsertMenus und TMenu::TMenu erzeugt wurde.

SetMenu gibt einen der folgenden Werte zurück:

Wert	Bedeutung

S_OK	Die Methode wurde erfolgreich aufgerufen.

E_INVALIDARG	Das Argument war ungültig.

E_UNEXPECTED	Es ist ein unerwarteter Fehler aufgetreten.


TOleInPlaceFrame::SetStatusText

TOleInPlaceFrame	Siehe auch

Die Methode SetStatusText zeigt in der Statusleiste des Rahmens Text zum aktiven Steuerelement an.

virtual long __stdcall SetStatusText(wchar_t * pszStatusText);

Beschreibung

Mit SetStatusText kann in der Statusleiste des aktiven Steuerelements erläuternder Text über das aktive Steuerelement angezeigt werden.

Der Parameter pszStatusText enthält den Text.

SetStatusText gibt einen der folgenden Werte zurück:

Wert	Bedeutung

S_OK	Der Text wurde angezeigt.

S_TRUNCATED	Der Text konnte nur teilweise angezeigt werden. Er war zu lang und wurde abgeschnitten.

E_INVALIDARG	Eines oder mehrere Argumente waren ungültig.

E_UNEXPECTED	Unerwarteter Fehler aufgetreten.

S_FALSE	Der Text konnte nicht angezeigt werden.


TOleInPlaceFrame::TOleInPlaceFrame

TOleInPlaceFrame	Siehe auch

Der Konstruktor TOleInPlaceFrame erzeugt ein neues TOleInPlaceFrame-Objekt.

__fastcall TOleInPlaceFrame(TOleControl* Control);

Beschreibung

Mit TOleInPlaceFrame können Sie eine neue Instanz des TOleInPlaceFrame-Objekts erzeugen.

Control ist das aktive OLE-Objekt.


TOleInPlaceFrame::TranslateAccelerator

TOleInPlaceFrame

Die Methode TranslateAccelerator interpretiert Tastenkürzel, die für den Container vorgesehen sind.

virtual long __stdcall TranslateAccelerator(MSG &msg, unsigned short wID);

Beschreibung

Mit TranslateAccelerator wird ein Tastenkürzel interpretiert, das funktional an den Container gerichtet ist.

Der Parameter msg ist eine MSG-Struktur, welche die Tastenkürzel-Botschaft enthält.

Der Parameter wID enthält den Befehlsbezeichner, der dem Tastenkürzel in der Tabelle des Containers entspricht. Container sollten diesen Wert verwenden, anstatt eine erneute Interpretation vorzunehmen.

TranslateAccelerator gibt einen der folgenden Werte zurück:

Wert	Bedeutung

S_FALSE	Das Tastenkürzel wurde nicht verwendet.

S_OK	Das Tastenkürzel wurde verwendet.

E_INVALIDARG	Eines oder mehrere Argumente waren ungültig.

E_OUTOFMEMORY	Speicherüberlauf.

E_UNEXPECTED	Unerwarteter Fehler aufgetreten.


Hierarchie

TObject

IUnknown

IOleWindow

IOleInPlaceUIWindow

IOleInPlaceFrame


TOleInPlaceFrame Beispiel

TOleInPlaceFrame


TOleInPlaceSite

Hierarchie	Methoden	Siehe auch

Header

vcl/olectrls.hpp

Das Objekt TOleInPlaceSite kapselt die Schnittstelle IOleInPlaceSite.

Beschreibung

Mit TOleInPlaceSite werden eingebettete OLE-Objekte verwaltet. Weitere Informationen über die Schnittstelle IOleInPlaceSite finden Sie in der Datei OLE.HLP.


Methoden von TOleInPlaceSite

TOleInPlaceSite	Alphabetisch

In TOleInPlaceSite

~TOleInPlaceSite

AddRef

CanInPlaceActivate

ContextSensitiveHelp

DeactivateAndUndo

DiscardUndoState

GetWindow

GetWindowContext

OnInPlaceActivate

OnInPlaceDeactivate

OnPosRectChange

OnUIActivate

OnUIDeactivate

QueryInterface

Release

Scroll

TOleInPlaceSite

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TOleInPlaceSite

TOleInPlaceSite	Nach Objekten

~TOleInPlaceSite

AddRef

CanInPlaceActivate

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

ContextSensitiveHelp

DeactivateAndUndo

DefaultHandler

DiscardUndoState

Dispatch

FieldAddress

FreeInstance

Free

GetWindowContext

GetWindow

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance

OnInPlaceActivate

OnInPlaceDeactivate

OnPosRectChange

OnUIActivate

OnUIDeactivate

QueryInterface

Release

Scroll

TOleInPlaceSite


TOleInPlaceSite::~TOleInPlaceSite

TOleInPlaceSite

Der Destruktor ~TOleInPlaceSite gibt den Speicher frei, der für das TOleInPlaceSite-Objekt reserviert war. Rufen Sie ~TOleInPlaceSite nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TOleInPlaceSite automatisch aufgerufen wird.

__fastcall virtual ~TOleInPlaceSite(void);


TOleInPlaceSite::AddRef

TOleInPlaceSite	Siehe auch

Die Methode AddRef inkrementiert den Referenzzähler für das TOleInPlaceSite-Objekt.

virtual long __stdcall AddRef(void);

Beschreibung

Mit AddRef wird der Referenzzähler für das TOleInPlaceSite-Objekt erhöht. Das Objekt wird erst dann freigegeben, wenn dessen Referenzzähler auf Null steht.

AddRef gibt den neuen Stand des Referenzzählers zurück.


TOleInPlaceSite::CanInPlaceActivate

TOleInPlaceSite

CanInPlaceActivate gibt an, ob der Container das eingebettete OLE-Objekt aktivieren kann.

virtual long __stdcall CanInPlaceActivate(void);

Beschreibung

Mit CanInPlaceActivate kann bestimmt werden, ob der Container das eingebettete OLE-Objekt aktivieren kann.

CanInPlaceActivate gibt einen der folgenden Werte zurück:

Wert	Bedeutung

S_OK	Der Container erlaubt In-Place-Aktivierung des OLE-Objekts.

E_FALSE	Der Container erlaubt keine In-Place-Aktivierung des Objekts.

E_INVALIDARG	Das Argument war ungültig.

E_UNEXPECTED	Ein unerwarteter Fehler ist aufgetreten.

CanInPlaceActivate gibt unter den folgenden Bedingungen S_OK zurück:

•	Die Eigenschaft ComponentState der Anwendung hat nicht den Wert csDesigning.

•	Die Eigenschaften Visible und AllowInPlace haben den Wert True.


TOleInPlaceSite::ContextSensitiveHelp

TOleInPlaceSite	Siehe auch

Die Methode ContextSensitiveHelp legt fest, ob beim Aktivieren des eingebetteten OLE-Objekts in den kontextsensitiven Hilfemodus gewechselt werden soll.

virtual long __stdcall ContextSensitiveHelp(DWORD fEnterMode);

Beschreibung

Setzen Sie fEnterMode auf True, wenn beim Aktivieren des eingebetteten OLE-Objekts in den kontextsensitiven Hilfemodus gewechselt werden soll. Andernfalls setzen Sie fEnterMode auf False.

ContextSensitiveHelp gibt einen der folgenden Werte zurück:

Wert	Bedeutung

S_OK	Der Hilfemodus wurde erfolgreich aktiviert oder verlassen.

E_INVALIDARG	Das Argument war ungültig.

E_OUTOFMEMORY	Speicherüberlauf.

E_UNEXPECTED	Ein unerwarteter Fehler ist aufgetreten.


TOleInPlaceSite::DeactivateAndUndo

TOleInPlaceSite

Die Methode DeactivateAndUndo veranlaßt den Container, das eingebettete OLE-Objekt zu deaktivieren und wieder im vorher gespeicherten Rückgängig-Status darzustellen.

virtual long __stdcall DeactivateAndUndo(void);

Beschreibung

Mit DeactivateAndUndo wird der Container veranlaßt, das eingebettete OLE-Objekt zu deaktivieren und wieder in den vorher gespeicherten Zustand zurückzuversetzen.

DeactivateAndUndo gibt einen der folgenden Werte zurück:

Wert	Bedeutung

S_OK	Die Methode wurde erfolgreich ausgeführt.

E_UNEXPECTED	Ein unerwarteter Fehler ist aufgetreten.


TOleInPlaceSite::DiscardUndoState

TOleInPlaceSite

Die Methode DiscardUndoState benachrichtigt den Container, daß es für das eingebettete OLE-Objekt keinen Rückgängig-Status mehr gibt.

virtual long __stdcall DiscardUndoState(void);

Beschreibung

Mit DiscardUndoState kann der Container benachrichtigt werden, daß das eingebettete OLE-Objekt keinen Rückgängig-Status mehr besitzt. Nach Empfang dieser Botschaft sollte der Container die Funktion IOleInPlaceObject::ReActivateAndUndo nicht aufrufen. Informationen über die IOleInPlaceObject-Schnittstelle finden Sie in der Datei OLE.HLP.

DiscardUndoState gibt einen der folgenden Werte zurück:

Wert	Bedeutung

S_OK	Die Methode wurde erfolgreich ausgeführt.

E_UNEXPECTED	Ein unerwarteter Fehler ist aufgetreten.


TOleInPlaceSite::GetWindow

TOleInPlaceSite

Die Methode GetWindow ermittelt das Fenster-Handle des Containers.

virtual long __stdcall GetWindow(HWND &wnd);

Beschreibung

Mit GetWindow wird das Handle des Container-Fensters ermittelt.

GetWindow gibt einen der folgenden Werte zurück:

Wert	Bedeutung

S_OK	Das Fenster-Handle wurde erfolgreich ermittelt.

E_FAIL	Der Container besitzt kein Fenster-Handle.

E_INVALIDARG	Das Argument war ungültig.

E_OUTOFMEMORY	Speicherüberlauf.

E_UNEXPECTED	Ein unerwarteter Fehler ist aufgetreten.


TOleInPlaceSite::GetWindowContext

TOleInPlaceSite

Die Methode GetWindowContext liefert Informationen darüber, wie und wo das eingebettete OLE-Objekt im übergeordneten Fenster plaziert werden soll.

virtual long __stdcall GetWindowContext(Ole2::IOleInPlaceFrame* &frame, Ole2::IOleInPlaceUIWindow*  &doc, Windows::TRect &rcPosRect, Windows::TRect &rcClipRect, OLEINPLACEFRAMEINFO &frameInfo);

Beschreibung

Mit GetWindowContext kann ermittelt werden, wie und wo das eingebettete OLE-Objekt im übergeordneten Fenster plaziert werden soll.

Die Variable frame speichert die Rahmenschnittstelle.

Die Variable doc speichert die Schnittstelle des Dokumentfensters.

Die Variable rcPosRect speichert die Position des OLE-Objekts innerhalb des übergeordneten Fensters.

Die Variabel rcClipRect speichert die äußere Position des OLE-Objekts im übergeordneten Fenster.

In der Variablen frameInfo speichert der Container Informationen über Tastenkürzel.

Weitere Informationen über diese Parameter finden Sie in der Datei OLE.HLP unter GetWindowContext.

GetWindowContext gibt einen der folgenden Werte zurück:

Wert	Bedeutung

S_OK	Die Methode wurde erfolgreich ausgeführt.

E_INVALIDARG	Ein Argument war ungültig.

E_UNEXPECTED	Ein unerwarteter Fehler ist aufgetreten.


TOleInPlaceSite::OnInPlaceActivate

TOleInPlaceSite	Siehe auch

Die Methode OnInPlaceActivate benachrichtigt den Container, daß das eingebettete OLE-Objekt aktiviert wurde.

virtual long __stdcall OnInPlaceActivate(void);

Beschreibung

Überschreiben Sie OnInPlaceActivate so, daß beim Aktivieren des eingebetteten OLE-Objekts ein bestimmter Vorgang ausgelöst wird.

OnInPlaceActivate muß einen der folgenden Werte zurückgeben:

Wert	Bedeutung

S_OK	Der Container erlaubt die In-Place-Aktivierung.

E_UNEXPECTED	Es ist ein unerwarteter Fehler aufgetreten.

Standardmäßig aktualisiert OnInPlaceActivate die internen Objekte des Containers, die das aktive OLE-Objekt repräsentieren, und gibt S_OK zurück.


TOleInPlaceSite::OnInPlaceDeactivate

TOleInPlaceSite	Siehe auch

Die Methode OnInPlaceDeactivate benachrichtigt den Container, daß das eingebettete OLE-Objekt deaktiviert wurde.

virtual long __stdcall OnInPlaceDeactivate(void);

Beschreibung

Überschreiben Sie OnInPlaceDeactivate so, daß ein bestimmter Vorgang eingeleitet wird, wenn das eingebettete OLE-Objekt deaktiviert wurde.

OnInPlaceDeactivate muß einen der folgenden Werte zurückgeben:

Wert	Bedeutung

S_OK	Die Methode hat den Container erfolgreich benachrichtigt.

E_UNEXPECTED	Ein unerwarteter Fehler ist aufgetreten.

Standardmäßig gibt OnInPlaceDeactivate die internen Objekte frei, die vom Container für die Repräsentation des aktiven OLE-Objekts verwendet wurden, und gibt S_OK zurück.


TOleInPlaceSite::OnPosRectChange

TOleInPlaceSite

Die Methode OnPosRectChange benachrichtigt den Container, daß das eingebettete OLE-Objekt in Größe oder Position verändert wurde.

virtual long __stdcall OnPosRectChange(const Windows::TRect &rcPosRect);

Beschreibung

Überschreiben Sie OnPosRectChange so, daß ein bestimmter Vorgang ausgelöst wird, wenn sich Größe oder Position des eingebetteten OLE-Objekts geändert haben.

Der Parameter rcPosRect bezeichnet die Position des eingebetteten OLE-Objekts. Als Maßsystem gelten die Client-Koordinaten des übergeordneten Fensters.

OnPosRectChange muß einen der folgenden Werte zurückgeben:

Wert	Bedeutung

S_OK	Die Methode wurde erfolgreich ausgeführt.

E_INVALIDARG	Das Argument war ungültig.

E_UNEXPECTED	Ein unerwarteter Fehler ist aufgetreten.

Standardmäßig aktualisiert OnPosRectChange die Darstellung des OLE-Objekts durch den Container.


TOleInPlaceSite::OnUIActivate

TOleInPlaceSite	Siehe auch

Die Methode OnUIActivate benachrichtigt den Container, daß die Benutzerschnittstelle für das eingebettete OLE-Objekt in Kürze aktiviert werden wird.

virtual long __stdcall OnUIActivate(void);

Beschreibung

Überschreiben Sie OnUIActivate so, daß ein bestimmter Vorgang ausgelöst wird, wenn die Benutzerschnittstelle des eingebetteten OLE-Objekts vor der Aktivierung steht.

OnUIActivate muß einen der folgenden Werte zurückgeben:

Wert	Bedeutung

S_OK	Der Container erlaubt die In-Place-Aktivierung.

E_UNEXPECTED	Ein unerwarteter Fehler ist aufgetreten.

Standardmäßig veranlaßt OnUIActivate den Container, die Benutzerschnittstelle einzubinden, und gibt dann S_OK zurück.


TOleInPlaceSite::OnUIDeactivate

TOleInPlaceSite	Siehe auch

Die Methode OnUIDeactivate benachrichtigt den Container, daß die Benutzerschnittstelle für das eingebettete OLE-Objekt deaktiviert wurde.

virtual long __stdcall OnUIDeactivate(DWORD fUndoable);

Beschreibung

Überschreiben Sie OnUIDeactivate so, daß ein bestimmter Vorgang eingeleitet wird, wenn die Benutzerschnittstelle für das eingebettete OLE-Objekt deaktiviert wurde.

OnUIActivate muß einen der folgenden Werte zurückgeben:

Wert	Bedeutung

S_OK	Der Container erlaubt die In-Place-Aktivierung.

E_UNEXPECTED	Ein unerwarteter Fehler ist aufgetreten.

Standardmäßig veranlaßt OnUIDeactivate den Container, die Benutzerschnittstelle für das OLE-Objekt einzubinden, und gibt dann S_OK zurück.


TOleInPlaceSite::QueryInterface

TOleInPlaceSite

Die Methode QueryInterface ermittelt eine Schnittstelle für das eingebettete OLE-Objekt.

virtual long __stdcall QueryInterface(const GUID &iid, void *obj);

Beschreibung

Mit QueryInterface wird eine Schnittstelle für das eingebettete OLE-Objekt ermittelt.

Der Parameter iid bezeichnet die IID für die Schnittstelle. Eine IID ist eine spezielle GUID-Struktur, die einen Schnittstellenbezeichner enthält. Weitere Informationen finden Sie in der Datei OLE.HLP unter GUID.

Die Variable obj speichert die Schnittstelle.

QueryInterface gibt den Wert S_OK zurück, wenn das OLE-Objekt die Schnittstelle unterstützt. Andernfalls wird S_FALSE zurückgegeben.

Weitere Informationen über QueryInterface finden Sie in der Datei OLE.HLP unter QueryInterface.


TOleInPlaceSite::Release

TOleInPlaceSite	Siehe auch

Die Methode Release dekrementiert den Referenzzähler für das TOleInPlaceSite-Objekt.

virtual long __stdcall Release(void);

Beschreibung

Mit Release wird der Referenzzähler für das TOleInPlaceSite-Objekt dekrementiert. Das Objekt wird erst dann freigegeben, wenn der Referenzzähler auf Null steht.

Release gibt den neuen Zählerstand zurück.


TOleInPlaceSite::Scroll

TOleInPlaceSite

Die Methode Scroll veranlaßt den Container, für die Ansicht des OLE-Objekts einen Bildlauf durchzuführen.

virtual long __stdcall Scroll(const POINT &scrollExtent);

Beschreibung

Mit Scroll wird der Container benachrichtigt, daß für das OLE-Objekt ein Bildlauf durchgeführt werden soll.

Der Parameter scrollExtent ist die Anzahl der Pixel, um die der Bildausschnitt in X- und Y-Richtung verschoben werden soll.

ScrollExtent gibt einen der folgenden Werte zurück:

Wert	Bedeutung

S_OK	Die Methode wurde erfolgreich ausgeführt.

E_INVALIDARG	Das Argument war ungültig.

E_UNEXPECTED	Ein unerwarteter Fehler ist aufgetreten.


TOleInPlaceSite::TOleInPlaceSite

TOleInPlaceSite	Siehe auch

TOleInPlaceSite erzeugt eine neue Instanz des TOleInPlaceSite-Objekts.

__fastcall TOleInPlaceSite(TOleControl* Control);

Beschreibung

Mit TOleInPlaceSite wird eine neue Instanz des TOleInPlaceSite-Objekts erzeugt.

Als Container fungiert der Container des OLE-Objekts.


Hierarchie

TObject

IUnknown

IOleWindow

IOleInPlaceSite


TOleInPlaceSite Beispiel

TOleInPlaceSite


 TOpenDialog

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/dialogs.hpp

TOpenDialog erzeugt ein Dialogfeld, in dem der Benutzer eine Datei auswählen kann.

Beschreibung

TOpenDialog erzeugt ein Windows-Dialogfeld, in dem der Benutzer eine Datei auswählen und öffnen kann. Das Dialogfeld wird zur Laufzeit erst angezeigt, wenn es mit der Methode Execute aktiviert wird. Wenn der Benutzer auf öffnen klickt, wird das Dialogfeld geschlossen, und die ausgewählten Dateien werden in der Eigenschaft File gespeichert.


Eigenschaften von TOpenDialog

TOpenDialog	Alphabetisch	Legende

In TOpenDialog

DefaultExt

FileEditStyle

FileName

Files

Filter

FilterIndex

HistoryList

InitialDir

Options

Title

Abgeleitet von TCommonDialog

Ctl3D

HelpContext

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Name

Owner

Tag


Eigenschaften von TOpenDialog

TOpenDialog	Nach Objekten	Legende

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

Ctl3D

DefaultExt

DesignInfo

FileEditStyle

FileName

Files

FilterIndex

Filter

HelpContext

HistoryList

InitialDir

Name

Options

Owner

Tag

Title


TOpenDialog::DefaultExt

TOpenDialog 	Beispiel

Die Eigenschaft DefaultExt legt die standardmäßige Dateierweiterung fest.

__property System::AnsiString DefaultExt;

Beschreibung

Die Eigenschaft DefaultExt bezeichnet eine Dateierweiterung, die automatisch an den ausgewählten Dateinamen angehängt wird, wenn dieser noch keine registrierte Erweiterung enthält. Wenn der Benutzer eine Datei mit einer nicht registrierten Erweiterung auswählt, wird DefaultExt an die Erweiterung angehängt.

Erweiterungen mit mehr als drei Zeichen werden nicht unterstützt. Geben Sie die Erweiterung ohne den Punkt an, der den Dateinamen von der Erweiterung trennt.


TOpenDialog::FileEditStyle

TOpenDialog

Die Eigenschaft FileEditStyle gibt die Art des Feldes an, in das der Anwender den Dateiinamen einträgt

__property TFileEditStyle FileEditStyle;

Beschreibung

FileEditStyle kann einen der folgenden TFileEditStyle-Werte haben:

Wert	Bedeutung

fsEdit	Eingabefeld.

fsComboBox	Kombinationsfeld.


TOpenDialog::FileName

TOpenDialog	Siehe auch 	Beispiel

Die Eigenschaft FileName gibt den Namen und den Pfad der zuletzt ausgewählten Datei zurück.

__property System::AnsiString FileName;

Beschreibung

Die Eigenschaft FileName gibt den Namen und den vollständigen Pfad der zuletzt ausgewählten Datei zurück. Um bereits beim öffnen des Dialogfeldes einen Standardnamen im Eingabefeld anzuzeigen, weisen Sie der Eigenschaft FileName im Objektinspektor oder programmseitig den entsprechenden Wert zu.


 TOpenDialog::Files

TOpenDialog	Siehe auch

Die Eigenschaft Files gibt eine Liste der ausgewählten Dateinamen zurück.

__property Classes::TStrings* Files;

Beschreibung

FileName ist eine TStrings-Instanz , die alle ausgewählten Dateinamen mit dem vollständigen Pfad enthält. Damit der Benutzer mehrere Dateinamen auswählen kann, setzen Sie in der Eigenschaft Options das Flag ofAllowMultiSelect.


TOpenDialog::Filter

TOpenDialog	Siehe auch

Die Eigenschaft Filter legt die Dateimasken (Filter) fest, die im Dialogfeld verfügbar sind.

__property System::AnsiString Filter;

Beschreibung

Im Dialogfeld befindet sich unter dem Eingabefeld eine Dropdown-Liste mit Dateitypen. Sobald ein Typ aus der Liste ausgewählt wird, werden nur noch Dateien dieses Typs angezeigt.

Um zur Entwurfszeit Dateimasken zu konfigurieren, klicken Sie im Objektinspektor auf die Ellipsen-Schaltfläche (...) der Eigenschaft Filter. Dadurch wird der Filter-Editor geöffnet. Geben Sie in der linken Spalte des Editors unter Filtername für jeden Dateityp eine kurze Beschreibung ein. In der rechten Spalte geben Sie unter Filter die Dateimaske ein, die der Beschreibung entspricht. Beispielsweise könnte neben der Maske „*.TXT“ die Beschreibung „Textdateien“ stehen und neben der Maske „*.CPP“ die Beschreibung „ C++ Dateien“. Da die Beschreibung auch zur Laufzeit angezeigt wird, sollte sie nach Möglichkeit die dazugehörige Maske enthalten (z.B. „Textdateien (*.TXT)“).

Um Dateimasken programmseitig zu erzeugen, weisen Sie der Eigenschaft Filter einen Wert zu. Dieser Wert besteht aus einer Beschreibung und einer Maske, die durch einen senkrechten Strich (das Pipe-Zeichen |) getrennt sind. Fügen Sie vor und nach dem senkrechten Strich kein Leerzeichen ein. Ein Beispiel:

OpenDialog1->Filter = "Text files (*.txt)|*.TXT";

Mehrere Filter sollten jeweils durch einen senkrechten Strich getrennt werden. Auch dazu ein Beispiel:

OpenDialog1->Filter = "Text files (*.txt)|*.TXT|C++ files (*.cpp)|*.CPP";

Um mehrere Masken in einem einzigen Filter anzugeben, trennen Sie die Masken durch Semikolons. Dies gilt sowohl für den Objektinspektor als auch für den Quelltext. Ein Beispiel:

OpenDialog1->Filter = "C++ files|*.CPP;*.H";

Wenn die Eigenschaft Filter keinen Wert enthält, zeigt das Dialogfeld alle Dateitypen an.


TOpenDialog::FilterIndex

TOpenDialog	Siehe auch

Die Eigenschaft FilterIndex gibt an, welcher Filter beim öffnen des Dialogfeldes ausgewählt ist.

__property int FilterIndex;

Beschreibung

Mit FilterIndex können Sie festlegen, welcher Dateityp (Eigenschaft Filter) beim öffnen des Dialogfeldes als Vorgabe ausgewählt ist. Wenn FilterIndex 1 ist, ist dies der erste Dateityp der Liste, bei 2 der zweite usw. Enthält FilterIndex einen Wert außerhalb des zulässigen Bereichs, wird der erste Dateityp der Liste als Vorgabe verwendet.


TOpenDialog::HistoryList

TOpenDialog

Die Eigenschaft HistoryList enthält die Namen der Dateien, die bereits geöffnet waren.

__property Classes::TStrings* HistoryList;


TOpenDialog::InitialDir

TOpenDialog

Die Eigenschaft InitialDir legt das aktuelle Verzeichnis beim Öffnen des Dialogfeldes fest.

__property System::AnsiString InitialDir;

Beschreibung

Mit InitialDir können Sie festlegen, welches Verzeichnis beim öffnen des Dialogfeldes als Vorgabe angezeigt wird. Damit das Dialogfeld beispielsweise auf das Verzeichnis WINDOWS\SYSTEM zeigt, weisen Sie InitialDir C:\WINDOWS\SYSTEM zu.

Wenn InitialDir keinen Wert enthält oder wenn das angegebene Verzeichnis nicht existiert, wird beim öffnen des Dialogfeldes das aktuelle Arbeitsverzeichnis angezeigt.


TOpenDialog::Options

TOpenDialog	Siehe auch

Die Eigenschaft Options legt das Aussehen und das Verhalten des Dialogfeldes fest.

__property TOpenOptions Options;

Beschreibung

Mit dieser Eigenschaft können Sie das Erscheinungsbild und die Funktionalität des Dialogfeldes festlegen. Die folgende Tabelle enthält die möglichen Werte für Options:

Wert	Bedeutung

ofAllowMultiSelect	Der Benutzer kann im Dialogfeld mehrere Dateien auswählen.

ofCreatePrompt	Wenn der Benutzer eine nicht existierende Datei angibt, wird er in einer Meldung gefragt, ob eine neue Datei mit dem angegebenen Namen erzeugt werden soll.

ofExtensionDifferent	Dieses Flag wird zur Laufzeit gesetzt, wenn der ausgewählte Dateiname eine von DefaultExt verschiedene Erweiterung hat. Vergessen Sie nicht, dieses Flag zurückzusetzen, wenn Sie es in einer Anwendung verwenden.

ofFileMustExist	Gibt eine Fehlermeldung aus, wenn der Benutzer eine nicht existierende Datei angibt.

ofHideReadOnly	Entfernt das Kontrollkästchen Schreibgechützt aus dem Dialogfeld.

ofNoChangeDir	Wenn der Benutzer auf OK klickt, wird das aktuelle Verzeichnis auf den Wert zurückgesetzt, den es vor dem öffnen des Dialogfeldes hatte.

ofNoDereferenceLinks	Deaktiviert die Dereferenzierung von Windows-Verknüpfungen. Wenn der Benutzer eine Verknüpfung auswählt, wird der Eigenschaft FileName nicht die Datei zugewiesen, auf die die Verknüpfung zeigt, sondern der Pfad und der Dateiname der Verknüpfung selbst (die .LNK-Datei).

ofNoLongNames	Zeigt nur Dateinamen im konventionellen DOS-Format an (8.3).

ofNoNetworkButton	Entfernt die Schaltfläche Netzwerk (die das Dialogfeld Netzlaufwerk verbinden öffnet) aus dem Dialogfeld. Dies gilt nur, wenn das Flag ofOldStyleDialog gesetzt ist.

ofNoReadOnlyReturn	Zeigt eine Fehlermeldung an, wenn der Benutzer eine schreibgeschützte Datei auswählt.

ofNoTestFileCreate	Prüft nicht, ob eine Netzwerkdatei geschützt ist und ob auf ein Laufwerk zugegriffen werden kann. Das Flag ist nur wirksam, wenn der Benutzer eine Datei in einem gemeinsam benutzten Netzwerkverzeichnis speichern will, in dem er zwar Dateien erzeugen, aber nicht ändern darf.

ofNoValidate	Deaktiviert die Prüfung auf ungültige Zeichen in Dateinamen und erlaubt die Auswahl solcher Dateinamen..

ofOldStyleDialog	Das Dialogfeld wird im traditionellen Stil erzeugt.

ofOverwritePrompt	Wenn der Benutzer eine Datei angibt, die bereits im Zugriff ist, wird er in einer Meldung gefragt, ob diese Datei überschrieben werden soll. Dieses Flag wird im Zusammenhang mit TSaveDialog und TSavePictureDialog verwendet.

ofPathMustExist	Wenn der Benutzer einen Dateinamen mit einem nicht existierenden Pfad angibt, wird eine Fehlermeldung angezeigt.

ofReadOnly	Aktiviert das Kontrollkästchen Schreibgeschützt, wenn das Dialogfeld geöffnet wird.

ofShareAware	Ignoriert Fehler, die aus gemeinsamen Zugriffen resultieren.

ofShowHelp	Im Dialogfeld wird die Schaltfläche Hilfe angezeigt.

Standardmäßig sind alle Optionen deaktiviert.


TOpenDialog::Title

TOpenDialog

Die Eigenschaft Title legt den Text in der Titelleiste des Dialogfeldes fest.

__property System::AnsiString Title;

Beschreibung

Mit Title können Sie den Text festlegen, der in der Titelleiste des Dialogfeldes angezeigt wird. Wenn die Eigenschaft keinen Wert enthält, hat das Dialogfeld den Titel öffnen.


Methoden von TOpenDialog

TOpenDialog	Alphabetisch

In TOpenDialog

~TOpenDialog

Execute

GetFilePath

TOpenDialog

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TOpenDialog

TOpenDialog	Nach Objekten

~TOpenDialog

Assign

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

DestroyComponents

Destroying

Dispatch

Execute

FieldAddress

FindComponent

FreeInstance

FreeNotification

Free

GetFilePath

GetParentComponent

HasParent

InheritsFrom

InitInstance

InsertComponent

InstanceSize

MethodAddress

MethodName

NewInstance

RemoveComponent

TOpenDialog


TOpenDialog::~TOpenDialog

TOpenDialog	Siehe auch

Der Destruktor ~TOpenDialog gibt den Speicher frei, der für das TOpenDialog-Objekt reserviert war. Rufen Sie ~TOpenDialog nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TOpenDialog automatisch aufgerufen wird.

__fastcall virtual ~TOpenDialog(void);


TOpenDialog::Execute

TOpenDialog

Die Methode Execute zeigt das Dialogfeld an.

virtual bool __fastcall Execute(void);

Beschreibung

Execute öffnet das Dialogfeld zur Auswahl von Dateien und gibt True zurück, wenn der Benutzer eine Datei ausgewählt und auf OK geklickt hat.


TOpenDialog::GetFilePath

TOpenDialog

Die Methode GetFilePath gibt den Pfad der aktuell ausgewählten Datei als Pascal-String zurück.

Beschreibung

Die Methode GetFilePath ist nur verfügbar, wenn das Dialogfeld geöffnet ist.


TOpenDialog::TOpenDialog

TOpenDialog	Siehe auch

TOpenDialog erzeugt und initialisiert eine Instanz von TOpenDialog.

__fastcall virtual TOpenDialog(Classes::TComponent* AOwner);

Beschreibung

TOpenDialog erzeugt eine Instanz von TOpenDialog. Zur Laufzeit wird das neue Dialogfeld aber erst angezeigt, wenn die Methode Execute aufgerufen wird.


Gültigkeitsbereich

Published

Zugriff

Read-only


Hierarchie

TObject

TPersistent

TComponent

TCommonDialog


TOpenDialog Beispiel

TOpenDialog


 TOutline

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Die Komponente TOutline wird für mehrstufige Gliederungsdiagramme verwendet. Mit einem Gliederungsdiagramm können Sie Informationen visuell in einer baumartigen Hierarchie anordnen. Jedes Element eines Gliederungsdiagramms ist in einem TOutlineNode-Objekt enthalten.

Header

vcl/outline.hpp

Beschreibung

Verwenden Sie eine Gliederung, um Informationen in einem hierarchischen Baum darzustellen. Jeder Eintrag einer Gliederung ist in einem Objekt TOutlineNode enthalten. Gliederungslemente erlauben einer Anwendung eine Hierarchie von Baumknoten zu verwalten. Dies beinhaltet auch die Steuerung des Erscheinungsbildes und Layouts dieser Knoten, sowie die Fähigkeit, Zweige dieses Gliederungsbaums aus- und einzuklappen.

TOutline implementiert das generische Verhalten von TCustomOutline. TOutline veröffentlicht viele Eigenschaften und Ereignisse,von TCustomOutline, führt jedoche selbst keine neuen ein.


Eigenschaften von TOutline

TOutline	Alphabetisch	Legende

Abgeleitet von TCustomOutline

ItemCount

ItemHeight

Items

ItemSeparator

Lines

Options

OutlineStyle

PictureClosed

PictureLeaf

PictureMinus

PictureOpen

PicturePlus

SelectedItem

Style

Abgeleitet von TCustomGrid

BorderStyle

Row

ScrollBars

Abgeleitet von TCustomControl

Canvas

Abgeleitet von TWinControl

Brush

ClientOrigin

ClientRect

ControlCount

Controls

Ctl3D

Handle

HelpContext

ParentCtl3D

Showing

TabOrder

TabStop

Abgeleitet von TControl

Align

BoundsRect

ClientHeight

ClientWidth

Color

ControlState

ControlStyle

Cursor

DragCursor

DragMode

Enabled

Font

Height

Hint

Left

Name

Parent

ParentColor

ParentFont

ParentShowHint

PopupMenu

ShowHint

Top

Visible

Width

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TOutline

TOutline	Nach Objekten	Legende

Align

BorderStyle

BoundsRect

Brush

Canvas

ClientHeight

ClientOrigin

ClientRect

ClientWidth

Color

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlCount

ControlState

Controls

ControlStyle

Ctl3D

Cursor

DesignInfo

DragCursor

DragMode

Enabled

Font

Handle

Height

HelpContext

Hint

ItemCount

ItemHeight

ItemSeparator

Items

Left

Lines

Name

Options

OutlineStyle

Owner

ParentColor

ParentCtl3D

ParentFont

ParentShowHint

Parent

PictureClosed

PictureLeaf

PictureMinus

PictureOpen

PicturePlus

PopupMenu

Row

ScrollBars

SelectedItem

ShowHint

Showing

Style

TabOrder

TabStop

Tag

Top

Visible

Width


Ereignisse von TOutline

TOutline	Alphabetisch	Legende

Abgeleitet von TCustomOutline

OnCollapse

OnDrawItem

OnExpand

Abgeleitet von TWinControl

OnEnter

OnExit

OnKeyDown

OnKeyPress

OnKeyUp

Abgeleitet von TControl

OnClick

OnDblClick

OnDragDrop

OnDragOver

OnEndDrag

OnMouseDown

OnMouseMove

OnMouseUp

OnStartDrag


Ereignisse von TOutline

TOutline	Nach Objekten	Legende

OnClick

OnCollapse

OnDblClick

OnDragDrop

OnDragOver

OnDrawItem

OnEndDrag

OnEnter

OnExit

OnExpand

OnKeyDown

OnKeyPress

OnKeyUp

OnMouseDown

OnMouseMove

OnMouseUp

OnStartDrag


Methoden von TOutline

TOutline	Alphabetisch

Abgeleitet von TCustomOutline

~TCustomOutline

Add

AddChild

AddChildObject

AddObject

BeginUpdate

Clear

Delete

EndUpdate

FullCollapse

FullExpand

GetDataItem

GetItem

GetNodeDisplayWidth

GetTextItem

GetVisibleNode

Insert

InsertObject

LoadFromFile

LoadFromStream

SaveToFile

SaveToStream

SetUpdateState

TCustomOutline

Abgeleitet von TWinControl

Broadcast

CanFocus

ContainsControl

ControlAtPos

DisableAlign

EnableAlign

Focused

GetTabOrderList

HandleAllocated

HandleNeeded

InsertControl

Invalidate

PaintTo

Realign

RemoveControl

Repaint

ScaleBy

ScrollBy

SetBounds

SetFocus

Update

UpdateControlState

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

GetTextLen

Hide

Perform

Refresh

ScreenToClient

SendToBack

SetTextBuf

Show

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TOutline

TOutline	Nach Objekten

~TCustomOutline

AddChildObject

AddChild

AddObject

Add

Assign

BeginDrag

BeginUpdate

BringToFront

Broadcast

CanFocus

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

Clear

ClientToScreen

ContainsControl

ControlAtPos

DefaultHandler

Delete

DestroyComponents

Destroying

DisableAlign

Dispatch

DragDrop

Dragging

EnableAlign

EndDrag

EndUpdate

FieldAddress

FindComponent

Focused

FreeInstance

FreeNotification

Free

FullCollapse

FullExpand

GetDataItem

GetItem

GetNodeDisplayWidth

GetParentComponent

GetTabOrderList

GetTextBuf

GetTextItem

GetTextLen

GetVisibleNode

HandleAllocated

HandleNeeded

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InsertControl

InsertObject

Insert

InstanceSize

Invalidate

LoadFromFile

LoadFromStream

MethodAddress

MethodName

NewInstance

PaintTo

Perform

Realign

Refresh

RemoveComponent

RemoveControl

Repaint

SaveToFile

SaveToStream

ScaleBy

ScreenToClient

ScrollBy

SendToBack

SetBounds

SetFocus

SetTextBuf

SetUpdateState

Show

TCustomOutline

UpdateControlState

Update


~TOutline

Der Destruktor ~TOutline gibt den Speicher frei, der für das TOutline-Objekt reserviert war. Rufen Sie ~TOutline nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TOutline automatisch aufgerufen wird.

__fastcall virtual ~TOutline(void);


TOutline

Der Konstruktor TOutline erzeugt ein neues TOutline-Objekt.

__fastcall virtual TOutline(Classes::TComponent* AOwner);


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TControl

TWinControl

TCustomControl

TCustomGrid

TCustomOutline


TOutline Beispiel

TOutline


OutlineError

Hierarchie	Methoden	Siehe auch

Header

vcl/outline.hpp

OutlineError ist eine spezielle Exception-Klasse für ungültige Knotenindizes in Gliederungsdiagrammen.

Beschreibung

OutlineError wird ausgelöst, wenn eine Anwendung nicht auf einen angegebenen Knoten in einem Gliederungsdiagramm zugreifen kann. Meistens ist ein ungültiger Index die Ursache.

Hinweis

OutlineError wird intern ausgelöst, um die Suche in Gliederungsdiagrammen abzubrechen. Da die Klasse nicht von Exception abstammt, erscheint sie niemals zur Laufzeit, auch dann nicht, wenn die Debugger-Option aktiviert ist, die eine Unterbrechung bei Auftreten einer Exception bewirkt. Damit steht ein nützliches Hilfsmittel zur Verfügung, mit dem tiefe Rekursionsebenen verlassen werden können.


Methoden von OutlineError

OutlineError	Alphabetisch

In OutlineError

~OutlineError

OutlineError

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von OutlineError

OutlineError	Nach Objekten

~OutlineError

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance

OutlineError


OutlineError::~OutlineError

OutlineError

Der Destruktor ~OutlineError gibt den Speicher frei, der für das OutlineError-Objekt reserviert war. Rufen Sie ~OutlineError nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~OutlineError automatisch aufgerufen wird.

__fastcall virtual ~OutlineError(void);


OutlineError::OutlineError

OutlineError

Der Konstruktor OutlineError erzeugt ein neues OutlineError-Objekt.

__fastcall OutlineError(void);


Hierarchie

TObject


OutlineError Beispiel

OutlineError


TOutlineNode

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/outline.hpp

Ein TOutlineNode-Objekt ist ein untergeordnetes Objekt einer TOutline-Komponente. Ein Gliederungsknoten wird als Zeile im Gliederungsdiagramm dargestellt.

Jeder Knoten kann in der Gliederungsstruktur 0 bis 16368 Untereinträge enthalten.


Eigenschaften von TOutlineNode

TOutlineNode	Alphabetisch	Legende

In TOutlineNode

Data

Expanded

FullPath

HasItems

Index

IsVisible

Level

Parent

Text

TopItem


Eigenschaften von TOutlineNode

TOutlineNode	Nach Objekten	Legende

Data

Expanded

FullPath

HasItems

Index

IsVisible

Level

Parent

Text

TopItem


TOutlineNode::Data

TOutlineNode	Siehe auch

Mit der Eigenschaft Data können Sie die Daten festlegen, die mit einem Gliederungsknoten verbunden sind.

__property void * Data;

Beschreibung

Der Wert von Data ist ein Zeiger auf die Daten.


TOutlineNode::Expanded

TOutlineNode	Siehe auch

Mit der Eigenschaft Expanded können Sie festlegen, ob der Gliederungsknoten erweitert wurde.

__property bool Expanded;

Beschreibung

Sobald ein Eintrag erweitert wird, werden die Untereinträge und das Minus-Bitmap oder das Bitmap für den Zustand Geöffnet angezeigt. Dies hängt vom Stil des Gliederungsdiagramms ab, das in der Eigenschaft OutlineStyle der TOutline-Komponente für den Gliederungsknoten festgelegt wurde.

Expanded hat den Wert True, falls der Eintrag erweitert wurde. Andernfalls hat die Eigenschaft den Wert False.


TOutlineNode::FullPath

TOutlineNode	Siehe auch

Mit der Eigenschaft FullPath können Sie den Pfad der Gliederungsknoten vom obersten Knoten in Ebene 1 bis zum Knoten festlegen, der im TOutlineNode-Objekt enthalten ist.

__property System::AnsiString FullPath;

Beschreibung

Der Pfad besteht aus den Werten der Eigenschaft Text der Gliederungsknoten. Diese werden durch den String getrennt, der in der Eigenschaft ItemSeparator der TOutline-Komponente festgelegt wurde.


TOutlineNode::HasItems

TOutlineNode	Siehe auch

Mit der Eigenschaft HasItem können Sie bestimmen, ob ein Gliederungseintrag untergeordnete Einträge enthält.

Beschreibung

Sobald ein übergeordnetes Objekt geöffnet wird, werden die Knoten unter dem Objekt angezeigt und mit einem Einzug versehen. Der Index des übergeordneten Knotens ist um Eins kleiner als der Index des ersten Eintrags. HasItems hat den Wert True, falls der Knoten Einträge enthält. Andernfalls hat die Eigenschaft den Wert False.


TOutlineNode::Index

TOutlineNode	Siehe auch

Mit der Eigenschaft Index werden alle Einträge (Knoten) eines Gliederungsdiagramms eindeutig bezeichnet.

__property long Index;

Beschreibung

Der erste Eintrag hat den Index 1. Die nachfolgenden Knoten werden mit einer laufenden Nummer indiziert. Enthält ein Knoten untergeordnete Einträge, ist der Index des übergeordneten Knotens um Eins kleiner als der Index des ersten untergeordneten Eintrags.

Der Wert der Eigenschaft Index entspricht dem Index im Array Items der TOutline-Komponente. Wird ein Eintrag angehängt, eingefügt oder aus dem Gliederungsdiagramm entfernt, müssen die Werte der Eigenschaft Index der folgenden Knoten neu berechnet werden. Dies wird automatisch durchgeführt, wenn die Methode BeginUpdate aufgerufen wurde.


TOutlineNode::IsVisible

TOutlineNode	Siehe auch

Die Eigenschaft IsVisible gibt an, ob der Gliederungsknoten in der TOutline-Komponente sichtbar ist.

__property bool IsVisible;

Beschreibung

Ein Knoten ist sichtbar, wenn er sich in der Ebene 1 befindet oder alle übergeordneten Knoten erweitert wurden.


TOutlineNode::Level

TOutlineNode	Siehe auch

Die Eigenschaft Level gibt die Ebene eines Knotens in der TOutline-Komponente an.

__property Cardinal Level;

Beschreibung

Für die Knoten der obersten Ebene hat Level den Wert 1. Für deren untergeordnete Knoten hat Level den Wert 2 usw.


TOutlineNode::Parent

TOutlineNode	Siehe auch	Beispiel

Die Eigenschaft Parent bezeichnet den übergeordneten Knoten dieses Gliederungsknotens.

__property TOutlineNode* Parent;

Beschreibung

Ein übergeordneter Knoten befindet sich eine Ebene höher und enthält den untergeordneten Knoten als Eintrag.


TOutlineNode::Text

TOutlineNode	Siehe auch	Beispiel

Die Eigenschaft Text enthält den String, mit dem der Gliederungsknoten bezeichnet wird.

__property System::AnsiString Text;

Beschreibung

Dieser String wird im Gliederungsdiagramm angezeigt. Der Wert von Text kann direkt zugewiesen oder über die Eigenschaft Lines der TOutline-Komponente eingestellt werden. Wird Text mit der Eigenschaft Lines eingestellt, werden die einzelnen Zeilen ohne die vorangestellten Leer- oder Tabulatorzeichen der Eigenschaft Text der jeweiligen TOutlineNode-Objekte zugewiesen.


TOutlineNode::TopItem

TOutlineNode	Siehe auch 	Beispiel

Die Eigenschaft TopItem bezeichnet den obersten Knoten eines Gliederungsdiagramms.

__property long TopItem;

Beschreibung

Mit der Eigenschaft TopItems können Sie den Index des übergeordneten Knotens der Ebene 1 festlegen. Bei einem Knoten der Ebene 1 hat TopItem denselben Wert wie der Index. Bei einem Knoten, der sich im Gliederungsbaum unterhalb der Ebene 1 befindet, ist TopItem der Index des obersten Knotens eines Gliederungsastes.


Methoden von TOutlineNode

TOutlineNode	Alphabetisch

In TOutlineNode

~TOutlineNode

ChangeLevelBy

Collapse

Expand

FullExpand

GetDisplayWidth

GetFirstChild

GetLastChild

GetNextChild

GetPrevChild

MoveTo

TOutlineNode

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TOutlineNode

TOutlineNode	Nach Objekten

~TOutlineNode

Assign

ChangeLevelBy

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

Collapse

DefaultHandler

Dispatch

Expand

FieldAddress

FreeInstance

Free

FullExpand

GetDisplayWidth

GetFirstChild

GetLastChild

GetNextChild

GetPrevChild

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

MoveTo

NewInstance

TOutlineNode


TOutlineNode::ChangeLevelBy

TOutlineNode	Siehe auch

Mit der Methode ChangeLevelBy können Sie die Ebene eines Gliederungsknotens ändern.

void __fastcall ChangeLevelBy(TChangeRange Value);

Beschreibung

Geben Sie für den Parameter Value den Wert -1 an, um den Knoten um eine Ebene nach oben (in Richtung des Stammes) zu verschieben. Geben Sie für den Parameter Value den Wert 1 an, um den Knoten um eine Ebene nach unten zu verschieben.

Wird ein Knoten um eine Ebene nach oben verschoben, wird er zum nächsten gleichrangigen Eintrag seines bisher übergeordneten Knotens. Wird ein Knoten um eine Ebene nach unten verschoben, wird er zum letzten untergeordneten Knoten seines bisher vorhergehenden gleichrangigen Eintrags. Die Ebene des ersten Knotens eines Gliederungsdiagramms kann nicht geändert werden, da dieser keinem Knoten unterstellt ist. Außerdem können keine Knoten um eine Ebene nach oben verschoben werden, die sich bereits in der ersten Ebene befinden.

Mit ChangeLevelBy können Sie den Wert der Eigenschaft Level ändern, um die neue Ebene einzustellen. Sie können einen Knoten immer nur um eine Ebene nach oben oder unten verschieben.


TOutlineNode::Collapse

TOutlineNode	Siehe auch

Die Methode Collapse schließt einen Gliederungsknoten.

void __fastcall Collapse(void);

Beschreibung

Mit Collapse können Sie der Eigenschaft Expanded den Wert False zuweisen. Sobald ein Gliederungsknoten geschlossen wird, werden die untergeordneten Einträge ausgeblendet, und das Plus-Bitmap oder das Bitmap für den Zustand Geschlossen wird angezeigt. Dies hängt vom Stil des Gliederungsdiagramms ab, das in der Eigenschaft OutlineStyle festgelegt wurde.


TOutlineNode::Expand

TOutlineNode	Siehe auch

Die Methode Expand erweitert einen Gliederungsknoten.

void __fastcall Expand(void);

Beschreibung

Mit der Methode Expand können Sie die nächste Ebene eines Gliederungsknotens einblenden, indem der Eigenschaft Expanded der Wert True zugewiesen wird. Sobald die nächste Ebene eines Knotens erscheint, werden die untergeordneten Knoten und gegebenenfalls das Minus-Bitmap oder das Bitmap für den Zustand Geöffnet angezeigt. Dies hängt vom Stil des Gliederungsdiagramms ab, das in der Eigenschaft OutlineStyle festgelegt wurde. Sobald ein Knoten geöffnet wird, wird die Eigenschaft Expanded auf True gesetzt. Außerdem werden die untergeordneten Knoten und gegebenenfalls das Bitmap für den Zustand Geöffnet oder das Minus-Bitmap angezeigt. Dies hängt vom Stil des Gliederungsdiagramms ab, das in der Eigenschaft OutlineStyle festgelegt wurde.


TOutlineNode::FullExpand

TOutlineNode	Siehe auch

Die Methode FullExpand erweitert alle Knoten, die sich in demselben Ast wie der Gliederungsknoten befinden.

void __fastcall FullExpand(void);

Beschreibung

Mit FullExpand können Sie alle Knoten anzeigen, die sich in demselben Ast wie der Gliederungsknoten befinden.


TOutlineNode::GetDisplayWidth

TOutlineNode	Siehe auch

Mit der Methode GetDisplayWidth können Sie die Breite der Anzeige eines Knoten ermitteln.

int __fastcall GetDisplayWidth(void);

Beschreibung

Mit der Methode GetDisplayWidth können Sie die Breite der Anzeige eines Gliederungsknotens bestimmen. Dazu wird die Methode TOutline::GetNodeDisplayWidth aufgerufen.


TOutlineNode::GetFirstChild

TOutlineNode	Siehe auch

Mit der Methode GetFirstChild können Sie den Index des ersten untergeordneten Knotens eines Gliederungsknotens ermitteln.

long __fastcall getFirstChild(void);

Beschreibung

Enthält der Knoten keine untergeordneten Einträge, gibt GetFirstChild den Wert -1 zurück.


TOutlineNode::GetLastChild

TOutlineNode	Siehe auch

Mit der Methode GetFirstChild können Sie den Index des letzten untergeordneten Knotens eines Gliederungsknotens ermitteln.

long __fastcall GetLastChild(void);

Enthält der Knoten keine untergeordneten Einträge, gibt GetLastChild den Wert -1 zurück.


TOutlineNode::GetNextChild

TOutlineNode	Siehe auch

Mit der Methode GetNextChild können Sie den Index des nächsten untergeordneten Knotens eines Gliederungsknotens ermitteln.

long __fastcall GetNextChild(long Value);

Beschreibung

Mit der Methode GetNextChild können Sie den Index des nächsten Gliederungsknotens ermitteln, der demselben Knoten untergeordnet ist wie der Knoten mit dem Index im Parameter Value. Diese Methode wird benötigt, wenn der mit Value indizierte Knoten untergeordnete Einträge enthält. Der Index des nächsten Knotens beträgt somit nicht einfach um Eins mehr als Value. Handelt es sich bei dem von Value indizierten Knoten um den letzten Eintrag, gibt GetNextChild den Wert -1 zurück.


TOutlineNode::GetPrevChild

TOutlineNode	Siehe auch

Mit der Methode GetPrevChild können Sie den Index des vorhergehenden untergeordneten Knotens eines Gliederungsknotens ermitteln.

long __fastcall GetPrevChild(long Value);

Beschreibung

Mit der Methode GetPrevChild können Sie den Index des vorhergehenden Gliederungsknotens ermitteln, der demselben Knoten untergeordnet ist wie der Knoten mit dem Index im Parameter Value. Diese Methode wird benötigt, wenn der vorhergehende gleichrangige Eintrag untergeordnete Einträge enthält. Der Index des vorhergehenden Knotens beträgt somit nicht einfach um Eins weniger als Value. Handelt es sich bei dem von Value indizierten Knoten um den ersten Eintrag, gibt GetPrevChild den Wert -1 zurück.


TOutlineNode::MoveTo

TOutlineNode	Siehe auch

Mit der Methode MoveTo können Sie ein Gliederungsdiagramm von einer Position im Gliederungsdiagramm (TOutline-Komponente) an eine andere verschieben.

void __fastcall MoveTo(long Destination, TAttachMode AttachMode);

Beschreibung

Mit dem Parameter Destination können Sie bestimmen, wohin der Knoten verschoben wird. Übergeben Sie im Parameter Destination den Index eines anderen Gliederungsknotens. Mit dem Parameter AttachMode können Sie festlegen, wie der Knoten an die gewünschte Position verschoben werden soll. Im folgenden finden Sie die möglichen Werte von AttachMode:

Wert	Beschreibung

oaAdd	Der Eintrag wird wie mit der Methode Add angefügt. Der verschobene Eintrag wird zum letzten gleichrangigen Eintrag des Eintrags, der im Parameter Destination angegeben wurde. Der verschobene Eintrag ist in demselben übergeordneten Knoten enthalten wie der Eintrag in Destination.

oaAddChild	Der Eintrag wird wie mit der Methode AddChild angefügt. Der verschobene Eintrag wird zum letzten untergeordneten Objekt des Eintrags, der im Parameter Destination angegeben wurde. Der Eintrag in Destination wird zum übergeordneten Objekt des verschobenen Eintrags.

oaInsert	Der Eintrag wird wie mit der Methode Insert eingefügt. Der Eintrag von Destination wird im Gliederungsdiagramm durch den verschobenen Eintrag ersetzt. Der Eintrag von Destination und alle folgenden Einträge werden um eine Zeile nach unten verschoben.


TOutlineNode::~TOutlineNode

TOutlineNode

Der Destruktor ~TOutlineNode gibt den Speicher frei, der für das TOutlineNode-Objekt reserviert war. Rufen Sie ~TOutlineNode nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TOutlineNode automatisch aufgerufen wird.

__fastcall virtual ~TOutlineNode(void);


TOutlineNode::TOutlineNode

TOutlineNode

Der Konstruktor TOutlineNode erzeugt ein neues TOutlineNode-Objekt.

__fastcall TOutlineNode(TCustomOutline* AOwner);


Zugriff

Read-only


Hierarchie

TObject

TPersistent


TOutlineNode Beispiel

TOutlineNode


 TPageControl

Hierarchie	Eigenschaften	Methoden	Ereignisse

Header

vcl/comctrls.hpp

Die Komponente TPageControl dient dazu, Dialogfelder aufzubauen, die aus mehreren, sich überlappenden, Seiten (Registerkarten) bestehen. Die einzelnen Seiten sind Objekte der Klasse TTabSheet. Diese Klasse ersetzt die Klasse TTabbedNotebook. Eine bestimmte Seite kann durch Klicken auf das sogenannte Register (ähnlich einem Reiter auf einer Karteikarte) ausgewählt werden, das sich am oberen Rand des Steuerelements befindet.

Beschreibung

Um während des Entwurfs eine neue Seite für ein TPageControl-Objekts zu erstellen, klicken Sie mit der rechten Maustaste auf das TPageControl-Objekt und wählen im lokalen Menü den Eintrag Neue Seite. Jede Seite eines TPageControl-Objekts ist eine sogenannte Registerkarte. Sie können auf eine bestimmte Registerkarte des Steuerelements zugreifen, indem Sie entweder auf das Register klicken oder die Eigenschaft ActivePage setzen. Die Eigenschaft PageIndex enthält den Index der Registerkarte.

Standardmäßig wird im Steuerelement nur eine einizige Zeile mit Registern („Reitern“) angezeigt. Können nicht alle Register gleichzeitig angezeigt werden, wird ein Wippregler eingefügt. Somit können durch Verschieben des Bildschirmausschnitts zusätzliche Register angezeigt werden. Mit der Eigenschaft MultiLine können Sie gegebenenfalls mehrere Registerzeilen anzeigen, so daß alle Register gleichzeitig sichtbar sind.

Die Komponente TPageControl ist ein indirekter Nachkomme von TWinControl. Zusätzlich zu den folgenden Eigenschaften, Methoden und Ereignissen enthält diese Komponente die Eigenschaften, Methoden und Ereignisse, die allen fensterorientierten Steuerelemente gemeinsam sind.


Eigenschaften von TPageControl

TPageControl	Alphabetisch	Legende

In TPageControl

ActivePage

PageCount

Pages

Abgeleitet von TCustomTabControl

MultiLine

TabHeight

TabWidth

Abgeleitet von TWinControl

Brush

ClientOrigin

ClientRect

ControlCount

Controls

Handle

HelpContext

Showing

TabOrder

TabStop

Abgeleitet von TControl

Align

BoundsRect

ClientHeight

ClientWidth

ControlState

ControlStyle

Cursor

DragCursor

DragMode

Enabled

Font

Height

Hint

Left

Name

Parent

ParentFont

ParentShowHint

PopupMenu

ShowHint

Top

Visible

Width

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TPageControl

TPageControl	Nach Objekten	Legende

ActivePage

Align

BoundsRect

Brush

ClientHeight

ClientOrigin

ClientRect

ClientWidth

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlCount

ControlState

Controls

ControlStyle

Cursor

DesignInfo

DragCursor

DragMode

Enabled

Font

Handle

Height

HelpContext

Hint

Left

MultiLine

Name

Owner

PageCount

Pages

ParentFont

ParentShowHint

Parent

PopupMenu

ShowHint

Showing

TabHeight

TabOrder

TabStop

TabWidth

Tag

Top

Visible

Width


TPageControl::ActivePage

TPageControl

Die Eigenschaft ActivePage legt die aktive Registerkarte fest und bringt sie in den Vordergrund.

__property TTabSheet* ActivePage;

Beschreibung

Jede Registerkarte ist ein TTabSheet-Objekt. Um eine bestimmte Registerkarte zu aktivieren, klicken Sie entweder auf das entsprechende Register oder setzen die Eigenschaft ActivePage. Mit den Methoden FindNextPage und SelectNextPage können Sie Registerkarten auswählen, deren Register nicht sichtbar sind. Es kann immer nur eine Registerkarte aktiv sein.


TPageControl::PageCount

TPageControl	Siehe auch

Die Eigenschaft PageCount enthält die Anzahl der Registerkarten eines TPageControl-Objekts.

__property int PageCount;

Beschreibung

Jede Registerkarte ist ein TTabSheet-Objekt.


TPageControl::Pages

TPageControl	Siehe auch

Die Eigenschaft Pages enthält ein indiziertes Array der Registerkarten eines TPageControl-Objekts.

__property TTabSheet* Pages[int Index];

Beschreibung

Jede Registerkarte ist ein TTabSheet-Objekt. Mit Pages können Sie auf ein TTabSheet-Objekt zugreifen, das durch seinen Index identifiziert wird.


Ereignisse von TPageControl

TPageControl	Alphabetisch	Legende

Abgeleitet von TCustomTabControl

OnChange

OnChanging

Abgeleitet von TWinControl

OnEnter

OnExit

Abgeleitet von TControl

OnDragDrop

OnDragOver

OnEndDrag

OnMouseDown

OnMouseMove

OnMouseUp

OnStartDrag


Ereignisse von TPageControl

TPageControl	Nach Objekten	Legende

OnChange

OnChanging

OnDragDrop

OnDragOver

OnEndDrag

OnEnter

OnExit

OnMouseDown

OnMouseMove

OnMouseUp

OnStartDrag


Methoden von TPageControl

TPageControl	Alphabetisch

In TPageControl

~TPageControl

FindNextPage

SelectNextPage

TPageControl

Abgeleitet von TWinControl

Broadcast

CanFocus

ContainsControl

ControlAtPos

DisableAlign

EnableAlign

Focused

GetTabOrderList

HandleAllocated

HandleNeeded

InsertControl

Invalidate

PaintTo

Realign

RemoveControl

Repaint

ScaleBy

ScrollBy

SetBounds

SetFocus

Update

UpdateControlState

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

GetTextLen

Hide

Perform

Refresh

ScreenToClient

SendToBack

SetTextBuf

Show

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TPageControl

TPageControl	Nach Objekten

~TPageControl

Assign

BeginDrag

BringToFront

Broadcast

CanFocus

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

ClientToScreen

ContainsControl

ControlAtPos

DefaultHandler

DestroyComponents

Destroying

DisableAlign

Dispatch

DragDrop

Dragging

EnableAlign

EndDrag

FieldAddress

FindComponent

FindNextPage

Focused

FreeInstance

FreeNotification

Free

GetParentComponent

GetTabOrderList

GetTextBuf

GetTextLen

HandleAllocated

HandleNeeded

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InsertControl

InstanceSize

Invalidate

MethodAddress

MethodName

NewInstance

PaintTo

Perform

Realign

Refresh

RemoveComponent

RemoveControl

Repaint

ScaleBy

ScreenToClient

ScrollBy

SelectNextPage

SendToBack

SetBounds

SetFocus

SetTextBuf

Show

TPageControl

UpdateControlState

Update


TPageControl::~TPageControl

TPageControl	Siehe auch

Der Destruktor ~TPageControl gibt den Speicher frei, der für das TPageControl-Objekt reserviert war. Rufen Sie ~TPageControl nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TPageControl automatisch aufgerufen wird.

__fastcall virtual ~TPageControl(void);


TPageControl::FindNextPage

TPageControl	Siehe auch 	Beispiel

Die Methode FindNextPage gibt die nächste Registerkarte des TPageControl-Objekts vor oder nach CurPage zurück. Die genaue Funktion hängt vom Wert von GoForward ab.

TTabSheet* __fastcall FindNextPage(TTabSheet* CurPage, bool GoForward, bool CheckTabVisible);

Beschreibung

Jede Registerkarte ist ein TTabSheet-Objekt. Um während des Entwurfs die nächste Registerkarte zu erreichen, klicken Sie mit der rechten Maustaste auf das TPageControl-Objekt und wählen im lokalen Menü Nächste Seite.

Hat CheckTabVisible den Wert True, wird die nächste Registerkarte zurückgegeben, deren Eigenschaft TabVisible auf True eingestellt wurde. Hat CheckTabVisible den Wert False, gibt FindNextPage die nächste Registerkarte zurück, auch wenn deren Eigenschaft TabVisible auf False eingestellt wurde. Mit FindNextPage können Sie auf eine Registerkarte zugreifen, deren Register nicht sichtbar ist.

Hat der Parameter GoForward den Wert True, wird die Registerkarte des Steuerelements nach v gesucht. Andernfalls ermittelt FindNextPage die der Registerkarte CurPage vorhergehende Registerkarte.


TPageControl::SelectNextPage

TPageControl	Siehe auch

Mit der Methode SelectNextPage kann die Registerkarte vor oder hinter der aktiven Registerkarte des TPageControl-Objekts ausgewählt werden.

void __fastcall SelectNextPage(bool GoForward);

Beschreibung

Mit der Methode SelectNextPage kann die Registerkarte vor oder hinter der aktiven Registerkarte des TPageControl-Objekts ausgewählt werden. Hat der Parameter GoForward den Wert True, wird die Registerkarte des Steuerelements hinter ActivePage gesucht. Andernfalls ermittelt SelectNextPage die der Registerkarte ActivePage vorhergehende Registerkarte. Mit SelectNextPage können nur Registerkarten ausgewählt werden, deren Eigenschaft TabVisible auf True eingestellt wurde.

Um eine Registerkarte während des Entwurfs auszuwählen, klicken Sie mit der rechten Maustaste auf das TPageControl-Objekt und wählen im lokalen Menü Vorherige Seite oder Nächste Seite.


TPageControl::TPageControl

TPageControl	Siehe auch

Der Konstruktor TPageControl erzeugt ein neues TPageControl-Objekt.

__fastcall virtual TPageControl(Classes::TComponent* AOwner);


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TControl

TWinControl

TCustomTabControl


TPageControl Beispiel

TPageControl


 TPaintBox

Hierarchie	Ereignisse 	Methoden	Ereignisse

Header

vcl/extctrls.hpp

TPaintBox stellt in einem rechteckigen Bereich eines Formulars ein TCanvas-Objekt zur Verfügung und beschränkt Zeichenoperationen auf das Innere dieses Bereichs.

Beschreibung

Mit dem Event-Handler für OnPaint können Sie auf dem TCanvas-Objekt (also auf der Zeichenoberfläche des Zeichenfeldes) zeichnen. Die Eigenschaften Color und Font werden verwendet, um das TCanvas-Objekt für den Event-Handler zu initialisieren. Der Eigenschaft Brush.Color des TCanvas-Objekts wird der Wert der Eigenschaft Color zugewiesen.

Mit dem Ereignis OnPaint des Formulars können Sie auf dem gesamten Formular zeichnen. Um die Zeichenoperationen auf einen bestimmten rechtekkigen Bereich zu beschränken, bietet sich die Verwendung eines Zeichenfeldes an.

Mit Hilfe der Eigenschaft Align können Sie ein Zeichenfeld so ausrichten, daß es in seiner Position relativ zum Formular verbleibt, auch wenn der Anwender die Größe des Formulars ändert.


Eigenschaften von TPaintBox

TPaintBox	Alphabetisch	Legende

Abgeleitet von TGraphicControl

Canvas

Abgeleitet von TControl

Align

BoundsRect

ClientHeight

ClientOrigin

ClientRect

ClientWidth

Color

ControlState

ControlStyle

Cursor

DragCursor

DragMode

Enabled

Font

Height

Hint

Left

Name

Parent

ParentColor

ParentFont

ParentShowHint

PopupMenu

ShowHint

Top

Visible

Width

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TPaintBox

TPaintBox	Nach Objekten	Legende

Align

BoundsRect

Canvas

ClientHeight

ClientOrigin

ClientRect

ClientWidth

Color

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlState

ControlStyle

Cursor

DesignInfo

DragCursor

DragMode

Enabled

Font

Height

Hint

Left

Name

Owner

ParentColor

ParentFont

ParentShowHint

Parent

PopupMenu

ShowHint

Tag

Top

Visible

Width


Ereignisse von TPaintBox

TPaintBox	Alphabetisch	Legende

In TPaintBox

OnPaint

Abgeleitet von TControl

OnClick

OnDblClick

OnDragDrop

OnDragOver

OnEndDrag

OnMouseDown

OnMouseMove

OnMouseUp

OnStartDrag


Ereignisse von TPaintBox

TPaintBox	Nach Objekten	Legende

OnClick

OnDblClick

OnDragDrop

OnDragOver

OnEndDrag

OnMouseDown

OnMouseMove

OnMouseUp

OnPaint

OnStartDrag


TPaintBox::OnPaint

TPaintBox

Das Ereignis OnPaint tritt auf, wenn Windows ein Zeichenfeld auffordert, sich zu zeichnen. Dies ist z.B. der Fall, wenn das Zeichenfeld den Fokus erhält oder zum ersten Mal auf dem Bildschirm erscheint.

__property Classes::TNotifyEvent OnPaint;

Beschreibung

Schreiben Sie einen Event-Handler für OnPaint, wenn Sie im TCanvas-Objekt des Zeichenfeldes zeichnen wollen.


Methoden von PaintBox

TPaintBox	Alphabetisch	Legende

In TPaintBox

~TPaintBox

Paint

TPaintBox

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

GetTextLen

Hide

Invalidate

Perform

Refresh

Repaint

ScreenToClient

SendToBack

SetBounds

SetTextBuf

Show

Update

Derived from TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von PaintBox

TPaintBox	Nach Objekten	Legende

~TPaintBox

Assign

BeginDrag

BringToFront

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

ClientToScreen

DefaultHandler

DestroyComponents

Destroying

Dispatch

DragDrop

Dragging

EndDrag

FieldAddress

FindComponent

FreeInstance

FreeNotification

Free

GetParentComponent

GetTextBuf

GetTextLen

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InstanceSize

Invalidate

MethodAddress

MethodName

NewInstance

Paint

Perform

Refresh

RemoveComponent

Repaint

ScreenToClient

SendToBack

SetBounds

SetTextBuf

Show

TPaintBox

Update


TPaintBox::~TPaintBox

TPaintBox

Der Destruktor ~TPaintBox gibt den Speicher frei, der für das TPaintBox-Objekt reserviert war. Rufen Sie ~TPaintBox nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TPaintBox automatisch aufgerufen wird.

__fastcall virtual ~TPaintBox(void);


TPaintBox::TPaintBox

TPaintBox

TPaintBox erzeugt eine Instanz eines TPaintBox-Objekts für eine Anwendung.

__fastcall virtual TPaintBox(Classes::TComponent* AOwner);

Beschreibung

Mit TPaintBox können Sie zur Laufzeit ein TPaintBox-Objekt erzeugen. Zur Entwurfszeit wird TPaintBox automatisch aufgerufen.

TPaintBox setzt die Standardwerte für die Instanz des TPaintBox-Objekts und weist ihr Speicher zu.


TPaintBox::Paint

TPaintBox

virtual void __fastcall Paint(void);

Beschreibung

TPaintBox reagiert auf WM_PAINT-Botschaften von Windows, indem es die Zeichenfläche des Steuerelements initialisiert und die Methode Paint aufruft.


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Protected


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TControl

TGraphicControl


TPaintBox Beispiel

TPaintBox


 TPanel

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/extctrls.hpp

TPanel implementiert ein generisches Steuerelement des Typs Tafel.

Beschreibung

Mit der Komponente TPanel plazieren Sie in Ihrem Formular eine leere Tafel. Mit den zugehörigen Eigenschaften kann ein dreidimensional wirkender Rahmen um dieses Steuerelement gelegt werden. Außerdem verfügen Tafeln über Methoden, die die Positionierung von untergeordneten Steuerelementen innerhalb der Tafel ermöglichen.

TPanel implementiert das generische Verhalten, das in TCustomPanel eingeführt wurde. TPanel deklariert viele der von TCustomPanel geerbten Eigenschaften als published, führt aber kein neues Verhalten ein.


Eigenschaften von TPanel

TPanel	Alphabetisch	Legende

Abgeleitet von TCustomPanel

Alignment

BevelInner

BevelOuter

BevelWidth

BorderStyle

BorderWidth

Locked

Abgeleitet von TWinControl

Brush

ClientOrigin

ClientRect

ControlCount

Controls

Ctl3D

Handle

HelpContext

ParentCtl3D

Showing

TabOrder

TabStop

Abgeleitet von TControl

Align

BoundsRect

Caption

ClientHeight

ClientWidth

Color

ControlState

ControlStyle

Cursor

DragCursor

DragMode

Enabled

Font

Height

Hint

Left

Name

Parent

ParentColor

ParentFont

ParentShowHint

PopupMenu

ShowHint

Top

Visible

Width

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TPanel

TPanel	Nach Objekten	Legende

Alignment

Align

BevelInner

BevelOuter

BevelWidth

BorderStyle

BorderWidth

BoundsRect

Brush

Caption

ClientHeight

ClientOrigin

ClientRect

ClientWidth

Color

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlCount

ControlState

Controls

ControlStyle

Ctl3D

Cursor

DesignInfo

DragCursor

DragMode

Enabled

Font

Handle

Height

HelpContext

Hint

Left

Locked

Name

Owner

ParentColor

ParentCtl3D

ParentFont

ParentShowHint

Parent

PopupMenu

ShowHint

Showing

TabOrder

TabStop

Tag

Top

Visible

Width


Ereignisse von TPanel

TPanel	Alphabetisch	Legende

Abgeleitet von TCustomPanel

OnResize

Abgeleitet von TWinControl

OnEnter

OnExit

Abgeleitet von TControl

OnClick

OnDblClick

OnDragDrop

OnDragOver

OnEndDrag

OnMouseDown

OnMouseMove

OnMouseUp

OnStartDrag


Ereignisse von TPanel

TPanel	Nach Objekten	Legende

OnClick

OnDblClick

OnDragDrop

OnDragOver

OnEndDrag

OnEnter

OnExit

OnMouseDown

OnMouseMove

OnMouseUp

OnResize

OnStartDrag


Methoden von TPanel

TPanel	Alphabetisch

In TPanel

~TPanel

TPanel

Abgeleitet von TWinControl

Broadcast

CanFocus

ContainsControl

ControlAtPos

DisableAlign

EnableAlign

Focused

GetTabOrderList

HandleAllocated

HandleNeeded

InsertControl

Invalidate

PaintTo

Realign

RemoveControl

Repaint

ScaleBy

ScrollBy

SetBounds

SetFocus

Update

UpdateControlState

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

GetTextLen

Hide

Perform

Refresh

ScreenToClient

SendToBack

SetTextBuf

Show

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TPanel

TPanel	Nach Objekten

~TPanel

Assign

BeginDrag

BringToFront

Broadcast

CanFocus

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

ClientToScreen

ContainsControl

ControlAtPos

DefaultHandler

DestroyComponents

Destroying

DisableAlign

Dispatch

DragDrop

Dragging

EnableAlign

EndDrag

FieldAddress

FindComponent

Focused

FreeInstance

FreeNotification

Free

GetParentComponent

GetTabOrderList

GetTextBuf

GetTextLen

HandleAllocated

HandleNeeded

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InsertControl

InstanceSize

Invalidate

MethodAddress

MethodName

NewInstance

PaintTo

Perform

Realign

Refresh

RemoveComponent

RemoveControl

Repaint

ScaleBy

ScreenToClient

ScrollBy

SendToBack

SetBounds

SetFocus

SetTextBuf

Show

TPanel

UpdateControlState

Update


TPanel::~TPanel

TPanel

Der Destruktor ~TPanel gibt den Speicher frei, der für das TPanel-Objekt reserviert war. Rufen Sie ~TPanel nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TPanel automatisch aufgerufen wird.

__fastcall virtual ~TPanel(void);


TPanel::TPanel

TPanel

Der Konstruktor TPanel erzeugt ein neues TPanel-Objekt.

__fastcall virtual TPanel(Classes::TComponent* AOwner);


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TControl

TWinControl

TCustomControl

TCustomPanel


TPanel Beispiel

TPanel


TParaAttributes

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/comctrls.hpp

TParaAttributes ist ein Hilfsobjekt, das die Eigenschaften zur Absatzformatierung in einem RTF-Eingabefeld repräsentiert.

Beschreibung

TParaAttributes besitzt eine Reihe von Eigenschaften, mit denen sich die Gestaltungsmerkmale eines Absatzes in einem RTF-Eingabefeld beschreiben lassen. TParaAttributes ist so konzipiert, daß ein Nachkomme von TCustomRichEdit die Formatierung ausgewählter Absätze lesen und schreiben kann. Die Eigenschaften eines TParaAttributes-Objekts sind erst dann gültig, wenn ein Nachkomme von TCustomRichEdit als Eigentümer fungiert.


Eigenschaften von TParaAttributes

TParaAttributes	Alphabetisch

In TParaAttributes

Alignment

FirstIndent

LeftIndent

Numbering

RightIndent

Tab

TabCount


Eigenschaften von TParaAttributes

TParaAttributes	Nach Objekten

Alignment

FirstIndent

LeftIndent

Numbering

RightIndent

TabCount

Tab


TParaAttributes::Alignment

TParaAttributes	Siehe auch	Beispiel

Die Eigenschaft steuert die Ausrichtung der Textzeilen innerhalb eines Absatzes.

__property Classes::TAlignment

Beschreibung

Mit Alignment wird Anordnung des Textes in einem Absatz gesteuert. Im Gegensatz zur Eigenschaft Alignment eines TCustomMemo-Objekts, die für den gesamten Fließtext gilt, wirkt sich die hier beschrieben Eigenschaft nur auf ausgewählte Absätze aus.

Die Eigenschaft kann folgende Werte annehmen:

Wert	Bedeutung

taLeftJustify	Der Text wird linksbündig gesetzt.

taCenter	Der Text wird zentriert gesetzt.

taRightJustify	Der Text wird rechtsbündig gesetzt.


TParaAttributes::FirstIndent

TParaAttributes	Siehe auch

Die Eigenschaft FirstIndent legt die Einrückung der ersten Zeile im Absatz fest. Diese Verschiebung wird auch als Einzug bezeichnet und bezieht sich auf den linken Rand. Als Maßeinheit gelten Pixel.

__property long FirstIndent;

Beschreibung

Mit FirstIndent wird die Anzahl der Pixel vorgegeben, um die die erste Zeile im Absatz eingerückt werden soll. Der Wert ist vollkommen unabhängig von LeftIndent, das heißt, der relative Einzug der ersten Zeile bezogen auf die nachfolgenden Zeilen ändert sich nicht, wenn LeftIndent verändert wird.


TParaAttributes::LeftIndent

TParaAttributes	Siehe auch

Die Eigenschaft LeftIndent gibt die Einrückung des Absatzes bezogen auf den linken Rand vor. Als Maßeinheit gelten Pixel.

__property long LeftIndent;

Beschreibung

Mit LeftIndent wird ausgehend vom linken Rand des Satzspiegels eine Einrückung des gesamten Absatzes erzeugt. Damit lassen sich einzelne Absätze hervorheben.

Hinweis

Aufzählungszeichen, die mehreren Absätzen mit der Eigenschaft Numbering zugewiesen werden, beeinflussen den linken Einzug ebenfalls.


TParaAttributes::Numbering

TParaAttributes	Siehe auch

Die Eigenschaft Numbering steuert, ab der betreffende Absatz zum Element einer Aufzählung werden und ein Numerierungszeichen erhalten soll.

__property TNumberingStyle Numbering;

Beschreibung

Wenn Numbering den Wert nsBullet hat, wird links vom Absatz ein Numerierungszeichen plaziert. Der linke Einzug des gesamten Absatzes wird entsprechend vergrößert. Die Numerierungszeichen werden so positioniert, wie in der Eigenschaft LeftIndent festgelegt, und der eigentliche Absatztext wird weiter nach rechts verschoben.

Folgende Werte sind möglich:

Wert	Bedeutung

nsNone	Keine Numerierung.

nsBullet	Numerierungs links. Dabei wird der nötige Einzug erzeugt.


TParaAttributes::RightIndent

TParaAttributes	Siehe auch

Die Eigenschaft RightIndent bezeichnet den Einzug des Absatzes relativ zum rechten Rand. Als Maßeinheit gelten Pixel.

__property long RightIndent;

Beschreibung

Mit RightIndent wird ausgehend vom rechten Rand des Satzspiegels eine Einrückung des gesamten Absatzes erzeugt. Damit lassen sich einzelne Absätze hervorheben. Besondere Effekte ergeben sich, wenn gleichzeitig Alignment auf taRightJustify gesetzt ist.

Mit LeftIndent werden Einrückungen erzeugt, die sich auf den linken Rand des Satzspiegels beziehen.


TParaAttributes::Tab

TParaAttributes	Siehe auch

Die Eigenschaft Tab bestimmt die Position eines bestimmten Tabstopps. Als Maßeinheit gelten Pixel.

__property long Tab[unsigned char Index];

Beschreibung

Tab ist eine indizierte Eigenschaft, die auf ein Array von absoluten Tabstopp-Positionen zeigt. Die Position des ersten Tabstopps ist Tab[0], die Position des nächsten ist Tab[1]. Die letzte Position wird mit Tab[TabCount - 1] referenziert.

Wenn Index Werte kleiner als TabCount erhält, wird die Position vorhandener Tabstopps verändert. Alle Wert von Index, die größer oder gleich TabCount sind, vergrößern die Anzahl der Tabstopps im Absatz und ändern entsprechend den Wert von TabCount.

Hinweis

Mit der Eigenschaft Tab wird kein wirkliches Tabulatorzeichen in den Absatz eingefügt. Vielmehr werden die Positionen innerhalb des Absatzes definiert, an denen Tabulatoren plaziert werden, falls sie eingefügt werden. Das Tabulatorzeichen selbst wird mit der Taste TAB auf der Tastatur erzeugt.


TParaAttributes::TabCount

TParaAttributes	Siehe auch

Die Eigenschaft TabCount enthält die Anzahl der Tabstopps, die für den Absatz definiert sind.

__property int TabCount;

Beschreibung

Mit einem Lesezugriff auf TabCount kann die Anzahl der Tabstopps im Array Tab festgestellt werden. TabCount kann in Verbindung mit der Eigenschaft Tab verwendet werden, um über alle Tabstopps eines Absatzes zu iterieren.


Methoden von TParaAttributes

TParaAttributes	Alphabetisch

In TParaAttributes

~TParaAttributes

Assign

TParaAttributes

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TParaAttributes

TParaAttributes	Nach Objekten

~TParaAttributes

Assign

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance

TParaAttributes


TParaAttributes::~TParaAttributes

TParaAttributes

Der Destruktor ~TParaAttributes gibt den Speicher frei, der für das TParaAttributes-Objekt reserviert war. Rufen Sie ~TParaAttributes nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TParaAttributes automatisch aufgerufen wird.

__fastcall virtual ~TParaAttributes(void);


TParaAttributes::Assign

TParaAttributes	Siehe auch

Die Methode Assign gleicht alle Eigenschaften eines TParaAttributes an die Eigenschaftswerte eines anderen TParaAttributes-Objekts an.

virtual void __fastcall Assign(Classes::TPersistent* Source);

Beschreibung

Mit Hilfe von Assign können die Formatierungsmerkmale eines ausgewählten Absatzes in einem RTF-Eingabefeld an die Merkmale des ausgewählten Absatzes in einem anderen RTF-Eingabefeld angeglichen werden. Da die Eigenschaften eines TParaAttributes-Objekts nur gültig sind, wenn das TParaAttributes-Objekt innerhalb eines RTF-Eingabefeldes existiert, kann Assign nur zwischen zwei RTF-Eingabefeldern Attribute übertragen.

Hinweis

Assign wird zur Laufzeit nur dann erfolgreich ausgeführt, wenn der Parameter Source ein TParaAttributes-Objekt oder ein anderes Objekt bezeichnet, das über eine AssignTo-Methode verfügt, die auf ein TParaAttributes-Objekt anwendbar ist. Bei allen übrigen Quellobjekten kommt es zu einer EConvertError-Exception.


TParaAttributes::TParaAttributes

TParaAttributes	Siehe auch

Die Methode TParaAttributes erzeugt eine Instanz von TParaAttributes.

__fastcall TParaAttributes(TCustomRichEdit* AOwner);

Beschreibung

Rufen Sie den Konstruktor für ein TParaAttributes-Objekt nicht direkt auf, da dessen Eigenschaften außerhalb eines TCustomRichEdit-Objekts nicht gültig sind. TParaAttributes wird automatisch vom Konstruktor eines RTF-Eingabefeldes aufgerufen, das TParaAttributes verwendet.


Hierarchie

TObject

TPersistent


TParaAttributes Beispiel

TParaAttributes


TParam

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/dbtables.hpp

Das Objekt TParam repräsentiert einen Feldparameter.

Beschreibung

Mit den Eigenschaften eines TParam-Objekts können Sie den Wert eines Parameters setzen, der den Wert eines Feldes repräsentiert. Objekte, die Parameter für die Angabe von Feldwerten verwenden, erzeugen TParam-Objekte, die diese Parameter repräsentieren. TParams-Objekte werden beispielsweise von TQuery- und TStoredProc-Objekten verwendet.

Das Objekt TParam hat viele Eigenschaften, die auch ein TField-Objekt besitzt, da beide den Wert eines Feldes in einer Datenmenge beschreiben. Ein TField-Objekt verfügt jedoch über mehrere Eigenschaften, die die Feldzuordnungen beschreiben und angeben, wie das Feld dargestellt, bearbeitet oder berechnet wird. Diese Eigenschaften werden in einem TParam-Objekt nicht benötigt. Umgekehrt enthält TParam Eigenschaften, die angeben, wie der Feldwert als Parameter übergeben wird.


Eigenschaften von TParam

TParam	Alphabetisch 	Legende

In TParam

AsBCD

AsBoolean

AsCurrency

AsDate

AsDateTime

AsFloat

AsInteger

AsSmallInt

AsString

AsTime

AsWord

Bound

DataType

IsNull

Name

ParamType

Text

Value


Eigenschaften von TParam

TParam	Nach Objekten 	Legende

IsNull

AsBCD

AsBoolean

AsCurrency

AsDateTime

AsDate

AsFloat

AsInteger

AsSmallInt

AsString

AsTime

AsWord

Bound

DataType

Name

ParamType

Text

Value


TParam::AsBCD

TParam	Siehe auch

__property System::Currency AsBCD;

Beschreibung

Indem Sie AsBCD setzen, können Sie dem Parameter den Wert eines BCD-Feldes zuweisen. AsBCD nimmt keinen BCD-Wert an. BCD-Feldobjekte verwenden den Typ Currency, um den Wert von BCD-Feldern zu repräsentieren. Entsprechend verwendet AsBCD einen Currency-Wert. Die Zuweisung setzt zugleich die Eigenschaft DataType auf ftBCD.

AsBCD können Sie denWert entnehmen, der dem Parameter zugewiesen wurde. AsBCD enthält einen Wert vom Typ Currency. Der Wert des Parameters wird gegebenenfalls in einen Währungswert umgewandelt.


TParam::AsBoolean

TParam	Siehe auch

Die Eigenschaft AsBoolean bezeichnet den Wert des Parameters, wenn dieser den Wert eines booleschen Feldes enthält.

__property bool AsBoolean;

Beschreibung

Indem Sie AsBoolean setzen, können Sie dem Parameter den Wert eines booleschen Feldes zuweisen. Die Zuweisung setzt zugleich die Eigenschaft DataType auf ftBoolean.

AsBoolean enthält den Wert, der dem Parameter zugewiesen wurde, als booleschen Wert. Der Wert des Parameters wird gegebenenfalls in einen booleschen Wert umgewandelt.


TParam::AsCurrency

TParam	Siehe auch

Die Eigenschaft AsCurrency bezeichnet den Wert des Parameters, wenn dieser den Wert eines Währungsfeldes enthält.

__property double AsCurrency;

Beschreibung

Indem Sie AsCurrency setzen, können Sie dem Parameter den Wert eines Währungsfeldes zuweisen. Die Zuweisung setzt zugleich die Eigenschaft DataType auf ftCurrency.

AsCurrency enthält den Wert, der dem Parameter zugewiesen wurde, als Wert vom Typ Double. Der Wert des Parameters wird gegebenenfalls in einen Wert vom Typ Double umgewandelt.

Hinweis

Verwechseln Sie die Eigenschaft AsCurrency nicht mit dem Datentyp Currency. Währungsfelder in Datenbanktabellen speichern ihren Inhalt als Wert vom Typ Double. Die Eigenschaft AsBCD gibt den Wert des Parameters mit dem Datentyp Currency an.


TParam::AsDate

TParam	Siehe auch

Die Eigenschaft AsDate bezeichnet den Wert des Parameters, wenn dieser den Wert eines Datumsfeldes enthält.

__property System::TDateTime AsDate;

Beschreibung

Indem Sie AsDate setzen, können Sie dem Parameter den Wert eines Datumsfeldes zuweisen. Die Zuweisung setzt zugleich die Eigenschaft DataType auf ftDate.

AsDate enthält den Wert, der dem Parameter zugewiesen wurde, als Datums-/Zeitwert. Der Wert des Parameters wird gegebenenfalls in einen Datums-/Zeitwert umgewandelt. Wenn die Eigenschaft DataType des Parameters auf ftDate gesetzt ist, ist nur der Datumsanteil des TDateTime-Wertes gültig.

Der Typ TDateTime, in dem Datumsfeld-Objekte ihre Werte speichern, repräsentiert einen Wert vom Typ Double.

Der ganzzahlige Teil eines TDateTime-Wertes bezeichnet die Anzahl von Tagen, die seit dem 30. Dezember 1899 vergangen sind. Die Nachkommastellen geben an, welcher Bruchteil eines 24-Stunden-Tages vergangen ist.


TParam::AsDateTime

TParam	Siehe auch

Die Eigenschaft AsDateTime bezeichnet den Wert des Parameters, wenn dieser den Wert eines Datums-/Zeitfeldes enthält.

__property System::TDateTime AsDateTime;

Beschreibung

Indem Sie AsDateTime setzen, können Sie dem Parameter den Wert eines Datums-/Zeitfeldes zuweisen. Die Zuweisung setzt zugleich die Eigenschaft DataType auf ftDateTime.

AsDateTime enthält den Wert, der dem Parameter zugewiesen wurde, als Datums-/Zeitwert. Der Wert des Parameters wird gegebenenfalls in einen Datums-/Zeitwert umgewandelt.

Der Typ TDateTime, in dem Datums-/Zeitfeld-Objekte ihre Werte speichern, repräsentiert einen Wert vom Typ class. Der ganzzahlige Teil eines TDateTime-Wertes bezeichnet die Anzahl von Tagen, die seit dem 30. Dezember 1899 vergangen sind. Die Nachkommastellen geben an, welcher Bruchteil eines 24-Stunden-Tages vergangen ist.


TParam::AsFloat

TParam	Siehe auch

Die Eigenschaft AsFloat bezeichnet den Wert des Parameters, wenn dieser den Wert eines Gleitkommafeldes enthält.

__property double AsFloat;

Beschreibung

Indem Sie AsFloat setzen, können Sie dem Parameter den Wert eines Gleitkommafeldes zuweisen. Die Zuweisung setzt zugleich die Eigenschaft DataType auf ftFloat.

AsFloat enthält den Wert, der dem Parameter zugewiesen wurde, als Wert vom Typ Double. Der Wert des Parameters wird gegebenenfalls in einen Wert vom Typ Double umgewandelt.


TParam::AsInteger

TParam	Siehe auch

Die Eigenschaft AsInteger bezeichnet den Wert des Parameters, wenn dieser den Wert eines Integer-Feldes enthält.

__property long AsInteger;

Beschreibung

Indem Sie AsInteger setzen, können Sie dem Parameter den Wert eines Integer-Feldes zuweisen. Die Zuweisung setzt zugleich die Eigenschaft DataType auf ftInteger.

AsInteger enthält den Wert, der dem Parameter zugewiesen wurde, als 32-Bit-Integer. Der Wert des Parameters wird gegebenenfalls in einen LongInt-Wert umgewandelt.


TParam::AsSmallInt

TParam	Siehe auch

Die Eigenschaft AsSmallInt bezeichnet den Wert des Parameters, wenn dieser den Wert eines SmallInt-Feldes enthält.

__property long AsSmallInt;

Beschreibung

Indem Sie AsSmallInt setzen, können Sie dem Parameter den Wert eines SmallInt-Feldes zuweisen. Die Zuweisung setzt zugleich die Eigenschaft DataType auf ftSmallint.

AsSmallInt enthält den Wert, der dem Parameter zugewiesen wurde, als 32-Bit-Integer-Wert. Der Wert des Parameters wird gegebenenfalls in einen LongInt-Wert umgewandelt.

Hinweis

AsSmallInt arbeitet mit einem 32-Bit-Integer. SmallInt-Feldobjekte speichern und bearbeiten die Daten als 32-Bit-Integer, obwohl es sich bei den Werten in den zugrundeliegenden Datenbanken um 16-Bit-Integer handelt.


TParam::AsString

TParam	Siehe auch

Die Eigenschaft AsString bezeichnet den Wert des Parameters, wenn dieser den Wert eines Stringfeldes enthält.

__property System::AnsiString AsString;

Beschreibung

Indem Sie AsString setzen, können Sie dem Parameter den Wert eines Stringfeldes zuweisen. Die Zuweisung setzt zugleich die Eigenschaft DataType auf ftString.

AsString enthält den Wert, der dem Parameter zugewiesen wurde, als String. Der Wert des Parameters wird in einen String umgewandelt.


TParam::AsTime

TParam	Siehe auch

Die Eigenschaft AsTime bezeichnet den Wert des Parameters, wenn dieser den Wert eines Zeitfeldes enthält.

__property System::TDateTime AsTime;

Beschreibung

Indem Sie AsTime setzen, können Sie dem Parameter den Wert eines Zeitfeldes zuweisen. Die Zuweisung setzt zugleich die Eigenschaft DataType auf ftTime.

AsTime enthält den Wert, der dem Parameter zugewiesen wurde, als Datums-/Zeitwert. Der Wert des Parameters wird gegebenenfalls in einen Datums-/Zeitwert umgewandelt. Wenn die Eigenschaft DataType des Parameters auf ftTime gesetzt ist, ist nur der Zeitanteil des TDateTime-Wertes gültig.

Der Typ TDateTime, in dem Zeitfeld-Objekte ihre Werte speichern, ist ein Wert vom Typ class. Er enthält mehr Informationen als nötig, da für ein Zeitfeld lediglich der Zeitanteil des Wertes von Bedeutung ist.

Der ganzzahlige Teil eines TDateTime-Wertes bezeichnet die Anzahl von Tagen, die seit dem 30. Dezember 1899 vergangen sind. Die Nachkommastellen geben an, welcher Bruchteil eines 24-Stunden-Tages vergangen ist.


TParam::AsWord

TParam	Siehe auch

Die Eigenschaft AsWord bezeichnet den Wert des Parameters, wenn dieser den Wert eines Word-Feldes enthält.

__property long AsWord;

Beschreibung

Indem Sie AsWord setzen, können Sie dem Parameter den Wert eines Word-Feldes zuweisen. Die Zuweisung setzt zugleich die Eigenschaft DataType auf ftWord.

AsWord enthält den Wert, der dem Parameter zugewiesen wurde, als 32-Bit-Integer. Der Wert des Parameters wird gegebenenfalls in einen Wert des Typs LongInt umgewandelt.

Hinweis

AsWord arbeitet mit einem 32-Bit-Integer. Word-Feldobjekte speichern und bearbeiten die Daten als 32-Bit-Integer, obwohl es sich bei den Werten in den zugrundeliegenden Datenbanken um 16-Bit-Werte ohne Vorzeichen handelt.


TParam::Bound

TParam	Siehe auch

Die Eigenschaft Bound gibt an, ob dem Paramter ein Wert (NULL oder ein sonstiger Wert) zugewiesen wurde.

__property bool Bound;

Beschreibung

Bound gibt an, ob dem Parameter ein Wert zugewiesen wurde. Wenn dem TParam-Objekt ein Wert zugewiesen wird, wird die Eigenschaft Bound automatisch auf True gesetzt. Wenn Bound auf False gesetzt wird, wird die Zuweisung des Wertes rückgängig gemacht. Der Wert des Parameters wird daraufhin von der Methode Clear durch NULL ersetzt. Die Eigenschaft Bound wird jedoch nicht auf False gesetzt. Wird dem Parameter mit der Methode Clear NULL zugewiesen, muß Bound explizit auf True gesetzt werden.

TQuery- und TStoredProc-Objekte verwenden den Wert von Bound, um zu ermitteln, ob dem Parameter ein Standardwert zugewiesen werden soll. Wenn Bound den Wert False hat, weist ein TQuery-Objekt einen Wert aus der Datenmenge zu, die in der Eigenschaft DataSource der Abfrage angegeben ist. Entsprechend ruft ein TStoredProc-Objekt einen Wert direkt vom Server ab, wenn Bound auf False gesetzt ist.


TParam::DataType

TParam

Die Eigenschaft DataType gibt den Feldtyp an, dessen Wert der Parameter repräsentiert.

__property Db::TFieldType DataType;

Beschreibung

Die Eigenschaft DataType wird automatisch gesetzt, wenn dem Parameter ein Wert zugewiesen wird. Weisen Sie DataType für zugeordnete Felder keinen Wert zu, da dadurch der zugewiesene Wert falsch interpretiert werden könnte.

DataType können Sie den Datentyp entnehmen, der dem Parameter zugewiesen wurde. Jeder mögliche Wert von DataType entspricht einem Datenbankfeldtyp. Im folgenden werden die möglichen Werte angezeigt:

Wert	Beschreibung

ftUnkown	Unbekannt oder unbestimmt

ftString	Zeichen- oder Stringfeld

ftSmallint	16-Bit-Integer-Feld

ftInteger	32-Bit-Integer-Feld

ftWord	Vorzeichenloses 16-Bit-Integer-Feld

ftBoolean	Logisches Feld

ftFloat	Gleitkommafeld

ftCurrency	Währungsfeld

ftBCD	Binärcodiertes Dezimalfeld

ftDate	Datumsfeld

ftTime	Zeitfeld

ftDateTime	Datums-/Zeitfeld

ftBytes	Feste Zahl von Bytes (binäre Speicherung)

ftVarBytes	Variable Zahl von Bytes (binäre Speicherung)

ftAutoInc	Autoinkrement-32-Bit -Integer-Feld (Zähler)

ftBlob	BLOB-Feld

ftMemo	Memo-Feld

ftGraphic	Bitmap-Feld

ftFmtMemo	Formatiertes Memo-Feld

ftParadoxOle	Paradox-OLE-Feld

ftDBaseOle	dBASE-OLE-Feld

ftTypedBinary	Typisiertes Binärfeld


TParam::IsNull

TParam	Siehe auch

Die Eigenschaft IsNull gibt an, ob der dem Parameter zugewiesene Wert NULL (leer) ist.

__property bool IsNull;

Beschreibung

IsNull können Sie entnehmen, ob der Wert des Parameters auf NULL gesetzt ist, also ein leeres Feld bezeichnet. Auf NULL gesetzte Werte können in folgenden Situationen auftreten:

•	Bei der Zuweisung des Wertes eines anderen auf NULL gesetzten Parameters.

•	Bei der Zuweisung des Wertes eines leeren Feldes.

•	Beim Aufruf der Methode Clear.

Hinweis

NULL-Parameter sind nicht mit nicht zugeordneten Parametern identisch. Nicht zugeordneten Parametern wurde kein Wert zugewiesen. NULL-Parameter haben einen NULL-Wert. NULL-Parameter können zugeordnet oder nicht zugeordnet sein.


TParam::Name

TParam	Siehe auch	Beispiel

Die Eigenschaft Name gibt den Namen des Parameters an.

__property System::AnsiString Name;

Beschreibung

Mit der Eigenschaft Name können Sie einen bestimmten Parameter in einem TParams-Objekt bezeichnen. Name ist der Name des Parameters und nicht der Name des Feldes, dessen Wert der Parameter repräsentiert.


TParam::ParamType

TParam

Die Eigenschaft ParamType gibt den Typ des Parameters an, den TParam repräsentiert.

__property TParamType ParamType;

Beschreibung

Objekte, die TParam-Objekte zur Repräsentation von Feldparametern verwenden, setzen die Eigenschaft ParamType, um den Verwendungszweck des Parameters anzugeben. Der Parameter muß einen der folgenden Werte annehmen:

Wert	Beschreibung

ptUnknown	Unbekannt oder unbestimmt

ptInput	Eingabe eines Feldwertes.

ptOutput	Ausgabe eines Feldwertes.

ptInputOutput	Ein- und Ausgabe.

ptResult	Rückgabewert


TParam::Text

TParam	Siehe auch	Beispiel

Die Eigenschaft Text gibt den Wert des Parameters als String an.

__property System::AnsiString Text;

Beschreibung

Indem Sie Text setzen, können Sie einem String den Wert des Parameters zuweisen, ohne die Eigenschaft DataType zu ändern. Im Gegensatz zur Eigenschaft AsString, die den Wert einem String zuweist und die Eigenschaft DataType ändert, wird beim Setzen der Eigenschaft Text der String in den Datentyp des Parameters umgewandelt. Die Werte werden entsprechend zugewiesen. Verwenden Sie daher AsString, wenn der Parameter wie die Repräsentation eines Stringfeldwertes verarbeitet werden soll. Wenn ein Wert als String zugewiesen und keine Bestimmung des Feldtyps durchgeführt wird, sollte statt dessen die Eigenschaft Text verwendet werden. Die Eigenschaft Text ist für die Zuweisung von Benutzerdaten hilfreich, die in ein Eingabefeld eingegeben wurden.

Der Lesezugriff auf die Eigenschaft Text entspricht dem Lesen der Eigenschaft AsString.


TParam::Value

TParam	Siehe auch

Die Eigenschaft Value gibt den den Wert des Parameters als Variante an.

__property System::Variant Value;

Beschreibung

Verwenden Sie die Eigenschaft Value in Programmen, die die Werte der Parameter bearbeiten, ohne Informationen zum Feldtyp zu besitzen, den der Parameter repräsentiert.


Methoden von TParam

TParam	Alphabetisch

In TParam

~TParam

Assign

AssignField

AssignFieldValue

Clear

GetData

GetDataSize

SetData

TParam

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TParam

TParam	Nach Objekten

~TParam

AssignField

AssignFieldValue

Assign

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

Clear

DefaultHandler

Dispatch

FieldAddress

FreeInstance

Free

GetDataSize

GetData

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance

SetData

TParam


TParam::~TParam

TParam	Siehe auch

Der Destruktor ~TParam gibt den Speicher frei, der für das TParam-Objekt reserviert war. Rufen Sie ~TParam nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TParam automatisch aufgerufen wird.

__fastcall virtual ~TParam(void);

Beschreibung

Bevor ~TParam den Speicher freigibt, der der Instanz zugewiesen war, entfernt die Methode das TParam-Objekt aus der Parameterliste, in der es enthalten war.


TParam::Assign

TParam	Siehe auch

Die Methode Assign kopiert die Eigenschaften Name und Value eines anderen TParam-Objekts.

void __fastcall Assign(TParam* Param);

Beschreibung

Mit Assign können Sie Daten von einem Parameter zu einem anderen kopieren. Assign kopiert die Werte folgender Eigenschaften:

•	DataType

•	Bound

•	Value

•	Name

Die Methode Assign kopiert den Wert der Eigenschaft ParamType nur, wenn diese auf ptUnknown gesetzt ist. Daher ändert Assign den Verwendungszweck eines Parameters nicht, sondern nur den Bezeichner und den Wert.


TParam::AssignField

TParam	Siehe auch

Die Methode AssignField weist die Eigenschaften DataType, Name und Value eines TField-Objekts zu.

void __fastcall AssignField(Db::TField* Field);

Beschreibung

Mit der Methode AssignField können Sie einen Parameter setzen, der ein bestimmtes TField-Objekt repräsentiert. AssignField setzt die Eigenschaft Bound auf True.

Im Gegensatz zu AssignFieldValue benennt AssignField den Parameter nach dem Feldobjekt und übernimmt dessen Wert.


TParam::AssignFieldValue

TParam	Siehe auch

Die Methode AssignFieldValue weist die Eigenschaften DataType und Value eines TField-Objekts zu.

void __fastcall AssignFieldValue(Db::TField* Field, const System::Variant &Value);

Beschreibung

Mit der Methode AssignFieldValue können Sie einem Parameter den Wert eines bestimmten TField-Objekts zuweisen. AssignFieldValue setzt die Eigenschaft Bound auf True.

Im Gegensatz zu AssignField benennt AssignFieldValue den Parameter nicht nach dem Feldobjekt und übernimmt dessen Wert nicht.


TParam::Clear

TParam	Siehe auch

Mit der Methode Clear wird der Wert des Parameters auf NULL gesetzt.

void __fastcall Clear(void);

Beschreibung

Mit Clear können Sie einem Parameter einen NULL-Wert zuweisen. Mit dem Aufruf von Clear wird die Eigenschaft Bound weder gesetzt noch freigegeben. Bei der Zuweisung eines NULL-Wertes an den Parameter muß sowohl die Eigenschaft Bound gesetzt als auch die Methode Clear aufgerufen werden.


TParam::GetData

TParam	Siehe auch

Mit der Methode GetData wird der Puffer mit dem Wert des Parameters im ursprünglichen Format eines Datenbankfeldes des entsprechenden Typs gefüllt.

void __fastcall GetData(void * Buffer);

Beschreibung

Mit GetData können Sie den Wert eines Parameters in dem Format abrufen, das direkt in einen Datensatzpuffer geschrieben werden kann. Dieses Format wird von physischen Datenbankfeldern verwendet, die DataType entsprechen. Der Puffer muß groß genug sein, um die Informationen aufnehmen zu können. Mit der Methode GetDataSize können Sie die erforderliche Größe festlegen.

Das ursprüngliche Format eines Datenbankfeldes kann sich von dem Datentyp unterscheiden, der vom entsprechenden Feldobjekt verwendet wird. Verwenden Sie die As-Eigenschaften, um den Wert des Typs abzurufen, der vom entsprechenden Feldobjekt verwendet wird. Mit GetData können Sie den Wert im ursprünglichen Datenbankformat abrufen.

Wenn DataType z.B. auf ftBCD gesetzt ist, ruft GetData den Wert als binärcodierte Dezimalzahl ab, obwohl das TBDCField-Objekt den Typ Currency zum Speichern und Bearbeiten der Werte verwendet. AsBCD ruft den Wert mit dem Typ Currency ab.


TParam::GetDataSize

TParam	Siehe auch

Die Methode GetDataSize gibt die Anzahl Bytes zurück, die für das Speichern des Parameterwertes in dem Format benötigt werden, das vom entsprechenden Datenbankfeld verwendet wird.

unsigned short __fastcall GetDataSize(void);

Beschreibung

Mit dem Aufruf von GetDataSize können Sie die Anzahl Bytes festlegen, die für das Speichern eines Parameterwertes in einem Datenbankdatensatz benötigt werden. GetDataSize gibt vor dem Aufruf der Methode GetData die erforderliche Puffergröße an. Der von GetDataSize zurückgegebene Wert ist vom Wert und Datentyp des Parameters abhängig.

Datentyp	Wert von DataSize

ftBoolean	2

ftSmallInt	2

ftWord	2

ftAutoInc	4

ftDate	4

ftInteger	4

ftTime	4

ftCurrency	8

ftDateTime	8

ftFloat	8

ftBCD	34

ftString	Länge des Strings + 1

ftVarBytes	Löst eine Exception aus

ftBytes	Löst eine Exception aus

ftBlob	Löst eine Exception aus

ftDBaseOle	Löst eine Exception aus

ftFmtMemo	Löst eine Exception aus

ftGraphic	Löst eine Exception aus

ftMemo	Löst eine Exception aus

ftParadoxOle	Löst eine Exception aus

ftTypedBinary	Löst eine Exception aus

ftUnknown	Löst eine Exception aus

Hinweis

Die von GetDataSize zurückgegebene Größe ist die Größe, die für die physische Repräsentation des Wertes in der Datenbank benötigt wird. Das dem physischen Datenbankfeld entsprechende Feldobjekt kann die Daten in einem anderen Format speichern, das eine abweichende Anzahl Bytes benötigt.


TParam::SetData

TParam	Siehe auch

Die Methode SetData kopiert einen neuen Wert für den Parameter aus Buffer in das physische Datenbankformat.

void __fastcall SetData(void * Buffer);

Mit SetData können Sie den Wert eines Parameters aus einem Puffer abrufen, der Daten im Format der Datenbank enthält. Die Methode GetData eines TField-Objekts ruft Daten im Format der Datenbank ab. Durch Aufruf der BDE-API können ebenfalls Daten in diesem Format zur Verfügung gestellt werden.


TParam::TParam

TParam	Siehe auch

Mit der Methode TParam können Sie eine Instanz von TParam erzeugen und in eine Parameterliste einfügen.

__fastcall TParam(TParams* AParamList, TParamType AParamType);

Beschreibung

Mit dem Aufruf von TParam können Sie ein TParam-Objekt instantiieren. TParam-Objekte werden normalerweise von dem Objekt erzeugt, das diese zur Anzeige seiner Feldparameter verwendet (beispielsweise TQuery- oder TStoredProc-Objekte).

Nach der Zuweisung des Speichers für eine Instanz von TParam führt TParam folgende Schritte durch:

•	Es fügt das neue TParam-Objekt der Liste AParamList hinzu.

•	Es setzt ParamType auf AParamType.

•	Es initialisiert DataType mit ftUnknown.

•	Es setzt die Eigenschaft Bound auf False.


Zugriff

Read-only


Hierarchie

TObject


TParam Beispiel

TParam


TParams

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/dbtables.hpp

Das Objekt TParams verwaltet eine Liste von Feldparametern.

Beschreibung

Mit TParams wird eine Liste von TParam-Objekten für ein Objekt verwaltet, das Feldparameter besitzt. Beispielsweise verwenden Objekte der Klassen TStoredProc und TQuery für die Erzeugung und den Zugriff auf ihre Parameter TParams-Objekte.

Mit den Eigenschaften und Methoden von TParams lassen sich folgende Aktionen ausführen:

•	Auf einen bestimmten Feldparameter zugreifen.

•	Feldparameter zu einer Liste hinzufügen oder daraus löschen.

•	Werte einzelner Feldparameter abrufen oder setzen.

•	Feldparameter vergleichen.

•	Eine Iteration über alle Feldparameter durchführen.

•	Eine Anzahl von Feldparametern in eine andere Parameterliste kopieren.


Eigenschaften von TParams

TParams	Alphabetisch	Legende

In TParams

Items

ParamValues


Eigenschaften von TParams

TParams	Nach Objekten	Legende

Items

ParamValues


TParams::Items

TParams	Siehe auch

Items enthält die einzelnen Feldparameter eines TParams-Objekts.

__property TParam* Items[unsigned short Index];

Beschreibung

Mit Items kann eine Iteration über alle Feldparameter durchgeführt werden. Das Argument Index bezeichnet dabei den Index im Bereich von 0 bis Count - 1. Die Eigenschaft Items kann einen bestimmten Parameter über dessen Index referenzieren. Wenn eine Abhängigkeit von der Reihenfolge der Parameter vermieden werden soll, ist die Methode ParamByName vorzuziehen.


TParams::ParamValues

TParams	Siehe auch

ParamValues ist ein variantes Array mit den Werten der einzelnen Feldparameter, die mit Namen angegebenen sind.

__property System::Variant ParamValues[System::AnsiString ParamName];

Beschreibung

Mit ParamValues werden die Werte einzelner Feldparameter ermittelt oder gesetzt, die per Name bezeichnet sind. Die Konstante ParamName ist ein String mit den Namen der betreffenden Feldparameter. Mehrere Namen werden jeweils durch ein Semikolon (;) getrennt.

Mit ParamValues wird die Eigenschaft Value für alle Parameter gesetzt, die im String ParamName enthalten sind. Die Werte müssen als Varianten sortiert in einem varianten Array angegeben werden.

Wenn ParamValues zur Abfrage aktueller Wert benutzt wird, erhält man ein variantes Array von Varianten, die jeweils den Wert eines der benannten Parameter repräsentieren.

Wenn ParamName einen Namen enthält, der keinem der Feldparameter in Items entspricht, wird eine Exception ausgelöst.


Methoden von TParams

TParams	Alphabetisch

In TParams

~TParams

AddParam

Assign

AssignValues

Clear

Count

CreateParam

GetParamList

IsEqual

ParamByName

RemoveParam

TParams

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TParams

TParams	Nach Objekten

~TParams

AddParam

Assign

AssignValues

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

Clear

Count

CreateParam

DefaultHandler

Dispatch

FieldAddress

FreeInstance

Free

GetParamList

InheritsFrom

InitInstance

InstanceSize

IsEqual

MethodAddress

MethodName

NewInstance

ParamByName

RemoveParam

TParams


TParams::~TParams

TParams	Siehe auch

Der Destruktor ~TParams gibt den Speicher frei, der für das TParams-Objekt reserviert war. Rufen Sie ~TParams nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TParams automatisch aufgerufen wird.

__fastcall virtual ~TParams(void);

Beschreibung

~TParams gibt die Liste der Eigenschaft Items frei, bevor der Destruktor des übergeordneten Objekts aufgerufen wird.


TParams::AddParam

TParams	Siehe auch

Die Methode AddParam fügt in die Liste Items einen neuen Feldparameter ein.

void __fastcall AddParam(TParam* Value);

Beschreibung

Mit AddParam wird der Liste Items ein bereits instantiierter Parameter hinzugefügt. Im Gegensatz dazu übernimmt die Methode CreateParam sowohl die Erzeugung eines Parameters als auch das Hinzufügen zur Liste.


TParams::Assign

TParams	Siehe auch

Die Methode Assign kopiert eine Parameterliste von einem anderen Objekt.

virtual void __fastcall Assign(Classes::TPersistent* Source);

Beschreibung

Mit Assign kann sowohl eine Anzahl von Parametern gespeichert und abgerufen als auch die Information eines anderen Objekts gelesen werden. Das Objekt, dessen Parameter kopiert werden sollen, wird in Source übergeben. Wenn Source ein weiteres TParams-Objekt ist, verwirft Assign alle aktuellen Parameterinformationen und ersetzt diese durch eine Kopie der Feldparameterliste, die über Source referenziert wird.

Beachten Sie den Unterschied zwischen Assign und AssignValues:

AssignValues dient dazu, lediglich die Werte der Feldparameterliste vom Quellobjekt zu übernehmen. Mit Assign werden die eigentlichen Feldparameter selbst kopiert.


TParams::AssignValues

TParams	Siehe auch

Die Methode AssignValues belegt die Parameter der Eigenschaft Items mit neuen Werten.

void __fastcall AssignValues(TParams* Value);

Beschreibung

Mit AssignValues werden die werden die Werte der Feldparameter in der Liste Items so aktualisiert, daß sie mit den entsprechenden Werten in einem anderen TParams-Objekt übereinstimmen. Dabei gilt folgendes Prinzip: AssignValues versucht, in der Eigenschaft Value einen Parameter mit demselben Wert der Eigenschaft Name zu finden. Wenn dies gelingt, werden die Parameterinformationen aus Value (Typ und aktuelle Daten) dem Element von Items zugewiesen. Sämtliche Elemente von Items, für die keine Entsprechung gefunden wird, bleiben unverändert.


TParams::Clear

TParams	Siehe auch

Die Methode Clear löscht aus der Eigenschaft Items des TParams-Objekts sämtliche Parameterinformationen.

void __fastcall Clear(void);

Beschreibung

Mit Clear wird die Liste Items geleert. Clear wird sinnvollerweise aufgerufen, bevor eine Parameterliste erstellt wird. Damit ist sichergestellt, daß die Liste ausschließlich die gewünschten Feldparameter enthält.


TParams::Count

TParams	Siehe auch

Die Methode Count gibt die Anzahl der Elemente von Items (Objekt TParams) zurück.

int __fastcall Count(void);

Beschreibung

Mit Count läßt sich ermitteln, wieviele Parameterobjekte vom vorliegenden TParams-Objekt verwaltet werden. Count kann für eine Iteration über alle Feldparameter in der Liste Items verwendet werden.


TParams::CreateParam

TParams	Siehe auch

Die Methode CreateParam erzeugt ein neues Feldparameterobjekt und fügt dieses in die Liste Items ein.

TParam* __fastcall CreateParam(Db::TFieldType FldType, const System::AnsiString ParamName, TParamType  ParamType);

Beschreibung

Mit CreateParam wird ein neues TParam-Objekt instantiiert und der Liste Items hinzugefügt, die von diesem TParams-Objekt verwaltet wird. Als Feldtyp des neuen Parameters geben Sie den Wert von FldType an, als Namen den Wert von ParamName und als Parametertyp den Wert von ParamType.


TParams::GetParamList

TParams	Siehe auch

GetParamList füllt ein TList-Objekt mit den verschiedenen TParam-Objekten, die über ParamNames bezeichnet sind.

void __fastcall GetParamList(Classes::TList* List, const System::AnsiString ParamNames);

Beschreibung

Mit GetParamList kann eine Teilmenge der Feldparameter aus der Liste Items abgerufen werden, die per Name identifiziert werden. ParamNames ist ein String mit den Namen der gewünschten Parameter. mehrere Parameternamen werden jeweils durch ein Semikolon (;) getrennt.

Die Feldparameter werden in der Reihenfolge zu der mit List bezeichneten Liste hinzugefügt, in der sie in ParamNames stehen. Wenn ParamNames einen Namen enthält, der in Items nicht gefunden werden kann, wird eine Exception ausgelöst.


TParams::IsEqual

TParams	Siehe auch

Die Methode IsEqual zeigt an, ob die Items-Werte zweier TParams-Objekte identisch sind.

bool __fastcall IsEqual(TParams* Value);

Beschreibung

IsEqual gibt den Wert True zurück, wenn die Eigenschaft Items des Parameters Value exakt mit der Eigenschaft Items übereinstimmt. Eine Übereinstimmung erfordert, daß jede Items-Liste dieselbe Anzahl von Feldparametern besitzt, und zwar in derselben Reihenfolge mit Gleichheit in Name, Datentyp, Parametertyp und Wert.


TParams::ParamByName

TParams	Siehe auch

Die Methode ParamByName findet den Parameter mit dem angegebenen Namen.

TParam* __fastcall ParamByName(const System::AnsiString Value);

Beschreibung

Mit ParamByName wird der Parameter angesprochen, dessen Name in Value angegeben ist. Im Fall einer Übereinstimmung gibt ParamByName den Parameter zurück. Andernfalls wird eine Exception ausgelöst. Diese Methode ist einer direkten Referenz auf die Eigenschaft Items vorzuziehen, wenn eine Abhängigkeit von der Reihenfolge der Einträge vermieden werden soll.

Wenn mehrere Parameter gleichzeitig angesprochen werden sollen, verwenden Sie die Methode GetParamList. Wenn Sie lediglich den Wert eines bestimmten Parameters benötigen, verwenden Sie die Eigenschaft ParamValues.


TParams::RemoveParam

TParams	Siehe auch

Die Methode RemoveParam entfernt den angegebenen Parameter aus der Eigenschaft Items eines TParams-Objekts.

void __fastcall RemoveParam(TParam* Value);

Beschreibung

Mit RemoveParam wird ein Feldparameter aus der Liste Items entfernt. Der über Value bezeichnete Parameter wird allerdings nicht freigegeben.


TParams::TParams

TParams	Siehe auch

Der Konstruktor TParams erzeugt ein neues TParams-Objekt.

__fastcall virtual TParams(void);

Beschreibung

Mit TParams können Sie ein TParams-Objekt instantiieren. Anwendungen brauchen nur selten eine TParams-Liste zu erzeugen, da sie von dem TQuery- oder TStoredProc-Objekt erzeugt wird, das das TParams-Objekt verwendet.


Zugriff

Read-only


Hierarchie

TObject

TPersistent


TParams Beispiel

TParams


TPasswordDialog

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/dbpwdlg.hpp

Das Objekt TPasswordDialog repräsentiert ein Dialogfeld, in dem der Benutzer für die aktuelle Sitzung Kennwörter vergeben kann.

Beschreibung

TPasswordDialog ermöglicht es dem Benutzer, Kennwörter für die aktuelle Sitzung zu definieren. (Die aktuelle Sitzung wird durch ein TSession-Objekt repräsentiert.) Die Kennwörter werden abgefragt, sobald eine entsprechend geschützte Paradox-Tabelle geöffnet wird. Wenn eine Tabelle ein Kennwort verlangt, das in der aktuellen Sitzung noch nicht eingegeben wurde, wird der Benutzer zur Eingabe aufgefordert.

Ein TPasswordDialog-Objekt wird normalerweise mit der Funktion PasswordDialog erzeugt. TPasswordDialog kann allerdings auch als Basisobjekt für andere Typen eines Kennwortdialogs dienen.


Eigenschaften von TPasswordDialog

TPasswordDialog	Alphabetisch	Legende

Abgeleitet von TForm

Active

ActiveControl

ActiveMDIChild

ActiveOleControl

BorderIcons

BorderStyle

Canvas

ClientHandle

ClientHeight

ClientWidth

Designer

DropTarget

FormStyle

Icon

KeyPreview

MDIChildCount

MDIChildren

Menu

ModalResult

ObjectMenuItem

OleFormObject

PixelsPerInch

Position

PrintScale

Scaled

TileMode

Visible

WindowMenu

WindowState

Abgeleitet von TScrollingWinControl

AutoScroll

HorzScrollBar

VertScrollBar

Abgeleitet von TWinControl

Brush

ClientOrigin

ControlCount

Controls

Ctl3D

Handle

HelpContext

Showing

TabOrder

TabStop

Abgeleitet von TControl

Align

BoundsRect

Caption

ClientRect

Color

ControlState

ControlStyle

Cursor

Enabled

Font

Height

Hint

Left

Name

PopupMenu

ShowHint

Top

Width

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TPasswordDialog

TPasswordDialog	Nach Objekten	Legende

ActiveControl

ActiveMDIChild

ActiveOleControl

Active

Align

AutoScroll

BorderIcons

BorderStyle

BoundsRect

Brush

Canvas

Caption

ClientHandle

ClientHeight

ClientOrigin

ClientRect

ClientWidth

Color

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlCount

ControlState

Controls

ControlStyle

Ctl3D

Cursor

Designer

DesignInfo

DropTarget

Enabled

Font

FormStyle

Handle

Height

HelpContext

Hint

HorzScrollBar

Icon

KeyPreview

Left

MDIChildCount

MDIChildren

Menu

ModalResult

Name

ObjectMenuItem

OleFormObject

Owner

PixelsPerInch

PopupMenu

Position

PrintScale

Scaled

ShowHint

Showing

TabOrder

TabStop

Tag

TileMode

Top

VertScrollBar

Visible

Width

WindowMenu

WindowState


Ereignisse von TPasswordDialog

TPasswordDialog	Alphabetisch	Legende

Abgeleitet von TForm

OnActivate

OnClose

OnCloseQuery

OnCreate

OnDeactivate

OnDestroy

OnHide

OnPaint

OnResize

OnShow

Abgeleitet von TWinControl

OnKeyDown

OnKeyPress

OnKeyUp

Abgeleitet von TControl

OnClick

OnDblClick

OnDragDrop

OnDragOver

OnMouseDown

OnMouseMove

OnMouseUp


Ereignisse von TPasswordDialog

TPasswordDialog	Nach Objekten	Legende

OnActivate

OnClick

OnCloseQuery

OnClose

OnCreate

OnDblClick

OnDeactivate

OnDestroy

OnDragDrop

OnDragOver

OnHide

OnKeyDown

OnKeyPress

OnKeyUp

OnMouseDown

OnMouseMove

OnMouseUp

OnPaint

OnResize

OnShow


Methoden von TPasswordDialog

TPasswordDialog	Alphabetisch

In TPasswordDialog

~TPasswordDialog

AddButtonClick

EditChange

OKButtonClick

RemoveAllButtonClick

RemoveButtonClick

TPasswordDialog

Abgeleitet von TForm

ArrangeIcons

Cascade

Close

CloseQuery

DefocusControl

FocusControl

GetFormImage

Hide

Next

Previous

Print

Release

SendCancelMode

SetFocus

SetFocusedControl

Show

ShowModal

Tile

Abgeleitet von TScrollingWinControl

ScrollInView

Abgeleitet von TWinControl

Broadcast

CanFocus

ContainsControl

ControlAtPos

DisableAlign

EnableAlign

Focused

GetTabOrderList

HandleAllocated

HandleNeeded

InsertControl

Invalidate

PaintTo

Realign

RemoveControl

Repaint

ScaleBy

ScrollBy

SetBounds

Update

UpdateControlState

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

GetTextLen

Perform

Refresh

ScreenToClient

SendToBack

SetTextBuf

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TPasswordDialog

TPasswordDialog	Nach Objekten

~TPasswordDialog

AddButtonClick

ArrangeIcons

Assign

BeginDrag

BringToFront

Broadcast

CanFocus

Cascade

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

ClientToScreen

CloseQuery

Close

ContainsControl

ControlAtPos

DefaultHandler

DefocusControl

DestroyComponents

Destroying

DisableAlign

Dispatch

DragDrop

Dragging

EditChange

EnableAlign

EndDrag

FieldAddress

FindComponent

FocusControl

Focused

FreeInstance

FreeNotification

Free

GetFormImage

GetParentComponent

GetTabOrderList

GetTextBuf

GetTextLen

HandleAllocated

HandleNeeded

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InsertControl

InstanceSize

Invalidate

MethodAddress

MethodName

NewInstance

Next

OKButtonClick

PaintTo

Perform

Previous

Print

Realign

Refresh

Release

RemoveAllButtonClick

RemoveButtonClick

RemoveComponent

RemoveControl

Repaint

ScaleBy

ScreenToClient

ScrollBy

ScrollInView

SendCancelMode

SendToBack

SetBounds

SetFocusedControl

SetFocus

SetTextBuf

ShowModal

Show

Tile

TPasswordDialog

UpdateControlState

Update


TPasswordDialog::~TPasswordDialog

TPasswordDialog

Der Destruktor ~TPasswordDialog gibt den Speicher frei, der für das TPasswordDialog-Objekt reserviert war. Rufen Sie ~TPasswordDialog nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TPasswordDialog automatisch aufgerufen wird.

__fastcall virtual ~TPasswordDialog(void);


TPasswordDialog::AddButtonClick

TPasswordDialog	Siehe auch

AddButtonClick steuert, was geschieht, wenn die Schaltfläche Hinzufügen angeklickt wird.

void __fastcall AddButtonClick(System::TObject* Sender);

Beschreibung

Die Methode AddButtonClick fügt das Kennwort im Eingabefeld zur aktuellen Sitzung hinzu, indem sie die Methode TSession::AddPassword aufruft. Anschließend wird der Inhalt des Eingabefeldes gelöscht, und das Feld erhält den Fokus.

Nach dem Aufruf von AddButtonClick wird das OKButton-Objekt aktiviert, und zwar unabhängig davon, ob das Eingabefeld gerade ein Kennwort enthält oder nicht.


TPasswordDialog::EditChange

TPasswordDialog	Siehe auch

Die Methode EditChange steuert, was geschieht, wenn sich der Inhalt des Eingabefeldes ändert.

void __fastcall EditChange(System::TObject* Sender);

Beschreibung

Abhängig davon, ob das Eingabefeld ein Kennwort enthält oder nicht, werden die Schaltflächen Hinzufügen, OK und Löschen aktiviert bzw. deaktiviert.

Hinweis

Die Methode AddButtonClick aktiviert die Schaltfläche OK auch dann, wenn das Eingabefeld leer ist.


TPasswordDialog::OKButtonClick

TPasswordDialog	Siehe auch

Die Methode OKButtonClick steuert, was geschieht, wenn auf die Schaltfläche OK geklickt wird.

void __fastcall OKButtonClick(System::TObject* Sender);

Beschreibung

Die Methode OKButtonClick ruft TSession::AddPassword auf und fügt damit das Kennwort, das im Eingabefeld steht, zur aktuellen Sitzung hinzu.


TPasswordDialog::RemoveAllButtonClick

TPasswordDialog	Siehe auch

Die Methode RemoveAllButtonClick löscht alle Kennwörter aus der aktuellen Sitzung.

void __fastcall RemoveAllButtonClick(System::TObject* Sender);

Beschreibung

RemoveAllButtonClick ruft die Methode TSession::RemoveAllPasswords auf und löscht damit alle Kennwörter aus der aktuellen Sitzung. Anschließend erhält das Eingabefeld den Fokus.


TPasswordDialog::RemoveButtonClick

TPasswordDialog	Siehe auch

Die Methode RemoveButtonClick löscht das Kennwort, das im Eingabefeld steht, aus der aktuellen Sitzung.

void __fastcall RemoveButtonClick(System::TObject* Sender);

Beschreibung

Mit RemoveButtonClick wird das Kennwort im Eingabefeld mit Hilfe der Methode TSession::RemovePassword aus der aktuellen Sitzung gelöscht. Der Inhalt des Eingabefeldes wird anschließend gelöscht, und das Feld erhält den Fokus.


TPasswordDialog::TPasswordDialog

TPasswordDialog

Der Konstruktor TPasswordDialog erzeugt ein neues TPasswordDialog-Objekt.

__fastcall virtual TPasswordDialog(Classes::TComponent* AOwner);


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TControl

TWinControl

TScrollingWinControl

TForm


TPasswordDialog Beispiel

TPasswordDialog


TPen

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/graphics.hpp

Mit einem TPen-Objekt können Sie Linien oder geometrische Formen auf einer Zeichenfläche darstellen.

Beschreibung

Das TPen-Objekt beschreibt die Attribute eines Windows-Stiftes, der ein Bild auf einer Zeichenfläche (TCanvas-Objekt) darstellt. TPen kapselt die Stifteigenschaften, die für den Gerätekontext der Zeichenfläche relevant sind.


Eigenschaften von TPen

TPen	Alphabetisch	Legende

In TPen

Color

Handle

Mode

Style

Width


Eigenschaften von TPen

TPen	Nach Objekten	Legende

Color

Handle

Mode

Style

Width


TPen::Color

TPen	Siehe auch

Die Eigenschaft Color bestimmt die Farbe, in der Linien auf der Zeichenfläche angezeigt werden.

__property TColor Color;

Beschreibung

Mit Color können Sie die Farbe für Linien oder geometrische Figuren ändern. Im folgenden sind die möglichen Farbwerte aufgeführt:

Wert	Bedeutung

clBlack	Schwarz

clMaroon	Rotbraun

clGreen	Grün

clOlive	Olivgrün

clNavy	Marineblau

clPurple	Violett

clTeal	Blaugrün

clGray	Grau

clSilver	Silbergrau

clRed	Rot

clLime	Limonengrün

clBlue	Blau

clFuchsia	Pink

clAqua	Türkis

clWhite	Weiß

clBackground	Aktuelle Hintergrundfarbe von Windows

clActiveCaption	Aktuelle Farbe der Titelleiste des aktiven Fensters

clInactiveCaption	Aktuelle Farbe der Titelleiste inaktiver Fenster

clMenu	Aktuelle Hintergrundfarbe der Menüs

clWindow	Aktuelle Hintergrundfarbe der Fenster

clWindowFrame	Aktuelle Farbe der Fensterrahmen

clMenuText	Aktuelle Farbe von Menütext

clWindowText	Aktuelle Farbe von Fenstertext

clCaptionText	Aktuelle Farbe des Textes in der Titelleiste des aktiven Fensters

clActiveBorder	Aktuelle Rahmenfarbe des aktiven Fensters

clInactiveBorder	Aktuelle Rahmenfarbe inaktiver Fenster

clAppWorkSpace	Aktuelle Farbe des Arbeitsbereichs der Anwendung

clHighlight	Aktuelle Hintergrundfarbe von markiertem Text

clHightlightText	Aktuelle Farbe von markiertem Text

clBtnFace	Aktuelle Farbe einer Schaltfläche

clBtnShadow	Aktuelle Farbe des Schattens einer Schaltfläche

clGrayText	Aktuelle Farbe von grau dargestelltem Text

clBtnText	Aktuelle Farbe von Text auf eine Schaltfläche

clInactiveCaptionText	Aktuelle Farbe des Textes in der Titelleiste eines inaktiven Fensters

clBtnHighlight	Aktuelle Farbe der Markierung einer Schaltfläche

cl3DDkShadow 	Nur bei Windows 95: Dunkler Schatten für dreidimensionale Dialogelemente

cl3DLight 	Nur bei Windows 95: Helle Farbe für dreidimensionale Dialogelemente (für Kanten, die dem Licht zugewandt sind)

clInfoText 	Nur bei Windows 95: Textfarbe für Tool-Tip-Steuerelemente

clInfoBk 	Nur bei Windows 95: Hintergrundfarbe für Tool-Tip-Steuerelemente

Bei der zweiten Hälfte der hier aufgeführten Farben handelt es sich um die Systemfarben von Windows. Die angezeigte Farbe hängt vom Farbschema ab, das aktuell in Windows eingestellt ist. Mit Hilfe der Systemsteuerung können diese Farben geändert werden. Die tatsächlich angezeigte Farbe ist von System zu System verschieden. Beispielsweise enthalten Farben im violetten Bereich einen mehr oder weniger starken Anteil an Blau.

Hinweis

Wie die Farbdarstellung vom Stift realisiert wird, hängt von den Eigenschaften Mode und Style ab.


TPen::Handle

TPen	Siehe auch	Beispiel

Die Eigenschaft Handle bezeichnet das Windows-Handle des Stiftobjekts.

__property HPEN Handle;

Beschreibung

Verwenden Sie Handle, wenn Sie eine Funktion der Windows-API aufrufen, die das Handle eines Stift-Objekts erfordert. Die Eigenschaft Handle ist das aktuelle Handle von Windows für den Gerätekontext der Zeichenfläche.


TPen::Mode

TPen	Siehe auch

Die Eigenschaft Mode bestimmt, wie der Stift Linien zeichnet.

__property TPenMode Mode;

Beschreibung

Mit Mode können Sie bestimmen, wie sich die Farbe des Stiftes und die Farbe der Zeichenfläche beeinflussen. Die folgende Tabelle enthält die Effekte, die mit Mode erreicht werden können:

Modus	Pixelfarbe

pmBlack	Immer schwarz

pmWhite	Immer weiß

pmNop	Unverändert

pmNot	Komplementärefarbe zur Hintergrundfarbe der Zeichenfläche

pmCopy	Stiftfarbe der Eigenschaft Color

pmNotCopy	Komplementärfarbe zur Stiftfarbe

pmMergePenNot	Kombination aus Stiftfarbe und Komplementärfarbe der Zeichenfläche

pmMaskPenNot	Kombination von Farbanteilen, die sowohl in der Stiftfarbe als auch in der Komplementärfarbe der Zeichenfläche enthalten sind.

pmMergeNotPen	Kombination von Hintergrundfarbe der Zeichenfläche und komplementärer Stiftfarbe

pmMaskNotPen	Kombination von Farbanteilen, die sowohl im Hintergrund der Zeichenfläche als auch in der komplementären Stiftfarbe enthalten sind.

pmMerge	Kombination aus Stiftfarbe und Hintergrundfarbe der Zeichenfläche

pmNotMerge	Komplementärfarbe zu pmMerge: Kombination aus Stiftfarbe und Hintergrundfarbe der Zeichenfläche

pmMask	Kombination von Farbanteilen, die sowohl in der Stiftfarbe als auch in der Hintergrundfarbe der Zeichenfläche enthalten sind.

pmNotMask	Komplementärfarbe zu pmMask: Kombination von Farbanteilen, die sowohl in der Stiftfarbe als auch in der Hintergrundfarbe der Zeichenfläche enthalten sind.

pmXor	Kombination von Farbanteilen, die entweder nur im Stift oder nur im Hintergrund der Zeichenfläche enthalten sind, aber nicht in beiden.

pmNotXor	Komplementärfarbe zu pmXor: Kombination von Farbanteilen, die entweder nur im Stift oder nur im Hintergrund der Zeichenfläche enthalten sind, aber nicht in beiden.


TPen::Style

TPen	Siehe auch

Mit der Eigenschaft Style können Sie den Stil bestimmen, in dem die Linien mit dem Stift gezeichnet werden.

__property TPenStyle Style;

Beschreibung

Mit Style können Sie eine punktierte oder eine strichlierte Linie zeichnen. Außerdem kann der Umriß einer geometrischen Figur ausgeblendet werden. Im folgenden finden Sie die möglichen Werte von Style:

Wert	Bedeutung

psSolid	Durchgezogene Linie

psDash	Strichlierte Linie

psDot	Punktierte Linie

psDashDot	Linie aus abwechselnden Strichen und Punkten

psDashDotDot	Linie aus Strich-Punkt-Punkt-Folgen

psClear	Keine Linie (der Umriß um Objekte wird ausgeblendet)

psInsideFrame	Durchgezogene Linie. Falls die Breite größer als ein Pixel ist, kann eine Rasterfarbe verwendet werden.

Hinweis

Nur beim Stil psInsideFrame wird eine Rasterfarbe verwendet, um den Farbton darzustellen, der in der Eigenschaft Color vorgegeben, aber nicht in der Farbtabelle enthalten ist. Bei allen anderen Eigenschaftswerten wird die betmögliche Annäherung gewählt.

Hinweis

Hat die Eigenschaft Width nicht den Wert 1, können keine punktierten oder strichlierten Linien gezeichnet werden.


TPen::Width

TPen	Siehe auch	Beispiel

Die Eigenschaft Width gibt die maximale Breite des Stiftes in Pixel an.

__property int Width;

Beschreibung

Mit Width können Sie die Linie verbreitern. Wurde Width auf einen Wert kleiner als 1 eingestellt, hat der Stift trotzdem die Breite 1.

Hinweis

Der Wert von Width beeinflußt, welche Werte von Style gültig sind.


Ereignisse von TPen

TPen	Alphabetisch

Abgeleitet von TGraphicsObject

OnChange


Ereignisse von TPen

TPen	Nach Objekten

OnChange


Methoden von TPen

TPen	Alphabetisch

In TPen

~TPen

Assign

TPen

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TPen

TPen	Nach Objekten

~TPen

Assign

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance

TPen


TPen::~TPen

TPen	Siehe auch

Der Destruktor ~TPen gibt den Speicher frei, der für das TPen-Objekt reserviert war. Rufen Sie ~TPen nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TPen automatisch aufgerufen wird.

__fastcall virtual ~TPen(void);


TPen::Assign

TPen	Siehe auch

Mit der Methode Assign können die Eigenschaften eines Stiftes von einem anderen TPen-Objekt übernommen werden.

virtual void __fastcall Assign(Classes::TPersistent* Source);

Beschreibung

Bezeichnet der Parameter Source ein anderes TPen-Objekt, kopiert die Methode Assign die Eigenschaften Color, Width, Style und Mode des Quellobjekts. Andernfalls werden mit der geerbten Methode die Eigenschaften eines Objekts kopiert, das Werte mit der Methode AssignTo in ein TPen-Objekt schreiben kann.


TPen::TPen

TPen	Siehe auch

Die Methode TPen erzeugt eine Instanz von TPen.

__fastcall TPen(void);

Beschreibung

Mit TPen können Sie ein TPen-Objekt erstellen, das der Stift-Eigenschaft einer Zeichenfläche zugewiesen wird. Der Stift für die Zeichenfläche wird im Konstruktor für das TCanvas-Objekt automatisch erstellt.

TPen belegt die Ressourcen für das TPen-Objekt und initialisiert die Eigenschaft Mode mit pmCopy.


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TGraphicsObject


TPen Beispiel

TPen


TPersistent

Hierarchie	Methoden	Siehe auch

Header

vcl/classes.hpp

TPersistent ist der Vorfahr aller Objekte in Borland C++Builder, die über Zuweisungs- und Stream-Funktionen verfügen.

Beschreibung

TPersistent kapselt das grundlegende Verhalten, das allen Objekten gemeinsam ist, die einem anderen Objekt zugewiesen werden können und die ihre Eigenschaftswerte in einen Stream schreiben bzw. daraus lesen können. Hierzu führt die Klasse TPersistent Methoden ein, die für folgende Zwecke überschrieben werden können:

•	Die Prozedur definieren, mit der nicht als published deklarierte Daten in einen Stream geschrieben bzw. daraus gelesen werden können.

•	Verfahren bereitstellen, mit denen Eigenschaftswerte gesetzt werden können.

•	Verfahren bereitstellen, mit denen der Inhalt eines Objekts einem anderen zugewiesen werden kann.

Erzeugen Sie keine neuen Instanzen von TPersistent. Die Klasse TPersistent dient als Basisklasse für die Deklaration von Objekten, die keine Komponenten sind, aber trotzdem Stream- oder Zuweisungsfunktionen benötigen.


Methoden von TPersistent

TPersistent	Alphabetisch	Legende

In TPersistent

~TPersistent

Assign

AssignTo

DefineProperties

TPersistent

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TPersistent

TPersistent	Nach Objekten	Legende

~TPersistent

AssignTo

Assign

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

DefineProperties

Dispatch

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance

TPersistent


TPersistent::~TPersistent

TPersistent	Siehe auch

Der Destruktor ~TPersistent gibt den Speicher frei, der für das TPersistent-Objekt reserviert war. Rufen Sie ~TPersistent nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TPersistent automatisch aufgerufen wird.

__fastcall virtual ~TPersistent(void);


TPersistent::Assign

TPersistent	Siehe auch

Die Methode Assign kopiert ein Objekt auf ein anderes. Dazu wird der Inhalt des Objekts kopiert.

virtual void __fastcall Assign(TPersistent* Source);

Beschreibung

Überschreiben Sie Assign so, daß die Daten eines Objekts in ein anderes Objekt desselben Typs kopiert werden. Einige Klassen unterstützen auch die Zuweisung an Objekte mit unterschiedlichem Typ. In allen anderen Fällen löst Assign eine EConvertError-Exception aus, wenn zwei von TPersistent abstammende Objekte nicht denselben Typ besitzen.

Ein Aufruf von Assign hat die grundsätzlich folgende Form:

Destination->Assign(Source);

Dadurch wird das Zielobjekt (Destination) angewiesen, den Inhalt des Quellobjekts (Source) auf sich selbst zu kopieren. Grundsätzlich ist die Anweisung „Destination := Source“ nicht gleichbedeutend mit „Destination.Assign(Source)“. Die Anweisung „Destination := Source“ bewirkt, daß Destination dasselbe Objekt referenziert wie Source, während „Destination.Assign(Source)“ den Inhalt des von Source referenzierten Objekts in das andere, von Destination referenzierte, kopiert.

Hinweis

Die Typen einiger Eigenschaften sind ebenfalls Objekte. Wenn diese Eigenschaften Methoden besitzen, die Eigenschaftswerte mit Assign setzen, dann ist die Anweisung „Destination := Source“ tatsächlich gleichbedeutend mit „Destination.Assign(Source)“.

Die Konvertierung kann entweder in der Methode Assign erfolgen oder in der Methode AssignTo. Der Unterschied liegt darin, wer die Zuweisung implementiert.

Beachten Sie, daß der Parameter Source auch NULL sein.


TPersistent::AssignTo

TPersistent	Siehe auch

AssignTo bietet einen generischen Mechanismus für die Zuweisung von Daten des einen Objekts zu einem anderen.

virtual void __fastcall AssignTo(TPersistent* Dest);

Beschreibung

AssignTo ist die geschützte Implementierung der als public deklarierten Methode Assign. Per Voreinstellung löst die von TPersistent definierte Methode AssignTo eine EConvertError-Exception aus. Abgeleitete Klassen können eine AssignTo-Methode definieren, die den Inhalt eines Objekts dieser Klasse in ein anderes kopiert. AssignTo erfordert nicht, daß auf beiden Seiten das Wissen vorhanden ist, in welcher Form Daten zwischen Typen kopiert werden. Im folgenden Beispiel sind A und B Instanzenvariablen:

A->Assign(B);

Wenn A weiß, wie B behandelt werden muß, erfolgt die Verarbeitung, und A kehrt zurück. Wenn A dagegen nicht weiß, wie der Typ von B behandelt werden muß, wird die Ausführung in der Hierarchie nach oben bis zu TPersistent.Assign weitergeleitet. Dort erfolgt der Aufruf:

B->Assign(A);

Wenn B nichts über A weiß, wird eine Exception ausgelöst.


TPersistent::DefineProperties

TPersistent	Siehe auch

Die von TPersistent definierte Methode DefineProperties sorgt für nichts anderes als die Bereitstellung einer Schnittstelle für Methoden, die Daten lesen und schreiben, die ansonsten nicht als published deklariert sind.

virtual void __fastcall DefineProperties(TFiler* Filer);

Beschreibung

Nachkommen von TPersistent können DefineProperties überschreiben, um eine Methode zu schaffen, welche die nicht als published deklarierten Daten eines Objektes in einem Stream, etwa einer Formulardatei, speichert. Standardmäßig werden beim Schreiben eines Objekts in einen Stream auch alle Werte seiner als published deklarierten Eigenschaften in den Stream geschrieben. Entsprechend werden diese Werte auch beim Einlesen des Objekts gelesen und den Eigenschaften zugewiesen. Die Methode DefineProperties kann so überschrieben werden, daß nicht nur als published deklarierte Eigenschaften erfaßt werden.

Beim Überschreiben von DefineProperties müssen einige oder alle der folgenden Punkte berücksichtigt werden:

•	Ein Aufruf der geerbten Methode

•	Aufrufe der Methode DefineProperty des Filer-Objekts

•	Aufrufe der Methode DefineBinaryProperty des Filer-Objekts

DefineProperties ist eine virtuelle Methode, so daß sie von Nachkommen nach Bedarf überschrieben werden kann. Das Überschreiben ist allerdings nicht erforderlich.


TPersistent::TPersistent

TPersistent	Siehe auch

Der Konstruktor TPersistent erzeugt ein neues TPersistent-Objekt.

__fastcall TPersistent(void);


Gültigkeitsbereich

Protected


Hierarchie

TObject


TPersistent Beispiel

TPersistent


TPicture

Hierarchie	Eigenschaften	Methoden	Ereignisse

Header

vcl/graphics.hpp

Objekte der Klasse TPicture enthalten Bitmaps, Symbole, Metadateien oder benutzerdefinierte Grafiken. Der Typ der Grafik wird mit der Eigenschaft Graphic festgelegt.

Beschreibung

Enthält das TPicture-Objekt eine Bitmap-Grafik, wird diese mit der Eigenschaft Bitmap angegeben. Bei einem Symbol wird die Grafik mit der Eigenschaft Icon und bei einem Metafile-Objekt mit der Eigenschaft Metafile festgelegt.


Eigenschaften von TPicture

TPicture	Alphabetisch	Legende

In TPicture

Bitmap

Graphic

Height

Icon

Metafile

Width


Eigenschaften von TPicture

TPicture	Nach Objekten	Legende

Bitmap

Graphic

Height

Icon

Metafile

Width


TPicture::Bitmap

TPicture	Siehe auch

Gibt an, daß der Inhalt des TPicture-Objekts ein Bitmap ist (Dateiformat .BMP).

__property TBitmap* Bitmap;

Beschreibung

Nehmen Sie mit Bitmap auf das Grafikobjekt Bezug, wenn es ein Bitmap enthält. Verwenden Sie diese Eigenschaft bei einem TPicture-Objekt, das eine Metadatei oder ein Symbol enthält, wird keine Grafikkonvertierung durchgeführt. Statt dessen wird der ursprüngliche Inhalt des Objekts verworfen und ein neues leeres Bitmap zurückgegeben.


TPicture::Graphic

TPicture	Siehe auch

Gibt die im TPicture-Objekt enthaltene Grafik an.

__property TGraphic* Graphic;

Beschreibung

Ein TPicture-Objekt kann eine Grafik des Typs Bitmap, Symbol oder Metadatei sowie eine benutzerdefinierte Grafikklasse enthalten.


TPicture::Height

TPicture	Beispiel

Gibt die Höhe der Grafik in Pixel an.

__property int Height;

Beschreibung

Mit Height können Sie die vertikale Größe der im Objekt enthaltenen Grafik feststellen.


TPicture::Icon

TPicture	Siehe auch

Gibt an, daß der Inhalt des TPicture-Objekts ein Symbol ist (Dateiformat .ICO).

__property TIcon* Icon = {read=GetIcon, write=SetIcon, nodefault};

Beschreibung

Nehmen Sie mit Icon auf das Grafikobjekt Bezug, wenn es ein Symbol enthält. Verwenden Sie diese Eigenschaft bei einem TPicture-Objekt, das ein Bitmap oder eine Metadatei enthält, wird keine Grafikkonvertierung durchgeführt. Statt dessen wird der ursprüngliche Inhalt des Objekts verworfen und ein neues leeres Symbol zurückgegeben.


TPicture::Metafile

TPicture	Siehe auch

Gibt an, daß der Inhalt des TPicture-Objekts eine erweiterte Windows-Metadatei ist (Dateiformat .EMF).

__property TMetafile* Metafile = {read=GetMetafile, write=SetMetafile, nodefault};

Beschreibung

Nehmen Sie mit Metafile auf das Grafikobjekt Bezug, wenn es eine Metadatei enthält. Verwenden Sie diese Eigenschaft bei einem TPicture-Objekt, das ein Bitmap oder Symbol enthält, wird keine Grafikkonvertierung durchgeführt. Statt dessen wird der ursprüngliche Inhalt des Objekts verworfen und eine neues leere Metadatei zurückgegeben.


TPicture::Width

TPicture	Beispiel

Gibt die maximale Breite der Grafik in Pixel an.

__property int Width = {read=GetWidth, nodefault};


Ereignisse von TPicture

TPicture	Alphabetisch

In TPicture

OnChange


Ereignisse von TPicture

TPicture	Nach Objekten

OnChange


TPicture::OnChange

TPicture

OnChange wird ausgelöst, sobald die im TPicture-Objekt enthaltene Grafik geändert wird.

__property Classes::TNotifyEvent OnChange = {read=FOnChange, write=FOnChange};


Methoden von TPicture

TPicture	Alphabetisch

In TPicture

~TPicture

Assign

LoadFromClipboardFormat

LoadFromFile

RegisterClipboardFormat

RegisterFileFormat

RegisterFileFormatRes

SaveToClipboardFormat

SaveToFile

SupportsClipboardFormat

TPicture

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TPicture

TPicture	Nach Objekten

~TPicture

Assign

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

LoadFromClipboardFormat

LoadFromFile

MethodAddress

MethodName

NewInstance

RegisterClipboardFormat

RegisterFileFormatRes

RegisterFileFormat

SaveToClipboardFormat

SaveToFile

SupportsClipboardFormat

TPicture


TPicture::~TPicture

TPicture

Gibt das TPicture-Objekt aus dem Speicher frei. Diese Routine sollte auf keinen Fall direkt aufgerufen werden. Verwenden Sie statt dessen das Schlüsselwort delete für das Objekt. Dadurch wird ~TPicture automatisch aufgerufen.

__fastcall virtual ~TPicture(void);

Beschreibung

Ein TPicture-Objekt gibt zuerst die in ihm enthaltene Grafik frei und ruft anschließend den Destruktor seines übergeordneten Fensters auf.


TPicture::Assign

TPicture

Weist einem TPicture-Objekt eine Grafik zu.

virtual void __fastcall AssignTo(Classes::TPersistent* Dest);


TPicture::LoadFromClipboardFormat

TPicture

Liest die Grafik aus dem im angegebenen Zwischenablageformat bereitgestellten Handle.

void __fastcall LoadFromClipboardFormat(unsigned short AFormat, int AData, HPALETTE APalette);

Beschreibung

Bei einem nicht unterstützen Format wird eine Exception ausgelöst.


TPicture::LoadFromFile

TPicture

Liest die mit FileName angegebene Datei und lädt ihren Inhalt in das TPicture-Objekt.

void __fastcall LoadFromFile(const System::AnsiString Filename);


TPicture::RegisterClipboardFormat

TPicture

Registriert eine neue TGraphic-Klasse, die danach in der Methode LoadFromClipboardFormat verwendet werden kann.

static void __fastcall RegisterClipboardFormat(const System::TMetaClass* const vmt,  unsigned short AFormat, System::TMetaClass* AGraphicClass);


TPicture::RegisterFileFormat

TPicture

Registriert ein neues Grafikdateiformat bei TPicture, das anschließend in einem öffnen- oder Speichern-Dialogfeld verwendet werden kann.

static void __fastcall RegisterFileFormat(const System::TMetaClass* const vmt, const System::AnsiString  AExtension, const System::AnsiString ADescription, System::TMetaClass* AGraphicClass);

Beschreibung

Der Parameter AExtension bestimmt die DOS-Dateinamenserweiterung für die Grafikklasse (beispielsweise “BMP“ für TBitmap). Mit ADescription kann die in der Dropdown-Liste des Dialogfelds angezeigte Beschreibung für die Grafik angegeben werden (so ist beispielsweise “Bitmaps“ die Beschreibung von TBitmap). Der Parameter AGraphicClass registriert die neue Grafikklasse, die dem Dateiformat zugeordnet werden soll.


TPicture::RegisterFileFormatRes

TPicture	Siehe auch

Registriert eine neue TGraphic-Klasse, die dann in der Methode LoadFromFile verwendet werden kann.

static void __fastcall RegisterFileFormatRes(const System::TMetaClass* const vmt,  const System::AnsiString AExtension, int ADescriptionResID, System::TMetaClass* AGraphicClass);

Beschreibung

Mit dem Parameter ADescriptionResID wird die ID der String-Ressource angegeben.


TPicture::SaveToClipboardFormat

TPicture

Weist ein globales Handle zu und schreibt die Grafik in ihrem nativen Zwischenablageformat (CF_BITMAP für Bitmaps, CF_METAFILE für Metadateien usw.).

void __fastcall SaveToClipboardFormat(unsigned short &AFormat, int &AData, HPALETTE &APalette);

Beschreibung

Die geschriebenen Formate werden in der von AFormat und AData angegebenen Array-Eigenschaft Formats von TClipboard gespeichert. Nach der Operation gibt SaveToClipboard die Anzahl der geschriebenen Elemente zurück. Hat der Parameter AFormat oder AData den Wert NULL, wird zurückgegeben, wieviele Zwischenablageelemente geschrieben worden wären.


TPicture::SaveToFile

TPicture

Speichert ein TPicture-Objekt in der mit FileName angegebenen Datei.

void __fastcall SaveToFile(const System::AnsiString Filename);


TPicture::SupportsClipboardFormat

TPicture	Siehe auch

Gibt an, ob ein bestimmtes Zwischenablageformat von der Methode LoadFromClipboardFormat unterstützt wird.

static bool __fastcall SupportsClipboardFormat(const System::TMetaClass* const vmt,  unsigned short AFormat);

Beschreibung

Wird das mit AFormat angegebene Zwischenablageformat von der Methode LoadFromClipboardFormat unterstützt, gibt SupportsClipboardFormat True zurück. Unterstützt die Methode das Format nicht, wird False zurückgegeben.


TPicture::TPicture

TPicture

Erstellt ein neues TPicture-Objekt.

__fastcall TPicture(void)


Zugriff

Read-only


Hierarchie

TObject

TPersistent


TPicture Beispiel

TPicture


 TPopupMenu

Hierarchie	Eigenschaften	Methoden	Ereignisse

Header

vcl/menus.hpp

Eine TPopupMenu-Komponente kapselt die Eigenschaften, Methoden und Ereignisse eines Popup-Menüs. Dieses Menü ist in Formularen und Steuerelementen verfügbar, wenn der Benutzer die Komponente markiert und mit der rechten Maustaste klickt.

Beschreibung

Um ein Popup-Menü verfügbar zu machen, weisen Sie der Eigenschaft PopupMenu eines Formulars oder eines Steuerelements eine TPopupMenu-Komponente zu.

Um ein Popup-Menü zu entwerfen, fügen Sie ein Popup-Menü in Ihr Formular ein und doppelklicken auf die Komponente.

Die Einträge des Popup-Menüs werden in der Eigenschaft Items festgelegt. Items ist vom Typ TMenuItem. Ihre Anwendung kann mit dieser Eigenschaft auf einen bestimmten Menüeintrag zugreifen.

Wenn  das Popup-Menü angezeigt werden soll, sobald der Benutzer mit der rechten Maustaste auf das Steuerelement klickt, dem das Popup-Menü zugeordnet ist, setzen Sie die Eigenschaft AutoPopup auf True. Mit der Methode Popup können Sie die Anzeige des Popup-Menüs programmseitig steuern.

Popup-Menüs verfügen über eine Ereignisbehandlungsroutine für OnPopup, mit der Sie bestimmte Aktionen durchführen können, bevor das Popup-Menü angezeigt wird.

TPopupMenu ist ein indirekter Nachkomme von TComponent. Zusätzlich zu den folgenden Eigenschaften, Methoden und Ereignissen enthält TPopupMenu auch die Eigenschaften und Methoden, die alle Komponenten gemeinsam haben.


Eigenschaften von TPopupMenu

TPopupMenu	Alphabetisch	Legende

In TPopupMenu

Alignment

AutoPopup

HelpContext

PopupComponent

Abgeleitet von TMenu

Handle

read-only	Items

WindowHandle

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Name

Owner

Tag


Eigenschaften von TPopupMenu

TPopupMenu	Nach Objekten	Legende

Alignment

AutoPopup

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

DesignInfo

Handle

HelpContext

read-only	Items

Name

Owner

PopupComponent

Tag

WindowHandle


TPopupMenu::Alignment

TPopupMenu	Siehe auch

Die Eigenschaft Alignment legt fest, an welcher Stelle das Popup-Menü eingeblendet wird, sobald der Benutzer die rechte Maustaste drückt.

__property TPopupAlignment Alignment;

Beschreibung

Die folgende Tabelle enthält die möglichen Werte und ihre Bedeutung:

Wert	Bedeutung

paLeft	Die linke obere Ecke des Popup-Menüs erscheint an der Position des Mauszeigers.

paCenter	Die Mitte des oberen Randes des Popup-Menüs erscheint an der Position des Mauszeigers.

paRight	Die rechte obere Ecke des Popup-Menüs erscheint an der Position des Mauszeigers.

Der Vorgabewert ist paLeft.


TPopupMenu::AutoPopup

TPopupMenu	Siehe auch

Die Eigenschaft AutoPopup bestimmt, ob das Popup-Menü angezeigt wird.

__property bool AutoPopup;

Beschreibung

Die Eigenschaft AutoPopup legt fest, ob das Popup-Menü nach einem Klick mit der rechten Maustaste auf die Komponente angezeigt wird, deren Eigenschaft PopupMenu auf dieses Menü zeigt. Wenn AutoPopup True ist, wird das Popup-Menu durch Klicken mit der rechten Maustaste eingeblendet. Andernfalls kann das Menü nicht durch Klicken mit der rechten Maustaste angezeigt werden. Der Vorgabewert ist True.

Mit der entsprechenden Taste einer Windows 95-Tastatur können Sie dieses Menü ebenfalls anzeigen.

Wenn AutoPopup False ist, können Sie das Popup-Menü mit der Methode Popup anzeigen.


TPopupMenu::HelpContext

TPopupMenu

Die Eigenschaft HelpContext liefert für einen Eintrag des Popup-Menüs eine Kontextnummer, mit der kontextsensitive Hilfe aufgerufen werden kann.

__property Classes::THelpContext HelpContext;

Beschreibung

Jeder Bildschirm des Hilfesystems sollte eine eindeutige Kontextnummer haben. Sobald eine Komponente in der Anwendung markiert ist, können Sie mit der Taste F1 einen Hilfebildschirm anzeigen. Welcher Hilfebildschirm das ist, hängt von der Eigenschaft HelpContext ab.


TPopupMenu::PopupComponent

TPopupMenu	Siehe auch

Die Eigenschaft PopupComponent gibt an, auf welche Komponente zur Anzeige des Popup-Menüs geklickt wurde.

virtual void __fastcall Popup(int X, int Y);

Beschreibung

Die Eigenschaft PopupComponent bezieht sich auf die Komponente, auf die der Benutzer geklickt hat. Wenn ein Popup-Menü in Ihrer Anwendung von mehreren Steuerelementen verwendet wird, können Sie mit PopupComponent ermitteln, auf welche Komponente geklickt wurde.

Wenn Sie ein Popup-Menü durch einen expliziten Aufruf von PopupMenu1.Popup aktivieren und es mit einer bestimmten Komponente verknüpfen wollen, sollten Sie diese Komponente vor dem Aufruf von Popup der Eigenschaft PopupComponent zuweisen.


Ereignisse von TPopupMenu

TPopupMenu	Alphabetisch	Legende

In TPopupMenu

OnPopup


Ereignisse von TPopupMenu

TPopupMenu	Nach Objekten	Legende

OnPopup


TPopupMenu::OnPopup

TPopupMenu	Siehe auch

Das Ereignis OnPopup wird ausgelöst, wenn ein Popup-Menü angezeigt wird.

__property Classes::TNotifyEvent OnPopup;

Beschreibung

Das Popup-Menü wird eingeblendet, wenn der Benutzer mit der rechten Maustaste auf die Komponente klickt, deren Eigenschaft PopupMenu auf dieses Menü zeigt. Wenn AutoPopup True ist, wird das Popup-Menu durch einen Klick mit der rechten Maustaste angezeigt, andernfalls nicht.Der Vorgabewert ist True.

Mit der entsprechenden Taste der Windows 95-Tastatur können Sie dieses Menü ebenfalls anzeigen.

Wenn AutoPopup False ist, können Sie das Popup-Menü mit der Methode Popup anzeigen.


Methoden von TPopupMenu

TPopupMenu	Alphabetisch

In TPopupMenu

~TPopupMenu

Popup

TPopupMenu

Abgeleitet von TMenu

DispatchCommand

DispatchPopup

FindItem

GetHelpContext

IsShortCut

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TPopupMenu

TPopupMenu	Nach Objekten

~TPopupMenu

Assign

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

DestroyComponents

Destroying

DispatchCommand

DispatchPopup

Dispatch

FieldAddress

FindComponent

FindItem

FreeInstance

FreeNotification

Free

GetHelpContext

GetParentComponent

HasParent

InheritsFrom

InitInstance

InsertComponent

InstanceSize

IsShortCut

MethodAddress

MethodName

NewInstance

Popup

RemoveComponent

TPopupMenu


TPopupMenu::~TPopupMenu

TPopupMenu	Siehe auch

Der Destruktor ~TPopupMenu gibt den Speicher frei, der für das TPopupMenu-Objekt reserviert war. Rufen Sie ~TPopupMenu nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TPopupMenu automatisch aufgerufen wird.

__fastcall virtual ~TPopupMenu(void);

Beschreibung

~TPopupMenu gibt vor dem Aufruf des Destruktors des übergeordneten Objekts die Liste der Popup-Menüs frei.


TPopupMenu::Popup

TPopupMenu	Siehe auch

Die Methode Popup zeigt ein Popup-Menü an.

__fastcall virtual Popup(X, Y: Integer);

Beschreibung

Das Menü wird an den Koordinaten angezeigt, die von den Werten X und Y (in Pixeln) bezeichnet werden.


TPopupMenu::TPopupMenu

TPopupMenu	Siehe auch

Der Konstruktor TPopupMenu erzeugt ein neues TPopupMenu-Objekt.

__fastcall virtual TPopupMenu(Classes::TComponent* AOwner);

Beschreibung

TPopupMenu ruft den Konstruktor des übergeordneten Objekts auf und initialisiert das Popup-Menü.


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TMenu


TPopupMenu Beispiel

TPopupMenu


 TProgressBar

Hierarchie	Eigenschaften	Methoden	Ereignisse

Header

vcl/comctrls.hpp

Eine TProgressBar-Komponente stellt den Fortschritt eines Vorgangs in einer Anwendung grafisch dar.

Beschreibung

Während der Vorgang fortschreitet, füllt sich das rechteckige TProgressBar-Objekt allmählich von links nach rechts mit der Farbe, die im System für Hervorhebungen vorgesehen ist. Die Eigenschaft Step legt fest, um welchen Wert die Eigenschaft Position bei jeder €nderung vergrößert wird.

Neben den beschriebenen Eigenschaften, Methoden und Ereignissen verfügt die Komponente über die Eigenschaften, Methoden und Ereignisse, die allen fensterorientierten Steuerelementen eigen sind.


Eigenschaften von TProgressBar

TProgressBar	Alphabetisch	Legende

In TProgressBar

Max

Min

Position

Step

Abgeleitet von TWinControl

Brush

ClientOrigin

ClientRect

ControlCount

Controls

Handle

HelpContext

Showing

TabOrder

TabStop

Abgeleitet von TControl

Align

BoundsRect

ClientHeight

ClientWidth

ControlState

ControlStyle

Cursor

Enabled

Height

Hint

Left

Name

Parent

ParentShowHint

PopupMenu

ShowHint

Top

Visible

Width

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TProgressBar

TProgressBar	Nach Objekten	Legende

Align

BoundsRect

Brush

ClientHeight

ClientOrigin

ClientRect

ClientWidth

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlCount

ControlState

Controls

ControlStyle

Cursor

DesignInfo

Enabled

Handle

Height

HelpContext

Hint

Left

Max

Min

Name

Owner

ParentShowHint

Parent

PopupMenu

Position

ShowHint

Showing

Step

TabOrder

TabStop

Tag

Top

Visible

Width


TProgressBar::Max

TProgressBar	Siehe auch

Die Eigenschaft Max legt die obere Grenze der möglichen Positionen einer Fortschrittsanzeige fest.

__property TProgressRange Max;

Beschreibung

Mit Max und Min können Sie den Bereich der möglichen Positionen einer Fortschrittsanzeige definieren.


TProgressBar::Min

TProgressBar	Siehe auch

Die Eigenschaft Min legt die untere Grenze der möglichen Positionen einer Fortschrittsanzeige fest.

__property TProgressRange Min;

Beschreibung

Mit Max und Min können Sie den Bereich der möglichen Positionen einer Fortschrittsanzeige definieren.


TProgressBar::Position

TProgressBar	Siehe auch	Beispiel

Die Eigenschaft Position legt die gegenwärtige Position der Fortschrittsanzeige fest.

__property TProgressRange Position;

Beschreibung

Der Wertebereich von Position liegt zwischen den Werten von Min und Max.


TProgressBar::Step

TProgressBar	Siehe auch

Die Eigenschaft Step legt den Wert fest, um den die Eigenschaft Position von der Methode StepIt erhöht wird.

__property TProgressRange Step;

Beschreibung

Legen Sie vor dem Aufruf der Methode StepIt einen Wert für Step fest.


Ereignisse von TProgressBar

TProgressBar	Alphabetisch	Legende

Abgeleitet von TWinControl

OnEnter

OnExit

Abgeleitet von TControl

OnDragDrop

OnDragOver

OnEndDrag

OnMouseDown

OnMouseMove

OnMouseUp

OnStartDrag


Ereignisse von TProgressBar

TProgressBar	Nach Objekten	Legende

OnDragDrop

OnDragOver

OnEndDrag

OnEnter

OnExit

OnMouseDown

OnMouseMove

OnMouseUp

OnStartDrag


Methoden von TProgressBar

TProgressBar	Alphabetisch

In TProgressBar

~TProgressBar

StepBy

StepIt

TProgressBar

Abgeleitet von TWinControl

Broadcast

CanFocus

ContainsControl

ControlAtPos

DisableAlign

EnableAlign

Focused

GetTabOrderList

HandleAllocated

HandleNeeded

InsertControl

Invalidate

PaintTo

Realign

RemoveControl

Repaint

ScaleBy

ScrollBy

SetBounds

SetFocus

Update

UpdateControlState

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

GetTextLen

Hide

Perform

Refresh

ScreenToClient

SendToBack

SetTextBuf

Show

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TProgressBar

TProgressBar	Nach Objekten

~TProgressBar

Assign

BeginDrag

BringToFront

Broadcast

CanFocus

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

ClientToScreen

ContainsControl

ControlAtPos

DefaultHandler

DestroyComponents

Destroying

DisableAlign

Dispatch

DragDrop

Dragging

EnableAlign

EndDrag

FieldAddress

FindComponent

Focused

FreeInstance

FreeNotification

Free

GetParentComponent

GetTabOrderList

GetTextBuf

GetTextLen

HandleAllocated

HandleNeeded

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InsertControl

InstanceSize

Invalidate

MethodAddress

MethodName

NewInstance

PaintTo

Perform

Realign

Refresh

RemoveComponent

RemoveControl

Repaint

ScaleBy

ScreenToClient

ScrollBy

SendToBack

SetBounds

SetFocus

SetTextBuf

Show

StepBy

StepIt

TProgressBar

UpdateControlState

Update


TProgressBar::~TProgressBar

TProgressBar

Der Destruktor ~TProgressBar gibt den Speicher frei, der für das TProgressBar-Objekt reserviert war. Rufen Sie ~TProgressBar nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TProgressBar automatisch aufgerufen wird.

__fastcall virtual ~TProgressBar(void);Position property, Step property, StepBy method


TProgressBar::StepBy

TProgressBar	Siehe auch

Die Methode StepBy ändert die Position der Fortschrittsanzeige.

void __fastcall StepBy(TProgressRange Delta);

Beschreibung

Der Wert, um den die Eigenschaft Position geändert werden soll, wird im Parameter Delta übergeben.


TProgressBar::StepIt

TProgressBar

Die Methode StepIt ändert den Wert der Eigenschaft Position um den Wert der Eigenschaft Step.

void __fastcall StepIt(void);

Beschreibung

Mit einem Aufruf von StepIt können Sie den Wert erhöhen, den die Fortschrittsanzeige anzeigt. Bei jedem Aufruf vergrößert sich der Wert der Eigenschaft Position um den Wert der Eigenschaft Step.


TProgressBar::TProgressBar

TProgressBar

Der Konstruktor TProgressBar erzeugt ein neues TProgressBar-Objekt.

__fastcall virtual TProgressBar(Classes::TComponent* AOwner);

Beschreibung

TProgressBar ruft den Konstruktor seines übergeordneten Objekts auf und initialisiert dann die Fortschrittsanzeige.


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TControl

TWinControl


TProgressBar Beispiel

TProgressBar


 TPrintDialog

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/dialogs.hpp

TPrintDialog erzeugt das Dialogfeld Drucken.

Beschreibung

Die Komponente TPrintDialog zeigt das unter Windows übliche Dialogfeld an, mit dem Druckaufträgen an einen Drucker gesendet werden können. Das Dialogfeld wird zur Laufzeit erst angezeigt, wenn es mit der Methode Execute aktiviert wird.


Eigenschaften von TPrintDialog

TPrintDialog	Alphabetisch	Legende

In TPrintDialog

Collate

Copies

FromPage

MaxPage

MinPage

Options

PrintRange

PrintToFile

ToPage

Abgeleitet von TCommonDialog

Ctl3D

HelpContext

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Name

Owner

Tag


Eigenschaften von TPrintDialog

TPrintDialog	Nach Objekten	Legende

Collate

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

Copies

Ctl3D

DesignInfo

FromPage

HelpContext

MaxPage

MinPage

Name

Options

Owner

PrintRange

PrintToFile

Tag

ToPage


TPrintDialog::Collate

TPrintDialog	Siehe auch

Die Eigenschaft Collate gibt an, ob das Kontrollkästchen Kopien sortieren aktiviert ist.

__property bool Collate;

Beschreibung

Collate ist True, wenn das Kontrollkästchen Kopien sortieren im Dialogfeld Drucken aktiviert ist. Um das Kontrollkästchen bereits beim öffnen des Dialogfeldes zu aktivieren, setzen Sie Collate im Objektinspektor oder programmseitig auf True.


TPrintDialog::Copies

TPrintDialog	Siehe auch

Die Eigenschaft Copies gibt die Anzahl der Exemplare an, die im Dialogfeld Drucken eingestellt ist.

__property int Copies;

Hat Copies den Wert 0 oder 1, wird im Feld Exemplare des Dialogfeldes der Wert 1 angezeigt. Um die Option bereits beim öffnen des Dialogfeldes auf zwei oder mehr Exemplare einzustellen, weisen Sie Copies im Objektinspektor oder programmseitig den entsprechenden Wert zu.


TPrintDialog::FromPage

TPrintDialog	Siehe auch

Die Eigenschaft FromPage gibt an, mit welcher Seite der Druck beginnen soll.

__property int FromPage;

Beschreibung

Die Eigenschaft FromPage entspricht im Dialogfeld Drucken dem Feld Von.


TPrintDialog::MaxPage

TPrintDialog	Siehe auch

Die Eigenschaft MaxPage legt die höchste Seitenzahl fest, die der Benutzer eingeben kann.

__property int MaxPage;

Beschreibung

Wenn der Benutzer eine höhere Zahl als MaxPage eingibt, wird eine Fehlermeldung angezeigt.

Hinweis

Seitenzahlen können vom Benutzer nur angegeben werden, wenn in der Eigenschaft Options das Flag poPageNums gesetzt ist. In diesem Fall muß MaxPage größer sein als MinPage, da andernfalls das Dialogfeld nicht geöffnet wird.


TPrintDialog::MinPage

TPrintDialog	Siehe auch

Die Eigenschaft MaxRange legt die niedrigste Seitenzahl fest, die der Benutzer eingeben kann.

__property int MinPage;

Beschreibung

Wenn der Benutzer eine kleinere Zahl als MinPage eingibt, wird eine Fehlermeldung angezeigt.

Hinweis

Seitenzahlen können vom Benutzer nur angegeben werden, wenn in der Eigenschaft Options das Flag poPageNums gesetzt ist. In diesem Fall muß MaxPage größer sein als MinPage, da andernfalls das Dialogfeld nicht geöffnet wird.


TPrintDialog::Options

TPrintDialog	Siehe auch

Die Eigenschaft Options legt das Aussehen und das Verhalten des Dialogfeldes Drucken fest.

__property TPrintDialogOptions Options;

Beschreibung

Die folgende Tabelle enthält die möglichen Werte für Options:

Wert	Bedeutung

poDisablePrintToFile	Das Kontrollkästchen Druckausgabe in Datei umleiten ist deaktiviert (gilt nur, wenn das Flag poPrintToFile gesetzt ist.)

poHelp	Im Dialogfeld wird die Schaltfläche Hilfe angezeigt. Dies funktioniert in einigen Versionen von Windows 95 nicht.

poPageNums	Das Optionsfeld Seiten ist aktiviert. Dadurch kann ein Seitenbereich festgelegt werden.

poPrintToFile	Im Dialogfeld wird das Kontrollkästchen Druckausgabe in Datei umleiten angezeigt.

poSelection	Das Optionsfeld Markierung ist aktiviert. Dadurch kann markierter Text gedruckt werden.

poWarning	Zeigt eine Warnmeldung an, wenn ein Druckauftrag an einen nicht installierten Drucker gesendet wird.

Standardmäßig sind alle Optionen deaktiviert.


TPrintDialog::PrintRange

TPrintDialog	Siehe auch

Die Eigenschaft PrintRange gibt an, welche Art von Druckbereich im Dialogfeld eingestellt ist.

__property TPrintRange PrintRange;

Beschreibung

Der Wert von PrintRange entspricht im Dialogfeld den Optionsfeldern Alles, Markierung und Seiten (Von/bis).

Wert	Bedeutung

prAllPages	Das Optionsfeld Alles ist aktiviert.

prSelection	Das Optionsfeld Markierung ist aktiviert.

prPageNums	Das Optionsfeld Seiten ist aktiviert.

Um ein Optionsfeld beim öffnen des Dialogfeldes standardmäßig zu aktivieren, weisen Sie PrintRange im Objektinspektor oder programmseitig den entsprechenden Wert zu.

Hinweis

Um das Optionsfeld Seiten zu aktivieren, setzen Sie in Options das Flag poPageNums. Um das Optionsfeld Markierung zu aktivieren, setzen Sie in Options das Flag poSelection und weisen MaxPage einen größeren Wert als MinPage zu.


TPrintDialog::PrintToFile

TPrintDialog	Siehe auch

Die Eigenschaft PrintToFile gibt an, ob das Kontrollkästchen Druckausgabe in Datei umleiten aktiviert ist.

__property bool PrintToFile;

Beschreibung

PrintToFile ist True, wenn im Dialogfeld das Kontrollkästchen Druckausgabe in Datei umleiten aktiviert ist. Um das Kontrollkästchen bereits beim öffnen des Dialogfeldes zu aktivieren, setzen Sie PrintToFile im Objektinspektor oder programmseitig auf True.

Hinweis

Um das Kontrollkästchen Druckausgabe in Datei umleiten im Dialogfeld anzuzeigen, setzen Sie in Options das Flag poPrintToFile. Mit dem Flag poDisablePrintToFile können Sie das Kontrollkästchen deaktivieren.


TPrintDialog::ToPage

TPrintDialog	Siehe auch

Die Eigenschaft ToPage gibt die letzte Seite an, die gedruckt werden soll.

__property int ToPage;

Beschreibung

Die Eigenschaft ToPage entspricht im Dialogfeld Drucken dem Feld Bis.


Methoden von TPrintDialog

TPrintDialog	Alphabetisch

In TPrintDialog

~TPrintDialog

Execute

TPrintDialog

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TPrintDialog

TPrintDialog	Nach Objekten

~TPrintDialog

Assign

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

DestroyComponents

Destroying

Dispatch

Execute

FieldAddress

FindComponent

FreeInstance

FreeNotification

Free

GetParentComponent

HasParent

InheritsFrom

InitInstance

InsertComponent

InstanceSize

MethodAddress

MethodName

NewInstance

RemoveComponent

TPrintDialog


TPrintDialog::~TPrintDialog

TPrintDialog

Der Destruktor ~TPrintDialog gibt den Speicher frei, der für das TPrintDialog-Objekt reserviert war. Rufen Sie ~TPrintDialog nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TPrintDialog automatisch aufgerufen wird.

__fastcall virtual ~TPrintDialog(void);


TPrintDialog::Execute

TPrintDialog

Die Methode Execute zeigt das Dialogfeld Drucken an.

bool __fastcall Execute(void);

Beschreibung

Execute öffnet das Dialogfeld Drucken und gibt True zurück, wenn der Benutzer auf OK geklickt hat.


TPrintDialog::TPrintDialog

TPrintDialog

Der Konstruktor TPrintDialog erzeugt ein neues TPrintDialog-Objekt.

__fastcall virtual TPrintDialog(Classes::TComponent* AOwner);


Gültigkeitsbereich

Published

Zugriff

Read-only


Hierarchie

TObject

TPersistent

TComponent

TCommonDialog


TPrintDialog Beispiel

TPrintDialog


TPrinter

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/printers.hpp

TPrinter kapselt die Druckerschnittstelle von Windows.

Beschreibung

TPrinter wird in der Unit Printers automatisch als Druckervariable instantiiert. Mit dieser Variablen können Sie auf einen Drucker zugreifen. Fügen Sie Printers dem uses-Abschnitt der Unit hinzu, die die Eigenschaften oder Methoden eines TPrinter-Objekts implementiert.

Wie das Formular gedruckt wird, können Sie mit der Eigenschaft PrintScale einer TForm-Komponente festlegen.

Wenn alle vorbereitenden Schritte an der Textvariablen oder an der Zeichenfläche des Druckers beendet sind, wird ein Druckauftrag gestartet. Dieser Auftrag bleibt aktiv, bis EndDoc aufgerufen oder die Textvariable geschlossen wird. Der im Druckmanager (und auf Header-Seiten im Netzwerk) angezeigte Titel wird durch die Eigenschaft Title festgelegt. Um einen Druckauftrag zu starten, rufen Sie die Methode BeginDoc auf. Um einen Druckauftrag zu beenden, der erfolgreich an den Drucker gesendet wurde, rufen Sie die Methode EndDoc auf. Wenn ein Problem auftritt und Sie einen Druckauftrag beenden müssen, der nicht erfolgreich an den Drucker gesendet wurde, rufen Sie die Methode Abort auf.


Eigenschaften von TPrinter

TPrinter	Alphabetisch	Legende

In TPrinter

Aborted

Canvas

Capabilities

Copies

Fonts

Handle

Orientation

PageHeight

PageNumber

PageWidth

PrinterIndex

Printers

Printing

Title


Eigenschaften von TPrinter

TPrinter	Nach Objekten	Legende

Aborted

Canvas

Capabilities

Copies

Fonts

Handle

Orientation

PageHeight

PageNumber

PageWidth

PrinterIndex

Printers

Printing

Title


TPrinter::Aborted

TPrinter	Siehe auch

Die Methode Aborted gibt an, ob der Benutzer den Druckauftrag abgebrochen und dadurch die Methode Abort aufgerufen hat.

__property bool Aborted;

Beschreibung

Wenn Aborted True ist, wurde der Druckauftrag abgebrochen. Ist Aborted False, hat der Benutzer den Druckauftrag nicht abgebrochen.


TPrinter::Canvas

TPrinter	Siehe auch

Die Eigenschaft Canvas stellt die Oberfläche der momentan gedruckten Seite dar.

__property Graphics::TCanvas* Canvas;

Beschreibung

Canvas stellt die druckbare Oberfläche einer Seite dar. Mit den Eigenschaften Brush, Font und Pen des Canvas-Objekts können Sie festlegen, in welcher Form Zeichnungen oder Text auf der Seite erscheinen.

Hinweis

Manche Drucker unterstützen keine Grafiken. Die Methoden Draw, StretchDraw und CopyRect können auf solchen Druckern fehlschlagen.


TPrinter::Capabilities

TPrinter

Die Eigenschaft Capabilities enthält die aktuellen Einstellungen eines Drukkertreibers.

__property TPrinterCapabilities Capabilities;

Beschreibung

Capabilities gibt über die Einstellungen des Druckers Auskunft. Die Eigenschaft gibt die Ausrichtung, die Anzahl der Kopien und die Sortierung an.


TPrinter::Copies

TPrinter

Die Eigenschaft Copies gibt die Anzahl der gedruckten Kopien an.

__property int Copies;

Beschreibung

Copies gibt die Anzahl der gedruckten Kopien zurück.


TPrinter::Fonts

TPrinter

Die Eigenschaft Fonts beinhaltet eine Liste von Schriften, die vom aktuellen Drucker unterstützt werden.

__property Classes::TStrings* Fonts;

Beschreibung

Mit Fonts können Sie ermitteln, welche Schriften der Drucker unterstützt. Die Liste enthält auch TrueType-Schriften, die vom Drucker ursprünglich nicht unterstützt werden, da die Windows-GDI (Graphics Device Interface) in der Lage ist, TrueType-Schriften exakt zu zeichnen, wenn sie in einem Druckauftrag verwendet werden.


TPrinter::Handle

TPrinter

Die Eigenschaft Handle dient dem Zugriff auf das Handle des Druckerobjekts.

__property HDC Handle;

Beschreibung

Mit Handle erhalten Sie Zugriff auf das Handle des Druckerobjekts.


TPrinter::Orientation

TPrinter

Die Eigenschaft Orientation legt fest, ob der Druckauftrag im Hoch- oder im Querformat ausgedruckt wird.

__property TPrinterOrientation Orientation;

Beschreibung

Orientation legt fest, ob ein Druckauftrag im Hoch- oder im Querformat ausgeführt wird.

Diese Eigenschaft ist vom Typ TPrinterOrientation. Die folgende Tabelle enthält die möglichen Werte für TPrinterOrientation:

Wert	Bedeutung

poPortrait	Der Druckauftrag wird im Hochformat gedruckt.

poLandscape	Der Druckauftrag wird im Querformat gedruckt.


TPrinter::PageHeight

TPrinter	Siehe auch

Die Eigenschaft PageHeight enthält die Höhe der momentan gedruckten Seite in Pixel.

__property int PageHeight;

Beschreibung

Mit PageHeight können Sie die Höhe der momentan gedruckten Seite in Pixel ermitteln.


TPrinter::PageNumber

TPrinter	Siehe auch

Die Eigenschaft PageNumber enthält die Seitennummer der momentan gedruckten Seite.

__property int PageNumber;

Beschreibung

Mit PageNumber können Sie die Nummer der momentan gedruckten Seite ermitteln. PageNumber wird bei jedem Aufruf der Methode NewPage hochgezählt.

Hinweis

Bei Textvariablen wird diese Eigenschaft auch inkrementiert, wenn die letzte Zeile einer Seite ein CR enthält.


TPrinter::PageWidth

TPrinter	Siehe auch

Die Eigenschaft PageWidth enthält die Breite der momentan gedruckten Seite in Pixel.

__property int PageWidth;

Beschreibung

Mit PageWidth können Sie die Breite der momentan gedruckten Seite in Pixel ermitteln.


TPrinter::PrinterIndex

TPrinter	Siehe auch

Die Eigenschaft PrinterIndex gibt an, welcher der in der Eigenschaft Printers aufgeführten Drucker momentan ausgewählt ist.

__property int PrinterIndex;

Beschreibung

Der Wert der Eigenschaft PrinterIndex ist der aktuell ausgewählte Drucker. Wenn sich dieser Wert ändert, wird automatisch EndDoc aufgerufen. Um den Standarddrucker auszuwählen, setzen Sie PrinterIndex auf -1.

Die Liste der installierten Drucker können Sie der Eigenschaft Printers entnehmen. Eine Liste der vom Drucker unterstützten Schriften finden Sie in der Eigenschaft Fonts.


TPrinter::Printers

TPrinter	Siehe auch

Die Eigenschaft Printers enthält eine Liste aller Drucker, die unter Windows installiert sind.

__property Classes::TStrings* Printers;

Beschreibung

Diese Eigenschaft enthält eine Liste der installierten Drucker. Der Wert der Eigenschaft PrinterIndex entspricht dem aktuell ausgewählten Drucker. Eine Liste der vom Drucker unterstützten Schriften finden Sie in der Eigenschaft Fonts.


TPrinter::Printing

TPrinter	Siehe auch

Die Eigenschaft Printing zeigt an, ob ein Druckauftrag bearbeitet wird.

__property bool Printing;

Beschreibung

Mit Printing können Sie ermitteln, ob ein Druckauftrag bearbeitet wird.

Printing ist True, wenn die Anwendung die Methode BeginDoc aufgerufen hat, die Methode EndDoc (oder die Methode Abort) jedoch noch nicht aufgerufen wurde.


TPrinter::Title

TPrinter

Die Eigenschaft Title legt fest, welcher Text im Druckmanager und auf den Header-Seiten im Netzwerk angezeigt wird.

__property System::AnsiString Title;

Beschreibung

Title wird im Druckmanager von Windows und für Header-Seiten im Netzwerk benutzt.


Methoden von TPrinter

TPrinter	Alphabetisch

In TPrinter

~TPrinter

Abort

BeginDoc

EndDoc

GetPrinter

NewPage

SetPrinter

TPrinter

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TPrinter

TPrinter	Nach Objekten

~TPrinter

Abort

BeginDoc

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

EndDoc

FieldAddress

FreeInstance

Free

GetPrinter

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance

NewPage

SetPrinter

TPrinter


TPrinter::~TPrinter

TPrinter	Siehe auch

Der Destruktor ~TPrinter gibt den Speicher frei, der für das TPrinter-Objekt reserviert war. Rufen Sie ~TPrinter nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TPrinter automatisch aufgerufen wird.

__fastcall virtual ~TPrinter(void);

Beschreibung

~TPrinter überprüft, ob alle Druckaufträge bearbeitet sind, und gibt dann die zugehörigen Ressourcen frei. Dann wird der Drucker geschlossen und der Destruktor des übergeordneten Objekts aufgerufen.


TPrinter::Abort

TPrinter	Siehe auch

Die Methode Abort beendet die Ausführung eines Druckauftrags. Alle nicht gedruckten Daten gehen dabei verloren.

void __fastcall Abort(void);

Beschreibung

Mit Abort können Sie einen Druckauftrag vorzeitig beenden. Verwenden Sie ansonsten die Methode EndDoc. Wenn Sie Abort verwenden wollen, müssen Sie dem uses-Abschnitt Ihrer Unit die Unit Printers hinzufügen.

Wenn Abort aufgerufen wird, wird der Drucker auf den nächsten Druckauftrag vorbereitet.


TPrinter::BeginDoc

TPrinter	Siehe auch

Die Methode BeginDoc sendet einen Druckauftrag an den Drucker.

void __fastcall BeginDoc(void);

Beschreibung

Wenn Sie BeginDoc verwenden wollen, müssen Sie dem uses-Abschnitt Ihrer Unit die Unit Printers hinzufügen.

Wenn der Druckauftrag erfolgreich gesendet wurde, sollte die Anwendung EndDoc aufrufen, um den Druckauftrag zu beenden. Der Druckauftrags wird erst gedruckt, wenn EndDoc aufgerufen wurde.


TPrinter::EndDoc

TPrinter	Siehe auch

Die Methode EndDoc beendet den aktuellen Druckauftrag und schließt die Textdatei-Variable.

void __fastcall EndDoc(void);

Beschreibung

EndDoc beendet den Druckauftrag und schließt die aktuell geöffnete Variable Text. Nach dem Aufruf von EndDoc wird der Druckauftrag vom Drucker bearbeitet.

Sobald die Anwendung EndDoc aufgerufen hat, beginnt der Drucker mit dem Druckvorgang. Rufen Sie EndDoc auf, wenn ein Druckauftrag erfolgreich an den Drucker gesendet wurde. Wurde der Druckauftrag nicht korrekt bearbeitet, verwenden Sie die Methode Abort.

Die Methode TForm::Close ruft EndDoc auf.


TPrinter::GetPrinter

TPrinter	Siehe auch

Die Methode GetPrinter ermittelt den aktuellen Drucker.

void __fastcall GetPrinter(char * ADevice, char * ADriver, char * APort, int &ADeviceMode);

Beschreibung

GetPrinter braucht nicht direkt aufgerufen zu werden. Verwenden Sie für den Zugriff auf einen Drucker das Array der Eigenschaft Printers. Weitere Informationen finden Sie unter CreateDC in der Hilfedatei WIN32.HLP.


TPrinter::NewPage

TPrinter	Siehe auch

Die Methode NewPage beginnt eine neue Seite und zählt den Wert der Eigenschaft PageNumber hoch.

void __fastcall NewPage(void);

Beschreibung

NewPage bewirkt, daß der Drucker den aktuellen Druckauftrag auf einer neuen Seite fortsetzt.

Die Methode zählt den Wert der Eigenschaft PageNumber hoch und setzt den Wert der Eigenschaft Pen der Zeichenfläche auf (0,0) zurück.


TPrinter::SetPrinter

TPrinter	Siehe auch

Die Methode SetPrinter legt einen Drucker als aktuellen Drucker fest.

void __fastcall SetPrinter(char * ADevice, char * ADriver, char * APort, int ADeviceMode);

Beschreibung

SetPrinter braucht nicht direkt aufgerufen zu werden. Verwenden Sie für den Zugriff auf einen Drucker das Array der Eigenschaft Printers. Weitere Informationen finden Sie in der Beschreibung der API-Funktion CreateDC.


TPrinter::TPrinter

TPrinter	Siehe auch

Der Konstruktor instantiiert ein Drucker-Objekt.

__fastcall TPrinter(void);

Beschreibung

TPrinter wird automatisch aufgerufen, um einen Drucker in der Variable Printer zu instantiieren. TPrinter reserviert den nötigen Speicher und ruft den Konstruktor des übergeordneten Objekts auf. Anschließend werden der korrekte Treiber, das Gerät und die Schnittstelle eingestellt.


Zugriff

Read-only


Hierarchie

TObject


TPrinter Beispiel

TPrinter


 TPrinterSetupDialog

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/dialogs.hpp

Die Komponente TPrinterSetupDialog erzeugt ein Dialogfeld, mit dem Drukker konfiguriert werden können.

Beschreibung

TPrinterSetupDialog zeigt das Standard-Dialogfeld an, mit dem unter Windows Drucker konfiguriert werden können. Zur Laufzeit wird der Dialog erst angezeigt, wenn er durch einen Aufruf der Methode Execute aktiviert wird.


Eigenschaften von TPrinterSetupDialog

TPrinterSetupDialog	Alphabetisch	Legende

Abgeleitet von TCommonDialog

Ctl3D

HelpContext

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Name

Owner

Tag


Eigenschaften von TPrinterSetupDialog

TPrinterSetupDialog	Nach Objekten	Legende

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

Ctl3D

DesignInfo

HelpContext

Name

Owner

Tag


Methoden von TPrinterSetupDialog

TPrinterSetupDialog	Alphabetisch

In TPrinterSetupDialog

~TPrinterSetupDialog

Execute

TPrinterSetupDialog

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TPrinterSetupDialog

TPrinterSetupDialog	Nach Objekten

~TPrinterSetupDialog

Assign

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

DestroyComponents

Destroying

Dispatch

Execute

FieldAddress

FindComponent

FreeInstance

FreeNotification

Free

GetParentComponent

HasParent

InheritsFrom

InitInstance

InsertComponent

InstanceSize

MethodAddress

MethodName

NewInstance

RemoveComponent

TPrinterSetupDialog


TPrinterSetupDialog::~TPrinterSetupDialog

TPrinterSetupDialog

Der Destruktor ~TPrinterSetupDialog gibt den Speicher frei, der für das TPrinterSetupDialog-Objekt reserviert war. Rufen Sie ~TPrinterSetupDialog nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TPrinterSetupDialog automatisch aufgerufen wird.

__fastcall virtual ~TPrinterSetupDialog(void);


TPrinterSetupDialog::Execute

TPrinterSetupDialog

Die Methode Execute zeigt das Dialogfeld für die Konfiguration von Drukkern an.

void __fastcall Execute(void);

Beschreibung

Die Methode Execute öffnet das Dialogfeld für die Druckereinrichtung und gibt True zurück, wenn der Anwender auf OK klickt.


TPrinterSetupDialog::TPrinterSetupDialog

TPrinterSetupDialog

Der Konstruktor TPrinterSetupDialog erzeugt ein neues TPrinterSetupDialog-Objekt.

__fastcall virtual TPrinterSetupDialog(Classes::TComponent* AOwner);


Gültigkeitsbereich

Published

Zugriff

Read-only


Hierarchie

TObject

TPersistent

TComponent

TCommonDialog


TPrinterSetupDialog Beispiel

TPrinterSetupDialog


 TQuery

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/dbtables.hpp

TQuery kapselt eine Datenmenge mit einer Ergebnismenge, die aus einer SQL-Anweisung resultiert.

Beschreibung

Mit TQuery können Sie mit Hilfe von SQL-Anweisungen auf eine Datenbank zugreifen. Abfragekomponenten können mit Paradox-, dBASE-, Access-, FoxPro- und ODBC-konformen Datenbanken sowie mit Remote-Datenbank-Servern wie Sybase, SQL Server, Oracle, Informix, DB2 und InterBase verwendet werden.

Abfragekomponenten sind aus folgenden Gründen nützlich:

•	Sie können auf mehrere Tabellen gleichzeitig zugreifen (wird in SQL als "Join" bezeichnet).

•	Sie können automatisch auf eine Untermenge der Zeilen und Spalten der zugrundeliegenden Tabellen zugreifen und müssen nicht alle Zeilen und Spalten abrufen.

Hinweis

TQuery ist bei der Entwicklung skalierbarer Datenbankanwendungen besonders wichtig. Soll eine Anwendung, die ursprünglich für lokale Datenbanken entwickelt wurde, später für einen Remote-Datenbank-Server verwendet werden, verwenden Sie die Komponenten von TQuery. Dadurch wird die spätere Skalierung vereinfacht.


Eigenschaften von TQuery

TQuery	Alphabetisch	Legende

In TQuery

Constrained

DataSource

Local

ParamCheck

ParamCount

Params

Prepared

RequestLive

RowsAffected

SQL

SQLBinary

StmtHandle

Text

UniDirectional

Abgeleitet von TDBDataSet

DBHandle

DBLocale

DBSession

SessionName

UpdateMode

Abgeleitet von TDataSet

Active

AutoCalcFields

BOF

Bookmark

DefaultFields

Designer

EOF

FieldCount

FieldDefs

Fields

FieldValues

Found

Modified

State

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TQuery

TQuery	Nach Objekten	Legende

Active

AutoCalcFields

BOF

Bookmark

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

Constrained

DataSource

DBHandle

DBLocale

DBSession

DefaultFields

Designer

DesignInfo

EOF

FieldCount

FieldDefs

Fields

FieldValues

Found

Local

Modified

Owner

ParamCheck

ParamCount

Params

Prepared

RequestLive

RowsAffected

SessionName

SQLBinary

SQL

State

StmtHandle

Tag

Text

UniDirectional

UpdateMode


TQuery::Constrained

TQuery	Siehe auch

Die Eigenschaft Constrained zeigt an, ob Aktualisierungen und Einfügungen für Paradox- und dBASE-Tabellen zulässig sind, die der von der Anweisung SELECT erzeugten Ergebnismenge nicht entsprechen.

__property bool Constrained;

Beschreibung

Mit Constrained können Sie bestimmen, ob mit den Anweisungen UPDATE und INSERT eine Paradox- oder dBASE-Tabelle geändert werden kann. Die Tabelle liegt einer Ergebnismenge zugrunde, wenn die Anweisung UPDATE oder INSERT einen oder mehrere Werte enthält, die nicht den Bedingungen der Klausel WHERE der die Ergebnismenge erzeugenden Anweisung SELECT entspricht. Constrained kann nur für aktualisierbare Ergebnismengen verwendet werden.

Hat Constrained den Wert False (Vorgabe), sind Aktualisierungen und Einfügungen unabhängig von der Anweisung SELECT zulässig. Bei True sind Aktualisierungen und Einfügungen nicht erlaubt, wenn sie die Kriterien der Anweisung SELECT verletzen, von der die Ergebnismenge erzeugt wurde.

Hat beispielsweise Constrained den Wert True und die Eigenschaft SQL einer Abfrage folgenden Wert:

SELECT * FROM CUSTOMERS

  WHERE (CUSTNO > 1400 AND CUSTNO < 1500)

ist die folgende UPDATE-Anweisung nicht zulässig:

UPDATE CUSTOMERS

  SET COMPANY = “Deep Diver“

  WHERE CUSTNO = 1567


TQuery::DataSource

TQuery	Siehe auch

Mit der Eigenschaft DataSource können Sie die Datenquelle festlegen, der aktuelle Feldwerte entnommen werden, um anderweitig nicht zugeordnete Parameter in die SQL-Anweisung der Abfrage aufzunehmen.

__property Db::TDataSource* DataSource;

Beschreibung

Weisen Sie der Eigenschaft DataSource den Namen der Datenquelle zu, der aktuelle Feldwerte entnommen werden, um anderweitig nicht zugeordnete Parameter in die SQL-Anweisung der Eigenschaft SQL dieser Komponente aufzunehmen. DataSource darf nicht auf diese Abfrage, sondern muß auf eine andere Datenmenge zeigen.

Die in DataSource angegebene Datenmenge muß erstellt und geöffnet werden, bevor die Parameter zugeordnet werden können. Parameter können zugeordnet werden, indem Sie vor der Abfrage die Methode Prepare der Abfrage aufrufen.

Tip

DataSource wird besonders häufig verwendet, wenn mit einer Abfrage eine Haupt-Detail-Beziehung zwischen Tabellen erstellt wird. Außerdem kann mit der Eigenschaft sichergestellt werden, daß Parameter zugeordnet werden, die in der Eigenschaft Params oder mit der Methode ParamByName noch nicht gesetzt wurden.

Falls die von einer SQL-Abfrage verwendete Anweisung keine Parameter enthält oder alle Parameter mit der Eigenschaft Params oder der Methode ParamByName zugeordnet werden, muß der Eigenschaft DataSource kein Wert zugewiesen werden.


TQuery::Local

TQuery	Siehe auch

Die Eigenschaft Local gibt an, ob sich eine Abfrage auf eine oder mehrere Paradox- oder dBASE-Tabellen und nicht auf die SQL-Tabellen eines Remote-Servers bezieht.

__property bool Local;

Beschreibung

Mit Local können Sie bestimmen, ob eine Abfrage auf eine oder mehrere Paradox- oder dBASE-Tabellen oder auf SQL-Tabellen zugreift. Hat Local den Wert True, bezieht sich die Abfrage nur auf dBASE oder Paradox. Andernfalls hat Local den Wert False. Die Eigenschaft wird automatisch gesetzt, wenn in einer Anwendung vor der Abfrage die Methode Prepare der Abfrage aufgerufen wird.

Einige Eigenschaften von Abfragen, wie z. B. Constrained, beziehen sich nur auf Abfragen für Paradox- und dBASE-Tabellen. Andere Einstellungen haben nur für Abfragen von Remote-SQL-Server eine Bedeutung. Local stellt Informationen bereit, wenn der Programmablauf aufgrund des verwendeten Datenbanktyps verzweigt werden soll. Mit der Eigenschaft kann auch bestimmt werden, ob eine Abfrage von der BDE mit der lokalen Abfrage-Engine durchgeführt oder die SQL-Anweisungen direkt an einen Remote-Server weitergeleitet wurden.


TQuery::ParamCheck

TQuery	Siehe auch

Mit der Eigenschaft ParamCheck können Sie festlegen, ob die Parameterliste für eine Abfrage aktualisiert wird, wenn die Eigenschaft SQL zur Laufzeit geändert wird.

__property bool ParamCheck;

Beschreibung

Mit ParamCheck können Sie festlegen, ob die Eigenschaft Params gelöscht und neu erstellt wird, falls in einer Anwendung die Eigenschaft SQL der Abfrage zur Laufzeit geändert wird. Standardmäßig hat ParamCheck den Wert True. Dies bedeutet, daß die Eigenschaft Params zur Laufzeit automatisch neu erstellt wird. So kann sichergestellt werden, daß die benötigte Anzahl von Parametern für die aktuelle SQL-Anweisung erstellt wird.

ParamCheck kann auf False gesetzt werden, wenn in einer Anwendung nur Abfragen ohne Parameter durchgeführt werden. In allen anderen Fällen sollte ParamCheck jedoch den Wert True enthalten.


TQuery::ParamCount

TQuery	Siehe auch

Die Eigenschaft ParamCount gibt die aktuelle Anzahl der Parameter der Abfrage an.

__property unsigned short ParamCount;

Beschreibung

Mit ParamCount können Sie bestimmen, wie viele Parameter in der Eigenschaft Params enthalten sind. Hat die Eigenschaft ParamCheck den Wert True, entspricht ParamCount immer der Anzahl der Parameter in der SQL-Anweisung der Abfrage.

In einer Anwendung können Parameter in die Eigenschaft Params eingefügt oder aus der Eigenschaft gelöscht werden. Solche Einfügungen und Löschungen wirken sich automatisch auf ParamCount aus.


TQuery::Params

TQuery	Siehe auch

Die Eigenschaft Params enthält die Parameter für die SQL-Anweisung einer Abfrage.

__property TParams* Params;

Beschreibung

Mit Params können Sie die Namen, Werte und Datentypen der Parameter zur Laufzeit dynamisch abrufen und einstellen. Um die Parameter während des Entwurfs einzustellen, verwenden Sie den Editor für Abfrageparameter. Params ist ein Array mit Parameterdatensätzen. Index gibt das Element des Arrays an, auf das zugegriffen wird.

Hinweis

Sind die Namen aller Parameter bekannt, können ihre Werte mit ParamByName einfacher eingestellt und abgerufen werden. Mit ParamByName können Sie jedoch nicht den Datentyp oder den Namen des Parameters ändern.


TQuery::Prepared

TQuery	Siehe auch

Mit der Eigenschaft Prepared können Sie bestimmen, ob eine Abfrage zur Ausführung vorbereitet wurde.

__property bool Prepared;

Beschreibung

Mit Prepared können Sie bestimmen, ob eine Abfrage bereits zur Ausführung vorbereitet wurde. Hat Prepared den Wert True, wurde die Abfrage vorbereitet. Andernfalls ist die Abfrage nicht bereit. Eine Abfrage muß vor ihrer Durchführung nicht vorbereitet werden. Sie können jedoch die Leistungsfähigkeit erweitern, wenn Sie die Abfrage vorbereiten. Dies gilt besonders, wenn eine Abfrage mit Parametern mehrere Male mit den selben Paramterwerten ausgeführt wird.

Hinweis

Die aktuelle Einstellung von Prepared kann in einer Anwendung geändert werden. Hat Prepared den Wert True, wird bei der Umstellung auf False die Methode UnPrepare aufgerufen, und die Vorbereitung wird rückgängig gemacht. Hat Prepared den Wert False, wird bei der Umstellung auf True die Methode Prepare aufgerufen, und die Abfrage wird vorbereitet.  Sie sollten im Programm Prepare und UnPrepare direkt aufrufen. Mit dieser Methode wird die Eigenschaft Prepared automatisch aktualisiert.


TQuery::RequestLive

TQuery	Siehe auch

Mit der Eigenschaft RequestLive können Sie festlegen, ob bei der Ausführung der Abfrage von der Borland Database Engine eine aktualisierbare Ergebnismenge geliefert werden soll.

__property bool RequestLive;

Beschreibung

Mit RequestLive können Sie festlegen, ob von der BDE eine aktualisierbare Ergebnismenge an die Anwendung zurückgegeben werden soll. Standardmäßig hat RequestLive den Wert False. Dies bedeutet, daß bei der Abfrage eine Ergebnismenge zurückgegeben wird, die nicht bearbeitet werden kann.

Durch Einstellen von Request auf True können Sie eine aktualisierbare Ergebnismenge anfordern. Dadurch wird jedoch nicht garantiert, daß von der BDE eine aktualisierbare Ergebnismenge zurückgegeben wird. Es wird lediglich versucht, eine aktualisierbare Ergebnismenge abzurufen. Eine aktualisierbare Ergebnismenge wird von der BDE nur zurückgegeben, wenn die Syntax der SELECT-Anweisung in der Abfrage den Anforderungen für eine aktualisierbare Ergebnismenge entspricht.

Hat RequestLive den Wert True, aber entspricht die Syntax den Anforderungen nicht, wird bei Paradox und dBASE von der BDE eine Ergebnismenge zurückgegeben, die nur gelesen werden kann. Bei Remote-Servern wird ein Fehlercode zurückgegeben.


TQuery::RowsAffected

TQuery	Siehe auch

Mit der Eigenschaft RowsAffected können Sie die Anzahl der Zeilen ermitteln, die in der letzten Abfrage verarbeitet wurden.

__property int RowsAffected;

Beschreibung

Mit RowsAffected können Sie bestimmen, wie viele Zeilen bei der letzten Abfrage aktualisiert oder gelöscht wurden. Hat die Eigenschaft den Wert -1, wurden keine Zeilen aktualisiert oder gelöscht.


TQuery::SQL

TQuery	Siehe auch

Die Eigenschaft SQL enthält den Text der SQL-Anweisung für die Abfrage.

__property Classes::TStrings* SQL;

Beschreibung

Mit SQL können Sie die SQL-Anweisung angeben, die beim Aufruf der Methode ExecSQL oder Open einer Abfragekomponente ausgeführt wird. Während des Entwurfs kann die Eigenschaft SQL bearbeitet werden, indem im Objektinspektor der Editor für Stringlisten aufgerufen wird.

Hinweis

In Borland C++Builder Client/Server können auszuführende SQL-Anweisungen von Entwicklern auch mit dem Visual Query Builder erstellt werden.

Mit der Eigenschaft SQL können Sie auf folgende Tabellen bzw. Datenbanken zugreifen:

•	Paradox- und dBASE-Tabellen, mit Hilfe des lokalen SQL. Die zulässige Syntax ist eine Untermenge von ANSI-SQL und enthält die Anweisungen SELECT, INSERT, UPDATE und DELETE.

•	Datenbanken auf dem lokalen InterBase-Server, mit Hilfe von SQL-92 und den InterBase-Erweiterungen zur SQL-Syntax. Informationen über die Syntax und die Einschränkungen finden Sie in der InterBase Language Reference.

•	Datenbanken auf Remote-Datenbank-Servern (nur Borland C++Builder-Client/Server), mit Hilfe der entsprechenden SQL Links-Treiber. Im SQL-Dialekt des Servers sind alle Standardanweisungen zulässig. Informationen über die SQL-Syntax und die Einschränkungen finden Sie in der Server-Dokumentation.

Die in die Eigenschaft SQL eingefügte SQL-Anweisung kann entsprechend den Standardkonventionen von SQL-92 Parameter enthalten. Die Parameter werden in der Eigenschaft Params erstellt und gespeichert.

Um eine SQL-Anweisung zur Laufzeit anzugeben, gehen Sie wie folgt vor:

1	Beenden Sie die Abfrage mit Close, falls sie aktiv ist.

2	Löschen Sie die Eigenschaft SQL mit Clear.

3	Geben Sie mit Add den neuen Text an, oder weisen Sie der Eigenschaft SQL mit LoadFromFile den Text einer SQL-Skriptdatei zu.

4	Richten Sie mit der Methode ParamByName alle Parameter für die Abfrage ein, falls diese benötigt werden.

5	Bereiten Sie die Abfrage mit Prepare zur Ausführung vor.

6	Starten Sie die Abfrage mit ExecSQL oder Open.

Hinweis

Die Eigenschaft SQL muß eine vollständige SQL-Anweisung enthalten. Im allgemeinen sind mehrere Anweisungen (Stapelanweisung) nur zulässig, wenn dies vom verwendeten Server unterstützt wird.


TQuery::SQLBinary

TQuery	Siehe auch

Die Eigenschaft SQLBinary zeigt auf einen binären Daten-Stream, der eine SQL-Abfrageanweisung oder eine Ergebnismenge repräsentiert.

__property char * SQLBinary;

Beschreibung

Greifen Sie auf SQLBinary nicht zu. Die Eigenschaft enthält einen internen binären Daten-Stream, mit dessen Hilfe die Abfragekomponente direkt mit der Borland Database Engine kommunizieren kann. Um die von dieser Abfragekomponente ausgeführte SQL-Anweisung abzurufen oder zu setzen, verwenden Sie die Eigenschaft SQL. Um die Parameter einer SQL-Anweisung abzurufen oder einzustellen, verwenden Sie die Eigenschaft Params.


TQuery::StmtHandle

TQuery

Die Eigenschaft StmtHandle bezeichnet das Anweisungs-Handle der Borland Database Engine (BDE) für die Abfrage.

__property Bde::hDBIStmt StmtHandle;

Beschreibung

Rufen Sie StmtHandle ab, falls die BDE in einer Anwendung direkt aufgerufen wird. Dadurch können Sie die Methoden von TQuery übergehen. Für einige Aufrufe der BDE-API ist ein Anweisungs-Handle als Parameter erforderlich. In allen anderen Fällen wird diese Eigenschaft nicht benötigt.


TQuery::Text

TQuery	Siehe auch	Beispiel

Die Eigenschaft Text zeigt auf den Text der SQL-Abfrage, die an die Borland Database Engine (BDE) übergeben wird.

__property System::AnsiString Text;

Beschreibung

Die Eigenschaft Text kann nicht bearbeitet werden. Mit ihr können Sie den tatsächlichen Inhalt der SQL-Anweisung bestimmen, die der BDE übergeben wird. Bei Abfragen mit Parametern enthält Text die SQL-Anweisung zusammen mit den Parameterwerten.

Im allgemeinen muß die Eigenschaft Text nicht abgerufen werden. Um die SQL-Anweisung der Abfrage abzurufen oder zu ändern, verwenden Sie die Eigenschaft SQL. Um die Parameter zu ermitteln oder zu bearbeiten, verwenden Sie die Eigenschaft Params.


TQuery::UniDirectional

TQuery

Mit der Eigenschaft UniDirectional können Sie bestimmen, ob der bidirektionale Cursor der Borland Database Engine für die Ergebnismenge einer Abfrage aktiviert ist.

__property bool UniDirectional;

Beschreibung

Mit UniDirectional können Sie steuern, ob ein BDE-Cursor in einer Ergebnismenge in beide Richtungen verschoben werden kann. Standardmäßig hat Unidirectional den Wert False, und der Cursor kann in beide Richtungen verschoben werden.

Hinweis

Ursprünglich kann ein SQL-Cursor in einer Datenmenge nur vorwärts bewegt werden. Durch die Zwischenspeicherung von Datensätzen ist in der BDE auch die Verschiebung in der anderen Richtung möglich. Muß der Cursor in einer Ergebnismenge nicht in beide Richtungen bewegt werden, setzen Sie UniDirectional auf True. In diesem Fall ist für eine Anwendung weniger Speicher erforderlich, und die Leistung wird verbessert.


Ereignisse von TQuery

TQuery	Alphabetisch	Legende

Abgeleitet von TDataSet

AfterCancel

AfterClose

AfterDelete

AfterEdit

AfterInsert

AfterOpen

AfterPost

BeforeCancel

BeforeClose

BeforeDelete

BeforeEdit

BeforeInsert

BeforeOpen

BeforePost

OnCalcFields

OnDeleteError

OnEditError

OnFilterRecord

OnNewRecord

OnPostError


Ereignisse von TQuery

TQuery	Nach Objekten	Legende

AfterCancel

AfterClose

AfterDelete

AfterEdit

AfterInsert

AfterOpen

AfterPost

BeforeCancel

BeforeClose

BeforeDelete

BeforeEdit

BeforeInsert

BeforeOpen

BeforePost

OnCalcFields

OnDeleteError

OnEditError

OnFilterRecord

OnNewRecord

OnPostError


Methoden von TQuery

TQuery	Alphabetisch

In TQuery

~TQuery

ExecSQL

ParamByName

Prepare

TQuery

UnPrepare

Abgeleitet von TDBDataSet

CheckOpen

Abgeleitet von TDataSet

ActiveBuffer

Append

AppendRecord

CheckBrowseMode

ClearFields

Close

ControlsDisabled

CursorPosChanged

Delete

DisableControls

Edit

EnableControls

FieldByName

FindField

FindFirst

FindLast

FindNext

FindPrior

First

FreeBookmark

GetBookmark

GetFieldList

GetFieldNames

GotoBookmark

Insert

InsertRecord

IsLinkedTo

Last

MoveBy

Next

Open

Post

Prior

Refresh

Resync

SetFields

UpdateCursorPos

UpdateRecord

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TQuery

TQuery	Nach Objekten

~TQuery

ActiveBuffer

AppendRecord

Append

Assign

CheckBrowseMode

CheckOpen

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

ClearFields

Close

ControlsDisabled

CursorPosChanged

DefaultHandler

Delete

DestroyComponents

Destroying

DisableControls

Dispatch

Edit

EnableControls

ExecSQL

FieldAddress

FieldByName

FindComponent

FindField

FindFirst

FindLast

FindNext

FindPrior

First

FreeBookmark

FreeInstance

FreeNotification

Free

GetBookmark

GetFieldList

GetFieldNames

GetParentComponent

GotoBookmark

HasParent

InheritsFrom

InitInstance

InsertComponent

InsertRecord

Insert

InstanceSize

IsLinkedTo

Last

MethodAddress

MethodName

MoveBy

NewInstance

Next

Open

ParamByName

Post

Prepare

Prior

Refresh

RemoveComponent

Resync

SetFields

TQuery

UnPrepare

UpdateCursorPos

UpdateRecord


TQuery::~TQuery

TQuery	Siehe auch

Der Destruktor ~TQuery gibt den Speicher frei, der für das TQuery-Objekt reserviert war. Rufen Sie ~TQuery nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TQuery automatisch aufgerufen wird.

__fastcall virtual ~TQuery(void);

Beschreibung

~TQuery trennt die Verbindung zum Server, löscht die Liste der SQL-Anweisungen, die Parameterliste, die Datenverbindung und den binären Speicherbereich für SQL. Anschließend wird der Destruktor des übergeordneten Objekts aufgerufen.


TQuery::ExecSQL

TQuery	Siehe auch

Mit der Methode ExecSQL können Sie die SQL-Anweisung der Abfrage ausführen.

void __fastcall ExecSQL(void);

Beschreibung

Mit ExecSQL können Sie die Anweisung INSERT, UPDATE oder DELETE ausführen, die die Eigenschaft SQL enthält. Mit ExecSQL können auch Anweisungen zu Datendefinitionen ausgeführt werden.

Hinweis

Für die SELECT-Anweisung verwenden Sie statt ExecSQL die Methode Open.

Mit ExecSQL können Sie die Anweisung der Eigenschaft SQL auf die Ausführung vorbereiten, falls dies noch nicht geschehen ist. Um die Leistung zu erhöhen, sollte vor dem ersten Aufruf von ExecSQL die Methode Prepare aufgerufen werden.


TQuery::ParamByName

TQuery	Siehe auch

Mit der Eigenschaft ParamByName können Sie über den Parameternamen auf die Daten des Parameters zugreifen.

TParam* __fastcall ParamByName(const System::AnsiString Value);

Beschreibung

Mit ParamByName können Sie die Daten eines bestimmten Parameters über seine Namen abrufen und einstellen. Value ist der Name des Parameters, dessen Daten abgerufen werden sollen. Mit ParamByName können Sie den Wert eines Parameters zur Laufzeit einstellen. Mit der folgenden Anweisung können Sie beispielsweise den aktuellen Wert des Parameters „Contact“ in ein Eingabefeld abrufen:

Edit1.Text := Query1.ParamsByName('Contact').AsString;


TQuery::Prepare

TQuery	Siehe auch

Mit der Methode Prepare können Sie eine Abfrage an die Borland Database Engine (BDE) und den Server übermitteln, damit diese vor der Ausführung optimiert wird.

void __fastcall Prepare(void);

Beschreibung

Mit Prepare können Sie Ressourcen für die BDE und einen Remote-Datenbank-Server für die Abfrage reservieren und zusätzliche Optimierungen durchführen. Wenn Sie vor der Ausführung einer Abfrage Prepare aufrufen, können Sie die Leistung einer Anwendung erhöhen.

Hinweis

In Borland C++Builder wird eine Abfrage automatisch für die Ausführung vorbereitet.

Für die Vorbereitung einer Abfrage werden Datenbankressourcen benötigt. Aus diesem Grund sollte die Vorbereitung einer Abfrage aufgehoben werden, nachdem die Abfrage ausgeführt wurde. Um die Vorbereitung einer Abfrage aufzuheben, verwenden Sie die Methode UnPrepare.

Hinweis

Wenn Sie den Text einer Abfrage zur Laufzeit ändern, wird die Abfrage automatisch geschlossen, und die Vorbereitung wird automatisch aufgehoben.


TQuery::TQuery

TQuery	Siehe auch

Der Konstruktor TQuery erzeugt ein neues TQuery-Objekt.

__fastcall virtual TQuery(Classes::TComponent* AOwner);

Beschreibung

Mit TQuery können Sie eine in einer Anwendung deklarierte Abfrage instantiieren. TQuery ruft den Konstruktor des übergeordneten Objekts auf, erzeugt eine leere Liste für SQL-Anweisungen und eine leere Parameterliste, weist die Behandlungsroutine für das Ereignis OnChange der Anweisungsliste zu, richtet die Datenverbindung ein und setzt die Eigenschaften RequestLive auf False, ParamCheck auf True und RowsAffected auf -1.


TQuery::UnPrepare

TQuery	Siehe auch

Mit der Methode UnPrepare können Sie die Ressourcen freigeben, die für die Vorbereitung einer Abfrage zugewiesen wurden.

void __fastcall UnPrepare(void);

Beschreibung

Mit UnPrepare können Sie die Ressourcen freigeben, die für die Vorbereitung einer Abfrage auf dem Server und den Clients zugewiesen wurden.

Hinweis

UnPrepare muß in einer Anwendung aufgerufen werden, bevor Parameter einer vorbereiteten Abfrage geändert werden. Sobald die Vorbereitung einer Abfrage aufgehoben wird, gehen alle aktuellen Parameterdaten verloren.

Für die Vorbereitung einer Abfrage werden Datenbankressourcen benötigt. Aus diesem Grund sollte die Vorbereitung einer Abfrage aufgehoben werden, nachdem die Abfrage ausgeführt wurde. Um die Vorbereitung einer Abfrage aufzuheben, verwenden Sie die Methode UnPrepare.

Hinweis

Wenn Sie den Text einer Abfrage zur Laufzeit ändern, wird die Abfrage automatisch geschlossen, und die Vorbereitung wird automatisch aufgehoben.


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TDataSet

TDBDataSet


TQuery Beispiel

TQuery


 TRadioButton

Hierarchie	Eigenschaften	Methoden	Ereignisse

Header

vcl/stdctrls.hpp

Die Komponente TRadioButtion ist ein Windows-Optionsfeld. Mit Hilfe von Optionsfeldern können Sie dem Benutzer eine Reihe von Optionen anbieten, die sich gegenseitig ausschließen und von denen immer nur eine zur selben Zeit aktiviert werden kann. Wenn der Benutzer auf ein Optionsfeld klickt, wird das Optionsfeld, das bisher aktiviert war, deaktiviert.

Beschreibung

Optionsfelder werden gewöhnlich in einem Gruppenfeld (TGroupBox) zusammengefaßt. Plazieren Sie zuerst das Gruppenfeld im Formular. Wählen Sie dann in der Komponentenpalette die Optionsfelder aus und fügen sie in das Gruppenfeld ein.

Die Eigenschaft Caption enthält den Text, der zum Optionsfeld gehört und seinen Zweck angibt.

Wenn der Benutzer auf ein Optionsfeld klickt, ändert sich der Wert der Eigenschaft Checked. Zugleich wird das Ereignis OnClick ausgelöst. Wenn Sie ein Optionsfeld aktivieren, werden alle anderen Optionsfelder seiner Gruppe deaktiviert. Standardmäßig gehören alle Optionsfelder, die in einem fensterorientierten Container enthalten sind (z.B. in TForm, TGroupBox oder TPanel), zur selben Gruppe. Zwei Optionsfelder in einem Formular können beispielsweise nur dann gleichzeitig aktiviert werden, wenn sie in separaten Containern (z.B. in zwei unterschiedlichen Gruppenfeldern) enthalten sind.


Eigenschaften von TRadioButton

TRadioButton	Alphabetisch	Legende

In TRadioButton

Alignment

Checked

Abgeleitet von TWinControl

Brush

ClientOrigin

ClientRect

ControlCount

Controls

Ctl3D

Handle

HelpContext

ParentCtl3D

Showing

TabOrder

TabStop

Abgeleitet von TControl

Align

BoundsRect

Caption

ClientHeight

ClientWidth

Color

ControlState

ControlStyle

Cursor

DragCursor

DragMode

Enabled

Font

Height

Hint

Left

Name

Parent

ParentColor

ParentFont

ParentShowHint

PopupMenu

ShowHint

Top

Visible

Width

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TRadioButton

TRadioButton	Nach Objekten	Legende

Alignment

Align

BoundsRect

Brush

Caption

Checked

ClientHeight

ClientOrigin

ClientRect

ClientWidth

Color

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlCount

ControlState

Controls

ControlStyle

Ctl3D

Cursor

DesignInfo

DragCursor

DragMode

Enabled

Font

Handle

Height

HelpContext

Hint

Left

Name

Owner

ParentColor

ParentCtl3D

ParentFont

ParentShowHint

Parent

PopupMenu

ShowHint

Showing

TabOrder

TabStop

Tag

Top

Visible

Width


TRadioButton::Alignment

TRadioButton	Siehe auch	Beispiel

Die Eigenschaft Alignment legt die Ausrichtung der Beschriftung relativ zum Optionsfeld fest.

__property Classes::TLeftRight Alignment;

Beschreibung

Bei Optionsfeldern wird die Beschriftung innerhalb des Textbereichs immer linksbündig ausgerichtet.

Die möglichen Werte für diese Eigenschaft sind:

Wert	Bedeutung

taLeftJustify	Die Beschriftung erscheint links vom Optionsfeld.

taRightJustify	Die Beschriftung erscheint rechts vom Optionsfeld.


TRadioButton::Checked

TRadioButton	Beispiel

Die Eigenschaft Checked gibt an, ob eine Option aktiviert ist.

__property bool Checked;

Beschreibung

Die möglichen Werte für diese Eigenschaft sind:

Wert	Bedeutung

True	Im Optionsfeld wird ein schwarzer Kreis angezeigt.
Die Option ist aktiviert.

False	Im Optionsfeld wird kein schwarzer Kreis angezeigt.
Die Option ist deaktiviert.


Ereignisse von TRadioButton

TRadioButton	Alphabetisch	Legende

Abgeleitet von TWinControl

OnEnter

OnExit

OnKeyDown

OnKeyPress

OnKeyUp

Abgeleitet von TControl

OnClick

OnDblClick

OnDragDrop

OnDragOver

OnEndDrag

OnMouseDown

OnMouseMove

OnMouseUp

OnStartDrag


Ereignisse von TRadioButton

TRadioButton	Nach Objekten	Legende

OnClick

OnDblClick

OnDragDrop

OnDragOver

OnEndDrag

OnEnter

OnExit

OnKeyDown

OnKeyPress

OnKeyUp

OnMouseDown

OnMouseMove

OnMouseUp

OnStartDrag


Methoden von TRadioButton

TRadioButton	Alphabetisch

In TRadioButton

~TRadioButton

TRadioButton

Abgeleitet von TWinControl

Broadcast

CanFocus

ContainsControl

ControlAtPos

DisableAlign

EnableAlign

Focused

GetTabOrderList

HandleAllocated

HandleNeeded

InsertControl

Invalidate

PaintTo

Realign

RemoveControl

Repaint

ScaleBy

ScrollBy

SetBounds

SetFocus

Update

UpdateControlState

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

GetTextLen

Hide

Perform

Refresh

ScreenToClient

SendToBack

SetTextBuf

Show

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TRadioButton

TRadioButton	Nach Objekten

~TRadioButton

Assign

BeginDrag

BringToFront

Broadcast

CanFocus

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

ClientToScreen

ContainsControl

ControlAtPos

DefaultHandler

DestroyComponents

Destroying

DisableAlign

Dispatch

DragDrop

Dragging

EnableAlign

EndDrag

FieldAddress

FindComponent

Focused

FreeInstance

FreeNotification

Free

GetParentComponent

GetTabOrderList

GetTextBuf

GetTextLen

HandleAllocated

HandleNeeded

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InsertControl

InstanceSize

Invalidate

MethodAddress

MethodName

NewInstance

PaintTo

Perform

Realign

Refresh

RemoveComponent

RemoveControl

Repaint

ScaleBy

ScreenToClient

ScrollBy

SendToBack

SetBounds

SetFocus

SetTextBuf

Show

TRadioButton

UpdateControlState

Update


TRadioButton::~TRadioButton

TRadioButton

Der Destruktor ~TRadioButton gibt den Speicher frei, der für das TRadioButton-Objekt reserviert war. Rufen Sie ~TRadioButton nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TRadioButton automatisch aufgerufen wird.

__fastcall virtual ~TRadioButton(void);Alignment property, ControlStyle property, Height property, Width property


TRadioButton::TRadioButton

TRadioButton

Die Methode erzeugt ein Optionsfeld.

__fastcall virtual TRadioButton(Classes::TComponent* AOwner);

Beschreibung

TRadioButton ruft den Konstruktor seines übergeordneten Objekts auf und initialisiert unter anderem die Eigenschaften Width mit 113 Pixel, Height mit 17 Pixel, Alignment mit taLeftJustify und ControlStyle mit csSetCaption und csDoubleClick.


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TControl

TWinControl

TButtonControl


TRadioButton Beispiel

TRadioButton


 TRadioGroup

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/extctrls.hpp

TRadioGroup stellt eine Gruppe zusammengehöriger Optionsfelder dar.

Beschreibung

Ein TRadioGroup-Objekt ist ein spezielles Gruppenfeld, das nur Optionsfelder enthält. Optionsfelder, die im selben Steuerelement enthalten sind, bezeichnet man als „gruppiert“. Wenn der Benutzer ein Optionsfeld aktiviert, werden alle anderen Optionsfelder derselben Gruppe deaktiviert. Zwei Optionsfelder in einem Formular können also nur dann zur gleichen Zeit aktiviert werden, wenn sie sich in separaten Containern befinden (z.B. in zwei unterschiedlichen Gruppenfeldern).

Mit der Eigenschaft Items können Sie einem TRadioGroup-Objekt Optionsfelder hinzufügen. Für jeden String in Items wird im Gruppenfeld ein Optionsfeld mit der entsprechenden Beschriftung angezeigt. Der Wert der Eigenschaft ItemIndex gibt an, welches Optionsfeld gegenwärtig aktiviert ist.

Indem Sie der Eigenschaft Columns einen Wert zuweisen, können Sie die Optionsfelder in mehreren Spalten anordnen.

TRadioGroup deklariert viele der geschützten Eigenschaften von TCustomRadioGroup als published, ohne daß deren Verhalten verändert wird.


Eigenschaften von TRadioGroup

TRadioGroup	Alphabetisch	Legende

Abgeleitet von TCustomRadioGroup

Columns

ItemIndex

Items

Abgeleitet von TWinControl

Brush

ClientOrigin

ClientRect

ControlCount

Controls

Ctl3D

Handle

HelpContext

ParentCtl3D

Showing

TabOrder

TabStop

Abgeleitet von TControl

Align

BoundsRect

Caption

ClientHeight

ClientWidth

Color

ControlState

ControlStyle

Cursor

DragCursor

DragMode

Enabled

Font

Height

Hint

Left

Name

Parent

ParentColor

ParentFont

ParentShowHint

PopupMenu

ShowHint

Top

Visible

Width

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TRadioGroup

TRadioGroup	Nach Objekten	Legende

Align

BoundsRect

Brush

Caption

ClientHeight

ClientOrigin

ClientRect

ClientWidth

Color

Columns

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlCount

ControlState

Controls

ControlStyle

Ctl3D

Cursor

DesignInfo

DragCursor

DragMode

Enabled

Font

Handle

Height

HelpContext

Hint

ItemIndex

Items

Left

Name

Owner

ParentColor

ParentCtl3D

ParentFont

ParentShowHint

Parent

PopupMenu

ShowHint

Showing

TabOrder

TabStop

Tag

Top

Visible

Width


Ereignisse von TRadioGroup

TRadioGroup	Alphabetisch	Legende

Abgeleitet von TWinControl

OnEnter

OnExit

Abgeleitet von TControl

OnClick

OnDragDrop

OnDragOver

OnEndDrag

OnStartDrag


Ereignisse von TRadioGroup

TRadioGroup	Nach Objekten	Legende

OnClick

OnDragDrop

OnDragOver

OnEndDrag

OnEnter

OnExit

OnStartDrag


Methoden von TRadioGroup

TRadioGroup	Alphabetisch	Legende

In TRadioGroup

~TRadioGroup

TRadioGroup

Abgeleitet von TCustomRadioGroup

CanModify

Abgeleitet von TWinControl

Broadcast

CanFocus

ContainsControl

ControlAtPos

DisableAlign

EnableAlign

Focused

GetTabOrderList

HandleAllocated

HandleNeeded

InsertControl

Invalidate

PaintTo

Realign

RemoveControl

Repaint

ScaleBy

ScrollBy

SetBounds

SetFocus

Update

UpdateControlState

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

GetTextLen

Hide

Perform

Refresh

ScreenToClient

SendToBack

SetTextBuf

Show

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TRadioGroup

TRadioGroup	Nach Objekten	Legende

~TRadioGroup

Assign

BeginDrag

BringToFront

Broadcast

CanFocus

CanModify

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

ClientToScreen

ContainsControl

ControlAtPos

DefaultHandler

DestroyComponents

Destroying

DisableAlign

Dispatch

DragDrop

Dragging

EnableAlign

EndDrag

FieldAddress

FindComponent

Focused

FreeInstance

FreeNotification

Free

GetParentComponent

GetTabOrderList

GetTextBuf

GetTextLen

HandleAllocated

HandleNeeded

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InsertControl

InstanceSize

Invalidate

MethodAddress

MethodName

NewInstance

PaintTo

Perform

Realign

Refresh

RemoveComponent

RemoveControl

Repaint

ScaleBy

ScreenToClient

ScrollBy

SendToBack

SetBounds

SetFocus

SetTextBuf

Show

TRadioGroup

UpdateControlState

Update


TRadioGroup::~TRadioGroup

TRadioGroup

Der Destruktor ~TRadioGroup gibt den Speicher frei, der für das TRadioGroup-Objekt reserviert war. Rufen Sie ~TRadioGroup nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TRadioGroup automatisch aufgerufen wird.

__fastcall virtual ~TRadioGroup(void);


TRadioGroup::TRadioGroup

TRadioGroup

Der Konstruktor TRadioGroup erzeugt ein neues TRadioGroup-Objekt.

__fastcall virtual TRadioGroup(Classes::TComponent* AOwner);


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Protected


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TControl

TWinControl

TCustomControl

TCustomGroupBox

TCustomRadioGroup


TRadioGroup Beispiel

TRadioGroup


TReader

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/classes.hpp

TReader ist ein spezialisiertes Filer-Objekt, mit dem Daten aus einem zugehörigen Stream gelesen werden.

Beschreibung

TReader wird intern vom VCL-Stream-System verwendet, um Statusdaten einer Komponente aus einem Stream zu laden. TReader ist ein Hilfsobjekt, das den eigentlichen Vorgang des Lesens von Komponentendaten aus einem Stream abwickelt. Nicht das Stream-Objekt, sondern das Reader-Objekt bewältigt diesen komplexen Prozeß. Die Methoden von TReader besitzen die folgende Funktionalität:

•	Komponenten-Instanzen aus Klassennamen erzeugen, die aus einem Stream gelesen werden.

•	Als published deklarierte Komponenteneigenschaften mit Werten belegen, die aus einem Stream stammen.

•	Verborgene oder komplexe Daten so für ein Objekt speichern, als ob sie wirkliche Eigenschaften des Objekts wären.

•	Referenzen zwischen Komponenten auflösen (z.B. in einer Eigenschaft, die auf eine andere Komponente verweist).

Weitere Methoden und Eigenschaften lösen objektspezifische Ereignisse aus und interagieren mit dem Stream.

Als Benutzer werden Sie Reader-Objekte nicht direkt erzeugen. Der Konstruktor für TReader nimmt einen Stream als Parameter entgegen. Reader werden automatisch in Methoden von Stream-Objekten oder in globalen Routinen erzeugt, die den Stream-Prozeß einleiten. Dieser Schritt umfaßt folgendes:

•	Aufruf der globalen Routine ObjectBinaryToText, die ein Reader-Objekt direkt erzeugt.

•	Aufruf der globalen Funktion ReadComponentResFile, die ein Datei-Stream-Objekt erzeugt, das wiederum ein Reader-Objekt erzeugt.

•	Aufruf der Methode TStream.ReadComponent, die wiederum ein Reader-Objekt erzeugt.

Der Konstruktor des Readers nimmt einen Stream als Parameter entgegen. Dieser repräsentiert den zugehörigen Stream. Aus diesem Grund ist Reader-Objekten immer ein Stream-Objekt zugeordnet. Sobald der Stream-Prozeß in Gang ist, brauchen Sie als Benutzer nie direkt auf Reader-Objekte zugreifen. Die Interaktion zwischen Reader, Komponente und Stream-Objekten erfolgt automatisch über Methoden dieser Objekte, die sich gegenseitig aufrufen.


Eigenschaften von TReader

TReader	Alphabetisch

In TReader

Owner

Parent

Position

Abgeleitet von TFiler

Ancestor

IgnoreChildren

Root


Eigenschaften von TReader

TReader	Nach Objekten

Ancestor

IgnoreChildren

Owner

Parent

Position

Root


TReader::Owner

TReader	Siehe auch

Die Eigenschaft Owner bezeichnet die Komponente, die allen Komponenten als Wert der Eigenschaft Owner zugewiesen wird, die aus dem Stream des Reader-Objekts gelesen werden.

__property TComponent* Owner;

Beschreibung

Owner wird intern vom VCL-Stream-System verwendet, um festzustellen, welche Komponenten in einem Stream enthalten sind. Dabei werden alle Komponenten erfaßt, die der Komponente Root untergeordnet sind.

Owner ist die Owner-Eigenschaft derjenigen Komponente, die sich im Stream befindet. Die Eigenschaft erhält ihren Wert vom Reader-Objekt. Wenn ein Reader eine neue Komponenteninstanz erzeugt, wird der Eigenschaft Owner der Komponente der Wert Reader.Owner zugewiesen. Wenn Reader.Owner NULL ist, wird die Eigenschaft Owner auf Reader.Root gesetzt.

Bei den meisten Komponenten hat Owner den Wert NULL. Komponenten, die weitere Komponenten enthalten können, wie zum Beispiel die Seiten eines Registersatzes, haben nicht den Eigentümer (Owner) Root. Die Methode GetChildOwner kann den jeweiligen Eigentümer bestimmen.


TReader::Parent

TReader	Siehe auch	Beispiel

Die Eigenschaft Parent speichert die Komponente, die allen Steuerelementen, die aus dem Stream des Reader-Objekts eingelesen werden, als Eigenschaft Parent zugewiesen wird.

__property TComponent* Parent;

Beschreibung

Die Eigenschaft Parent wird intern vom VCL-Stream-System verwendet. Ihr Wert wird durch die Reihenfolge bestimmt, in der die Komponenten vom Stream eingelesen werden. Ihr Wert drückt die hierarchische Beziehung von Komponenten aus.


TReader::Position

TReader	Siehe auch	Beispiel

Die Eigenschaft Position repräsentiert die aktuelle Leseposition im zugehörigen Stream.

__property long Position;

Beschreibung

Mit dem Wert dieser Eigenschaft läßt sich die Position des Readers im Stream verfolgen. Der Wert von Position liegt immer innerhalb des letzten gelesenen Pufferblocks. Somit hat Position immer einen kleineren Wert als die Eigenschaft Position des Streams.


Ereignisse von TReader

TReader	Alphabetisch

In TReader

OnError

OnFindMethod

OnSetName


Ereignisse von TReader

TReader	Nach Objekten

OnError

OnFindMethod

OnSetName


TReader::OnError

TReader	Siehe auch

Das Ereignis OnError wird ausgelöst, wenn ein Reader-Objekt beim Lesen von Daten auf einen Fehler stößt, wie etwa den Namen einer nicht deklarierten Eigenschaft oder einen unzulässigen Wert.

__property TReaderError OnError;

Beschreibung

Das Ereignis OnError wird intern von Borland C++Builder verwendet, um Fehler zu erkennen. Es kann auch in einer Ereignisbehandlungsroutine dazu dienen, bestimmte Fehler zu ignorieren oder abzufangen.

Der letzte Parameter, der an die Ereignisbehandlungsroutine für OnError übergeben wird, ist die boolesche Variable Handled. Standardmäßig übergibt die Methode Error in Handled den Wert False, allerdings kann eine Ereignisbehandlungsroutine, die den Fehler behebt oder ignoriert, Handled auf True setzen und so die weitere Bearbeitung des Fehlers unterbinden. Wenn die Ereignisbehandlungsroutine zurückkehrt, während Handled immer noch den Wert False hat, löst das Reader-Objekt eine EReadError-Exception aus.


TReader::OnFindMethod

TReader	Siehe auch

Das Ereignis OnFindMethod wird jedesmal ausgelöst, wenn das Reader-Objekt ein Ereignis liest, das als Eigenschaft einen Methodenzeiger darstellt.

__property TFindMethodEvent OnFindMethod;

Beschreibung

Das Ereignis OnFindMethod wird intern von der Borland C++Builder-Umgebung verwendet, wenn Ereignisse gelesen werden. Es kann auch in einer Ereignisbehandlungsroutine eingesetzt werden, um vom Benutzer zu erfragen, wie auf fehlende Methoden reagiert werden soll.

Wenn der Reader die Methode nicht finden kann, auf die der Methodenzeiger verweist, setzt er den Parameter Error für die Behandlungsroutine von OnFindMethod auf True. Die Ereignisbehandlungsroutine wiederum kann Error auf False setzen und so verhindern, daß bei Rückkehr der Ereignisbehandlungsroutine eine Exception ausgelöst wird.


TReader::OnSetName

TReader	Siehe auch

Das Ereignis OnSetName wird ausgelöst, bevor das Reader-Objekt die Eigenschaft Name derjenigen Komponente setzt, die aus einem Stream gelesen wird.

__property TSetNameEvent OnSetName;

Beschreibung

OnSetName wird intern von der Borland C++Builder-Umgebung verwendet, um das mehrfache Vorkommen von Komponenten- und Formularnamen abzufangen. Die Eigenschaft kann außerdem in einer Ereignisbehandlungsroutine verwendet werden, um spezielle Schritte auszuführen, bevor die Eigenschaft Name einer gerade erzeugten Komponente gesetzt und deren Eigenschaften aus dem Stream gelesen werden.

Der Parameter Name, der an die Ereignisbehandlungsroutine für OnSetName übergeben wird, ist eine Variable, so daß die Ereignisbehandlungsroutine den Namen ändern kann, bevor sie ihn der Komponente zuweist. OnSetName ist beispielsweise hilfreich, wenn alle Komponentennamen in einem Formular gefiltert werden sollen und dazu ein Teil des Strings geändert oder hinzugefügt wird.


Methoden von TReader

TReader	Alphabetisch	Legende

In TReader

~TReader

BeginReferences

DefineBinaryProperty

DefineProperty

EndOfList

EndReferences

Error

FindMethod

FixupReferences

FlushBuffer

NextValue

Read

ReadBoolean

ReadChar

ReadComponent

ReadComponents

ReadFloat

ReadIdent

ReadInteger

ReadListBegin

ReadListEnd

ReadPrefix

ReadRootComponent

ReadSignature

ReadStr

ReadString

ReadValue

SetName

TReader

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TReader

TReader	Nach Objekten	Legende

~TReader

BeginReferences

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

DefineBinaryProperty

DefineProperty

Dispatch

EndOfList

EndReferences

Error

FieldAddress

FindMethod

FixupReferences

FlushBuffer

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance

NextValue

ReadBoolean

ReadChar

ReadComponents

ReadComponent

ReadFloat

ReadIdent

ReadInteger

ReadListBegin

ReadListEnd

ReadPrefix

ReadRootComponent

ReadSignature

ReadString

ReadStr

Read

ReadValue

SetName

TReader


TReader::~TReader

TReader	Siehe auch

Der Destruktor ~TReader verschiebt die aktuelle Position des Streams zurück zum Anfang. Dann wird die geerbte Version von ~TReader aufgerufen.

__fastcall virtual ~TReader(void);

Beschreibung

~TReader sollte nicht direkt aufgerufen werden. Verwenden Sie statt dessen Free. Die Methode Free überprüft zuerst, daß die Objektinstanz nicht bereits NULL ist, bevor ~TReader aufgerufen wird.


TReader::BeginReferences

TReader	Siehe auch

BeginReference startet die Ausführung eines Befehlsblocks, der solche Komponenten liest, die Referenzen auf andere Komponenten enthalten können.

void __fastcall BeginReferences(void);

Beschreibung

Rufen Sie BeginReferences nicht direkt auf. BeginReferences wird intern von Borland C++Builder verwendet, um in Streams Eigenschaften zu verarbeiten, die andere Komponenten referenzieren.

Nach dem Aufruf von BeginReferences erzeugt das Reader-Objekt eine Liste mit allen gelesenen Objekten und deren Namen. Sobald alle abhängigen Objekte gelesen sind, wird FixupReferences aufgerufen, um die namensbezogenen Referenzen aus dem Stream in Instanz-Referenzen umzuwandeln. Zuletzt wird diese Liste mit EndReferences freigegeben.

BeginReferences wird immer in einem try..finally-Block zusammen mit FixupReferences und EndReferences eingesetzt.


TReader::DefineBinaryProperty

TReader	Siehe auch

Die Methode DefineBinaryProperty definiert binäre Daten, die das Reader-Objekt so liest, als ob es sich um eine Eigenschaft handeln würde.

virtual void __fastcall DefineBinaryProperty(const System::AnsiString Name, TStreamProc ReadData, TStreamProc  WriteData, bool HasData);

Beschreibung

DefineBinaryProperty wird intern von der Methode DefineProperties eines Objekts aufgerufen, das Daten speichern muß. Als Benutzer werden Sie DefineBinaryProperty direkt aufrufen, wenn Sie eine Komponente mit umfangreichen benutzerdefinierten Daten (z.B. Bitmaps) implementieren. Der Aufruf erfolgt dann in der Methode DefineProperties der Komponente. DefineBinaryProperty (oder DefineProperty) werden ausschließlich in diesem Kontext verwendet.

DefineProperties nimmt ein generisches Filer-Objekt als Parameter entgegen. Beim Lesen von binären Daten übernimmt DefineProperties ein TReader-Objekt und ruft für das Reader-Objekt die Methode DefineBinaryProperty der Klassen TReader oder TFiler auf. Anschließend liest DefineBinaryProperty den Namen und die Daten der Eigenschaft und übergibt die Daten an die mit ReadData vorgegebene Methode.

Der Parameter Name bezeichnet den Namen der verborgenen Eigenschaft, die aus dem Stream gelesen werden soll. Die Bezeichnung „verborgene“ Eigenschaft drückt aus, daß die betreffende Eigenschaft nicht als published deklariert ist und nur im Code der Methode DefineBinaryProperty existiert. Die Eigenschaften Top und Left einer nicht visuellen Komponente sind Beispiele für solche verborgenen Eigenschaften. Sie werden auch als „definierte“ Eigenschaften bezeichnet.

Der Typ TStreamProc beschreibt den Typ der Parameter ReadData und WriteData. Dieser Methodenzeiger-Typ verweist auf eine Prozedur (definiert im speichernden Objekt), welche die binäre Repräsentation der Objektdaten liest oder schreibt, und zwar direkt in bzw. aus dem Stream, der im Parameter Stream übergeben wurde. Bei TReader wird der Parameter WriteData ignoriert.

Der Parameter HasData gibt zur Laufzeit an, ob die verborgene Eigenschaft Daten besitzt, die gespeichert (geschrieben) werden müssen. Bei TReader wird der Parameter HasData ignoriert.

Für das Schreiben einer Komponente, für die eine große Datenmenge gespeichert werden muß, kann DefineProperties überschrieben werden. Rufen Sie für jede spezielle oder verborgene Eigenschaft die Methode Filer.DefineProperty oder Filer.DefineBinaryProperty auf. Übergeben Sie in den Parametern ReadData und WriteData die Komponentenmethoden, die diesen speziellen Datentyp verarbeiten können. Beim Lesen wird ReadData aufgerufen, beim Schreiben entsprechend WriteData.

Definierte binäre Eigenschaften sind sehr selten. VCL-Objekte, die Grafikdaten in binärer Form speichern, sind der häufigste Anwendungsfall für Filer-Objekte. Gängige Objekte verwenden die Methode DefineProperty. Der Unterschied zwischen DefineBinaryProperty und DefineProperty liegt darin, daß die binäre Eigenschaft direkt aus einem Stream gelesen bzw. in einen solchen geschrieben wird, anstatt ein Filer-Objekt zu durchsuchen. Zudem lassen sich binäre Daten nicht so einfach bearbeiten wie Text.

Hinweis

Stream-fähige Objekte, die von TPersistent abstammen, erben eine Methode DefineProperties, die jedoch erst in TComponent eine Funktionalität besitzt. Deshalb ist es die Methode DefineProperties des Komponentenobjekts, die zum Lesen binärer Daten die Methode DefineBinaryProperty des Readers aufruft.


TReader::DefineProperty

TReader	Siehe auch

Die Methode DefineProperty definiert vom Reader-Objekt gelesene Daten so, als handelte es sich um wirkliche Objekteigenschaften.

virtual void __fastcall DefineProperty(const System::AnsiString Name, TReaderProc ReadData, TWriterProc  WriteData, bool HasData);

Beschreibung

DefineProperty wird intern von der Methode DefineProperties eines Objekts aufgerufen, das Daten speichern muß. DefineProperties nimmt ein generisches Filer-Objekt als Parameter entgegen. Beim Lesen von Daten übernimmt DefineProperties ein TReader-Objekt und ruft dessen Methode DefineProperties auf. Anschließend liest DefineProperty den Namen und die Daten der Eigenschaft.

Der Parameter Name bezeichnet den Namen der verborgenen Eigenschaft, die aus dem Stream gelesen werden soll.

Der Typ TReaderProc beschreibt den Typ des Parameters ReadData. Dieser Methodenzeiger-Typ verweist auf eine Prozedur (definiert im speichernden Objekt), welche die Daten des Objekts liest, die einen Eigenschaftswert repräsentieren. Bei TReader wird der Parameter WriteData ignoriert.

Der Parameter HasData gibt zur Laufzeit an, ob die verborgene Eigenschaft Daten besitzt, die gespeichert (geschrieben) werden müssen. Bei TReader wird HasData ignoriert.

Der Unterschied zwischen DefineBinaryProperty und DefineProperty liegt darin, daß die binäre Eigenschaft direkt aus einem Stream-Objekt gelesen wird, anstatt ein Filer-Objekt zu durchsuchen. Zudem lassen sich binäre Daten nicht so einfach bearbeiten wie Text.


TReader::EndOfList

TReader	Siehe auch

Die Methode EndOfList signalisiert das Ende einer Gruppe von Elementen, die sequentiell aus dem Stream eingelesen werden.

bool __fastcall EndOfList(void);

Beschreibung

EndOfList wird von anderen Methoden verwendet, die beim Lesen von Daten über eine Liste von Elementen iterieren. EndOfList prüft auf einen Wertetyp, der das Ende einer Folge gleichartiger Daten anzeigt. EndOfList gibt True zurück, wenn das Reader-Objekt alle Daten bis zum Ende einer Elementliste gelesen hat.

Beim Lesen einer Elementliste sind folgende Methoden beteiligt: Zuerst wird ReadListBegin aufgerufen, dann werden die Elemente gelesen, bis EndOfList den Wert True zurückgibt. Anschließend wird ReadListEnd aufgerufen.


TReader::EndReferences

TReader	Siehe auch

Die Methode EndReferences beendet einen Codeblock, der solche Komponenten aus dem Stream des Reader-Objekts liest, die gegenseitige Referenzen enthalten können.

void __fastcall EndReferences(void);

Beschreibung

EndReferences wird für die Stream-Verarbeitung von Eigenschaften verwendet, die eine andere Komponente referenzieren. Als Benutzer werden Sie EndReferences nicht direkt aufrufen müssen.

Das Reader-Objekt ruft EndReferences auf und erzeugt eine Liste aller gelesenen Objekte mit deren Namen. Sobald alle abhängigen Objekte gelesen sind, wird FixupReferences aufgerufen, um die namensbezogenen Referenzen aus dem Stream in Instanz-Referenzen umzuwandeln. Zuletzt wird diese Liste mit EndReferences freigegeben.

EndReferences wird immer am Ende eines try..finally-Blocks eingesetzt, der außerdem Aufrufe von BeginReferences und FixupReferences enthält.


TReader::Error

TReader	Siehe auch

Error ist die Implementierungsmethode für das Ereignis OnError des Reader-Objekts.

virtual bool __fastcall Error(const System::AnsiString Message);

Beschreibung

Das Reader-Objekt ruft Error auf, sobald beim Lesen einer Komponente oder Eigenschaft ein Problem auftaucht. Standardmäßig gibt Error den Wert False zurück und ruft dann die Ereignisbehandlungsroutine für OnError auf, die den Rückgabewert modifizieren kann.

Mit Error kann der Rückgabewert geändert werden, der signalisiert, ob eine weitere Fehlerbehandlung stattfinden soll. Der Rückgabewert True sagt aus, daß die Bedingung in der Anwendung weiterhin als Fehler gelten soll. False gibt an, daß die Fehlerbedingung entweder beseitigt wurde oder ignoriert werden kann.

Hinweis

Diese Methode ist nur innerhalb der Entwurfsumgebung virtuell. Benutzer werden von TReader keine Klassen ableiten.


TReader::FindMethod

TReader	Siehe auch

Die Methode FindMethod gibt einen Zeiger auf eine bestimmte Komponentenmethode zurück.

virtual void * __fastcall FindMethod(TComponent* Root, const System::AnsiString MethodName);

Beschreibung

FindMethod wird vom Reader-Objekt beim Lesen einer Eigenschaft verwendet, die einen Methodenzeiger darstellt (normalerweise ein Ereignis). Nachdem der Name der zugeordneten Methode (d.h. der Ereignisbehandlungsroutine) gelesen wurde, ruft der Reader FindMethod auf, um die Adresse der Methode im Hauptobjekt (dem Formular) zu ermitteln.

FindMethod gibt für die in Root übergebene Komponente einen Zeiger auf die Methode zurück, die im Parameter MethodName angegeben ist. Anschließend wird die Ereignisbehandlungsroutine für OnFindMethod aufgerufen, falls es eine solche gibt. Wenn FindMethod die gesuchte Methode nicht finden kann und die Ereignisbehandlungsroutine für OnFindMethod ihr Fehler-Flag nicht löscht, löst FindMethod eine EReadError-Exception aus.

In einer Ereignisbehandlungsroutine für OnFindMethod läßt sich die individuelle Verarbeitung von Methodenzeigern festlegen, die aus dem Reader-Objekt gelesen wurden.


TReader::FixupReferences

TReader	Siehe auch

Mit FixupReferences werden Referenzen aufgelöst, wenn Eigenschaften aus einem Stream gelesen werden, die von einer anderen Komponente repräsentiert werden.

void __fastcall FixupReferences(void);

Beschreibung

FixupReferences wird intern vom Stream-System verwendet. Als Benutzer werden Sie diese Methode nicht direkt aufrufen müssen.

Nach dem Aufruf von BeginReferences erzeugt das Reader-Objekt eine Liste mit allen gelesenen Objekten und deren Namen. Sobald alle abhängigen Objekte gelesen sind, wird FixupReferences aufgerufen, um die namensbezogenen Referenzen aus dem Stream in Instanz-Referenzen umzuwandeln. Zuletzt wird diese Liste mit EndReferences freigegeben.

BeginReferences wird immer in einem try..finally-Block zusammen mit FixupReferences und EndReferences eingesetzt.


TReader::FlushBuffer

TReader	Siehe auch

Die Methode FlushBuffer synchronisiert den Puffer des Readers mit dem Puffer des zugeordneten Streams.

virtual void __fastcall FlushBuffer(void);

Beschreibung

FlushBuffer synchronisiert die beiden Puffer von Stream und Reader. Dazu wird der Wert der Position-Eigenschaften von Stream und Reader angeglichen.


TReader::NextValue

TReader	Siehe auch

Die Methode NextValue gibt den Typ des nächsten Elements im Stream des Reader-Objekts zurück, ohne jedoch die Position im Stream zu verändern.

TValueType __fastcall NextValue(void);

Beschreibung

NextValue wird intern von Reader-Methoden verwendet, um den Typ des nächsten Elements im Stream abzufragen. Die Position befindet sich nach Rückkehr der Methode unverändert vor dem Typbezeichner.

Der Typ TValueType definiert die Art des Wertes, der in Filer-Objekte geschrieben bzw. daraus gelesen wird. Die Filer-Objekte in Borland C++Builder verwenden ein bestimmtes Schema von Markierungen. Jedem Wert im Stream wird ein Präfix vorangestellt, das den Typ kennzeichnet. Diese Präfixe sind wiederum vom Typ TValueType.


TReader::Read

TReader	Siehe auch

Die Methode Read wird intern von anderen Methoden verwendet, um Daten zu lesen.

void __fastcall Read(void *Buf, long Count);

Beschreibung

Rufen Sie Read nicht direkt auf. Read wird intern verwendet, um Daten aus dem Stream zu lesen. Viele andere Methoden rufen Read auf, normalerweise nach dem Einstellen von zugehörigen Werten oder nach der Überprüfung von Datentypen.


TReader::ReadBoolean

TReader

ReadBoolean liest einen logischen (Boolschen) Wert aus dem Stream des Objekts und gibt den logischen Wert zurück.

bool __fastcall ReadBoolean(void);

Beschreibung

ReadBoolean ist eine Hilfsmethode, die von anderen Reader-Methoden beim Lesen eines markierten logischen Wertes an der aktuellen Position verwendet wird. Siehe auch

Methode ReadChar, Methode ReadIdent, Methode ReadInteger, Methode ReadStr, Methode ReadString


TReader::ReadChar

TReader	Siehe auch

Die Methode ReadChar liest ein Zeichen aus dem Stream des Reader-Objekts und gibt den Zeichenwert zurück.

char __fastcall ReadChar(void);

Beschreibung

ReadChar ist eine Hilfsmethode, die von anderen Reader-Methoden beim Lesen eines markierten Zeichenwertes an der aktuellen Position verwendet wird. ReadChar überprüft zuerst den Typ des Wertes (TValueType). Dazu wird ReadValue aufgerufen. Wenn das Element den Typ vaString besitzt, prüft ReadString die Länge. Wenn die Länge darauf hinweist, daß es sich um ein einzelnes Zeichen handelt, wird Read aufgerufen und das Zeichen zurückgegeben. Andernfalls wird eine EReadError-Exception ausgelöst.

Hinweis

Wenn es sich bei dem markierten Datenwert um einen String mit der Länge 1 handelt, ist er zum Typ char kompatibel. Wenn die Länge dagegen größer als 1 ist, muß auch der Rest des Strings gelesen werden, damit der Reader in konsistentem Zustand bleibt. Jede Operation, die markierte Daten verarbeitet, muß die Eigenschaft Position des Readers so hinterlassen, daß sie auf den Anfang des nächsten, noch nicht gelesenen Datenwertes zeigt.


TReader::ReadComponent

TReader	Siehe auch

Die Methode ReadComponent liest die mit Instance bezeichnete Komponente aus dem Stream und gibt die Komponente zurück.

TComponent* __fastcall ReadComponent(TComponent* Component);

Beschreibung

ReadComponent wird intern von ReadRootComponent verwendet, um alle Komponenten zu lesen, die Eigentum von Root sind. Für Programmierer gibt es keinen Grund, ReadComponent direkt aufzurufen.

ReadComponent übernimmt für alle Komponenten den Lade- und Initialisierungsvorgang. Nach dem Laden aller Komponenten in der Liste ruft ReadComponents die Methode Loaded jeder geladenen Komponente auf, und zwar in der Reihenfolge, in der sie gelesen werden. ReadComponent ruft für die Abwicklung des komplexen Lesevorgangs weitere Reader-Methoden sowie Methoden der Komponente auf.


TReader::ReadComponents

TReader

Die Methode ReadComponents liest eine Liste untergeordneter Komponenten aus dem Stream des Reader-Objekts.

void __fastcall ReadComponents(TComponent* AOwner, TComponent* AParent, TReadComponentsProc Proc);

Beschreibung

ReadComponents wird intern von der Borland C++Builder-Umgebung für Stream-Prozesse während des Entwurfs verwendet. Rufen Sie ReadComponents nicht direkt auf.

ReadComponents setzt zuerst die Eigenschaften Root und Owner des Reader-Objekts auf die Komponente, die im Parameter AOwner übergeben wurde, und dessen Eigenschaft Parent auf AParent. Anschließend liest ReadComponents die Komponenten mit Hilfe der Methode ReadComponent und übergibt jede gelieferte Komponente an die Methode, die mit dem Parameter Proc festgelegt wurde.

Hinweis

ReadComponents wird zur Laufzeit verwendet, wenn mehrere Komponenten über die Zwischenablage ausgeschnitten und eingefügt werden.


TReader::ReadFloat

TReader	Siehe auch

Die Methode ReadFloat liest eine Gleitkommazahl aus dem Stream des Reader-Objekts und gibt dessen Wert zurück.

long double __fastcall ReadFloat(void);

Beschreibung

ReadFloat ist eine Hilfsmethode, die anderen Reader-Methoden dazu dient, einen markierten Gleitkommawert an der aktuellen Position zu lesen. ReadFloat untersucht zuerst den Typ des Wertes (TValueType). Dazu wird ReadValue aufgerufen. Wenn das Element den Typ vaExtended besitzt, ruft ReadFloat die Methode Read auf und gibt den Gleitkommawert zurück. Andernfalls wird ReadInteger aufgerufen.


TReader::ReadIdent

TReader	Siehe auch

Die Methode liest einen Bezeichner aus dem Stream des Reader-Objekts und gibt ihn zurück.

System::AnsiString __fastcall ReadIdent(void);

Beschreibung

ReadIndent ist eine Hilfsmethode, die anderen Methoden zur Typbestimmung des Elements dient, das an der aktuellen Position gelesen werden soll. ReadIndent untersucht zuerst den Typ des Wertes (TValueType). Dazu wird ReadValue aufgerufen. Der Rückgabewert der Funktion hängt vom Typ des Elements ab. Es gilt folgendes Schema:

•	Wenn das Element den Typ vaIdent hat, ruft ReadIndent die Methode Read auf und gibt den Wert des Bezeichner-Strings zurück.

•	Wenn das Element den Typ vaFalse hat, gibt ReadIdent den String ‘False’ zurück.

•	Wenn das Element den Typ vaTrue hat, gibt ReadIdent den String ‘True’ zurück.

•	Wenn das Element den Typ vaNil hat, gibt ReadIdent den String ‘NULL’ zurück.

In allen anderen Fällen wird eine EReadError-Exception ausgelöst.


TReader::ReadInteger

TReader	Siehe auch

Die Methode ReadInteger liest eine Integer-Zahl aus dem Stream des Reader-Objekts und gibt deren Wert zurück.

long __fastcall ReadInteger(void);

Beschreibung

ReadInteger ist eine Hilfsmethode, die von anderen Reader-Methoden verwendet wird, um an der aktuellen Position einen markierten Integer-Wert zu lesen. Die Position wird durch die entsprechende Eigenschaft bestimmt. ReadInteger prüft zuerst den Typ des Wertes (TValueType). Dazu wird ReadValue aufgerufen. Wenn das Element einen der Typen vaString, vaInt8, vaInt16 oder vaInt32 besitzt, ruft ReadInteger die Methode Read auf und gibt den Integer-Wert zurück. Andernfalls wird eine EReadError-Exception ausgelöst.


TReader::ReadListBegin

TReader	Siehe auch

Die Methode ReadListBegin liest die Markierung für den Listenanfang aus dem Stream des Reader-Objekts.

void __fastcall ReadListBegin(void);

Beschreibung

Die Methode ReadListBegin wird von anderen Methoden verwendet, die über eine Liste von Elementen iterieren, um zu prüfen, ob der einzulesende Typ eine Liste ist. ReadListBegin wird auch von Komponentenentwicklern in ReadData-Methoden für Eigenschaftsdefinitionen eingesetzt.

Wenn das nächste Element im Stream keine Markierung für den Listenanfang darstellt (erzeugt von WriteListBegin), löst ReadListBegin eine EReadError-Exception aus.

Ein Aufruf von ReadListBegin steht normalerweise vor dem Eintritt in eine Leseschleife, die abbricht, sobald die Methode EndOfList den Wert True zurückgibt und damit anzeigt, daß an nächster Position im String eine Markierung für das Listenende steht. Die Verarbeitung dieser Markierung erfordert einen Aufruf von ReadListEnd.


TReader::ReadListEnd

TReader	Siehe auch

Die Methode ReadListEnd liest die Markierung für das Listenende aus dem Stream des Reader-Objekts.

void __fastcall ReadListEnd(void);

Beschreibung

ReadListEnd wird von anderen Methoden verwendet, die über eine Liste von Elementen iterieren, um anzuzeigen, daß das Ende einer Gruppe von gelesenen Elementen erreicht wurde. ReadListEnd wird auch von Komponentenentwicklern in ReadData-Methoden für Eigenschaftsdefinitionen eingesetzt.

ReadListEnd wird normalerweise nach einer Leseschleife aufgerufen, die abbricht, sobald die Methode EndOfList den Wert True zurückgibt und damit anzeigt, daß eine Markierung für das Listenende als nächstes Element im Stream steht.

Wenn das gelesene Element keine Markierung für das Listenende darstellt, löst ReadListEnd eine EReadError-Exception aus. Ein Aufruf von ReadListEnd steht immer im Zusammenhang mit einem vorausgegangenen Aufruf von ReadListBegin.


TReader::ReadPrefix

TReader	Siehe auch

Die Methode ReadPrefix liest für eine Komponente vorläufige Informationen über die Vererbung auf Formularebene.

void __fastcall ReadPrefix( TFilerFlags *Flags, int &AChildPos);

Beschreibung

ReadPrefix wird intern vom Borland C++Builder-Stream-System verwendet. Die Methode wird automatisch von ReadComponent aufgerufen und liest zwei Flags, die signalisieren, ob sich eine Komponente in einem geerbten Formular befindet und ob die Erstellungsreihenfolge im Formular von Bedeutung ist. Außerdem wird die Position der Komponente in der Erstellungsreihenfolge des übergeordneten Formulars gelesen. Wenn ein Writer-Objekt eine Komponente in seinen Stream stellt, werden der Komponente diese Flags vorangestellt.

Der Typ TFilerFlags ist der Typ des Parameters Flags.


TReader::ReadRootComponent

TReader	Siehe auch

Die Methode ReadRootComponent liest eine Komponente und alle untergeordneten Komponenten aus dem Stream des Reader-Objekts.

TComponent* __fastcall ReadRootComponent(TComponent* Root);

Beschreibung

Rufen Sie ReadRootComponent nicht direkt auf. Die Methode wird intern vom Stream-System verwendet. Wenn das Reader-Objekt von seinem Stream in TStream.ReadComponent erzeugt wird, ruft es sofort ReadRootComponent auf. Damit wird der Lesevorgang für ein Objekt eingeleitet.

ReadRootComponent ruft zuerst ReadSignature auf, um sicherzustellen, daß eine gültige Komponente vorliegt. ReadRootComponent übernimmt auch die Initialisierung und die Auflösung von Referenzen. Beispielsweise wird die in Root übergebene Komponente der Wert der Eigenschaft Root des Reader-Objekts.

ReadRootComponent ruft die Methode ReadState der Komponente auf, die den Aufruf an TReader.ReadData zurückleitet. TComponent.ReadState ist eine virtuelle Methode, womit es der Komponente möglich wird, sich darauf vorzubereiten, daß sie mit neuen Daten aus dem Stream geladen wird.


TReader::ReadSignature

TReader	Siehe auch

Die Methode ReadSignature liest eine Borland C++Builder-Filer-Signatur aus dem Stream des Reader-Objekts.

void __fastcall ReadSignature(void);

Beschreibung

ReadSignature wird von verschiedenen Routinen verwendet, um sicherzustellen, daß die zu lesende Datei einen gültigen Borland C++Builder-Komponenten-Stream darstellt. Dies gilt z.B. für ReadRootComponent. Durch diese Überprüfung wird verhindert, daß das Reader-Objekt ungültige oder beschädigte Daten einzulesen versucht.

Die Signatur ist eine Folge von vier Zeichen. In dieser Borland C++Builder-Version lautet die Signatur 'TPF0'.


TReader::ReadStr

TReader	Siehe auch

Die Methode ReadStr wird intern von einigen Borland C++Builder-Komponenten zum Lesen eines String-Wertes verwendet.

System::AnsiString __fastcall ReadStr(void);

Beschreibung

Rufen Sie ReadStr nicht direkt auf. ReadStr ist für den internen Gebrauch durch einige VCL-Komponenten vorgesehen.

Achtung

Verwenden Sie für das Lesen von Komponenten-Strings immer die Methode ReadString. Die hier beschriebene Methode ReadStr kann Daten beschädigen, wenn sie falsch eingesetzt wird.


TReader::ReadString

TReader	Siehe auch

Die Methode ReadString liest einen markierten String aus dem Stream des Reader-Objekts und gibt den Inhalt zurück. Der String-Wert muß vorher mit WriteString geschrieben worden sein.

System::AnsiString __fastcall ReadString(void);

Beschreibung

ReadString ist eine Hilfsmethode, die von anderen Reader-Methoden zum Lesen eines Strings an der aktuellen Position verwendet wird. ReadString überprüft zuerst den Typ des Wertes (TValueType). Dazu wird ReadValue aufgerufen. Wenn der Typ vaString oder vaLString ist, ruft ReadString die Methode Read auf und gibt den String zurück. Andernfalls wird eine EReadError-Exception ausgelöst.

Achtung

Wenn Komponenten-Strings aus Streams gelesen werden sollen, verwenden Sie immer ReadString. Es gibt eine ähnlich benannte Methode ReadStr, die jedoch nur für den internen Gebrauch durch einige VCL-Komponenten vorgesehen ist.


TReader::ReadValue

TReader	Siehe auch

Die Methode ReadValue liest den Typ des nächsten Elements im Stream des Reader-Objekts. Nach der Rückkehr liegt die Stream-Position hinter der Markierung für den Wertetyp.

TValueType __fastcall ReadValue(void);

Beschreibung

ReadValue wird von anderen Methoden verwendet, wenn die nachfolgenden Bearbeitungsschritte davon abhängen, welchen Typ die zu lesenden Daten besitzen.

Der Typ TValueType definiert die Art des Wertes, der in Filer-Objekte geschrieben bzw. daraus gelesen wird. Die Filer-Objekte in Borland C++Builder verwenden ein bestimmtes Schema von Markierungen. Jedem Wert im Stream wird ein Präfix vorangestellt, das den Typ kennzeichnet. Diese Präfixe sind wiederum vom Typ TValueType.


TReader::SetName

TReader	Siehe auch

Mit der Methode SetName kann ein Reader-Objekt die Namen von Komponenten ändern, die aus dem zugehörigen Stream gelesen werden, bevor sie den Name-Eigenschaften der Komponenten zugewiesen werden.

virtual void __fastcall SetName(TComponent* Component,  System::AnsiString &Name);

Beschreibung

SetName wird von ReadComponent aufgerufen. ReadComponent liest zuerst den Namen aus dem Stream und übergibt diesen im Parameter Name an SetName. Der Parameter Name ist eine Variable, er kann also von SetName vor der Rückgabe geändert werden.

SetName ruft außerdem die Ereignisbehandlungsroutine auf, die dem Ereignis OnSetName zugeordnet ist. Die Ereignisbehandlungsroutine kann den String ebenfalls verändern.


TValueType

Die Methode TValueType definiert die verschiedenen Typen für Werte, die in Filer-Objekte geschrieben bzw. daraus gelesen werden.

void __fastcall CheckValue(TValueType Value);

Beschreibung

Der Typ TValueType wird von den Filer-Objekten der Klassen TReader und TWriter für die Typenprüfung von Eigenschaftswerten verwendet, wenn Komponenten mit ihren Eigenschaften aus Streams gelesen bzw. in Streams geschrieben werden.

Die Filer-Objekte in Borland C++Builder verwenden ein bestimmtes Schema von Markierungen. Jedem Wert im Stream wird ein Präfix vorangestellt, das den Typ kennzeichnet. Diese Präfixe sind wiederum vom Typ TValueType. Die folgende Tabelle enthält die möglichen Werte:

Wert	Bedeutung

vaNull	Kennzeichnet den Typ als die konstante Variante NULL.

vaList	Kennzeichnet den Typ als Liste von markierten Elementen, die mit NULL terminiert sind.

vaInt8	Kennzeichnet den Typ als Shortint.

vaInt16	Kennzeichnet den Typ als Smallint.

vaInt32	Kennzeichnet den Typ als Longint.

vaExtended	Kennzeichnet den Typ als Float.

vaString	Kennzeichnet den Typ als kurzen String.

vaIdent	Kennzeichnet den Typ als einen Pascal-String-Bezeichner.

vaFalse	Kennzeichnet den Typ als booleschen Wert False.

vaTrue	Kennzeichnet den Typ als booleschen Wert True.

vaBinary	Kennzeichnet den Typ als Block von Binärwerten, dem ein Längenbezeichner voransteht.

vaSet	Kennzeichnet den Typ als Menge.

vaLString	Kennzeichnet den Typ als langen String.

vaNil	Kennzeichnet den Typ als NULL.

vaCollection	Kennzeichnet den Typ als TCollection.


TReader::TReader

TReader	Siehe auch

TReader erzeugt ein neues TReader-Objekt.

__fastcall TReader(TStream* Stream, int BufSize);


Gültigkeitsbereich

Protected


Hierarchie

TObject

TFiler


TReader Beispiel

TReader


TRegIniFile

Hierarchie	Eigenschaften	Methoden

Header

vcl/registry.hpp

Die Klasse TRegIniFile bietet systemnahe Funktionalität für den Umgang mit der Registrierdatenbank von Windows 95 und Windows NT. Das besondere an dieser Klasse liegt darin, daß bestehende Borland C++Builder-Anwendungen, die noch mit den INI-Dateien von Windows 3.1 arbeiten, mit minimalen €nderungen für Windows 95/NT aufgerüstet werden können.

Beschreibung

TRegIniFile ermöglicht die Verwaltung der Registrierdatenbank von Windows 95/NT in einer Form, als ob es sich um eine INI-Datei von Windows 3.x handelte. Anstatt jedoch eine INI-Datei zu verarbeiten, greift TRegIniFile auf die Registrierdatenbank zu.

TRegIniFile ist von TRegistry abgeleitet, wodurch alle Eigenschaften und Methoden geerbt werden. Außerdem kommen die Eigenschaften und Methoden hinzu, die auch vom Objekt TIniFile verwendet werden. Einige der Methoden für TRegIniFile (z.B. ReadBool und WriteBool) überschreiben die Methoden von TRegistry.

Der Dateiname, der im Parameter FileName an ein TRegIniFile-Objekt übergeben wird, übernimmt die Funktion eines Unterschlüssels, der vom Hauptschlüssel der Registrierdatenbank ausgeht (per Voreinstellung von HKEY_CURRENT_USER). Was früher in einer INI-Datei ein „Abschnitt“ war, wird in der Registrierdatenbank ein „Schlüssel“. Analog dazu werden die einzelnen Variableneinträge im Abschnitt einer INI-Datei zu „Datenwerten“, die in der Registrierung einem bestimmen Schlüssel zugeordnet sind.

TRegIniFile ist außerordentlich hilfreich, wenn 16-Bit-Anwendungen, die unter Windows 3.x entwickelt wurden, auf Windows 95/NT umgestellt werden müssen. Als Programmierer müssen Sie nichts weiter tun, als im Quellcode alle Referenzen auf TIniFile in Referenzen auf TRegIniFile umzuwandeln. Anschließend compilieren Sie erneut. Ihre Anwendung greift nun nicht mehr auf INI-Dateien, sondern auf die Registrierdatenbank zu. €nderungen in der logischen Programmstruktur sind nicht notwendig.

Hinweis

Das oben beschriebene Vorgehen ist nicht anwendbar, wenn es sich um benutzerspezifische INI-Dateien handelt, die nicht den standardisierten Aufbau besitzen.

Tip

TRegIniFile stellt eine sehr einfach zu handhabende Schnittstelle zur Registrierdatenbank dar. Sie benötigen keine Kenntnisse über die eigentliche Struktur der Registrierung. Einige Entwickler bevorzugen daher TRegIniFile anstelle von TRegistry.


Eigenschaften von TRegIniFile

TRegIniFile	Alphabetisch	Legende

In TRegIniFile

FileName

Abgeleitet von TRegistry

CurrentKey

CurrentPath

LazyWrite

RootKey


Eigenschaften von TRegIniFile

TRegIniFile	Nach Objekten	Legende

CurrentKey

CurrentPath

FileName

LazyWrite

RootKey


TRegIniFile::FileName

TRegIniFile	Siehe auch

Die Eigenschaft enthält den Namen des Schlüssels, der in der Registrierdatenbank geöffnet oder erzeugt wurde.

__property System::AnsiString FileName;

Beschreibung

Mit einem Lesezugriff auf FileName kann der Name des Schlüssels ermittelt werden, der in der Registrierdatenbank als Hauptschlüssel für alle TRegIniFile-Operationen fungiert.


Methoden von TRegIniFile

TRegIniFile	Alphabetisch

In TRegIniFile

~TRegIniFile

DeleteKey

EraseSection

ReadBool

ReadInteger

ReadSection

ReadSections

ReadSectionValues

ReadString

TRegIniFile

WriteBool

WriteInteger

WriteString

Abgeleitet von TRegistry

CloseKey

CreateKey

DeleteValue

GetDataInfo

GetDataSize

GetDataType

GetKeyInfo

GetKeyNames

GetValueNames

HasSubKeys

KeyExists

LoadKey

MoveKey

OpenKey

ReadBinaryData

ReadCurrency

ReadDate

ReadDateTime

ReadFloat

ReadTime

RegistryConnect

RenameValue

ReplaceKey

RestoreKey

SaveKey

UnLoadKey

ValueExists

WriteBinaryData

WriteCurrency

WriteDate

WriteDateTime

WriteFloat

WriteTime

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TRegIniFile

TRegIniFile	Nach Objekten

~TRegIniFile

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

CloseKey

CreateKey

DefaultHandler

DeleteKey

DeleteValue

Dispatch

EraseSection

FieldAddress

FreeInstance

Free

GetDataInfo

GetDataSize

GetDataType

GetKeyInfo

GetKeyNames

GetValueNames

HasSubKeys

InheritsFrom

InitInstance

InstanceSize

KeyExists

LoadKey

MethodAddress

MethodName

MoveKey

NewInstance

OpenKey

ReadBinaryData

ReadBool

ReadCurrency

ReadDateTime

ReadDate

ReadFloat

ReadInteger

ReadSections

ReadSection

ReadSectionValues

ReadString

ReadTime

RegistryConnect

RenameValue

ReplaceKey

RestoreKey

SaveKey

TRegIniFile

UnLoadKey

ValueExists

WriteBinaryData

WriteBool

WriteCurrency

WriteDateTime

WriteDate

WriteFloat

WriteInteger

WriteString

WriteTime


TRegIniFile::~TRegIniFile

TRegIniFile

Der Destruktor ~TRegIniFile gibt den Speicher frei, der für das TRegIniFile-Objekt reserviert war. Rufen Sie ~TRegIniFile nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TRegIniFile automatisch aufgerufen wird.

__fastcall virtual ~TRegIniFile(void);


TRegIniFile::DeleteKey

TRegIniFile	Siehe auch

Die Methode löscht einen Datenwert, der einem bestimmten Schlüssel zugeordnet ist.

void __fastcall DeleteKey(const System::AnsiString Section, const System::AnsiString Ident);

Beschreibung

Mit DeleteKey wird ein Datenwert gelöscht. Der String Section enthält den Namen des Schlüssels in der Registrierdatenbank, der wiederum den zu löschenden Datenwert enthält. Der Name des Datenwertes wird im Parameter Ident übergeben.

Hinweis

Diese Funktion überschreibt die Methode DeleteKey der Klasse TRegistry, von der TRegIniFile abgeleitet ist. Mit dem Aufruf TRegistry::DeleteKey können Sie auf die entsprechende Methode von TRegistry zugreifen.


TRegIniFile::EraseSection

TRegIniFile	Siehe auch

Die Methode löscht in der Registrierdatenbank einen Schlüssel und dessen Datenwerte.

void __fastcall EraseSection(const System::AnsiString Section);

Beschreibung

Mit EraseSection wird ein Schlüssel mit seinen Datenwerten aus der Registrierdatenbank gelöscht. Der Parameter Section bezeichnet den Schlüssel, der gelöscht werden soll.


TRegIniFile::ReadBool

TRegIniFile	Siehe auch

Die Methode liest einen booleschen Wert aus einem bestimmten Datenwert, der einem Schlüssel zugeordnet ist.

bool __fastcall ReadBool(const System::AnsiString Section, const System::AnsiString Ident, bool Default );

Beschreibung

Mit ReadBool wird ein boolescher Wert aus einem Datenwert gelesen, der zum angegebenen Schlüssel gehört.

Der String Section bezeichnet den Schlüssel, zu dem der gewünschte Datenwert gehört. Der String Ident gibt den Namen des Datenwertes an. Der Parameter Default ist ein boolescher Wert, der dann verwendet werden soll, wenn es keinen Schlüssel gibt, dessen Name mit dem Wert von Section übereinstimmt, oder keinen Datenwert, dessen Name mit dem Wert von Ident übereinstimmt.

Hinweis

Diese Funktion überschreibt die Funktion ReadBool der Klasse TRegistry, von der TRegIniFile abgeleitet ist. Mit dem Aufruf TRegistry::ReadBool können Sie auf die entsprechende Methode von TRegistry zugreifen.


TRegIniFile::ReadInteger

TRegIniFile	Siehe auch

Die Methode liest einen Integer aus einem bestimmten Datenwert (Ident), der zum angegebenen Schlüssel (Section) gehört.

long __fastcall ReadInteger(const System::AnsiString Section, const System::AnsiString Ident, long  Default);

Beschreibung

Mit ReadInteger wird ein Integer-Wert aus einem bestimmten Datenwert gelesen, der einem Schlüssel zugeordnet ist.

Der String-Parameter Section bezeichnet den Schlüssel, aus dem ein Datenwert gelesen werden soll. Der String Ident enthält den Namen des gewünschten Datenwertes. Der Parameter Default ist ein Integer-Wert, der dann verwendet wird, wenn es keinen Schlüssel gibt, dessen Name dem Wert von Section entspricht oder wenn es keinen Datenwert gibt, dessen Name dem Wert von Ident entspricht.

Hinweis

Diese Funktion überschreibt die Funktion ReadInteger der Klasse TRegistry, von der TRegIniFile abgeleitet ist. Mit dem Aufruf TRegistry::ReadInteger können Sie auf die entsprechende Methode von TRegistry zugreifen.


TRegIniFile::ReadSection

TRegIniFile	Siehe auch

Die Methode liest die Namen aller Datenwerte, die einem bestimmten Schlüssel zugeordnet sind, und speichert diese Namen in einem TString-Objekt.

void __fastcall ReadSection(const System::AnsiString Section, Classes::TStrings* Strings);

Beschreibung

Mit ReadSection werden die Namen aller Datenwerte zu einem bestimmten Schlüssel gelesen und in einem TString-Objekt abgelegt. Der String Section bezeichnet den Schlüssel, dessen Datenwerte gesucht sind.

Der Parameter Strings gibt das String-Objekt an, das die zurückgelieferten Namen aufnimmt. Der Parameter kann auf ein TString-Objekt zeigen, etwa auf eine String-Liste, oder auf eine Komponenteneigenschaft wie Items für eine TListBox-Komponente, die wiederum ein TString-Objekt ist.


TRegIniFile::ReadSections

TRegIniFile	Siehe auch

Die Methode liefert den Namen aller Unterschlüssel, die dem aktuellen Schlüssel zugeordnet sind.

void __fastcall ReadSections(Classes::TStrings* Strings);

Beschreibung

Mit ReadSections können die Namen aller Unterschlüssel ermittelt werden, die zum aktuellen Schlüssel gehören.

Der Parameter Strings bezeichnet das String-Objekt, das die gesuchten Namen aufnehmen soll. Der Parameter kann entweder auf ein TString-Objekt zeigen oder auf eine Komponenteneigenschaft wie Items für eine TListBox-Komponente, die wiederum ein TString-Objekt darstellt.


TRegIniFile::ReadSectionValues

TRegIniFile	Siehe auch

Die Methode liest die Datenwerte, die zu einem bestimmten Schlüssel gehören, und speichert sie in einem String-Objekt.

void __fastcall ReadSectionValues(const System::AnsiString Section, Classes::TStrings* Strings);

Beschreibung

Mit ReadSectionValues können alle Datenwerte eines bestimmten Schlüssels in ein String-Objekt eingelesen werden. Der Parameter Section bezeichnet den Namen des Schlüssels, dessen Datenwerte gesucht sind. Der Parameter String verweist auf das String-Objekt, das die zurückgegebenen Werte aufnimmt.

Der Parameter Strings kann entweder auf ein TString-Objekt oder auf eine Komponenteneigenschaft zeigen, wie etwa auf Items für eine TListBox-Komponente, die wiederum ein TString-Objekt darstellt. Über die Eigenschaft Values des String-Objekts kann auf einen bestimmten String zugegriffen werden.


TRegIniFile::ReadString

TRegIniFile	Siehe auch

Die Methode liest einen String aus einem bestimmten Datenwert (Ident), der dem angegebenen Schlüssel (Section) zugeordnet ist.

System::AnsiString __fastcall ReadString(const System::AnsiString Section, const System::AnsiString  Ident, const System::AnsiString Default);

Beschreibung

Mit ReadString wird ein String aus einem Datenwert gelesen, der zu einem bestimmten Schlüssel gehört.

Der String Section bezeichnet den Schlüssel. Der String Ident enthält den Namen des gewünschten Datenwertes. Der Parameter Default ist ein String, der dann verwendet wird, wenn es keinen Schlüssel mit dem Namen gibt, der dem Wert von Section entspricht, oder keinen Datenwert mit dem Namen, den Ident vorgibt.

Hinweis

Diese Funktion überschreibt die Funktion ReadString der Klasse TRegistry, von der TRegIniFile abgeleitet ist. Mit dem Aufruf TRegistry::ReadString können Sie auf die entsprechende Methode von TRegistry zugreifen.


TRegIniFile::TRegIniFile

TRegIniFile	Siehe auch

Der Konstruktor TRegIniFile erzeugt ein neues TRegIniFile-Objekt.

__fastcall TRegIniFile(const System::AnsiString FileName);

Beschreibung

Mit TRegIniFile können Sie für eine Anwendung ein TRegIniFile-Objekt erzeugen. TRegIniFile erzeugt die Eigenschaft FileName, die den Namen des Schlüssels angibt, der in der Registrierung geöffnet oder erzeugt werden soll.


TRegIniFile::WriteBool

TRegIniFile	Siehe auch

Die Methode schreibt einen booleschen Wert in einen bestimmten Datenwert, der dem angegebenen Schlüssel zugeordnet ist.

void __fastcall WriteBool(const System::AnsiString Section, const System::AnsiString Ident, bool Value );

Beschreibung

Mit WriteBool wird ein boolescher Wert im Datenwert eines bestimmten Schlüssels gespeichert.

Der String Section bezeichnet den Schlüssel, in dem ein Datenwert gespeichert werden soll. Der String Ident enthält den Namen des betreffenden Datenwertes. Der Parameter Value ist der boolesche Wert, der in den Datenwert gelangen soll.

Hinweis

Diese Funktion überschreibt die Prozedur WriteBool der Klasse TRegistry, von der TRegIniFile abgeleitet ist. Mit dem Aufruf TRegistry::WriteBool können Sie auf die entsprechende Methode von TRegistry zugreifen.


TRegIniFile::WriteInteger

TRegIniFile	Siehe auch

Die Methode schreibt einen langen Integer-Wert in einen bestimmten Datenwert, der zum angegebenen Schlüssel gehört.

void __fastcall WriteInteger(const System::AnsiString Section, const System::AnsiString Ident, long  Value);

Beschreibung

Mit WriteInteger wird ein Integer in einem Datenwert gespeichert, der zu einem bestimmten Schlüssel gehört.

Der String Section bezeichnet den Schlüssel, in dem ein Datenwert gespeichert werden soll. Der String Ident enthält den Namen des betreffenden Datenwertes. Der Parameter Value ist der Integer, der in den Datenwert gelangen soll.

Hinweis

Diese Funktion überschreibt die Prozedur WriteInteger der Klasse TRegistry, von der TRegIniFile abgeleitet ist. Mit dem Aufruf TRegistry::WriteInteger können Sie auf die entsprechende Methode von TRegistry zugreifen.


TRegIniFile::WriteString

TRegIniFile	Siehe auch

Die Methode schreibt einen String in einen bestimmten Datenwert, der zum angegebenen Schlüssel gehört.

void __fastcall WriteString(const System::AnsiString Section, const System::AnsiString Ident, const System::AnsiString  Value);

Beschreibung

Mit WriteString wird ein String in einem Datenwert gespeichert, der einem bestimmten Schlüssel zugeordnet ist.

Der String Section bezeichnet den Schlüssel, der den Datenwert enthält. Der String ist der Name des Datenwertes, in den geschrieben werden soll. Der Parameter Value ist der eigentliche String, der in den Datenwert gelangen soll.

Hinweis

Diese Funktion überschreibt die Prozedur WriteString der Klasse TRegistry, von der TRegIniFile abgeleitet ist. Mit dem Aufruf TRegistry::WriteString können Sie auf die entsprechende Methode von TRegistry zugreifen.


Zugriff

Read-only


Hierarchie

TObject

TRegistry


TRegIniFile Beispiel

TRegIniFile


TRegistry

Hierarchie	Eigenschaften	Methoden

Header

vcl/registry.hpp

Das Objekt TRegistry bietet systemnahe Funktionalität für den Zugriff auf die Registrierdatenbank von Microsoft Windows95/NT.

Beschreibung

TRegistry kapselt den Zugriff auf die Windows 95/NT-Registrierung von einer Anwendung aus. Bei der Registrierung handelt es sich um eine Datenbank, in der Anwendungen Informationen zur aktuellen Konfiguration verwalten. Die Informationen sind dabei nach hierarchischen Gesichtspunkten gegliedert. Jede Verzweigung in dieser baumartigen Struktur wird als Schlüssel bezeichnet. Jeder Schlüssel kann weitere Unterschlüssel sowie Datenwerte enthalten, die einen bestimmten Teil der Konfigurationsinformationen repräsentieren.

Alle Schlüssel, die eine Anwendung erzeugt, öffnet, liest oder schreibt, sind Unterschlüssel von sogenannten vordefinierten Hauptschlüsseln. Standardmäßig wird ein TRegistry-Objekt mit dem Hauptschlüssel HKEY_CURRENT_USER erzeugt.

In einem TRegistry-Objekt kann zu einem bestimmten Zeitpunkt immer nur auf einen einzigen Schlüssel zugegriffen werden. Der Schlüssel, der aktuell erreichbar ist, kann mit einem Lesezugriff auf die Eigenschaft CurrentKey ermittelt werden. Mit den Methoden von TRegistry kann eine Anwendung Schlüssel öffnen, schließen, speichern, kopieren und löschen.

Jeder Schlüssel kann einen oder mehrere Datenwerte mit Konfigurationsinformationen aufnehmen. Über die Methoden von TRegistry läßt sich feststellen, ob ein Schlüssel Daten enthält. Außerdem können Schlüsseldaten gelesen und geschrieben werden.


Eigenschaften von TRegistry

TRegistry	Alphabetisch	Legende

In TRegistry

CurrentKey

CurrentPath

LazyWrite

RootKey


Eigenschaften von TRegistry

TRegistry	Nach Objekten	Legende

CurrentKey

CurrentPath

LazyWrite

RootKey


TRegistry::CurrentKey

TRegistry	Siehe auch

Die Eigenschaft liefert den aktuell geöffneten Schlüssel der Registrierdatenbank.

__property HKEY CurrentKey;

Beschreibung

Mit CurrentKey wird der Schlüssel ermittelt, der aktuell in der Registrierdatenbank geöffnet ist. Alle Operationen von TRegistry betreffen nur diesen Schlüssel. Vor dem Zugriff auf einen anderen Schlüssel muß die Methode OpenKey aufgerufen werden.


TRegistry::CurrentPath

TRegistry	Siehe auch

Diese Eigenschaft gibt den Registrierungspfad zurück, der für den aktuellen Schlüssel gilt.

__property System::AnsiString CurrentPath;

Beschreibung

Mit CurrentPath kann innerhalb der Registrierung der Pfad zum aktuellen Schlüssel ermittelt werden. Die Registrierdatenbank ist hierarchisch aufgebaut, so daß CurrentPath einen String zurückgibt, der ausgehend vom Hauptschlüssel alle Schlüssel, einschließlich des aktuellen, enthält.

Der Wert von CurrentPath wird jedesmal automatisch neu gesetzt, sobald ein anderer Schlüssel zum aktuellen wird.


TRegistry::LazyWrite

TRegistry	Siehe auch

Die Eigenschaft legt fest, nach welchem Schema die Schlüssel in die Registrierung geschrieben werden, wenn die Methode CloseKey aufgerufen wird.

__property bool LazyWrite;

Beschreibung

Mit LazyWrite wird gesteuert, wie Schlüssel in die Registrierung geschrieben werden. Standardmäßig hat LazyWrite den Wert True, wenn ein Registrierungsobjekt zum ersten Mal erzeugt wird. In dieser Einstellung werden Schlüssel beim Schließen in die Registrierung geschrieben. Die Methode CloseKey kann aber eventuell zurückkehren, bevor die Schreiboperation stattgefunden hat.

Wenn LazyWrite auf False steht, werden Schlüssel in die Registrierung geschrieben, bevor CloseKey zurückkehrt. Setzen Sie LazyWrite nur dann auf False, wenn unbedingt nötig. Damit ist zwar garantiert, daß Änderungen an Schlüsseln in die Registrierung geschrieben werden, bevor weitere Verarbeitungsschritte stattfinden, aber das Schließen von Schlüsseln beansprucht dann mehr Systemressourcen. Wenn in einer Anwendung viele Registrierungseinträge geändert oder angezeigt werden müssen, verringert dies die Leistung.


TRegistry::RootKey

TRegistry	Siehe auch

Die Eigenschaft bestimmt in einer Anwendung den Hauptschlüssel für das TRegistry-Objekt.

__property HKEY RootKey;

Beschreibung

Mit RootKey wird die Hierarchie der Unterschlüssel definiert, auf die eine Anwendung zugreifen kann, oder es wird der Hauptschlüssel der Anwendung definiert.

Per Voreinstellung wird RootKey beim Erzeugen des Registrierungsobjekts auf HKEY_CURRENT_USER gesetzt. Um den Hauptschlüssel zu ändern, setzen Sie die Eigenschaft RootKey auf einen gültigen Integer-Wert.

Hinweis

Bei einigen Operationen, wie z.B. LoadKey oder RegistryConnect, muß die Anwendung eventuell den Vorgabewert von RootKey ändern.


Methoden von TRegistry

TRegistry	Alphabetisch

In TRegistry

~TRegistry

CloseKey

CreateKey

DeleteKey

DeleteValue

GetDataInfo

GetDataSize

GetDataType

GetKeyInfo

GetKeyNames

GetValueNames

HasSubKeys

KeyExists

LoadKey

MoveKey

OpenKey

ReadBinaryData

ReadBool

ReadCurrency

ReadDate

ReadDateTime

ReadFloat

ReadInteger

ReadString

ReadTime

RegistryConnect

RenameValue

ReplaceKey

RestoreKey

SaveKey

TRegistry

UnLoadKey

ValueExists

WriteBinaryData

WriteBool

WriteCurrency

WriteDate

WriteDateTime

WriteFloat

WriteInteger

WriteString

WriteTime

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TRegistry

TRegistry	Nach Objekten

~TRegistry

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

CloseKey

CreateKey

DefaultHandler

DeleteKey

DeleteValue

Dispatch

FieldAddress

FreeInstance

Free

GetDataInfo

GetDataSize

GetDataType

GetKeyInfo

GetKeyNames

GetValueNames

HasSubKeys

InheritsFrom

InitInstance

InstanceSize

KeyExists

LoadKey

MethodAddress

MethodName

MoveKey

NewInstance

OpenKey

ReadBinaryData

ReadBool

ReadCurrency

ReadDateTime

ReadDate

ReadFloat

ReadInteger

ReadString

ReadTime

RegistryConnect

RenameValue

ReplaceKey

RestoreKey

SaveKey

TRegistry

UnLoadKey

ValueExists

WriteBinaryData

WriteBool

WriteCurrency

WriteDateTime

WriteDate

WriteFloat

WriteInteger

WriteString

WriteTime


TRegistry::~TRegistry

TRegistry	Siehe auch

Der Destruktor ~TRegistry gibt den Speicher frei, der für das TRegistry-Objekt reserviert war. Rufen Sie ~TRegistry nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TRegistry automatisch aufgerufen wird.

__fastcall virtual ~TRegistry(void);

Beschreibung

~TRegistry schließt den aktuellen Schlüssel und gibt die Ressourcen frei, die für das Registrierungsobjekt reserviert waren.


TRegistry::CloseKey

TRegistry	Siehe auch

Diese Methode schreibt den aktuellen Schlüssel in die Registrierdatenbank und schließt ihn.

void __fastcall CloseKey(void);

Beschreibung

Mit CloseKey wird der aktuelle Schlüssel in die Registrierung geschrieben und dann geschlossen. In Anwendungen sollten Schlüssel nie länger als nötig geöffnet bleiben. Viele Methoden von TRegistry rufen CloseKey routinemäßig nach Lese- oder Schreibvorgängen auf. Ein Aufruf von CloseKey hat keinen Effekt, wenn aktuell kein Schlüssel geöffnet ist.

Hinweis

Wenn eine Anwendung einen Schlüssel schließt, wird dieser in die Registrierung geschrieben. Die Eigenschaft LazyWrite legt dabei fest, nach welchem zeitlichen Schema dieser Schreibvorgang abläuft.

Der Destruktor ~TRegistry schließt den Schlüssel, wenn dieser noch geöffnet ist.


TRegistry::CreateKey

TRegistry	Siehe auch

Die Methode erzeugt in der Registrierung einen neuen Schlüssel.

bool __fastcall CreateKey(const System::AnsiString Key);

Beschreibung

Mit CreateKey wird ein neuer Schlüssel, der mit dem Parameter Key definiert ist, in die Registrierung eingefügt. Key kann ein absoluter oder ein relativer Schlüsselname sein. Ein absoluter Schlüssel beginnt mit einem Backslash und setzt direkt auf den Hauptschlüssel auf. Ein relativer Schlüssel ist ein Unterschlüssel des aktuellen.

CreateKey gibt True zurück, wenn die Erzeugung erfolgreich ist. Im Fehlerfall wird eine Exception ausgelöst und False zurückgegeben. Der Versuch, einen bereits vorhandenen Schlüssel erneut zu erzeugen, hat keine Auswirkung.

CreateKey erzeugt nur permanente Schlüssel. Wenn unter Windows NT temporäre Schlüssel erforderlich sind, muß die Windows-API direkt aufgerufen werden.

Alle erzeugten Schlüssel haben die Zugriffsebene KEY_ALL_ACCESS. Wenn Sie Schlüssel mit eingeschränktem Zugriff wünschen, müssen Sie die Windows-API direkt aufrufen.

Ein von CreateKey erzeugter Schlüssel hat zunächst keine Werte. Zur Einstellung von Werten dienen die Prozeduren WriteCurrency, WriteBinaryData, WriteBool, WriteDate, WriteDateTime, WriteFloat, WriteInteger, WriteString und WriteTime.


TRegistry::DeleteKey

TRegistry	Siehe auch

Die Methode entfernt einen bestimmten Schlüssel und die zugehörigen Daten aus der Registrierung.

bool __fastcall DeleteKey(const System::AnsiString Key);

Beschreibung

DeleteKey entfernt den angegebenen Schlüssel sowie die zugehörigen Daten (falls vorhanden) aus der Registrierung. Wenn der Schlüssel noch Unterschlüssel besitzt, werden auch diese mit ihren Daten gelöscht.

DeleteKey gibt bei Erfolg den Wert True zurück. Im Fehlerfall lautet der Rückgabewert False.


TRegistry::DeleteValue

TRegistry	Siehe auch

Die Methode löscht einen Datenwert, der dem aktuellen Schlüssel zugeordnet ist.

bool __fastcall DeleteValue(const System::AnsiString Name);

Beschreibung

Mit DeleteValue wird ein bestimmter Datenwert gelöscht, der zum aktuellen Schlüssel gehört. Der zu löschende Wert wird im String-Parameter Name bezeichnet. Schlüssel können mehrere Datenwerte enthalten, von denen jeder einen eindeutigen Namen besitzt.

DeleteValue gibt bei Erfolg den Wert True zurück. Im Fehlerfall lautet der Rückgabewert False.


TRegistry::GetDataInfo

TRegistry	Siehe auch

Die Methode liefert Informationen über einen bestimmten Datenwert, der zum aktuellen Schlüssel gehört.

bool __fastcall GetDataInfo(const System::AnsiString ValueName, TRegDataInfo &Value);

Beschreibung

Über GetDataInfo erhält man Informationen über einen Datenwert, der dem aktuellen Schlüssel zugeordnet ist. Der String-Parameter ValueName enthält den Namen des Datenwertes, der abgefragt werden soll. Der Parameter Value ist ein Datensatz des Typs TRegDataInfo und enthält die zurückgegebenen Informationen. Wenn der Datenwert vom Typ rdString oder rdExpandString ist, umfaßt er ein zusätzliches Byte für das abschließende NULL-Zeichen.

GetDataInfo liefert bei erfolgreicher Ausführung den Wert True zurück. Andernfalls lautet der Rückgabewert False, und der Datensatz Value wird mit Nullen gefüllt.

Value ist ein Datensatz mit dem Typ TRegDataInfo und ist in der Anwendung deklariert. Datensätze des Typs TRegDataInfo enthalten zwei Felder RegData (Typ TRegDataType) und DataSize. RegDate bestimmt den Datentyp des Datenwertes, und DataSize bestimmt die Größe des Datenwertes in Byte. RegData kann die folgenden Werte annehmen:

Wert	Bedeutung

rdUnknown	Der Typ des Datenwertes ist nicht definiert.

rdString	Der Datenwert ist ein nullterminierter String. Abhängig davon, ob die Anwendung die Unicode- oder die ANSI-String-Funktionen verwendet, ist er ein Unicode- oder ein ANSI-String.

rdExpandString	Der Datenwert ist ein nullterminierter String mit nicht erweiterten Referenzen auf Umgebungsvariablen (z.B. "%PATH%"). Abhängig davon, ob die Anwendung die Unicode- oder die ANSI-String-Funktionen verwendet, ist er ein Unicode- oder ein ANSI-String.

rdInteger	Der Datenwert ist eine 32-Bit-Zahl.

rdBinary	Der Datenwert liegt in beliebiger binärer Form vor.


TRegistry::GetDataSize

TRegistry	Siehe auch

Die Methode liefert die Größe in Byte eines bestimmten Datenwertes, der dem aktuellen Schlüssel zugeordnet ist.

int __fastcall GetDataSize(const System::AnsiString ValueName);

Beschreibung

Mit GetDataSize wird die Größe eines bestimmten Datenwertes in Byte ermittelt. Der String-Parameter ValueName bezeichnet den Namen des Datenwertes, der untersucht werden soll.

Bei Erfolg liefert GetDataSize die Größe des Datenwertes zurück. Ansonsten lautet der Rückgabewert -1.

Hinweis

Wenn der Datenwert als String vorliegt, ist im Rückgabewert auch ein zusätzliches Byte für das abschließende NULL-Zeichen enthalten.


TRegistry::GetDataType

TRegistry	Siehe auch

Die Methode liefert den Datentyp eines Datenwertes, der dem aktuellen Schlüssel zugeordnet ist. Die möglichen Rückgabewerte sind in einem Aufzählungstyp definiert.

TRegDataType __fastcall GetDataType(const System::AnsiString ValueName);

Beschreibung

Mit GetDataType wird der Datentyp eines Datenwertes bestimmt, der dem aktuellen Schlüssel zugeordnet ist. Der String-Parameter ValueName enthält den Namen des Datenwertes, der abgefragt werden soll.

Der Rückgabewert besitzt den Aufzählungstyp TRegDataType. Folgende Werte sind möglich:

Wert	Bedeutung

rdUnknown	Der Typ des Datenwertes ist nicht definiert.

rdString	Der Datenwert ist ein nullterminierter String. Abhängig davon, ob die Anwendung die Unicode- oder die ANSI-String-Funktionen verwendet, ist er ein Unicode- oder ein ANSI-String.

rdExpandString	Der Datenwert ist ein nullterminierter String mit nicht erweiterten Referenzen auf Umgebungsvariablen (z.B. "%PATH%"). Abhängig davon, ob die Anwendung die Unicode- oder die ANSI-String-Funktionen verwendet, ist er ein Unicode- oder ein ANSI-String.

rdInteger	Der Datenwert ist eine 32-Bit-Zahl.

rdBinary	Der Datenwert liegt in beliebiger binärer Form vor.


TRegistry::GetKeyInfo

TRegistry	Siehe auch

Die Methode gibt Informationen über den aktuellen Schlüssel zurück.

bool __fastcall GetKeyInfo(TRegKeyInfo &Value);

Beschreibung

Über GetKeyInfo erhält eine Anwendung sämtliche Informationen zum aktuellen Schlüssel. Die Variable Value ist in der Anwendung deklariert und nimmt die zurückgegebenen Informationen auf. Value muß den Typ TRegKeyInfo besitzen. Die Funktion liefert folgende Details:

•	Anzahl der Unterschlüssel

•	Anzahl der Zeichen des längsten Unterschlüssel-Namens

•	Anzahl der Datenwerte

•	Größte Länge eines Datenwert-Namens

•	Größte Länge eines Datenwertes

•	Zeit des letzten Schreibzugriffs auf den Schlüssel

Bei Erfolg liefert GetKeyInfo den Wert True zurück. Ansonsten lautet der Rückgabewert False, und der Datensatz Value wird mit Nullen gefüllt.


TRegistry::GetKeyNames

TRegistry	Siehe auch

Die Methode gibt eine String-Liste mit den Namen aller Unterschlüssel zurück, die zum aktuellen Schlüssel gehören.

void __fastcall GetKeyNames(Classes::TStrings* Strings);

Beschreibung

Mit GetKeyNames ermitteln Sie die Namen aller Unterschlüssel, die dem aktuellen Schlüssel zugeordnet sind. Diese Informationen sind erforderlich, wenn in einer Anwendung über eine Reihe von Schlüsseln iteriert werden soll.

Die Variable Strings besitzt den Typ TString und nimmt die Liste mit den Namen der Unterschlüssel auf.


TRegistry::GetValueNames

TRegistry	Siehe auch

Die Methode gibt eine String-Liste mit den Namen aller Datenwerte zurück, die dem aktuellen Schlüssel zugeordnet sind.

void __fastcall GetValueNames(Classes::TStrings* Strings);

Beschreibung

Mit GetValueNames ermitteln Sie die Namen aller Datenwerte, die dem aktuellen Schlüssel zugeordnet sind. Diese Informationen sind erforderlich, wenn in einer Anwendung über mehrere Datenwerte eines Schlüssels iteriert werden soll.

Die Variable Strings ist vom Typ TString und nimmt die Liste mit den Namen der Datenwerte auf.


TRegistry::HasSubKeys

TRegistry	Siehe auch

Die Methode ermittelt, ob der aktuelle Schlüssel Unterschlüssel besitzt.

bool __fastcall HasSubKeys(void);

Beschreibung

Mit HasSubKeys kann ermittelt werden, ob sich der aktuelle Schlüssel in weitere Unterschlüssel verzweigt. HasSubKeys gibt den Wert True zurück, wenn der aktuelle Schlüssel in der untersten Verzweigungsebene liegt. Andernfalls lautet der Rückgabewert False.


TRegistry::KeyExists

TRegistry	Siehe auch

Die Methode ermittelt, ob der angegebene Schlüssel existiert.

bool __fastcall KeyExists(const System::AnsiString Key);

Beschreibung

Mit KeyExists wird ermittelt, ob ein Schlüssel mit dem angegebenen Namen existiert. Der gesuchte Name wird im Parameter Key übergeben.


TRegistry::LoadKey

TRegistry	Siehe auch

Die Methode erzeugt ausgehend vom Hauptschlüssel einen Unterschlüssel und lädt in diesen Registrierungsinformationen aus einer Datei.

bool __fastcall LoadKey(const System::AnsiString Key, const System::AnsiString FileName);

Beschreibung

Rufen Sie LoadKey auf, um folgendes zu erreichen:

1	Ausgehend vom Hauptschlüssel einen neuen Unterschlüssel erzeugen.

2	Registrierungsinformationen aus einer Datei in den Unterschlüssel laden. Registrierungsinformationen können Datenwerte, Unterschlüssel sowie Datenwerte für diese Unterschlüssel umfassen.

Mit LoadKey wird es vereinfacht, in einer einzigen Operation einen Schlüssel mit Datenwerten sowie Unterschlüssel mit Datenwerten zu erzeugen. Für die Gesamtheit dieser Schlüssel und Datenwerte hat sich in der Literatur der englische Begriff „Hive“ eingebürgert. Eine wörtliche Übersetzung wäre „Bienenschwarm“. Dieser Hive wird am besten aus einer Datei eingelesen, anstatt jeden Schlüssel und jeden Wert einzeln zu erzeugen. Ein solches Verfahren ist vor allem dann sinnvoll, wenn die Anwendung vom Benutzer zur Laufzeit neu konfiguriert werden kann.

Hinweis

Vor dem Aufruf von LoadKey muß die Anwendung die Eigenschaft RootKey auf HKEY_USERS, HKEY_LOCAL_MACHINE oder auf den Wert gesetzt werden, der mit einem vorherigen Aufruf von RegistryConnect ermittelt wurde.

Der Parameter Key ist der Name des Unterschlüssels, der erzeugt werden soll. Der Parameter FileName bezeichnet den Speicherort der Datei mit den Registrierungsinformationen. Diese Datei muß vorher mit der Funktion SaveKey oder der Windows-API-Funktion RegSaveKey erzeugt worden sein. Bei Systemen, denen eine Dateizuordnungstabelle (FAT) zugrundeliegt, darf FileName keine Erweiterung enthalten.


TRegistry::MoveKey

TRegistry	Siehe auch

Die Methode verschiebt einen vorhandenen Schlüssel zusammen mit Unterschlüsseln und Datenwerten an eine neue Position. Dabei wird ein neuer Schlüsselname verwendet.

void __fastcall MoveKey(const System::AnsiString OldName, const System::AnsiString NewName, bool Delete );

Beschreibung

Mit MoveKey wird ein vorhandener Schlüssel zusammen mit Unterschlüsseln und Datenwerten an eine andere Position verschoben oder kopiert. Der Kopiervorgang verläuft rekursiv, das heißt, eventuell vorhandene Unterschlüssel und deren Datenwerte werden ebenfalls kopiert. Nach Beendigung des Vorgangs wird der neue Schlüssel geschlossen.

Der Parameter OldName bezeichnet den Schlüssel, der kopiert oder verschoben werden soll. Der neue Name für die Kopie des Schlüssels wird in NewName übergeben. Wenn der Name in NewName noch nicht existiert, wird er von MoveKey erzeugt. Der boolesche Parameter Delete steuert, ob der alte Schlüssel nach dem Kopiervorgang gelöscht werden soll: True bedeutet, daß OldName nach dem Kopieren gelöscht wird. Andernfalls wird der alte Schlüssel geschlossen.


TRegistry::OpenKey

TRegistry	Siehe auch

Die Methode öffnet den angegebenen Schlüssel.

bool __fastcall OpenKey(const System::AnsiString Key, bool CanCreate);

Beschreibung

Mit OpenKey wird der mit Key bezeichnete Schlüssel zum aktuellen gemacht. Wenn Key leer ist, wird die Eigenschaft CurrentKey auf den Schlüssel gesetzt, der mit der Eigenschaft RootKey bezeichnet wird.

Der Parameter CanCreate steuert, ob der angegebene Schlüssel erzeugt werden soll, wenn er noch nicht existiert (True), oder nicht (False).

Der Schlüssel wird mit der Zugriffsebene KEY_ALL_ACCESS geöffnet. OpenKey erzeugt nur permanente Schlüssel. Permanente Schlüssel zeichnen sich dadurch aus, daß sie in der Registrierung gespeichert und beim Neustart eines Systems erhalten bleiben.

Bei erfolgreicher Ausführung gibt OpenKey den Wert True zurück.


TRegistry::ReadBinaryData

TRegistry	Siehe auch

Die Methode liest einen Binärwert aus einem bestimmten Datenwert, der dem aktuellen Schlüssel zugeordnet ist.

int __fastcall ReadBinaryData(const System::AnsiString Name, void *Buffer, int BufSize);

Beschreibung

Mit ReadBinaryData wird ein binärer Wert aus einem bestimmten Datenwert gelesen, der dem aktuellen Schlüssel zugeordnet ist. Der Parameter Name bezeichnet den gewünschten Datenwert. Der Parameter Buffer ist eine Anwendungsvariable, welche die gelesenen Registrierungsdaten aufnimmt. Dieser Puffer muß so groß sein, daß alle zurückgegebenen Daten Platz finden. Der Parameter BufSize ist die Größe des Puffers.

Bei erfolgreicher Ausführung liefert ReadBinaryData die angeforderten Daten zurück. Im Fehlerfall wird eine Exception ausgelöst, und der Rückgabewert dieser Funktion sollte verworfen werden.

Hinweis

Binäre Daten existieren typischerweise als Datensatz. Es kann sich aber auch um ein Symbol oder ein Bitmap handeln. Microsoft empfiehlt allerdings aus Gründen der Anwendungsleistung, Grafikobjekte nicht in der Registrierung zu speichern.


TRegistry::ReadBool

TRegistry	Siehe auch

Die Methode liest einen booleschen Wert aus dem angegebenen Datenwert, der dem aktuellen Schlüssel zugeordnet ist.

bool __fastcall ReadBool(const System::AnsiString Name);

Beschreibung

Mit ReadBool wird ein boolescher Wert aus einem bestimmten Datenwert gelesen, der dem aktuellen Schlüssel zugeordnet ist. Der Parameter Name bezeichnet den Namen des Datenwertes.

Nach erfolgreicher Ausführung liefert ReadBool den angeforderten booleschen Wert. Im Fehlerfall wird eine Exception ausgelöst, und der Rückgabewert dieser Funktion sollte verworfen werden.


TRegistry::ReadCurrency

TRegistry	Siehe auch

Die Methode liest einen Währungsbetrag aus einem bestimmten Datenwert, der dem aktuellen Schlüssel zugeordnet ist.

System::Currency __fastcall ReadCurrency(const System::AnsiString Name);

Beschreibung

Mit ReadCurrency wird ein Währungsbetrag aus einem bestimmten Datenwert gelesen, der dem aktuellen Schlüssel zugeordnet ist. Der Parameter Name bezeichnet den Datenwert.

Bei Erfolg liefert ReadCurrency einen Wert des Typs Currency. Im Fehlerfall wird eine Exception ausgelöst, und der Rückgabewert dieser Funktion sollte verworfen werden.


TRegistry::ReadDate

TRegistry	Siehe auch

Die Methode liest ein Kalenderdatum aus einem bestimmten Datenwert, der dem aktuellen Schlüssel zugeordnet ist.

System::TDateTime __fastcall ReadDate(const System::AnsiString Name);

Beschreibung

Mit ReadDate wird der Wert eines Kalenderdatums aus einem bestimmten Datenwert gelesen, der dem aktuellen Schlüssel zugeordnet ist. Der Parameter Name bezeichnet den gewünschten Datenwert.

Bei erfolgreicher Ausführung gibt ReadDate einen Borland C++Builder-TDateTime-Wert zurück. Der ganzzahlige Anteil ist die Anzahl der Tage, die seit dem 30.12.1899 vergangen sind. Der Bruchteil gibt die Uhrzeit an.

Im Fehlerfall wird eine Exception ausgelöst, und der Rückgabewert dieser Funktion sollte verworfen werden.

Hinweis

Verwenden Sie ReadDate ausschließlich für solche Datenwerte, die vorher mit WriteDate gespeichert wurden.


TRegistry::ReadDateTime

TRegistry	Siehe auch

Die Methode liest einen Datums-/Zeitwert aus einem bestimmten Datenwert, der dem aktuellen Schlüssel zugeordnet ist.

System::TDateTime __fastcall ReadDateTime(const System::AnsiString Name);

Beschreibung

Mit ReadDateTime wird ein Datums-/Zeitwert aus einem bestimmten Datenwert gelesen, der dem aktuellen Schlüssel zugeordnet ist. Der Parameter Name enthält den Namen des Datenwertes.

Bei erfolgreicher Ausführung gibt ReadDateTime einen Borland C++Builder-TDateTime-Wert zurück. Der ganzzahlige Anteil eines TDateTime-Wertes ist die Anzahl der Tage, die seit dem 30.12.1899 vergangen sind. Der Bruchteil eines TDateTime-Wertes gibt die Uhrzeit an.

Im Fehlerfall wird eine Exception ausgelöst, und der Rückgabewert dieser Funktion sollte verworfen werden.


TRegistry::ReadFloat

TRegistry	Siehe auch

Die Methode liest eine Gleitkommazahl aus einem bestimmten Datenwert, der dem aktuellen Schlüssel zugeordnet ist.

double __fastcall ReadFloat(const System::AnsiString Name);

Beschreibung

Mit ReadFloat wird eine Gleitkommazahl aus einem bestimmten Datenwert gelesen, der dem aktuellen Schlüssel zugeordnet ist. Der Parameter Name enthält den Namen des Datenwertes.

Bei erfolgreicher Ausführung gibt ReadFloat einen Double-Wert zurück. Im Fehlerfall wird eine Exception ausgelöst, und der Rückgabewert der Funktion sollte verworfen werden.


TRegistry::ReadInteger

TRegistry	Siehe auch

Die Funktion liest eine Integer-Zahl aus einem bestimmten Datenwert, der dem aktuellen Schlüssel zugeordnet ist.

int __fastcall ReadInteger(const System::AnsiString Name);

Beschreibung

Mit ReadInteger wird ein Integer aus einem bestimmten Datenwert gelesen, der dem aktuellen Schlüssel zugeordnet ist. Der Parameter Name enthält den Namen des Datenwertes.

Bei erfolgreicher Ausführung gibt ReadInteger einen Integer-Wert zurück. Im Fehlerfall wird eine Exception ausgelöst, und der Rückgabewert der Funktion sollte verworfen werden.


TRegistry::ReadString

TRegistry	Siehe auch

Die Methode liest einen String aus einem Datenwert, der dem aktuellen Schlüssel zugeordnet ist.

System::AnsiString __fastcall ReadString(const System::AnsiString Name);

Beschreibung

Mit ReadString wird ein String aus einem bestimmten Datenwert gelesen, der dem aktuellen Schlüssel zugeordnet ist. Der String Name enthält den Namen des Datenwertes.

Bei erfolgreicher Ausführung gibt ReadString einen String-Wert zurück. Im Fehlerfall wird eine Exception ausgelöst, und der Rückgabewert dieser Funktion sollte verworfen werden.


TRegistry::ReadTime

TRegistry	Siehe auch

Die Methode liest eine Uhrzeit aus einem bestimmten Datenwert, der dem aktuellen Schlüssel zugeordnet ist.

System::TDateTime __fastcall ReadTime(const System::AnsiString Name);

Beschreibung

Mit ReadTime wird eine Uhrzeit aus einem Datenwert gelesen, der dem aktuellen Schlüssel zugeordnet ist. Der String Name enthält den Namen des gewünschten Datenwertes.

Bei erfolgreicher Ausführung gibt ReadTime einen Borland C++Builder-TDateTime-Wert zurück. Der ganzzahlige Anteil ist die Anzahl der Tage, die seit dem 30.12.1899 vergangen sind. Der Bruchteil gibt die Uhrzeit an.

Im Fehlerfall wird eine Exception ausgelöst, und der Rückgabewert dieser Funktion sollte verworfen werden.

Hinweis

Verwenden Sie ReadTime nur für solche Datenwerte, die vorher mit der Prozedur WriteTime geschrieben wurden.


TRegistry::RegistryConnect

TRegistry	Siehe auch

Die Methode richtet eine Verbindung zur Registrierdatenbank auf einem anderen Computer ein.

bool __fastcall RegistryConnect(const System::AnsiString UNCName);

Beschreibung

Mit RegistryConnect wird eine Verbindung zur Registrierung auf einem anderen Computer eingerichtet, der unter Windows 95 oder Windows NT läuft. Der String UNCName enthält den Namen des Remote-Computers und muß in folgender Form angegeben werden:

\\computername

Hierbei bezeichnet „computername“ den Remote-Computer. Wenn UNCName den Wert NULL hat, wird der Name des lokalen Rechners verwendet.

Hinweis

Vor dem Aufruf von RegistryConnect muß die Anwendung die Eigenschaft RootKey ihres Registrierungsobjekts auf HKEY_USERS oder HKEY_LOCAL_MACHINE setzen.

Wenn die Verbindung erfolgreich hergestellt werden konnte, setzt RegistryConnect die Eigenschaft RootKey auf den Hauptschlüssel des Remote-Computers und gibt True zurück. Im Fehlerfall wird False zurückgegeben, und RootKey bleibt unverändert.


TRegistry::RenameValue

TRegistry	Siehe auch

Die Methode ändert den Namen eines Datenwertes, der dem aktuellen Schlüssel zugeordnet ist.

void __fastcall RenameValue(const System::AnsiString OldName, const System::AnsiString NewName);

Beschreibung

Mit RenameValue wird der Name eines Datenwertes geändert, der dem aktuellen Schlüssel zugeordnet ist. Der String OldName enthält den aktuell gültigen Namen. Der neue Name wird in NewName übergeben.

Wenn OldName einen vorhandenen Datenwert bezeichnet und noch kein Datenwert mit dem Namen in NewName existiert, funktioniert RenameValue wie beschrieben. Andernfalls bleibt der aktuelle Name unverändert.


TRegistry::ReplaceKey

TRegistry	Siehe auch

Die Methode ersetzt die Hive-Datei, in der ein Schlüssel mit seinen Unterschlüsseln gespeichert ist, durch eine andere Datei. Beim nächsten Start des Systems besitzt dann der Schlüssel und seine Unterschlüssel die Werte, die aus der neuen Datei stammen.

bool __fastcall ReplaceKey(const System::AnsiString Key, const System::AnsiString FileName, const System::AnsiString  BackUpFileName);

Beschreibung

Mit ReplaceKey wird die Datei ausgetauscht, in der ein Schlüssel und seine Unterschlüssel gespeichert sind. Der Begriff Hive bezeichnet eine aus einzelnen Teilen bestehende Menge von Schlüsseln, Unterschlüsseln und Datenwerten, deren Verzweigung von der obersten Ebene der Registrierungshierarchie ausgeht.

Der Parameter FileName enthält den Namen der Datei mit den neuen Informationen. BackUpFileName ist der Name der Sicherungsdatei, die bisher die Informationen enthielt.

Bei erfolgreicher Ausführung gibt ReplaceKey den Wert True zurück.

Hinweis

Die im Parameter FileName übergebene Datei muß mit der Funktion SaveKey oder durch einen direkten Aufruf der Windows 95/NT-API-Funktion RegSaveKey angelegt worden sein. Bei Dateisystemen, denen eine Dateizuordnungstabelle (FAT) zugrundeliegt, darf FileName keine Namenserweiterung enthalten.


TRegistry::RestoreKey

TRegistry	Siehe auch

Die Methode öffnet den angegebenen Schlüssel erneut und überschreibt alle Informationen des Schlüssels und seiner Unterschlüssel mit Registrierungsdaten, die in einer Hive-Datei gespeichert sind.

bool __fastcall RestoreKey(const System::AnsiString Key, const System::AnsiString FileName);

Beschreibung

Mit RestoreKey wird der angegebene Schlüssel in der Zugriffsebene KEY_ALL_ACCESS geöffnet, und alle Informationen im Schlüssel und seinen Unterschlüsseln werden durch die Registrierungsdaten aus einer Hive-Datei ersetzt. Der Begriff Hive bezeichnet eine aus einzelnen Teilen bestehende Menge von Schlüsseln, Unterschlüsseln und Datenwerten, deren Verzweigung von der obersten Ebene der Registrierungshierarchie ausgeht.

Der Parameter Key enthält den Schlüssel, der geöffnet werden soll. FileName ist der Name der Datei mit den Hive-Informationen.

Bei erfolgreicher Ausführung gibt RestoreKey den Wert True zurück, und der Schlüssel wird geschlossen.

Hinweis

Die in FileName übergebene Datei muß mit der Funktion SaveKey oder mit einem direkten Aufruf der Windows 95/NT-API-Funktion RegSaveKey angelegt worden sein. Bei Dateisystemen, denen eine Dateizuordnungstabelle (FAT) zugrundeliegt, darf FileName keine Namenserweiterung enthalten.


TRegistry::SaveKey

TRegistry	Siehe auch

Die Methode öffnet den angegebenen Schlüssel in der Zugriffsebene KEY_ALL_ACCESS und speichert den angegebenen Schlüssel zusammen mit allen Unterschlüsseln und Datenwerten in einer Hive-Datei.

bool __fastcall SaveKey(const System::AnsiString Key, const System::AnsiString FileName);

Beschreibung

Mit SaveKey wird ein Schlüssel in der Zugriffsebene KEY_ALL_ACCESS geöffnet. Er gelangt dann mit allen Unterschlüsseln und Datenwerten in eine Hive-Datei. Der Begriff Hive bezeichnet eine aus einzelnen Teilen bestehende Menge von Schlüsseln, Unterschlüsseln und Datenwerten, deren Verzweigung von der obersten Ebene der Registrierungshierarchie ausgeht.

Der String Key enthält den Schlüssel, der gespeichert werden soll. Der Parameter FileName gibt die Datei an, in der die Informationen gespeichert werden sollen. Es muß sich um den Namen einer neuen, noch nicht vorhandenen Datei handeln. Bei Dateisystemen, denen eine Dateizuordnungstabelle (FAT) zugrundeliegt, darf FileName keine Namenserweiterung enthalten.

Von SaveKey erzeugte Dateien werden als Parameter an die Funktionen RestoreKey, ReplaceKey und LoadKey übergeben.

Bei erfolgreicher Ausführung gibt SaveKey den Wert True zurück und schließt den Schlüssel.


TRegistry::TRegistry

TRegistry	Siehe auch

Der Konstruktor TRegistry erzeugt ein neues TRegistry-Objekt.

__fastcall TRegistry(void);

Beschreibung

Mit TRegistry wird ein TRegistry-Objekt für eine Anwendung erzeugt. TRegistry setzt die Eigenschaft RootKey von TRegistry auf HKEY_CURRENT_USER und die Eigenschaft LazyWrite auf den Wert True.


TRegistry::UnLoadKey

TRegistry	Siehe auch

Die Methode entfernt einen Hive aus der Registrierung.

bool __fastcall UnLoadKey(const System::AnsiString Key);

Beschreibung

Mit UnLoadKey wird ein Hive aus der Registrierung entfernt, ohne die eventuell vorhandene, zugehörige Datei zu verändern. Der Begriff Hive bezeichnet eine aus einzelnen Teilen bestehende Menge von Schlüsseln, Unterschlüsseln und Datenwerten, deren Verzweigung von der obersten Ebene der Registrierungshierarchie ausgeht.

Der Parameter Key bezeichnet den Schlüssel in der obersten Hierarchie-Ebene des Hive, der entfernt werden soll.

Bei erfolgreicher Ausführung gibt UnLoadKey den Wert True zurück.

Hinweis

Setzen Sie vor dem Aufruf dieser Funktion die Eigenschaft RootKey auf HKEY_USERS oder HKEY_LOCAL_MACHINE. Alternativ dazu rufen Sie RegistryConnect auf.


TRegistry::ValueExists

TRegistry	Siehe auch

Die Methode ermittelt, ob es für den aktuellen Schlüssel den angegebenen Datenwert gibt.

bool __fastcall ValueExists(const System::AnsiString Name);

Beschreibung

Mit ValueExists wird festgestellt, ob ein bestimmter Name in der Registrierung existiert. Ein Aufruf dieser Methode erfolgt sinnvollerweise, bevor weitere TRegistry-Methoden aufgerufen werden, die nur mit vorhandenen Schlüsseln arbeiten.

Der Parameter Name ist der Name des Datenwertes, nach dem gesucht werden soll.

ValueExists gibt den Wert True zurück, wenn eine Übereinstimmung gefunden werden kann, ansonsten False.


TRegistry::WriteBinaryData

TRegistry	Siehe auch

Die Methode speichert einen Datensatz in einem bestimmten Datensatz, der dem aktuellen Schlüssel zugeordnet ist.

void __fastcall WriteBinaryData(const System::AnsiString Name, void *Buffer, int BufSize);

Beschreibung

Mit WriteBinaryData wird ein Datensatz in einem Datenwert gespeichert, der dem aktuellen Schlüssel zugeordnet ist.

Der String-Parameter Name enthält den Namen des Datenwertes. Ist der Name bereits vorhanden, wird dessen Wert überschrieben. Andernfalls wird der Name neu erzeugt.

Der Parameter Buffer ist ein Datensatz oder -Datenpuffer, der alles enthält, was in der Registrierung gespeichert werden soll. Die Größe des Puffers wird mit BufSize angegeben.

Hinweis

Die Länge von Datenwerten wird nur durch den verfügbaren Speicher begrenzt. Werte mit mehr als 2048 Byte sollten allerdings als separate Dateien gespeichert werden, von denen dann nur der Name in der Registrierung hinterlegt wird. Anwendungskomponenten, wie Symbole, Bitmaps und ausführbare Dateien sollten auf jeden Fall als eigene Dateien gespeichert werden.

Wenn die Ausführung von WriteBinaryData fehlschlägt, wird eine Exception ausgelöst, und der Wert gelangt nicht in die Registrierung.


TRegistry::WriteBool

TRegistry	Siehe auch

Die Methode speichert einen booleschen Wert in einem bestimmten Datenwert, der dem aktuellen Schlüssel zugeordnet ist.

void __fastcall WriteBool(const System::AnsiString Name, bool Value);

Beschreibung

Mit WriteBool wird ein boolescher Wert in einem Datenwert gespeichert, der dem aktuellen Schlüssel zugeordnet ist.

Der String-Parameter Name enthält den Namen des Datenwertes. Ist der Name bereits vorhanden, wird dessen Wert überschrieben. Andernfalls wird der Name neu erzeugt.

Der Parameter Value ist ein Wert des Typs Boolean, der in der Registrierung gespeichert werden soll.

Wenn die Ausführung von WriteBool fehlschlägt, wird eine Exception ausgelöst, und der Wert gelangt nicht in die Registrierung.


TRegistry::WriteCurrency

TRegistry	Siehe auch

Die Methode speichert einen Währungsbetrag in einem bestimmten Datenwert, der dem aktuellen Schlüssel zugeordnet ist.

void __fastcall WriteCurrency(const System::AnsiString Name, System::Currency Value);

Beschreibung

Mit WriteCurrency wird ein Wert des Typs Currency in einem Datenwert gespeichert, der dem aktuellen Schlüssel zugeordnet ist.

Der String-Parameter Name enthält den Namen des Datenwertes. Ist der Name bereits vorhanden, wird dessen Wert überschrieben. Andernfalls wird der Name neu erzeugt.

Der Wert Value ist ein Wert mit dem Typ Currency, der in der Registrierung gespeichert werden soll.

Wenn die Ausführung von WriteCurrency fehlschlägt, wird eine Exception ausgelöst, und der Wert gelangt nicht in die Registrierung.


TRegistry::WriteDate

TRegistry	Siehe auch

Die Methode speichert ein Kalenderdatum in einem bestimmten Datenwert, der dem aktuellen Schlüssel zugeordnet ist.

void __fastcall WriteDate(const System::AnsiString Name, System::TDateTime Value);

Beschreibung

Mit WriteDate wird ein Wert für Datum und Uhrzeit in einem Datumswert gespeichert, der dem aktuellen Schlüssel zugeordnet ist.

Der String-Parameter Name enthält den Namen des Datenwertes. Ist der Name bereits vorhanden, wird dessen aktueller Wert überschrieben. Andernfalls wird der Name neu erzeugt.

Der Parameter Value ist ein Wert für Datum und Uhrzeit, der in der Registrierung gespeichert werden soll.

Wenn die Ausführung von WriteDate fehlschlägt, wird eine Exception ausgelöst, und der Wert gelangt nicht in die Registrierung.

Bei Erfolg speichert WriteDate einen Borland C++Builder-TDateTime-Wert. Der ganzzahlige Anteil von TDateTime ist die Anzahl der Tage, die seit dem 30.12.1899 vergangen sind. Der Bruchteil gibt die Uhrzeit an.


TRegistry::WriteDateTime

TRegistry	Siehe auch

Die Methode speichert einen Datums-/Zeitwert im angegebenen Datenwert des aktuellen Schlüssels.

void __fastcall WriteDateTime(const System::AnsiString Name, System::TDateTime Value);

Beschreibung

Mit WriteDateTime wird ein Wert für Datum und Zeit in einem Datenwert gespeichert, der dem aktuellen Schlüssel zugeordnet ist.

Der String-Parameter Name enthält den Namen des Datenwertes. Ist der Name bereits vorhanden, wird dessen aktueller Wert überschrieben. Andernfalls wird der Name neu erzeugt.

Der Parameter Value ist der Wert für Datum und Zeit, der in der Registrierung gespeichert werden soll.

Wenn die Ausführung von WriteDateTime fehlschlägt, wird eine Exception ausgelöst, und der Wert gelangt nicht in die Registrierung.

Bei Erfolg speichert WriteDateTime einen Borland C++Builder-TDateTime-Wert. Der ganzzahlige Anteil eines TDateTime-Wertes ist die Anzahl der Tage, die seit dem 31.12.1899 vergangen sind. Der Bruchteil gibt die Uhrzeit an.


TRegistry::WriteFloat

TRegistry	Siehe auch

Die Methode speichert einen Double-Wert in einem bestimmten Datenwert, der dem aktuellen Schlüssel zugeordnet ist.

void __fastcall WriteFloat(const System::AnsiString Name, double Value);

Beschreibung

Mit WriteFloat wird ein Gleitkommawert in einem Datenwert gespeichert, der dem aktuellen Schlüssel zugeordnet ist.

Der String-Parameter Name enthält den Namen des Datenwertes. Ist der Name bereits vorhanden, wird dessen aktueller Wert überschrieben. Andernfalls wird der Name neu erzeugt.

Der Parameter Value ist ein Gleitkommawert, der in der Registrierung gespeichert werden soll.

Wenn die Ausführung von WriteFloat fehlschlägt, wird eine Exception ausgelöst, und der Wert gelangt nicht in die Registrierung.


TRegistry::WriteInteger

TRegistry	Siehe auch

Die Methode speichert einen Integer-Wert in einem bestimmten Datenwert, der dem aktuellen Schlüssel zugeordnet ist.

void __fastcall WriteInteger(const System::AnsiString Name, int Value);

Beschreibung

Mit WriteInteger wird ein Integerwert in einem Datenwert gespeichert, der dem aktuellen Schlüssel zugeordnet ist.

Der String-Parameter Name enthält den Namen des Datenwertes. Ist der Name bereits vorhanden, wird dessen Wert überschrieben. Andernfalls wird der Name neu erzeugt.

Der Parameter Value ist der Integer, der in der Registrierung gespeichert werden soll.

Wenn die Ausführung von WriteInteger fehlschlägt, wird eine Exception ausgelöst, und der Wert gelangt nicht in die Registrierung.


TRegistry::WriteString

TRegistry	Siehe auch

Die Methode speichert einen String in einem bestimmten Datenwert, der dem aktuellen Schlüssel zugeordnet ist.

void __fastcall WriteString(const System::AnsiString Name, const System::AnsiString Value);

Beschreibung

Mit WriteString wird ein String-Wert in einem Datenwert gespeichert, der dem aktuellen Schlüssel zugeordnet ist.

Der String-Parameter Name enthält den Namen des Datenwertes, in dem die Daten gespeichert werden sollen. Ist der Name bereits vorhanden, wird dessen aktueller Wert überschrieben. Andernfalls wird der Name neu erzeugt.

Der Parameter Value ist ein String, der in der Registrierung gespeichert werden soll.

Wenn die Ausführung von WriteString fehlschlägt, wird eine Exception ausgelöst, und der Wert gelangt nicht in die Registrierung.


TRegistry::WriteTime

TRegistry	Siehe auch

Die Methode speichert eine Uhrzeit in einem bestimmten Datenwert, der dem aktuellen Schlüssel zugeordnet ist.

void __fastcall WriteTime(const System::AnsiString Name, System::TDateTime Value);

Beschreibung

Mit WriteTime wird ein Wert für die Uhrzeit in einem Datenwert gespeichert, der dem aktuellen Schlüssel zugeordnet ist.

Der String-Parameter Name enthält den Namen des Datenwertes. Ist der Name bereits vorhanden, wird dessen aktueller Wert überschrieben. Andernfalls wird der Name neu erzeugt.

Der Wert Value ist der Uhrzeitwert, der in der Registrierung gespeichert werden soll.

Wenn die Ausführung von WriteTime fehlschlägt, wird eine Exception ausgelöst, und der Wert gelangt nicht in die Registrierung.

Bei Erfolg speichert WriteTime einen Borland C++Builder-TDateTime-Wert. Der ganzzahlige Anteil eines TDateTime-Wertes ist die Anzahl der Tage, die seit dem 30.12.1899 vergangen sind. Der Bruchteil gibt die Uhrzeit an.


Zugriff

Read-only


Hierarchie

TObject


TRegistry Beispiel

TRegistry


 TReplaceDialog

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/dialogs.hpp

TReplaceDialog erzeugt einen Dialog zum Suchen und Ersetzen von Text.

Beschreibung

TReplaceDialog ist eine spezielle Version von TFindDialog, mit der Sie Text suchen und ersetzen können. Wie bei TFindDialog ist auch dieser Dialog nicht modal und wird zur Laufzeit erst angezeigt, wenn er durch einen Aufruf der Methode Execute aktiviert wird.


Eigenschaften von TReplaceDialog

TReplaceDialog	Alphabetisch	Legende

In TReplaceDialog

ReplaceText

Abgeleitet von TFindDialog

FindText

Handle

Left

Options

Position

Top

Abgeleitet von TCommonDialog

Ctl3D

HelpContext

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Name

Owner

Tag


Eigenschaften von TReplaceDialog

TReplaceDialog	Nach Objekten	Legende

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

Ctl3D

DesignInfo

FindText

Handle

HelpContext

Left

Name

Options

Owner

Position

ReplaceText

Tag

Top


TReplaceDialog::ReplaceText

TReplaceDialog	Siehe auch

Die Eigenschaft ReplaceText enthält den Text, der den in der Eigenschaft FindText angegebenen String ersetzen soll.

__property ReplaceText;

Die Eigenschaft FindText, der der Wert des Eingabefeldes Suchen nach zugewiesen wird, enthält den Textstring, nach dem der Anwender suchen möchte. Die Eigenschaft ReplaceText, der der Wert des Eingabefeldes Ersetzen durch zugewiesen wird, enthält den Textstring, der den Text in FindText ersetzt. Wenn das Eingabefeld Ersetzen durch bereits beim öffnen des Dialogs einen bestimmten Textstring anzeigen soll, weisen Sie diesen im Objektinspektor oder programmseitig der Eigenschaft ReplaceText zu.


Ereignisse von TReplaceDialog

TReplaceDialog	Alphabetisch	Legende

In TReplaceDialog

OnReplace

Abgeleitet von TFindDialog

OnFind


Ereignisse von TReplaceDialog

TReplaceDialog	Nach Objekten	Legende

OnFind

OnReplace


TReplaceDialog::OnReplace

TReplaceDialog	Siehe auch

Das Ereignis OnReplace tritt ein, wenn der Anwender auf die Schaltfläche Ersetzen oder Alles ersetzen klickt.

__property Classes::TNotifyEvent OnReplace;

Beschreibung

Das Ereignis OnReplace tritt immer dann ein, wenn der Anwender auf Ersetzen oder Alles ersetzen klickt. Im Falle von Ersetzen wird außerdem in der Eigenschaft Options das Flag frReplace gesetzt und das Flag frReplaceAll gelöscht. Umgekehrt wird frReplaceAll gesetzt und frReplace gelöscht, wenn der Benutzer auf Alles ersetzen klickt.

Schreiben Sie eine Ereignisbehandlungsroutine für OnReplace, der nach dem Text der Eigenschaft FindText sucht und diesen durch den Text der Eigenschaft ReplaceText ersetzt. Mit den Flags der Eigenschaft Options können Sie ermitteln, wie die Suche durchgeführt werden soll. Wenn Sie ein TMemo-Objekt durchsuchen wollen, rufen Sie die Methode Search auf.


Methoden von TReplaceDialog

TReplaceDialog	Alphabetisch

In TReplaceDialog

~TReplaceDialog

TReplaceDialog

Abgeleitet von TFindDialog

CloseDialog

Execute

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TReplaceDialog

TReplaceDialog	Nach Objekten

~TReplaceDialog

Assign

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

CloseDialog

DefaultHandler

DestroyComponents

Destroying

Dispatch

Execute

FieldAddress

FindComponent

FreeInstance

FreeNotification

Free

GetParentComponent

HasParent

InheritsFrom

InitInstance

InsertComponent

InstanceSize

MethodAddress

MethodName

NewInstance

RemoveComponent

TReplaceDialog


TReplaceDialog::~TReplaceDialog

TReplaceDialog

Der Destruktor ~TReplaceDialog gibt den Speicher frei, der für das TReplaceDialog-Objekt reserviert war. Rufen Sie ~TReplaceDialog nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TReplaceDialog automatisch aufgerufen wird.

__fastcall virtual ~TReplaceDialog(void);


TReplaceDialog::TReplaceDialog

TReplaceDialog	Siehe auch

Die Methode TReplaceDialog erzeugt und initialisiert eine Instanz von TReplaceDialog.

__fastcall virtual TReplaceDialog(Classes::TComponent* AOwner);

Beschreibung

TReplaceDialog erzeugt eine Instanz von TReplaceDialog. Zur Laufzeit wird der Dialog jedoch erst angezeigt, wenn die Methode Execute aufgerufen wird.


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TCommonDialog

TFindDialog


TReplaceDialog Beispiel

TReplaceDialog


 TRichEdit

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/comctrls.hpp

TRichEdit kapselt ein RTF-Eingabefeld von Windows.

Beschreibung

Mit Hilfe eines TRichEdit-Objekts kann ein Windows-RTF-Eingabefeld in einem Formular plaziert werden. Eingabefelder dieses Typs ermöglichen die Eingabe von formatiertem Text mit verschiedenen Attributen für Schrift und Absatzausrichtung.

TRichEdit umfaßt die Eigenschaften und Methoden, mit denen formatierter Text eingegeben und verarbeitet werden kann. Allerdings sind keine Dialogfeldelemente enthalten, über die der Benutzer auf diese Formatmerkmale zugreifen kann. Der Programmierer einer Anwendung muß die Benutzeroberfläche mit entsprechenden Komponenten ausstatten, so daß die externe Steuerung der Funktionen eines TRichEdit-Objekts möglich wird.

TRichEdit deklariert viele der Eigenschaften als published, die von TCustomRichEdit geerbt wurden, ohne jedoch neues Verhalten einzuführen.


Eigenschaften von TRichEdit

TRichEdit	Alphabetisch	Legende

Abgeleitet von TCustomRichEdit

DefAttributes

DefaultConverter

HideScrollBars

HideSelection

Lines

PageRect

Paragraph

PlainText

SelAttributes

Abgeleitet von TCustomMemo

Alignment

ScrollBars

WantReturns

WantTabs

WordWrap

Abgeleitet von TCustomEdit

BorderStyle

MaxLength

Modified

ReadOnly

SelLength

SelStart

SelText

Abgeleitet von TWinControl

Brush

ClientOrigin

ClientRect

ControlCount

Controls

Ctl3D

Handle

HelpContext

ParentCtl3D

Showing

TabOrder

TabStop

Abgeleitet von TControl

Align

BoundsRect

ClientHeight

ClientWidth

Color

ControlState

ControlStyle

Cursor

DragMode

Enabled

Font

Height

Hint

Left

Name

Parent

ParentColor

ParentFont

PopupMenu

ShowHint

Text

Top

Visible

Width

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TRichEdit

TRichEdit	Nach Objekten	Legende

Alignment

Align

BorderStyle

BoundsRect

Brush

ClientHeight

ClientOrigin

ClientRect

ClientWidth

Color

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlCount

ControlState

Controls

ControlStyle

Ctl3D

Cursor

DefAttributes

DefaultConverter

DesignInfo

DragMode

Enabled

Font

Handle

Height

HelpContext

HideScrollBars

HideSelection

Hint

Left

Lines

MaxLength

Modified

Name

Owner

PageRect

Paragraph

ParentColor

ParentCtl3D

ParentFont

Parent

PlainText

PopupMenu

ReadOnly

ScrollBars

SelAttributes

SelLength

SelStart

SelText

ShowHint

Showing

TabOrder

TabStop

Tag

Text

Top

Visible

WantReturns

WantTabs

Width

WordWrap


Ereignisse von TRichEdit

TRichEdit	Alphabetisch	Legende

Abgeleitet von TCustomRichEdit

OnProtectChange

OnResizeRequest

OnSaveClipboard

OnSelectionChange

Abgeleitet von TCustomEdit

OnChange

Abgeleitet von TWinControl

OnEnter

OnExit

OnKeyDown

OnKeyPress

OnKeyUp

Abgeleitet von TControl

OnDragDrop

OnDragOver

OnEndDrag

OnMouseDown

OnMouseMove

OnMouseUp

OnStartDrag


Ereignisse von TRichEdit

TRichEdit	Nach Objekten	Legende

OnChange

OnDragDrop

OnDragOver

OnEndDrag

OnEnter

OnExit

OnKeyDown

OnKeyPress

OnKeyUp

OnMouseDown

OnMouseMove

OnMouseUp

OnProtectChange

OnResizeRequest

OnSaveClipboard

OnSelectionChange

OnStartDrag


Methoden von TRichEdit

TRichEdit	Alphabetisch

Abgeleitet von TCustomRichEdit

~TCustomRichEdit

FindText

Print

RegisterConversionFormat

TCustomRichEdit

Abgeleitet von TCustomEdit

Clear

ClearSelection

CopyToClipboard

CutToClipboard

GetSelTextBuf

PasteFromClipboard

SelectAll

SetSelTextBuf

Abgeleitet von TWinControl

Broadcast

CanFocus

ContainsControl

ControlAtPos

DisableAlign

EnableAlign

Focused

GetTabOrderList

HandleAllocated

HandleNeeded

InsertControl

Invalidate

PaintTo

Realign

RemoveControl

Repaint

ScaleBy

ScrollBy

SetBounds

SetFocus

Update

UpdateControlState

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

GetTextLen

Hide

Perform

Refresh

ScreenToClient

SendToBack

SetTextBuf

Show

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TRichEdit

TRichEdit	Nach Objekten

~TCustomRichEdit

Assign

BeginDrag

BringToFront

Broadcast

CanFocus

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

ClearSelection

Clear

ClientToScreen

ContainsControl

ControlAtPos

CopyToClipboard

CutToClipboard

DefaultHandler

DestroyComponents

Destroying

DisableAlign

Dispatch

DragDrop

Dragging

EnableAlign

EndDrag

FieldAddress

FindComponent

FindText

Focused

FreeInstance

FreeNotification

Free

GetParentComponent

GetSelTextBuf

GetTabOrderList

GetTextBuf

GetTextLen

HandleAllocated

HandleNeeded

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InsertControl

InstanceSize

Invalidate

MethodAddress

MethodName

NewInstance

PaintTo

PasteFromClipboard

Perform

Print

Realign

Refresh

RegisterConversionFormat

RemoveComponent

RemoveControl

Repaint

ScaleBy

ScreenToClient

ScrollBy

SelectAll

SendToBack

SetBounds

SetFocus

SetSelTextBuf

SetTextBuf

Show

TCustomRichEdit

UpdateControlState

Update


~TRichEdit

Der Destruktor ~TRichEdit gibt den Speicher frei, der für das TRichEdit-Objekt reserviert war. Rufen Sie ~TRichEdit nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TRichEdit automatisch aufgerufen wird.

__fastcall virtual ~TRichEdit(void);


TRichEdit

Der Konstruktor TRichEdit erzeugt ein neues TRichEdit-Objekt.

__fastcall virtual TRichEdit(Classes::TComponent* AOwner);


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TControl

TWinControl

TCustomEdit

TCustomMemo

TCustomRichEdit


TRichEdit Beispiel

TRichEdit


TResourceStream

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/classes.hpp

Das Objekt TResourceStream stellt einen Speicher-Stream dar, der einen Zugriff auf die compilierten Ressourcen einer Windows-Anwendung ermöglicht.

Beschreibung

Mit TResourceStream können die Ressourcen einer Windows-Anwendung gelesen werden. Zu diesem Zweck speichert eine Instanz von TResourceStream den Wert einer bestimmten Ressource in einem Speicherpuffer. Über diesen Puffer ist die Ressource dann für die Anwendung zugänglich.

Die globale Funktion ReadComponentRes verwendet TResourceStream für den Zugriff auf die compilierten Ressourcen, die von der Anwendung benötigt werden.


Eigenschaften von TResourceStream

TResourceStream	Alphabetisch	Legende

Abgeleitet von TCustomMemoryStream

Memory

Abgeleitet von TStream

Position

Size


Eigenschaften von TResourceStream

TResourceStream	Nach Objekten	Legende

Memory

Position

Size


Methoden von TResourceStream

TResourceStream	Alphabetisch

In TResourceStream

~TResourceStream

TResourceStream

Write

Abgeleitet von TCustomMemoryStream

Read

SaveToFile

SaveToStream

Seek

Abgeleitet von TStream

CopyFrom

ReadBuffer

ReadComponent

ReadComponentRes

ReadResHeader

WriteBuffer

WriteComponent

WriteComponentRes

WriteDescendent

WriteDescendentRes

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TResourceStream

TResourceStream	Nach Objekten

~TResourceStream

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

CopyFrom

DefaultHandler

Dispatch

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance

ReadBuffer

ReadComponentRes

ReadComponent

ReadResHeader

Read

SaveToFile

SaveToStream

Seek

TResourceStream

WriteBuffer

WriteComponentRes

WriteComponent

WriteDescendentRes

WriteDescendent

Write


TResourceStream::~TResourceStream

TResourceStream	Siehe auch

Der Destruktor ~TResourceStream gibt den Speicher frei, der für das TResourceStream-Objekt reserviert war. Rufen Sie ~TResourceStream nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TResourceStream automatisch aufgerufen wird.

__fastcall virtual ~TResourceStream(void);

Beschriebung

~TResourceStream gibt vor dem Aufruf des geerbten Destruktors den Puffer frei, in dem die Ressource gespeichert war.


TResourceStream::TResourceStream

TResourceStream	Siehe auch

Mit der Methode TResourceStream wird eine Instanz von TResourceStream erzeugt, der ein bestimmter Ressourcennname und -typ zugeordnet ist.

__fastcall TResourceStream(int Instance, const System::AnsiString ResName, char * ResType);

-oder-

__fastcall TResourceStream(int Instance, int ResID, char * ResType);

Beschreibung

TResourceStream instantiiert ein TResourceStream-Objekt für eine Ressource in der angegebenen Instanz, die per Name identifiziert werden kann. TResourceStream findet die Ressourcendaten und lädt diese in den Speicherpuffer.

Der Parameter Instance bezeichnet das Windows-Instanzen-Handle, das der ausführbaren Datei oder der DLL zugeordnet ist, in der sich die Ressource befindet.

Der Parameter ResID bezeichnet die Integer-ID der Ressource in der RC-Datei, die mit der Anwendung compiliert wurde.

Der Parameter ResName enthält den String für die Ressource in der RC-Datei, die mit der Anwendung compiliert wurde. Wenn der Ressource kein String, sondern eine Integer-ID zugeordnet wurde, wird dieser ID das Nummernzeichen vorangestellt (#). Beispielsweise erhält der Parameter ResName für eine Ressource mit dem Integer-Bezeichner 128 den Wert #128.

Der Typ der Ressource wird mit ResType identifiziert. Anwendungen können eigene Ressourcentypen definieren und per Name in der RC-Datei referenzieren. Zusätzlich bietet Windows eine Anzahl von vordefinierten Ressourcentypen. Die folgende Tabelle enthält die jeweiligen Werte für ResType:

ResType	Ressourcentyp

RT_ACCELERATOR	Tabelle der Tastenkürzel

RT_BITMAP	Bitmap

RT_DIALOG	Dialogfeld

RT_FONT	Schrift

RT_FONTDIR	Schriftenverzeichnis

RT_MENU	Menü

RT_RCDATA	Anwendungsdefinierte Ressource (Rohdaten)

RT_STRING	Eintrag in String-Tabelle

RT_MESSAGETABLE	Eintrag in Meldungstabelle

RT_CURSOR	Hardware-abhängige Cursor-Ressource

RT_GROUP_CURSOR	Hardware-unabhängige Cursor-Ressource

RT_ICON	Hardware-abhängige Symbol-Ressource

RT_GROUP_ICON	Hardware-unabhängige Symbol-Ressource

RT_VERSION	Versions-Ressource

Hinweis

Die Referenzierung von Ressourcen über ihre ID erfordert weniger Speicher als die Referenzierung per Name.


TResourceStream::Write

TResourceStream	Siehe auch

Die Methode Write überschreibt die geerbte Methode zum Auslösen einer EStreamError-Exception, wenn versucht wird, die Ressource in die Anwendung zurückzuschreiben.

virtual long __fastcall Write(const void *Buffer, long Count);

Beschreibung

Ein TResourceStream-Objekt sollte nicht dazu verwendet werden, die Ressourcen einer laufenden Anwendung zu modifizieren. Die Methode Write ersetzt die geerbte Methode zum Auslösen eines Fehlers, sobald die Anwendung versucht, in ihre eigenen Ressourcen zu schreiben.

Da alle übrigen Methoden von TResourceStream zum Schreiben von Daten (WriteBuffer, WriteComponent) die Methode Write für den eigentlichen Schreibvorgang aufrufen, führt der direkte Aufruf zu einer Exception.


Zugriff

Read-only


Hierarchie

TObject

TStream

TCustomMemoryStream


TResourceStream Beispiel

TResourceStream


 TSaveDialog

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/dialogs.hpp

TSaveDialog erzeugt einen Dialog zum Speichern von Dateien.

Beschreibung

TSaveDialog zeigt ein Windows-Dialogfeld an, in dem der Benutzer einen Dateinamen eingeben oder markieren und eine Datei speichern kann. Zur Laufzeit wird der Dialog erst angezeigt, wenn er durch einen Aufruf der Methode Execute aktiviert wird. Wenn der Benutzer auf die Schaltfläche Speichern klickt, wird der Dialog beendet und der angegebene Dateiname in der Eigenschaft FileName gespeichert.


Eigenschaften von TSaveDialog

TSaveDialog	Alphabetisch	Legende

Abgeleitet von TOpenDialog

DefaultExt

FileEditStyle

FileName

Files

Filter

FilterIndex

HistoryList

InitialDir

Options

Title

Abgeleitet von TCommonDialog

Ctl3D

HelpContext

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Name

Owner

Tag


Eigenschaften von TSaveDialog

TSaveDialog	Nach Objekten	Legende

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

Ctl3D

DefaultExt

DesignInfo

FileEditStyle

FileName

Files

FilterIndex

Filter

HelpContext

HistoryList

InitialDir

Name

Options

Owner

Tag

Title


Methoden von TSaveDialog

TSaveDialog	Alphabetisch

In TSaveDialog

Execute

Abgeleitet von TOpenDialog

~TOpenDialog

TOpenDialog

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TSaveDialog

TSaveDialog	Nach Objekten

~TOpenDialog

Assign

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

DestroyComponents

Destroying

Dispatch

Execute

FieldAddress

FindComponent

FreeInstance

FreeNotification

Free

GetParentComponent

HasParent

InheritsFrom

InitInstance

InsertComponent

InstanceSize

MethodAddress

MethodName

NewInstance

RemoveComponent

TOpenDialog


~TSaveDialog

Der Destruktor ~TSaveDialog gibt den Speicher frei, der für das TSaveDialog-Objekt reserviert war. Rufen Sie ~TSaveDialog nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TSaveDialog automatisch aufgerufen wird.

__fastcall virtual ~TSaveDialog(void);


TSaveDialog::Execute

TSaveDialog

Die Methode Execute zeigt das Dialogfeld Speichern unter an.

virtual bool __fastcall Execute(void);

Beschreibung

Execute öffnet den Dialog Speichern unter und gibt True zurück, wenn der Anwender einen Dateinamen eingibt oder markiert und auf Speichern klickt.


TSaveDialog

Der Konstruktor TSaveDialog erzeugt ein neues TSaveDialog-Objekt.

__fastcall virtual TSaveDialog(Classes::TComponent* AOwner);


Gültigkeitsbereich

Published

Zugriff

Read-only


Hierarchie

TObject

TPersistent

TComponent

TCommonDialog

TOpenDialog


TSaveDialog Beispiel

TSaveDialog


TScreen

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/forms.hpp

TScreen repräsentiert den Status des Bildschirms, in dem eine Anwendung ausgeführt wird.

Beschreibung

Es existierte eine globale Variable namens Screen vom Typ TScreen, die bereits für die Verwendung durch $$Delphi$$-Anwendungen instantiiert ist. Mit Hilfe von Screen erhalten Sie Informationen über den aktuellen Bildschirmstatus in einer Anwendung. Mit den Eigenschaften von TScreen können folgende Informationen überwacht werden:

•	Formulare und Datenmodule, die von der Anwendung instantiiert wurden.

•	Das aktive Formular und das darin enthaltene aktive Steuerelement.

•	Die Größe und die Auflösung des Bildschirms.

•	Die Cursor und die Schriften, die für die Anwendung verfügbar sind.


Eigenschaften von TScreen

TScreen	Alphabetisch	Legende

In TScreen

ActiveControl

ActiveForm

Cursor

Cursors

DataModuleCount

DataModules

Fonts

FormCount

Forms

Height

PixelsPerInch

Width

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Name

Owner

Tag


Eigenschaften von TScreen

TScreen	Nach Objekten	Legende

ActiveControl

ActiveForm

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

Cursors

Cursor

DataModuleCount

DataModules

DesignInfo

Fonts

FormCount

Forms

Height

Name

Owner

PixelsPerInch

Tag

Width


TScreen::ActiveControl

TScreen	Siehe auch

Die Eigenschaft ActiveControl gibt das Steuerelement an, das momentan den Eingabefokus im Bildschirm besitzt.

__property Controls::TWinControl* ActiveControl;

Beschreibung

Durch Abfragen von ActiveControl können Sie feststellen, welches Fenstersteuerelement-Objekt im aktiven Formular momentan die Eingaben über die Tastatur empfängt.

ActiveControl ist eine Nur-Lesen-Eigenschaft. Wenn Sie den Fokus an ein anderes Steuerelement übergeben wollen, verwenden Sie die Methode SetFocusedControl des Formulars, in dem das betreffende Steuerelement enthalten ist.

Beim Wechsel des Fokus von einem Steuerelement zu einem anderen empfängt der Bildschirm ein OnActiveControlChange-Ereignis.


TScreen::ActiveForm

TScreen	Siehe auch

Die Eigenschaft ActiveForm gibt das Formular an, das momentan den Fokus besitzt.

__property TForm* ActiveForm;

Beschreibung

Durch Abfragen von ActiveForm läßt sich feststellen, welches Formular der Anwendung den Eingabefokus besitzt. Wenn die Anwendung nicht aktiv ist, bezeichnet AcitveForm das Formular, das bei einer erneuten Aktivierung der Anwendung den Fokus erhält.

ActiveForm ist eine Nur-Lesen-Eigenschaft. Wenn Sie den Fokus an ein anderes Formular übergeben wollen, verwenden Sie die Methode SetFocus des betreffenden Formulars. ActiveForm ändert sich, wenn die Methode SetFocusedControl eines inaktiven Formulars aufgerufen wird, um den Fokus an ein darin enthaltenes Steuerelement zu übergeben.

Beim Wechsel des Fokus von einem Formular zu einem anderen empfängt der Bildschirm ein OnActiveFormChange-Ereignis.


TScreen::Cursor

TScreen	Siehe auch

Die Eigenschaft Cursor steuert die Darstellung des Mauszeigers auf globaler Ebene.

__property Controls::TCursor Cursor;

Beschreibung

Durch das Setzen der Eigenschaft Cursor können Sie die Zeigerdarstellung ändern, die mit den einzelnen Steuerelementobjekten verbunden ist. Hat Cursor den Wert crDefault, erfolgt die Darstellung des Mauszeigers in Abhängigkeit von dem Objekt, in dem er enthalten ist. Durch die Zuweisung eines anderen Wertes legen Sie die Form des Mauszeigers für alle Fenster fest, die zur Anwendung gehören. Diese Einstellung bleibt aktiv, bis die Eigenschaft Cursor für den Bildschirm wieder auf crDefault gesetzt wird.

Zuweisungen an die Eigenschaft Cursor des Bildschirmobjekts werden in der Regel in einer try...finally-Anweisung vorgenommen. Diese stellt sicher, daß das normale Verhalten des Mauszeigers wiederhergestellt wird. Ein Beispiel:

class TWaitCursor {

public:

    TWaitCursor() : oldc(Screen->Cursor)   { Screen->Cursor = crHourGlass; }

    ~TWaitCursor()                         { Screen->Cursor = oldc; }

private:

    TCursor oldc;

};

    TWaitCursor wait; // show hourglass

    // do some lengthy operation

    // cursor restored on exit of block

Die Eigenschaft Cursor kann auf alle Werte gesetzt werden, die in der Eigenschaft Cursors enthalten sind. Es kann sich dabei um integrierte Cursor-Werte handeln, oder um eine benutzerdefinierte Form, die der Eigenschaft Cursors hinzugefügt wurde.


TScreen::Cursors

TScreen	Siehe auch

Die Eigenschaft Cursors ist ein Array mit den Mauszeigern, die für die Anwendung verfügbar sind.

__property HICON Cursors[int Index];

Beschreibung

Mit Hilfe der Eigenschaft Cursor können Sie auf die Mauszeigerdarstellung zugreifen, die von der Anwendung oder einem Steuerelement in der Anwendung benutzt werden soll. TScreen umfaßt mehrere integrierte Zeigerformen, die mit Cursor-Konstanten indiziert sind. Die Bilder, die mit den integrierten Cursor-Konstanten verbunden sind, können über die Eigenschaft Cursors geändert werden.

Die folgende Tabelle enthält die Cursor-Konstanten und ihre Position im Eigenschaften-Array Cursors:

Konstante	Wert	Darstellung

crDefault	0	Abhängig von der Eigenschaft ActiveControl.

crNone	-1

crArrow	 -2

crCross	-3

crIBeam	-4

crSize	-5

crSizeNESW	-6

crSizeNS	-7

crSizeNWSE	-8

crSizeWE	-9

crUpArrow	-10

crHourGlass	-11

crDrag	-12

crNoDrop	-13

crHSplit	-14

crVSplit	-15

crMultiDrag	-16

crSQLWait	-17

crNo	-18

crAppStart	-19

crHelp	-20

Sie können eigene Mauszeigerformen in das Eigenschaften-Array einfügen, die dann von der Anwendung bzw. einem Steuerelement verwendet werden können. Folgendermaßen fügen Sie eine benutzerdefinierte Mauszeigerform einer Anwendung hinzu:

1	Erstellen Sie die Mauszeigerressourcen mit Hilfe eines Ressourceneditors.

2	Deklarieren Sie eine Cursor-Konstante, die nicht mit vorhandenen Cursor-Konstanten konfligiert.

3	Rufen Sie mit Hilfe der Windows-API-Funktion LoadCursor ein Handle für die neue Mauszeigerform ab.

4	Setzen Sie die Eigenschaft Cursors (die mit der neudeklarierten Cursor-Konstante indiziert ist) auf das Handle, das von LoadCursor zurückgegeben wurde.

Wenn beispielsweise eine benutzerdefinierte Mauszeigerform namens NewCursor den Ressourcen einer Anwendung hinzugefügt wurde, kann diese mit dem folgenden Quelltext für die Anwendung verfügbar gemacht werden. Dabei wird die Konstante crMyCursor benutzt und die Mauszeigerform global für die gesamte Anwendung gesetzt.

__fastcall TForm1::TForm1(TComponent* Owner)

    : TForm(Owner)

{

    Screen->Cursors[crMyCursor] = LoadCursor(HInstance, "NewCursor");

    Cursor = crMyCursor;

}

Hinweis

Es ist kein Aufruf der Windows-API-Funktion DestroyCursor erforderlich, wenn die benutzerdefinierte Mauszeigerform nicht mehr benötigt wird. Delphi ruft diese Funktion automatisch auf.


TScreen::DataModuleCount

TScreen	Siehe auch

Die Eigenschaft DataModuleCount gibt an, wie viele Datenmodule aktuell in der Anwendung instantiiert sind.

__property int DataModuleCount;

Beschreibung

Durch Abfragen der Eigenschaft DataModuleCount können Sie die Anzahl der Datenmodule ermitteln, die in der Eigenschaft DataModules enthalten sind. DataModuleCount kann zusammen mit DataModules eingesetzt werden, wenn eine Anwendung über alle Datenmodule iterieren muß.


TScreen::DataModules

TScreen	Siehe auch

Die Eigenschaft DataModule enthält eine Liste mit allen Datenmodulen, die aktuell in der Anwendung instantiiert sind.

__property TDataModule* DataModules[int Index];

Beschreibung

Mit Hilfe von DataModules können Sie auf ein instantiiertes Datenmodul über seinen Index zugreifen. Der Wert von Index ist eine Zahl zwischen Null (das erste Datenmodul) und DataModuleCount - 1. Die Eigenschaft DataModules kann zusammen mit DataModuleCount eingesetzt werden, wenn eine Anwendung über alle Datenmodule iterieren muß.


TScreen::Fonts

TScreen	Siehe auch

Die Eigenschaft Fonts enthält eine Liste mit den Namen aller Schriften, die vom Bildschirm unterstützt werden.

__property Classes::TStrings* Fonts;

Beschreibung

Über die Eigenschaft Fonts können Sie feststellen, welche Bildschirmschriften aktuell installiert sind. Eine Anwendung kann mit Hilfe von Fonts sicherstellen, daß keine Schrift angefordert wird, die nicht im System des Benutzers installiert ist. Wenn mit Hilfe eines TFont-Objekts eine nicht installierte Schrift angefordert wird, stellt Windows eine andere Schrift bereit, die aber möglicherweise nicht den Anforderungen der Anwendung genügt.

Hinweis

Die Eigenschaft Fonts besteht aus einer Liste mit Bildschirmschriften. Sie gibt keinen Aufschluß über die Druckerschriften, die für die Anwendung verfügbar sind.


TScreen::FormCount

TScreen	Siehe auch

Die Eigenschaft FormCount enthält die Anzahl der Formulare, die auf dem Bildschirm angezeigt werden.

__property int FormCount;

Beschreibung

Mit der Eigenschaft FormCount können Sie feststellen, wie viele Formulare aktuell auf dem Bildschirm angezeigt werden. Der Zugriff auf diese Formulare ist mit der Eigenschaft Forms möglich. FormCount kann zusammen mit Forms eingesetzt werden, wenn über alle Formulare in einer Anwendung iteriert werden muß.


TScreen::Forms

TScreen	Siehe auch

Die Eigenschaft Forms enthält eine Liste mit allen Formularen, die aktuell in der Anwendung angezeigt werden.

__property TForm* Forms[int Index];

Beschreibung

Mit Hilfe von Forms können Sie auf ein Formular über seinen Index zugreifen. Der Wert von Index ist eine Zahl zwischen Null (das erste Formular) und FormCount - 1. Die Eigenschaft Forms kann zusammen mit FormCount eingesetzt werden, wenn eine Anwendung über alle Formulare iterieren muß.

Der folgende Quelltext fügt die Namen aller Formulare im Bildschirm ListBox1 hinzu, wenn auf Button1 geklickt wird:

void __fastcall TForm1::Button1Click(TObject *Sender)

{

    for (int i = 0; i < Screen->FormCount; ++i)

        ListBox1->Items->Add(Screen->Forms[i]->Name);

}


TScreen::Height

TScreen	Siehe auch	Beispiel

Die Eigenschaft Height gibt das vertikale Maß des Bildschirms in Pixel an.

__property int Height;

Beschreibung

Durch eine Abfrage von Height können Sie die Höhe des Benutzerbildschirms in Pixel ermitteln. Die Größe bzw. die Position von Objekten kann dann so eingestellt werden, daß sie auf dem Bildschirm Platz haben und dieser nicht unübersichtlich wird. Der folgende Quelltext ermittelt die Höhe aller Formulare auf dem Bildschirm und ändert gegebenenfalls ihre Größe .


TScreen::PixelsPerInch

TScreen	Siehe auch

Die Eigenschaft PixelsPerInch enthält die Anzahl der Bildschirmpixel, die einen virtuellen Zoll in vertikaler Richtung bilden.

__property int PixelsPerInch;

Beschreibung

Verwenden Sie die Eigenschaft PixelsPerInch, wenn Maße von Pixel in Zoll (und umgekehrt) konvertiert werden müssen. PixelsPerInch gilt nur für vertikale Maße. Die meisten Bildschirme verwenden für horizontale Maße einen anderen Skalierungsfaktor. Der Wert in PixelsPerInch wird von Windows gesetzt, wenn $$Delphi$$ geladen wird.


TScreen::Width

TScreen	Siehe auch	Beispiel

Die Eigenschaft Width gibt das horizontale Maß des Bildschirms in Pixel an.

__property int Width;

Beschreibung

Durch eine Abfrage von Width können Sie die Breite des Benutzerbildschirms in Pixel ermitteln. Die Größe bzw. die Position von Objekten kann dann so eingestellt werden, daß sie auf dem Bildschirm Platz haben und dieser nicht unübersichtlich wird. Der folgende Quelltext ermittelt die Breite aller Formulare auf dem Bildschirm und ändert gegebenenfalls ihre Größe.


Ereignisse von TScreen

TScreen	Alphabetisch

In TScreen

OnActiveControlChange

OnActiveFormChange


Ereignisse von TScreen

TScreen	Nach Objekten

OnActiveControlChange

OnActiveFormChange


TScreen::OnActiveControlChange

TScreen	Siehe auch

Das Ereignis OnActiveControlChange tritt unmittelbar nach dem Wechsel des Eingabefokus zu einem neuen Fenstersteuerelement ein.

__property Classes::TNotifyEvent OnActiveControlChange;

Beschreibung

In einer Ereignisbehandlungsroutine für OnActiveControlChange können Sie eine Aktion festlegen, die ausgeführt wird, wenn der Eingabefokus zu einem anderen Steuerelement wechselt. Der Fokus kann entweder innerhalb des aktiven Formulars wechseln oder aber an ein Steuerelement in einem anderen Formular übergeben werden, das dann zum aktiven Formular wird.

Der Fokuswechsel von einem Steuerelement zu einem anderen hat folgende Auswirkungen:

1	Wenn sich das Steuerelement, das den Fokus erhält, in einem anderen Formular befindet, wird der Fokus an das neue Formular übergeben.

2	Der Fokus wird an das neue aktive Steuerelement übergeben.

3	Wenn ein anderes Formular aktiviert wird, tritt ein OnActiveFormChange-Ereignis ein.

4	Ein OnActiveControlChange-Ereignis tritt ein.


TScreen::OnActiveFormChange

TScreen	Siehe auch

Das Ereignis OnActiveFormChange tritt ein, unmittelbar nachdem in einer Anwendung mit mehreren Formularen ein neues Formular aktiviert wurde.

__property Classes::TNotifyEvent OnActiveFormChange;

Beschreibung

In einer Ereignisbehandlungsroutine für OnActiveFormChange können Sie eine Aktion festlegen, die ausgeführt werden soll, wenn ein neues Formular aktiviert wird. OnActiveFormChange tritt ein, wenn sich das aktive Formular einer Anwendung ändert, jedoch nicht, wenn ein Formular aktiv wird, weil die Anwendung aktiviert wurde.


Methoden von TScreen

TScreen	Alphabetisch

In TScreen

~TScreen

TScreen

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TScreen

TScreen	Nach Objekten

~TScreen

Assign

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

DestroyComponents

Destroying

Dispatch

FieldAddress

FindComponent

FreeInstance

FreeNotification

Free

GetParentComponent

HasParent

InheritsFrom

InitInstance

InsertComponent

InstanceSize

MethodAddress

MethodName

NewInstance

RemoveComponent

TScreen


TScreen::~TScreen

TScreen	Siehe auch

Der Destruktor ~TScreen gibt den Speicher frei, der für das TScreen-Objekt reserviert war. Rufen Sie ~TScreen nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TScreen automatisch aufgerufen wird.

__fastcall virtual ~TScreen(void);


TScreen::TScreen

TScreen	Siehe auch

Die Methode TScreen erzeugt eine Instanz von TScreen.

__fastcall virtual TScreen(Classes::TComponent* AOwner);

Beschreibung

Erstellen Sie keine separaten Instanzen von TScreen. Es existierte eine globale Variable namens Screen vom Typ TScreen, die bereits für die Verwendung durch Borland C++Builder-Anwendungen instantiiert ist. Die Eigenschaften von Screen sind für die gesamte Anwendung global.

TScreen reserviert Speicher für das TScreen-Objekt und führt außerdem folgende Aktionen aus:

•	Die Eigenschaft Cursors wird mit den integrierten Mauszeigerformen gefüllt.

•	Die Eigenschaft Fonts wird mit den verfügbaren Bildschirmschriften gefüllt.

•	Die Eigenschaft PixelsPerInch wird für die aktuelle Bildschirmauflösung gesetzt.

•	Hilfsobjekte für die Eigenschaften IconFont, Forms und DataModules werden erstellt.


Gültigkeitsbereich

Published

Zugriff

Read-only


Hierarchie

TObject

TPersistent

TComponent


TScreen Beispiel

TScreen


 TScrollBar

Hierarchie	Eigenschaften	Methoden	Ereignisse

Header

vcl/stdctrls.hpp

Eine TScrollBar-Komponente ist eine Windows-Bildlaufleiste, mit der der Bildschirmausschnitt eines Fensters, eines Formulars oder eines Steuerelements verschoben werden kann. In einer Ereignisbehandlungsroutine für OnScroll können Sie festlegen, wie das Fenster, das Formular oder das Steuerelement auf das Verschieben der Bildlaufleiste reagiert.

Beschreibung

Mit der Eigenschaft LargeChange können Sie bestimmen, wie weit die Positionsmarke verschoben wird, wenn der Benutzer auf die Bildlaufleiste klickt. Der Wert der Eigenschaft SmallChange legt fest, wie weit die Positionsmarke bewegt wird, wenn die Pfeile am Ende der Bildlaufleiste angeklickt werden oder der Bildschirmausschnitt mit den Pfeiltasten der Tastatur verschoben wird.

Mit den Eigenschaften Min und Max können Sie festlegen, wieviele Positionen die Positionsmarke der Bildlaufleiste einnehmen kann. Die Position kann über die Eigenschaft Position festgelegt oder ermittelt werden. Mit der Methode SetParams können Sie die Eigenschaften Min, Max und Position gleichzeitig setzen.

Wenn die Eigenschaft Tracking True ist, verschiebt sich der Bildschirmausschnitt eines Formulars oder Bildlauffeldes, während die Positionsmarke gezogen wird. Der Benutzer braucht nicht erst die Maustaste loszulassen.

Die Komponente TScrollBar ist ein direkter Nachkomme von TWinControl. Zusätzlich zu den folgenden Eigenschaften, Methoden und Ereignissen verfügt die Komponente über die Eigenschaften, Methoden und Ereignisse, die alle fensterorientierte Steuerelemente gemeinsam haben.


Eigenschaften von TScrollBar

TScrollBar	Alphabetisch	Legende

In TScrollBar

Kind

LargeChange

Max

Min

Position

SmallChange

Abgeleitet von TWinControl

Brush

ClientOrigin

ClientRect

ControlCount

Controls

Ctl3D

Handle

HelpContext

ParentCtl3D

Showing

TabOrder

TabStop

Abgeleitet von TControl

Align

BoundsRect

ClientHeight

ClientWidth

ControlState

ControlStyle

Cursor

DragCursor

DragMode

Enabled

Height

Hint

Left

Name

Parent

ParentShowHint

PopupMenu

ShowHint

Top

Visible

Width

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TScrollBar

TScrollBar	Nach Objekten	Legende

Align

BoundsRect

Brush

ClientHeight

ClientOrigin

ClientRect

ClientWidth

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlCount

ControlState

Controls

ControlStyle

Ctl3D

Cursor

DesignInfo

DragCursor

DragMode

Enabled

Handle

Height

HelpContext

Hint

Kind

LargeChange

Left

Max

Min

Name

Owner

ParentCtl3D

ParentShowHint

Parent

PopupMenu

Position

ShowHint

Showing

SmallChange

TabOrder

TabStop

Tag

Top

Visible

Width


TScrollBar::Kind

TScrollBar	Beispiel

Die Eigenschaft Kind bestimmt, ob eine Bildlaufleiste horizontal oder vertikal angezeigt wird.

__property Forms::TScrollBarKind Kind;

Beschreibung

Die möglichen Werte für diese Eigenschaft sind:

Wert	Bedeutung

sbHorizontal	Die Bildlaufleiste wird horizontal angezeigt.

sbVertical	Die Bildlaufleiste wird vertikal angezeigt.


TScrollBar::LargeChange

TScrollBar	Siehe auch	Beispiel

Die Eigenschaft LargeChange bestimmt, wie weit das Bildlauffeld verschoben wird, wenn der Benutzer auf die Bildlaufleiste klickt oder die Taste AUF oder AB drückt.

__property Forms::TScrollBarInc LargeChange;

Beschreibung

Wenn LargeChange beispielsweise den Wert 1000 hat, bewegt sich das Bildlauffeld bei jedem Klick auf die Bildlaufleiste um 1000 Positionen. Der Abstand zweier Positionen hängt von der Differenz der Eigenschaften Max und Min ab. Wenn Max 3000 und Min 0 ist, muß der Benutzer dreimal auf die Bildlaufleiste klicken, um von einem Ende des Bildlauffeldes zum anderen zu gelangen.


TScrollBar::Max

TScrollBar	Siehe auch

Zusammen mit der Eigenschaft Min legt Max die Anzahl der möglichen Positionen fest, die die Positionsmarke in der Bildlaufleiste einnehmen kann.

__property int Max;

Beschreibung

Die Eigenschaften LargeChange und SmallChange berechnen aus der Anzahl der Positionen, wie weit das Bildlauffeld beim Klicken auf die Bildlaufleiste verschoben wird.

Wenn beispielsweise Max 30000 und Min 0 ist, kann die Positionsmarke in einer horizonalen Bildlaufleiste 30000 Positionen einnehmen. Wenn LargeChange auf 10000 eingestellt ist und sich die Positionsmarke am linken Rand der Bildlaufleiste befindet (an Position 0), kann die positionsmarke durch dreimaliges Klicken auf den Bereich rechts von ihr an das rechte Ende der Bildlaufleiste verschoben werden (30000/10000 = 3).

Mit der Methode SetParams können Sie zur Laufzeit die Werte von Min, Max und Position gleichzeitig ändern.


TScrollBar::Min

TScrollBar	Siehe auch

Zusammen mit der Eigenschaft Max können Sie mit Min die Anzahl der möglichen Positionen festlegen, die die Positionsmarke in der Bildlaufleiste einnehmen kann.

__property int Min;

Beschreibung

Die Eigenschaften LargeChange und SmallChange berechnen aus der Anzahl der Positionen, wie weit das Bildlauffeld beim Klicken auf die Bildlaufleiste verschoben wird.

Wenn beispielsweise Max 3000 und Min 0 ist, kann die Positionsmarke in einer horizonalen Bildlaufleiste 3000 Positionen einnehmen. Wenn LargeChange auf 1000 eingestellt ist und sich die Positionsmarke am linken Rand der Bildlaufleiste befindet (an Position 0), kann die positionsmarke durch dreimaliges Klicken auf den Bereich rechts von ihr an das rechte Ende der Bildlaufleiste verschoben werden (3000/1000 = 3).

Mit der Methode SetParams können Sie zur Laufzeit die Werte von Min, Max und Position gleichzeitig ändern.


TScrollBar::Position

TScrollBar	Siehe auch	Beispiel

Die Eigenschaft Position legt die Position der Positionsmarke in einer Bildlaufleiste fest.

__property int Position;

Beschreibung

Wenn der Benutzer die Positionsmarke bewegt, ändert sich der Wert von Position. Umgekehrt können Sie auch die Position der Positionsmarke verändern, indem Sie Position einen Wert zuweisen.

Die Anzahl der möglichen Positionen in der Bildlaufleiste wird durch die Differenz von Max und Min bestimmt. Wenn Min und Position 0 sind, wird die Positionsmarke in einer horizontalen Bildlaufleiste am linken Rand und in einer vertikalen Bildlaufleiste am oberen Rand angezeigt. Hat Min den Wert 10, kann Position nicht kleiner als 10 sein.


TScrollBar::SmallChange

TScrollBar	Siehe auch	Beispiel

Die Eigenschaft SmallChange bestimmt, wie weit die Positionsmarke verschoben wird, wenn der Benutzer auf die Pfeile am Ende der Bildlaufleiste klickt oder die Pfeiltasten der Tastatur drückt.

__property Forms::TScrollBarInc SmallChange;

Wenn SmallChange beispielsweise 1000 ist, bewegt sich die Positionsmarke bei jedem Klick auf einen Pfeil der Bildlaufleiste um 1000 Positionen. Die Anzahl der möglichen Positionen ergibt sich aus der Differenz zwischen Max und Min. Ist Max beispielsweise 30000 und Min 0, muß der Benutzer dreißigmal auf einen Pfeil klicken, um die Positionsmarke von einem Ende der Bildlaufleiste zum anderen zu verschieben.


Ereignisse von TScrollBar

TScrollBar	Alphabetisch	Legende

In TScrollBar

OnScroll

Abgeleitet von TWinControl

OnEnter

OnExit

OnKeyDown

OnKeyPress

OnKeyUp

Abgeleitet von TControl

OnDragDrop

OnDragOver

OnEndDrag

OnStartDrag


Ereignisse von TScrollBar

TScrollBar	Nach Objekten	Legende

OnDragDrop

OnDragOver

OnEndDrag

OnEnter

OnExit

OnKeyDown

OnKeyPress

OnKeyUp

OnScroll

OnStartDrag


TScrollBar::OnScroll

TScrollBar	Beispiel

Das Ereignis OnScroll wird ausgelöst, wenn der Benutzer den Bildschirmausschnitt verschiebt.

__property TScrollEvent OnScroll;

Beschreibung

Der Typ TScrollEvent zeigt auf eine Methode, die das Verschieben eines Bildschirmausschnitts bearbeitet. Der Parameter ScrollCode kann einen der folgenden Werte annehmen:

Wert	Bedeutung

scLineUp	Der Benutzer hat auf den oberen oder den linken Pfeil geklickt oder die Taste AUF gedrückt.

scLineDown	Der Benutzer hat auf den unteren oder den rechten Pfeil geklickt oder die Taste AB gedrückt.

scPageUp	Der Benutzer hat auf den Bereich links der Positionsmarke geklickt oder die Taste BILD AUF gedrückt.

scPageDown	Der Benutzer hat auf den Bereich rechts der Positionsmarke geklickt oder die Taste BILD AB gedrückt.

scPosition	Der Benutzer hat die Positionmarke bewegt und die Maustaste losgelassen.

scTrack	Der Benutzer bewegt soeben die Positionsmarke.

scTop	Der Benutzer hat Die Positionsmarke wurde an den oberen bzw. linken Rand der Bildlaufleiste verschoben.

scBottom	Der Benutzer hat die Positionsmarke wurde den unteren bzw. rechten Rand der Bildlaufleiste verschoben.

scEndScroll	Der Benutzer hat das Verschieben der Positionsmarke in der Bildlaufleiste beendet.

Der Parameter ScrollPos gibt die Position der Positionsmarke in der Bildlaufleiste an.


Methoden von TScrollBar

TScrollBar	Alphabetisch

In TScrollBar

~TScrollBar

SetParams

TScrollBar

Abgeleitet von TWinControl

Broadcast

CanFocus

ContainsControl

ControlAtPos

DisableAlign

EnableAlign

Focused

GetTabOrderList

HandleAllocated

HandleNeeded

InsertControl

Invalidate

PaintTo

Realign

RemoveControl

Repaint

ScaleBy

ScrollBy

SetBounds

SetFocus

Update

UpdateControlState

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

GetTextLen

Hide

Perform

Refresh

ScreenToClient

SendToBack

SetTextBuf

Show

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TScrollBar

TScrollBar	Nach Objekten

~TScrollBar

Assign

BeginDrag

BringToFront

Broadcast

CanFocus

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

ClientToScreen

ContainsControl

ControlAtPos

DefaultHandler

DestroyComponents

Destroying

DisableAlign

Dispatch

DragDrop

Dragging

EnableAlign

EndDrag

FieldAddress

FindComponent

Focused

FreeInstance

FreeNotification

Free

GetParentComponent

GetTabOrderList

GetTextBuf

GetTextLen

HandleAllocated

HandleNeeded

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InsertControl

InstanceSize

Invalidate

MethodAddress

MethodName

NewInstance

PaintTo

Perform

Realign

Refresh

RemoveComponent

RemoveControl

Repaint

ScaleBy

ScreenToClient

ScrollBy

SendToBack

SetBounds

SetFocus

SetParams

SetTextBuf

Show

TScrollBar

UpdateControlState

Update


TScrollBar::~TScrollBar

TScrollBar

Der Destruktor ~TScrollBar gibt den Speicher frei, der für das TScrollBar-Objekt reserviert war. Rufen Sie ~TScrollBar nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TScrollBar automatisch aufgerufen wird.

__fastcall virtual ~TScrollBar(void);Max property, Min property, Position property


TScrollBar::SetParams

TScrollBar

Die Methode SetParams weist den Eigenschaften Position, Max und Min gleichzeitig Werte zu.

void __fastcall SetParams(int APosition, int AMin, int AMax);

Beschreibung

Mit der Methode SetParams können Sie die Eigenschaften Position, Max und Min gleichzeitig setzen. Auf diese Weise wird nicht nach jeder einzelnen Zuweisung die Anzeige aktualisiert.


TScrollBar::TScrollBar

TScrollBar

Der Konstruktor TScrollBar erzeugt ein neues TScrollBar-Objekt.

__fastcall virtual TScrollBar(Classes::TComponent* AOwner);


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TControl

TWinControl


TScrollBar Beispiel

TScrollBar


 TScrollBox

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/forms.hpp

TScrollBox ist die Komponente für ein Bildlauffeld. Darunter versteht man einen Bereich innerhalb eines Fensters, in dem sich der dargestellte Ausschnitt eines Objekts verschieben läßt.

Beschreibung

Mit TScrollBox wird ein Bildlauffeld in einem Fenster plaziert.

Eine mögliche Anwendung für Bildlauffelder besteht darin, bestimmte Bereiche eines Fensters, wie etwa eine Werkzeugleiste oder eine Statusleiste, von einem Bildlauf auszuschließen. Dazu werden die Bildlaufleisten des Fensters ausgeblendet, und im Client-Bereich des Fensters zwischen Schalterleiste und Statusleiste wird ein Bildlauffeld plaziert. Aus der Sicht des Benutzers scheinen die Bildlaufleisten dieses Feldes zum gesamten Fenster zu gehören. Allerdings wirkt sich ein Bildlauf nur auf den Bereich innerhalb des Feldes aus. Die Elemente am oberen und unteren Rand des Fensters behalten ihre Position.

Ein weiterer Einsatzbereich von Steuerelementen dieser Art ist die Realisierung mehrerer Bildlaufbereiche (Ansichten) in einem einzigen Fenster. Dergleichen ist aus Textverarbeitungen, Tabellenkalkulationen oder Projektverwaltungsprogrammen bekannt.

Ein Bildlauffeld kann seinerseits Objekte enthalten, wie etwa TButton- oder TCheckBox-Objekte.


Eigenschaften von TScrollBox

TScrollBox	Alphabetisch	Legende

In TScrollBox

BorderStyle

Abgeleitet von TScrollingWinControl

AutoScroll

HorzScrollBar

VertScrollBar

Abgeleitet von TWinControl

Brush

ClientOrigin

ClientRect

ControlCount

Controls

Ctl3D

Handle

HelpContext

ParentCtl3D

Showing

TabOrder

TabStop

Abgeleitet von TControl

Align

BoundsRect

ClientHeight

ClientWidth

Color

ControlState

ControlStyle

Cursor

DragCursor

DragMode

Enabled

Font

Height

Hint

Left

Name

Parent

ParentColor

ParentFont

ParentShowHint

PopupMenu

ShowHint

Top

Visible

Width

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TScrollBox

TScrollBox	Nach Objekten	Legende

Align

AutoScroll

BorderStyle

BoundsRect

Brush

ClientHeight

ClientOrigin

ClientRect

ClientWidth

Color

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlCount

ControlState

Controls

ControlStyle

Ctl3D

Cursor

DesignInfo

DragCursor

DragMode

Enabled

Font

Handle

Height

HelpContext

Hint

HorzScrollBar

Left

Name

Owner

ParentColor

ParentCtl3D

ParentFont

ParentShowHint

Parent

PopupMenu

ShowHint

Showing

TabOrder

TabStop

Tag

Top

VertScrollBar

Visible

Width


TScrollBox::BorderStyle

TScrollBox	Beispiel

Der Wert BorderStyle legt fest, ob das Bildlauffeld einen Rahmen besitzt.

__property TBorderStyle BorderStyle;

Beschreibung

Mit BorderStyle kann ermittelt oder festgelegt werden, ob das Bildlauffeld von einem Rahmen umgeben ist. Folgende Werte sind möglich:

Wert	Bedeutung

bsNone	Kein Rahmen sichtbar.

bsSingle	Rahmen aus einer einzelnen Linie.


Ereignisse von TScrollBox

TScrollBox	Alphabetisch	Legende

In TScrollBox

OnResize

Abgeleitet von TWinControl

OnEnter

OnExit

Abgeleitet von TControl

OnClick

OnDblClick

OnDragDrop

OnDragOver

OnEndDrag

OnMouseDown

OnMouseMove

OnMouseUp


Ereignisse von TScrollBox

TScrollBox	Nach Objekten	Legende

OnClick

OnDblClick

OnDragDrop

OnDragOver

OnEndDrag

OnEnter

OnExit

OnMouseDown

OnMouseMove

OnMouseUp

OnResize


TScrollBox::OnResize

TScrollBox

Das Ereignis OnResize wird ausgelöst, wenn die Größe des Bildlauffeldes verändert wird.

typedef void __fastcall (__closure *TNotifyEvent)(System::TObject* Sender);

__property Classes::TNotifyEvent OnResize;

Beschreibung

Mit Hilfe von OnResize können bestimmte Aktionen als Folge einer Größenänderung des Bildlauffeldes eingeleitet werden.


Methoden von TScrollBox

TScrollBox	Alphabetisch

In TScrollBox

~TScrollBox

TScrollBox

Abgeleitet von TScrollingWinControl

ScrollInView

Abgeleitet von TWinControl

Broadcast

CanFocus

ContainsControl

ControlAtPos

DisableAlign

EnableAlign

Focused

GetTabOrderList

HandleAllocated

HandleNeeded

InsertControl

Invalidate

PaintTo

Realign

RemoveControl

Repaint

ScaleBy

ScrollBy

SetBounds

SetFocus

Update

UpdateControlState

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

GetTextLen

Hide

Perform

Refresh

ScreenToClient

SendToBack

SetTextBuf

Show

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TScrollBox

TScrollBox	Nach Objekten

~TScrollBox

Assign

BeginDrag

BringToFront

Broadcast

CanFocus

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

ClientToScreen

ContainsControl

ControlAtPos

DefaultHandler

DestroyComponents

Destroying

DisableAlign

Dispatch

DragDrop

Dragging

EnableAlign

EndDrag

FieldAddress

FindComponent

Focused

FreeInstance

FreeNotification

Free

GetParentComponent

GetTabOrderList

GetTextBuf

GetTextLen

HandleAllocated

HandleNeeded

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InsertControl

InstanceSize

Invalidate

MethodAddress

MethodName

NewInstance

PaintTo

Perform

Realign

Refresh

RemoveComponent

RemoveControl

Repaint

ScaleBy

ScreenToClient

ScrollBy

ScrollInView

SendToBack

SetBounds

SetFocus

SetTextBuf

Show

TScrollBox

UpdateControlState

Update


TScrollBox::~TScrollBox

TScrollBox

Der Destruktor ~TScrollBox gibt den Speicher frei, der für das TScrollBox-Objekt reserviert war. Rufen Sie ~TScrollBox nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TScrollBox automatisch aufgerufen wird.

__fastcall virtual ~TScrollBox(void);


TScrollBox::TScrollBox

TScrollBox	Siehe auch

Diese Methode erzeugt und initialisiert ein neues TScrollBox-Objekt.

__fastcall virtual TScrollBox(Classes::TComponent* AOwner);

Beschreibung

Mit TScrollBox wird ein neues TScrollBox-Objekt erzeugt und initialisiert.

AOwner ist ein TComponent-Objekt, in dem das übergeordnete Objekt des Bildlauffeldes gekapselt ist.

Folgende Aktionen werden ausgeführt:

•	TScrollBox ruft die Methode TScrollingWinControl::TScrollingWinControl auf und übergibt dieser AOwner.

•	TScrollBox setzt die Eigenschaft TScrollingWinControl::ControlStyle auf csAcceptsControls, csCaptureMouse, csClickEvents, csSetCaption, csDoubleClicks.

•	TScrollBox setzt die Eigenschaft TScrollingWinControl::Width auf 185.

•	TScrollBox setzt die Eigenschaft TScrollingWinControl::Height auf 41.

•	TScrollBox setzt die Eigenschaft BorderStyle auf bsSingle.


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TControl

TWinControl

TScrollingWinControl


TScrollBox Beispiel

TScrollBox


TScroller

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/tabs.hpp

TScroller ist eine horizontale Bildlaufleiste, die Grundfunktionen für einen horizontalen Bildlauf bietet.

Beschreibung

Mit TScroller steht ein Steuerelement für solche Objekte zur Verfügung, die nicht die komplexe Funktionalität eines TScrollBar-Objekts benötigen. Im Gegensatz zu Bildlaufleisten des Typs TScrollBar verfügen die Steuerelemente der Klasse TScroller nicht über eine Positionsmarke. Wenn Sie eine ähnliche Funktionalität in vertikaler Richtung realisieren möchten, verwenden Sie ein TUpDown-Objekt.

TScroller wird vom Objekt TTabSet für den Bildlauf der sichtbaren Registerkarten verwendet.


Eigenschaften von TScroller

TScroller	Alphabetisch	Legende

In TScroller

Change

Max

Min

Position

Abgeleitet von TWinControl

Brush

ClientOrigin

ClientRect

ControlCount

Controls

Handle

HelpContext

Showing

TabOrder

TabStop

Abgeleitet von TControl

Align

BoundsRect

ClientHeight

ClientWidth

ControlState

ControlStyle

Cursor

Enabled

Height

Hint

Left

Name

Parent

ShowHint

Top

Visible

Width

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TScroller

TScroller	Nach Objekten	Legende

Align

BoundsRect

Brush

Change

ClientHeight

ClientOrigin

ClientRect

ClientWidth

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlCount

ControlState

Controls

ControlStyle

Cursor

DesignInfo

Enabled

Handle

Height

HelpContext

Hint

Left

Max

Min

Name

Owner

Parent

Position

ShowHint

Showing

TabOrder

TabStop

Tag

Top

Visible

Width


TScroller::Change

TScroller	Siehe auch

Mit der Eigenschaft Change wird die Weite eines Bildlaufschritts definiert, das heißt die Anzahl der virtuellen Längeneinheiten, um die das Objekt verschoben werden soll, sobald der Benutzer auf eine der Pfeilschaltflächen klickt.

__property int Change;

Beschreibung

Change bezeichnet die Anzahl der Einheiten zwischen den Grenzwerten Min und Max, um die sich die Position verschieben soll, wenn der Benutzer auf eine der Pfeilschaltflächen klickt. Change übernimmt die Zuordnung des Einheitensystems, das für Min, Max und Position gilt, zu den logischen Einheiten, die als Maßsystem für die Bildlaufleiste gelten.

Wenn die Werte der Eigenschaften Min, Max und Position beispielsweise in Bildschirmpixeln ausgedrückt werden, entspricht Change der Anzahl von Pixeln, um die bei einem Bildlaufschritt verschoben werden soll.


TScroller::Max

TScroller	Siehe auch

Max ist der Maximalwert der Eigenschaft Position.

__property long Max;

Beschreibung

Mit Max wird der obere Grenzwert des Bildlaufbereichs festgelegt. Die beiden Eigenschaften Min und Max definieren den Wertebereich, in dem eine Bildlaufleiste eine Verschiebung durchführen kann.


TScroller::Min

TScroller	Siehe auch

Min ist der Minimalwert der Eigenschaft Position.

__property long Min;

Beschreibung

Mit Min wird der untere Grenzwert des Bildlaufbereichs festgelegt. Die beiden Eigenschaften Min und Max definieren den Wertebereich, in dem eine Bildlaufleiste eine Verschiebung durchführen kann.


TScroller::Position

TScroller	Siehe auch	Beispiel

Position bezeichnet die aktuelle Position innerhalb des Bildlaufbereichs.

__property long Position;

Beschreibung

Mit dem Wert dieser Eigenschaft bestimmt man die aktuelle Position, welche von der Bildlaufleiste repräsentiert wird. Sobald sich die Position ändert, muß das Objekt, das einem Bildlauf unterzogen wird, mit einer Ereignisbehandlungsroutine für OnClick benachrichtigt werden.


Ereignisse von TScroller

TScroller	Alphabetisch	Legende

In TScroller

OnClick


Ereignisse von TScroller

TScroller	Nach Objekten	Legende

OnClick


TScroller::OnClick

TScroller	Siehe auch	Beispiel

Das Ereignis OnClick wird ausgelöst, sobald die Eigenschaft Position aktualisiert wurde. Dies ist immer dann der Fall, wenn der Benutzer auf eine der Pfeilschaltflächen klickt.

__property Classes::TNotifyEvent OnClick;

Beschreibung

Schreiben Sie eine Ereignisbehandlungsroutine für OnClick, der die Bildlaufaktion des Objekts implementiert, das einen Bildlauf mit TScroller steuert. Sobald der Benutzer auf eine der Pfeilschaltflächen klickt, wird der Wert von Position mit dem Wert von Change aktualisiert, wenn nicht bereits Max oder Min erreicht ist. Anschließend wird ein OnClick-Ereignis ausgelöst.


Methoden von TScroller

TScroller	Alphabetisch

In TScroller

~TScroller

Paint

TScroller

Abgeleitet von TWinControl

Broadcast

CanFocus

ContainsControl

ControlAtPos

DisableAlign

EnableAlign

Focused

GetTabOrderList

HandleAllocated

HandleNeeded

InsertControl

Invalidate

PaintTo

Realign

RemoveControl

Repaint

ScaleBy

ScrollBy

SetBounds

SetFocus

Update

UpdateControlState

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

GetTextLen

Hide

Perform

Refresh

ScreenToClient

SendToBack

SetTextBuf

Show

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TScroller

TScroller	Nach Objekten

~TScroller

Assign

BeginDrag

BringToFront

Broadcast

CanFocus

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

ClientToScreen

ContainsControl

ControlAtPos

DefaultHandler

DestroyComponents

Destroying

DisableAlign

Dispatch

DragDrop

Dragging

EnableAlign

EndDrag

FieldAddress

FindComponent

Focused

FreeInstance

FreeNotification

Free

GetParentComponent

GetTabOrderList

GetTextBuf

GetTextLen

HandleAllocated

HandleNeeded

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InsertControl

InstanceSize

Invalidate

MethodAddress

MethodName

NewInstance

PaintTo

Paint

Perform

Realign

Refresh

RemoveComponent

RemoveControl

Repaint

ScaleBy

ScreenToClient

ScrollBy

SendToBack

SetBounds

SetFocus

SetTextBuf

Show

TScroller

UpdateControlState

Update


TScroller::~TScroller

TScroller	Siehe auch

Der Destruktor ~TScroller gibt den Speicher frei, der für das TScroller-Objekt reserviert war. Rufen Sie ~TScroller nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TScroller automatisch aufgerufen wird.

__fastcall virtual ~TScroller(void);


TScroller::Paint

TScroller	Siehe auch

Mit Paint wird das TScroller-Objekt in dessen Zeichenbereich dargestellt.

virtual void __fastcall Paint(void);

Beschreibung

Mit Paint wird die Anzeige der Bildlaufleiste aktualisiert. Paint wird automatisch als Reaktion auf WM_PAINT-Botschaften aufgerufen. Dabei werden die Pfeilschaltflächen grau schattiert (als inaktiv dargestellt), wenn die Position in der jeweiligen Richtung nicht weiter verschoben werden kann.


TScroller::TScroller

TScroller	Siehe auch

Der Konstruktor TScroller erzeugt ein neues TScroller-Objekt.

__fastcall virtual TScroller(Classes::TComponent* AOwner);

Beschreibung

Mit TScroller wird zur Laufzeit eine Instanz von TScroller erzeugt. TScroller reserviert Speicher für das TScroller-Objekt und nimmt folgende Initialisierungen vor:

•	Width wird auf 24 gesetzt und Height auf 13.

•	Min und Max werden auf 0 gesetzt.

•	Position wird auf 0 gesetzt.

•	Change wird auf 1 gesetzt.


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TControl

TWinControl

TCustomControl


TScroller Beispiel

TScroller


TScrollingWinControl

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/forms.hpp

TScrollingWinControl ist die Komponente für ein fensterorientiertes Steuerelement, das einen Bildlauf unterstützt.

Beschreibung

Mit TScrollingWinControl wird ein fensterorientiertes Steuerelement erzeugt, das einen Bildlauf unterstützt.

Solche Steuerelemente enthalten normalerweise horizontale und vertikale Bildlaufleisten, mit denen der sichtbare Ausschnitt eines untergeordneten Steuerelements verschoben werden kann, sobald dieses den Fokus erhält.

Die Objekte TForm und TScrollBox sind Beispiele für Steuerelemente dieser Art.


Eigenschaften von TScrollingWinControl

TScrollingWinControl	Alphabetisch	Legende

In TScrollingWinControl

AutoScroll

HorzScrollBar

VertScrollBar

Abgeleitet von TWinControl

Brush

ClientOrigin

ClientRect

ControlCount

Controls

Handle

HelpContext

Showing

TabOrder

TabStop

Abgeleitet von TControl

Align

BoundsRect

ClientHeight

ClientWidth

ControlState

ControlStyle

Cursor

Enabled

Height

Hint

Left

Name

Parent

ShowHint

Top

Visible

Width

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TScrollingWinControl

TScrollingWinControl	Nach Objekten	Legende

Align

AutoScroll

BoundsRect

Brush

ClientHeight

ClientOrigin

ClientRect

ClientWidth

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlCount

ControlState

Controls

ControlStyle

Cursor

DesignInfo

Enabled

Handle

Height

HelpContext

Hint

HorzScrollBar

Left

Name

Owner

Parent

ShowHint

Showing

TabOrder

TabStop

Tag

Top

VertScrollBar

Visible

Width


TScrollingWinControl::AutoScroll

TScrollingWinControl	Siehe auch

AutoScroll ist eine boolesche Eigenschaft, mit der festgelegt wird, ob Bildlaufleisten automatisch eingeblendet werden, wenn ein fensterorientiertes Steuerelement zu klein ist, um alle enthaltenen Steuerelemente gleichzeitig anzuzeigen.

__property bool AutoScroll;

Beschreibung

Wenn AutoScroll den Wert True hat, erscheinen die Bildlaufleisten bei Bedarf automatisch. Dies ist immer dann nötig, wenn der Benutzer das fensterorientierte Steuerelement so verkleinert, daß einige der enthaltenen Steuerelemente nicht vollständig sichtbar sind.

Der Wert False verhindert die automatische Anzeige. Bildlaufleisten müssen dann mit den Eigenschaften HorzScrollBar und VertScrollBar explizit aktiviert werden.


TScrollingWinControl::HorzScrollBar

TScrollingWinControl	Siehe auch

Die Eigenschaft HorzScrollBar ist ein TControlScrollBar-Objekt, das die horizontale Bildlaufleiste für das fensterorientierte Steuerelement kapselt.

__property TControlScrollBar* HorzScrollBar;

Beschreibung

Mit HorzScrollBar wird die horizontale Bildlaufleiste ausgeblendet, eingeblendet und im Aussehen verändert.


TScrollingWinControl::VertScrollBar

TScrollingWinControl	Siehe auch

Die Eigenschaft VertScrollBar ist ein TControlScrollBar-Objekt, das die vertikale Bildlaufleiste für das fensterorientierte Steuerelement kapselt.

__property TControlScrollBar* VertScrollBar;

Beschreibung

Mit VertScrollBar wird die vertikale Bildlaufleiste ausgeblendet, eingeblendet und im Aussehen verändert.


Methoden von TScrollingWinControl

TScrollingWinControl	Alphabetisch	Legende

In TScrollingWinControl

~TScrollingWinControl

AlignControls

AutoScrollInView

ChangeScale

CreateWnd

ScrollInView

TScrollingWinControl

Abgeleitet von TWinControl

Broadcast

CanFocus

ContainsControl

ControlAtPos

DisableAlign

EnableAlign

Focused

GetTabOrderList

HandleAllocated

HandleNeeded

InsertControl

Invalidate

PaintTo

Realign

RemoveControl

Repaint

ScaleBy

ScrollBy

SetBounds

SetFocus

Update

UpdateControlState

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

GetTextLen

Hide

Perform

Refresh

ScreenToClient

SendToBack

SetTextBuf

Show

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TScrollingWinControl

TScrollingWinControl	Nach Objekten	Legende

~TScrollingWinControl

AlignControls

Assign

AutoScrollInView

BeginDrag

BringToFront

Broadcast

CanFocus

ChangeScale

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

ClientToScreen

ContainsControl

ControlAtPos

CreateWnd

DefaultHandler

DestroyComponents

Destroying

DisableAlign

Dispatch

DragDrop

Dragging

EnableAlign

EndDrag

FieldAddress

FindComponent

Focused

FreeInstance

FreeNotification

Free

GetParentComponent

GetTabOrderList

GetTextBuf

GetTextLen

HandleAllocated

HandleNeeded

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InsertControl

InstanceSize

Invalidate

MethodAddress

MethodName

NewInstance

PaintTo

Perform

Realign

Refresh

RemoveComponent

RemoveControl

Repaint

ScaleBy

ScreenToClient

ScrollBy

ScrollInView

SendToBack

SetBounds

SetFocus

SetTextBuf

Show

TScrollingWinControl

UpdateControlState

Update


TScrollingWinControl::~TScrollingWinControl

TScrollingWinControl	Siehe auch

Der Destruktor ~TScrollingWinControl gibt den Speicher frei, der für das TScrollingWinControl-Objekt reserviert war. Rufen Sie ~TScrollingWinControl nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TScrollingWinControl automatisch aufgerufen wird.

__fastcall virtual ~TScrollingWinControl(void);

Beschreibung

~TScrollingWinControl gibt die Eigenschaften HorzScrollBar und VertScrollBar frei und ruft dann TWinControl::~TWinControl auf.


TScrollingWinControl::AlignControls

TScrollingWinControl	Siehe auch

Die Methode AlignControls legt die Ausrichtung der Steuerelemente fest, die in einem fensterorientierten Steuerelement mit Bildlauffunktion angeordnet sind.

virtual void __fastcall AlignControls(Controls::TControl* AControl, Windows::TRect &ARect);

Beschreibung

Mit AlignControls werden die einzelnen Steuerelemente innerhalb des fensterorientierten Steuerelements entsprechend ihren Align-Eigenschaften ausgerichtet.

Der Parameter AControl ist ein TControl-Objekt und bezeichnet das Steuerelement, das vorrangig die Ausrichtung bestimmt, wenn es mehrere Steuerelemente gibt, deren Eigenschaft Align denselben Wert besitzt. AControl kann auch auf NULL zeigen.

Der Parameter ARect ist ein TRect-Objekt und gibt den Bereich vor, in dem die Steuerelemente angeordnet sind, die innerhalb des umgebenden fensterorientierten Steuerelements ausgerichtet werden sollen. Der Parameter ARect wird automatisch so gesetzt, daß er den gesamten Bildlaufbereich beschreibt.

Wenn AutoScroll den Wert True hat und das fensterorientierte Steuerelement nicht in der Größe verändert wurde, werden die Bereichsgrenzen für die Bildlaufleisten automatisch neu berechnet, und ARect erhält einen neuen Wert.

Anschließend ruft AlignControls die Methode TWinControl.AlignControls auf und übergibt die Objekte AControl und ARect.


TScrollingWinControl::AutoScrollInView

TScrollingWinControl	Siehe auch

Die Methode AutoScrollInView führt einen Bildlauf durch, so daß ein Steuerelement in den sichtbaren Bereich des umgebenden fensterorientierten Steuerelements verschoben wird.

void __fastcall AutoScrollInView(Controls::TControl* AControl);

Beschreibung

Mit AutoScrollInView wird ein Steuerelement in den sichtbaren Bereich des fensterorientierten Steuerelements verschoben.

Der Parameter AControl ist ein TControl-Objekt, welches das Steuerelement kapselt, das sichtbar gemacht werden soll.

Im Gegensatz zu ScrollInView bewirkt AutoScrollInView keinen Bildlauf, wenn die Eigenschaft ComponentState des mit AControl bezeichneten Objekts oder des fensterorientierten Steuerelements den Wert csLoading hat.

AutoScrollInView ruft für den eigentlichen Bildlaufvorgang die Methode ScrollInView auf.


TScrollingWinControl::ChangeScale

TScrollingWinControl	Siehe auch

Die Methode ChangeScale verändert die Größe des fensterorientierten Steuerelements in einem bestimmten Verhältnis.

virtual void __fastcall ChangeScale(int M, int D);

Beschreibung

Mit ChangeScale kann das fensterorientierte Steuerelement vergrößert oder verkleinert werden.

Die Größenänderung wird dabei durch den Wert eines Bruchs festgelegt. Der Parameter M ist der Zähler, und D ist der Nenner. Wenn das Fenster beispielsweise auf das 0,8fache (4/5) seiner gegenwärtigen Größe verkleinert werden soll, setzen Sie M auf 4 und D auf 5.

ChangeScale berechnet die neuen Bereichsgrenzen für die Bildlaufleisten und ruft dann TControl.ChangeScale auf.


TScrollingWinControl::CreateWnd

TScrollingWinControl	Siehe auch

Die Methode CreateWnd erzeugt ein Windows-Steuerelement, das dem TScrollingWinControl-Objekt entspricht.

virtual void __fastcall CreateWnd(void);

Beschreibung

Mit CreateWnd wird ein Windows-Steuerelement erzeugt, das dem ScrollingWinControl-Objekt entspricht.

CreateWnd initialisiert die Bildlaufleisten des fensterorientierten Steuerelements und ruft dann TWinControl.CreateWnd auf.


TScrollingWinControl::ScrollInView

TScrollingWinControl	Siehe auch

Die Methode ScrollInView verschiebt ein Steuerelement in den sichtbaren Bereich des umgebenden fensterorientierten Steuerelements.

void __fastcall ScrollInView(Controls::TControl* AControl);

Beschreibung

Mit ScrollInView wird ein Steuerelement durch einen Bildlauf sichtbar gemacht.

Der Parameter AControl ist ein TControl-Objekt, in dem das Steuerelement gekapselt ist, das sichtbar gemacht werden soll.

Hinweis

Wenn die Eigenschaft ComponentState des mit AControl bezeichneten Objekts oder des fensterorientierten Steuerelements den Wert csLoading hat, verwenden Sie die Methode AutoScrollInView.


TScrollingWinControl::TScrollingWinControl

TScrollingWinControl	Siehe auch

Die Methode TScrollingWinControl erzeugt und initialisiert ein neues TScrollingWinControl-Objekt.

__fastcall virtual TScrollingWinControl(Classes::TComponent* AOwner);

Beschreibung

Mit TScrollingWinControl wird ein neues TScrollingWinControl-Objekt erzeugt und initialisiert.

Der Parameter AOwner bezeichnet ein TComponent-Objekt, das den Eigentümer des bildlauffähigen fensterorientierten Steuerelements bezeichnet.

TScrollingWinControl führt die folgenden Operationen aus:

•	Mit TWinControl::TWinControl wird das TScrollingWinControl-Objekt erzeugt und in den Eigentümer eingefügt.

•	Es werden horizontale und vertikale Bildlaufleisten erzeugt und den Eigenschaften HorzScrollBar bzw. VertScrollBar zugewiesen.

•	AutoScroll wird auf True gesetzt.


Gültigkeitsbereich

Protected

Published

Zugriff

Read-only


Gültigkeitsbereich

Protected


Hierarchie

TObject

TPersistent

TComponent

TControl

TWinControl


TScrollingWinControl Beispiel

TScrollingWinControl


TSessionList

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/dbtables.hpp

TSessionList verwaltet die BDE-Sitzungen einer Datenbankanwendung.

Beschreibung

Mit TSessionList können Sie die Sitzungskomponenten in Anwendungen verwalten, in denen mit mehreren Sitzungen gearbeitet wird. Borland C++Builder erzeugt für alle Datenbankanwendungen automatisch die globale Sitzungsliste Sessions. Auch in Anwendungen mit mehreren Sitzungen kann es immer nur eine aktuelle Sitzung geben. Mit TSessionList kann eine Anwendung die aktuelle Sitzung wechseln.

Hinweis

Anwendungen sollten keine zusätzlichen Sitzungslisten instantiieren.


Eigenschaften von TSessionList

TSessionList	Alphabetisch	Legende

In TSessionList

Count

CurrentSession

List

Sessions


Eigenschaften von TSessionList

TSessionList	Nach Objekten	Legende

Count

CurrentSession

List

Sessions


TSessionList::Count

TSessionList	Siehe auch

Die Eigenschaft Count gibt die Anzahl der für die Anwendung verfügbaren Sitzungen an.

__property int Count;

Beschreibung

Mit einem Lesezugriff auf Count können Sie die aktuelle Anzahl der verfügbaren Sitzungen ermitteln. Mit Hilfe dieser Eigenschaft wird normalerweise die Liste der verfügbaren Sitzungen durchlaufen, um für alle Sitzungen bestimmte Aktionen durchzuführen. Für die Eigenschaft Sessions, mit der Sie über einen Index auf eine Sitzung zugreifen können, gibt Count die maximale Anzahl der Indexeinträge an (Count - 1).


TSessionList::CurrentSession

TSessionList	Siehe auch

Die Eigenschaft CurrentSession gibt einen Zeiger auf die aktuelle Sitzung zurück.

__property TSession* CurrentSession;

Beschreibung

Mit CurrentSession können Sie ermitteln oder festlegen, welche Sitzung in einer Datenbankanwendung die aktuelle Sitzung ist. Standardmäßig zeigt diese Eigenschaft auf die Standardsitzung Session, die von Borland C++Builder für alle Datenbankanwendungen automatisch erstellt wird. Indem Sie CurrentSession eine Sitzung zuweisen, wird diese zur aktuellen Sitzung. Es können zwar mehrere Sitzungen gleichzeitig aktiv, aber immer nur eine Sitzung aktuell sein.


TSessionList::List

TSessionList	Siehe auch

Die Eigenschaft List gibt eine bestimmte Sitzungskomponente zurück.

void __fastcall GetSessionNames(Classes::TStrings* List);

Beschreibung

List gibt einen Zeiger auf eine bestimmte Sitzungskomponente zurück, die von der Sitzungsliste verwaltet wird. Die aktuelle Sitzung wird dadurch nicht geändert. Der Parameter SessionName gibt die zu ermittelnde Sitzungskomponente an. Diese muß mit der Eigenschaft SessionName einer existierenden Sitzungskomponente übereinstimmen. Existiert die Sitzung nicht, löst List eine EDatabaseError-Exception mit einer Meldung aus, die den ungültigen Sitzungsnamen angibt.

Hinweis

Um die Exception zu verhindern, verwenden Sie statt der Eigenschaft List die Methode FindSession.


TSessionList::Sessions

TSessionList	Siehe auch

Die Eigenschaft Sessions enthält ein indiziertes Array mit allen aktiven Sitzungen einer Sitzungsliste.

__property TSession* Sessions[int Index];

Beschreibung

Mit Sessions können Sie auf die verfügbaren Sitzungskomponenten zugreifen. Index gibt die Sitzung an, auf die zugegriffen werden soll. Der Index muß zwischen 0 und Count - 1 liegen. Andernfalls wird eine EListError-Exception erzeugt, die eine Bereichsüberschreitung anzeigt.

Sie können in einer Anwendung beispielsweise die verfügbaren Sitzungen der Liste durchlaufen, um mit allen eine bestimmte Aktion durchzuführen. Der folgende Code setzt die Eigenschaft KeepConnections aller Sitzungen auf False:

for (int index = 0; index < Sessions.Count - 1; index++)

Sessions[index]->KeepConnections = false;


Methoden von TSessionList

TSessionList	Alphabetisch

In TSessionList

~TSessionList

FindSession

GetSessionNames

OpenSession

TSessionList

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TSessionList

TSessionList	Nach Objekten

~TSessionList

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

FindSession

FreeInstance

Free

GetSessionNames

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance

OpenSession

TSessionList


TSessionList::~TSessionList

TSessionList	Siehe auch

Der Destruktor ~TSessionList gibt den Speicher frei, der für das TSessionList-Objekt reserviert war. Rufen Sie ~TSessionList nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TSessionList automatisch aufgerufen wird.

__fastcall virtual ~TSessionList(void);

Beschreibung

~TSessionList schließt alle Sitzungskomponenten, löscht die BDE-Sitzung und ruft dann den Destruktor des übergeordneten Objekts auf.


TSessionList::FindSession

TSessionList	Siehe auch

Die Methode FindSession durchsucht die Sitzungsliste nach einer bestimmten Sitzung.

TSession* __fastcall FindSession(const System::AnsiString SessionName);

Beschreibung

Mit FindSession können Sie ermitteln, ob die im Parameter SessionName übergebene Sitzung existiert.

FindSession vergleicht den Parameter SessionName mit der Eigenschaft SessionName aller Sitzungen der Sitzungsliste. Wenn FindSession eine Übereinstimmung findet, wird ein Zeiger auf die Sitzungskomponente zurückgegeben. Wird in SessionName ein leerer String übergeben, gibt FindSession die Standardsitzung Session zurück. Wenn keine Übereinstimmung gefunden wird, wird NULL zurückgegeben.


TSessionList::GetSessionNames

TSessionList	Siehe auch

Die Methode GetSessionNames füllt eine String-Liste mit den Namen aller verfügbaren Sitzungen.

void __fastcall GetSessionNames(Classes::TStrings* List);

Die Methode GetSessionNames füllt eine von Ihnen erzeugte String-Liste mit den Namen (Eigenschaft SessionName) aller verfügbaren Sitzungen.

Beschreibung

Mit GetSessionName können Sie eine Liste aller verfügbaren Sitzungen erzeugen. Der Parameter List ist eine String-Liste, die von der Anwendung erzeugt und verwaltet wird und in der die Sitzungsnamen gespeichert werden. Die von GetSessionNames zurückgegebenen Namen entsprechen der Eigenschaft SessionName aller verfügbaren Sitzungen.


TSessionList::OpenSession

TSessionList	Siehe auch

Die Methode OpenSession aktiviert eine bestehende Sitzung oder erzeugt und aktiviert eine neue Sitzung.

TSession* __fastcall OpenSession(const System::AnsiString SessionName);

Beschreibung

Mit OpenSession können Sie eine bestehende Sitzung aktivieren oder eine neue Sitzung erzeugen und aktivieren. Der Parameter SessionName bezeichnet den Namen der zu öffnenden Sitzung.

OpenSession ruft FindSession auf, um zu prüfen, ob die im Parameter SessionName übergebene Sitzung bereits existiert. In diesem Fall wird die Sitzung geöffnet und aktiviert. Wenn OpenSession diese Sitzung nicht findet, wird sie unter dem angegebenen Namen neu erzeugt, geöffnet und aktiviert.

In beiden Fällen gibt die Methode das Sitzungsobjekt zurück.


TSessionList::TSessionList

TSessionList	Siehe auch

Die Methode TSessionList erzeugt eine Instanz einer TSessionList-Komponente.

__fastcall TSessionList(void);

Beschreibung

Erzeugen Sie keine Instanzen von TSessionList. Für alle Datenbankanwendungen wird automatisch die Sitzungsliste Sessions erzeugt. Weitere Sitzungslisten sind nicht erforderlich.

TSessionList ruft den Konstruktor des übergeordneten Objekts auf, erzeugt eine leere Liste zur Erfassung der Sitzungskomponenten und erzeugt und initialisiert eine BDE-Sitzung.


Zugriff

Read-only


Hierarchie

TObject


TSessionList Beispiel

TSessionList


 TSession

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/db.hpp

Mit TSession können Sie Datenbankverbindungen in einer Anwendung verwalten.

Beschreibung

Mit TSession können Sie eine Gruppe von Datenbankverbindungen in einer Anwendung verwalten. Es gibt drei Verwendungsarten für TSession: Standard, mehrere Netzwerksteuerdateien für Paradox und Multithread-Datenbankanwendungen.

In Borland C++Builder wird automatisch die allgemein zugängliche TSession-Standardkomponente Session für alle Datenbankanwendungen erstellt. Mit Hilfe der Standardkomponente werden die Standard-Datenbankverbindungen verarbeitet. In einer Anwendung kann die Standardsitzung gesteuert werden, indem zur Laufzeit auf ihre Eigenschaften, Ereignisse und Methoden zugegriffen wird.

In Datenbankanwendungen, die gleichzeitig auf Paradox-Tabellen an verschiedenen Netzwerkstandorten zugreifen müssen, kann für jeden Netzwerkstandort eine Sitzung eingerichtet werden.

Schließlich werden Datenbankanwendungen, in denen mehrere Verbindungen zu einer Datenbank eingerichtet werden müssen (z.B. zwei Abfragen für die gleichen Tabellen), als Multithread-Anwendungen bezeichnet. In Multithread-Anwendungen muß für jede simultane Verbindung zu einem einzelnen Datenbank-Server eine zusätzliche Sitzung erstellt werden.

Hinweis

Mehrere Sitzungen können in Anwendungen über die TSessionList-Komponente verwaltet werden. Für alle Datenbankanwendungen wird automatisch eine Standard-Sitzungsliste namens Sessions erstellt. Beachten Sie den Plural, der diese Komponente von der Standardsitzung (Session) unterscheidet.


Eigenschaften von TSession

TSession	Alphabetisch	Legende

In TSession

Active

ConfigMode

DatabaseCount

Databases

Handle

KeepConnections

Locale

NetFileDir

PrivateDir

SessionName

TraceFlags

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Name

Owner

Tag


Eigenschaften von TSession

TSession	Nach Objekten	Legende

Active

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ConfigMode

DatabaseCount

Databases

DesignInfo

Handle

KeepConnections

Locale

Name

NetFileDir

Owner

PrivateDir

SessionName

Tag

TraceFlags


TSession::Active

TSession	Siehe auch

Die Eigenschaft Active gibt an, ob eine Sitzung aktiv ist.

__property bool Active;

Beschreibung

Mit der Eigenschaft Active können Sie zur Laufzeit bestimmen, ob die Standardsitzung Session aktiv ist. Active hat standardmäßig den Wert False. Dies bedeutet, daß keine der Sitzung zugeordneten Datenbankverbindungen oder Datenmengen geöffnet sind. Ist Active auf True eingestellt, ist eine oder sind mehrere Datenbankverbindungen und möglicherweise auch Datenmengen geöffnet.

Stellen Sie die Eigenschaft Active zusätzlicher Sitzungen einer Datenbankanwendung während des Entwurfs oder zur Laufzeit ein. Durch Einstellen von Active auf True wird die Sitzung gestartet, und die Sitzung wird zur aktuellen Sitzung. Durch Einstellen von Active auf True wird für die Sitzung die Ereignisbehandlungsroutine für OnStartup gestartet, und die Eigenschaften NetFileDir, PrivateDir und ConfigMode werden initialisiert.

Durch Einstellen von Active auf False (Vorgabe) werden alle geöffneten Datenmengen geschlossen, und die Anwendung wird von den zugehörigen Datenbank-Servern getrennt.

Hinweis

In einer Anwendung kann die Standardsitzung geschlossen werden, indem Active auf False gesetzt wird. Dies wird jedoch nicht empfohlen.


TSession::ConfigMode

TSession	Siehe auch

Die Eigenschaft ConfigMode legt fest, wie die Aliase der Sitzung von der Borland Database Engine (BDE) verwendet werden sollen.

__property TConfigMode ConfigMode;

Beschreibung

Mit ConfigMode können Sie festlegen, wie die Aliase von der BDE behandelt werden sollen, die im Kontext einer Sitzung mit den Methoden AddAlias oder AddStandardAlias erstellt wurden. Mit ConfigMode können Sie auch bestimmen, welche BDE-Aliase einer Sitzung mitgeteilt werden, wenn in einer Anwendung die Methode GetAliasNames aufgerufen wird.

Die Standardeinstellung von ConfigMode ist cmAll. Dies bedeutet, daß die Aliase der BDE-Konfigurationsdatei, des BDE-Speichers und die zur Sitzung gehörenden Aliase in dieser Sitzung verfügbar sind. In der folgenden Tabelle werden die möglichen BDE-Konfigurationsmodi zusammengefaßt, die für Aliase verwendet werden können:

Modus	Beschreibung

cmAll	Alle Aliase der BDE-Konfigurationsdatei, des BDE-Speichers und die zur Sitzung gehörenden Aliase sind in dieser Sitzung verfügbar.

cmPersistent	Nur die Aliase der BDE-Konfigurationsdatei und des BDE-Speichers sind verfügbar.

cmSession	Es sind nur die Aliase verfügbar, die in dieser Sitzung erstellt wurden.

Hauptsächlich können Sie mit ConfigMode in einer Anwendung Aliase auf Sitzungsebene festlegen und filtern.

Hinweis

Die in einer Sitzung erstellten Aliase werden nicht automatisch in der BDE-Konfigurationsdatei gespeichert. Mit der Methode SaveConfigFile können Sie einen Alias in der Konfigurationsdatei speichern.


TSession::DatabaseCount

TSession	Siehe auch

Die Eigenschaft DatabaseCount gibt die Anzahl der aktiven Datenbank-Komponenten an, die der Sitzung aktuell zugeordnet sind.

__property int DatabaseCount;

Beschreibung

Mit DatabaseCount können Sie die Anzahl der aktiven Datenbank-Komponenten bestimmen, die einer Sitzung zugeordnet sind. Da Datenbankverbindungen während der Lebensdauer einer Sitzung geöffnet oder geschlossen werden, ist diese Zahl variabel. Hat DatabaseCount den Wert Null, enthält die Sitzung im Augenblick keine aktiven Datenbank-Komponenten.

DatabaseCount wird zusammen mit der Eigenschaft Databases verwendet, um über die aktiven Datenbanken einer Sitzung zu iterieren. Mit dem folgenden Programm können Sie beispielsweise die Eigenschaft KeepConnection jeder aktiven Datenbank der Standardsitzung auf True setzen:

if (Session.DataBaseCount > 0)

for (int MaxDbCount = 1; MaxDbCount <= Session.DatabaseCount; MaxDbCount++)

Databases[MaxDbCount]->KeepConnection = true;


TSession::Databases

TSession	Siehe auch

Die Eigenschaft Databases enthält ein indiziertes Array mit den Namen aller aktiven Datenbanken einer Sitzung.

__property TDatabase* Databases[int Index];

Beschreibung

Mit Databases können Sie auf die aktiven Datenbank-Komponenten zugreifen, die einer Sitzung zugeordnet sind. Eine Datenbank ist aktiv, wenn Sie mit einem Datenbank-Server verbunden ist.

Databases wird zusammen mit der Eigenschaft DatabaseCount verwendet, um über die aktiven Datenbanken einer Sitzung zu iterieren. Mit dem folgenden Programm können Sie beispielsweise die Eigenschaft KeepConnection jeder aktiven Datenbank der Standardsitzung auf True setzen:

if (Session.DataBaseCount > 0)

for (int MaxDbCount = 1; MaxDbCount <= Session.DatabaseCount; MaxDbCount++)

Databases[MaxDbCount]->KeepConnection = true;


TSession::Handle

TSession	Siehe auch	Beispiel

Mit der Eigenschaft Handle können Sie das BDE-Handle für die Sitzung festlegen.

__property Bde::hDBISes Handle;

Beschreibung

Verwenden Sie Handle nur, um die Methoden der Klasse TSession zu umgehen und direkt auf die BDE-API zuzugreifen. Für viele BDE-Funktionen ist der Parameter Handle erforderlich. Der Eigenschaft Handle wird ein Anfangswert zugeordnet, sobald eine Sitzung aktiviert wird.

Hinweis

Verwenden Sie diese Eigenschaft nur, wenn in einer Anwendung BDE-Funktionen benötigt werden, die über die Standard- Borland C++Builder-Komponenten nicht verfügbar sind.


TSession::KeepConnections

TSession	Siehe auch

Mit der Eigenschaft KeepConnections können Sie festlegen, ob eine in einer Sitzung erstellte temporäre Datenbank-Komponente die Verbindung zu einem Datenbank-Server aufrecht erhält, auch wenn der Datenbank-Komponente keine aktiven Datenmengen zugeordnet sind.

__property bool KeepConnections;

Beschreibung

Mit KeepConnections können Sie festlegen, ob zur Laufzeit erstellte, temporäre Datenbank-Komponenten Server-Verbindungen aufrechterhalten, auch wenn sie keine aktiven Datenmengen enthalten. Hat KeepConnections den Wert True (Standardwert), werden die Datenbankverbindungen aufrechterhalten, bis die Anwendung beendet oder die Methode DropConnections aufgerufen wird. Bei Verbindungen zu Remote-Datenbank-Servern oder bei Anwendungen, in denen häufig Datenmengen geöffnet und geschlossen werden, sollte KeepConnections immer den Wert True enthalten. Dadurch wird die Belastung des Netzwerks verringert und die Verarbeitung beschleunigt.

Hat KeepConnections den Wert False, wird eine Anwendung von einer Datenbank getrennt, wenn alle einer Datenbank-Komponente zugeordeten Datenmengen geschlossen werden. Durch das Aufheben einer Verbindung werden die entsprechenden Systemressourcen freigegeben. Wird jedoch später eine Datenmenge neu geöffnet, die dieselbe Datenbank verwendet, muß die Verbindung neu eingerichtet und neu initialisiert werden.

Hinweis

Die Dauer der Verbindung zwischen einer dauerhaften Datenbank-Komponente und einem Datenbank-Server wird von der Eigenschaft KeepConnection der Datenbank-Komponente und nicht von der Eigenschaft KeepConnections der Sitzung bestimmt.


TSession::Locale

TSession	Siehe auch

Mit der Eigenschaft Locale können Sie den Sprachtreiber der Borland Database Engine (BDE) für die Sitzung festlegen.

__property void * Locale;

Beschreibung

Mit der Eigenschaft Locale können Sie den BDE-Sprachtreiber bestimmen, der von der Sitzungskomponente verwendet wird. Werden in Anwendungen BDE-Funktionen direkt aufgerufen, muß die Eigenschaft Locale möglicherweise als Parameter übergeben werden.

Hinweis

Verwenden Sie diese Eigenschaft nur, wenn in einer Anwendung BDE-Funktionen benötigt werden, die über die Standard- Borland C++Builder-Komponenten nicht verfügbar sind.


TSession::NetFileDir

TSession	Siehe auch

Mit der Eigenschaft NetFileDir können Sie das Verzeichnis festlegen, das die Netzwerksteuerdatei PDOXUSRS.NET der Borland Database Engine (BDE) enthält.

__property System::AnsiString NetFileDir;

Beschreibung

Mit NetFileDir können Sie das Verzeichnis festlegen, das die Netzwerksteuerdatei PDOXUSER.NET der BDE enthält. Mit dieser Datei wird die Verwendung von Paradox-Tabellen auf Netzwerklaufwerken verwaltet. In allen Anwendungen, die Paradox-Tabellen in einem Netzwerkverzeichnis gemeinsam benutzen, muß diese Eigenschaft denselben Wert haben, und Sie müssen Rechte zum Lesen, Schreiben und Erstellen für das Verzeichnis besitzen.

Aus der BDE-Konfigurationsdatei für den Paradox-Treiber wird ein Anfangswert für NetFileDir abgeleitet. Wird der Eigenschaft während des Entwurfs oder zur Laufzeit ein Wert zugewiesen, wird die BDE-Konfiguration überschrieben.


TSession::PrivateDir

TSession	Siehe auch

Mit der Eigenschaft PrivateDir können Sie das Verzeichnis festlegen, in dem die temporären Dateien gespeichert werden, die von der Borland Database Engine (BDE) für die einer Sitzung zugeordneten Datenbank-Komponenten erstellt werden.

__property System::AnsiString PrivateDir;

Beschreibung

Mit PrivateDir können Sie das Verzeichnis festlegen, in dem die temporären Dateien aller Datenbankverbindungen gespeichert werden sollen. Dazu gehören beispielsweise die von der BDE erstellten Dateien, mit denen lokale SQL-Anweisungen verarbeitet werden. Enthält PrivateDir keinen Wert, werden die temporären Dateien automatisch im Verzeichnis gespeichert, das bei der Initialisierung der BDE aktuell war.

Hinweis

In einer Anwendung, die direkt von einem Netzwerk-Server ausgeführt wird, können Sie PrivateDir das lokale Laufwerk des Benutzers zuweisen. Damit kann verhindert werden, daß auf dem Server temporäre Dateien erstellt werden, die dort mit temporären Dateien in Konflikt geraten, die von anderen Instanzen der Anwendung erstellt wurden.


TSession::SessionName

TSession	Siehe auch

Mit der Eigenschaft SessionName können Sie einen eindeutigen Sitzungsnamen festlegen, mit dem von Komponenten einer Datenbank oder einer Datenmenge Verbindungen zu dieser Sitzung hergestellt werden können.

__property System::AnsiString SessionName;

Beschreibung

Weisen Sie SessionName einen eindeutigen und sinnvollen Namen zu, mit dessen Hilfe die Komponenten einer Datenbank und einer Datenmenge mit der Sitzung verbunden werden können. Die Komponenten einer Datenbank und einer Datenmenge besitzen die entsprechende Eigenschaft SessionName. Diese Werte müssen entweder mit der Eigenschaft SessionName einer aktiven Sitzung übereinstimmen oder leer sein. In diesem Fall werden die Komponenten der Standardsitzung Session zugeordnet.


TSession::TraceFlags

TSession	Siehe auch

Mit der Eigenschaft TraceFlags können Sie die Datenbankoperationen festlegen, die mit dem SQL-Monitor zur Laufzeit überwacht werden.

__property TTraceFlags TraceFlags;

Beschreibung

Mit TraceFlags können Sie die festlegen, welche Datenbankoperationen einer Anwendung mit dem SQL-Monitor zur Laufzeit verfolgt werden sollen. TraceFlags hat nur für den SQL-Monitor eine Bedeutung, mit dem Sie bei der Arbeit mit Remote-SQL-Datenbank-Servern die Leistungsfähigkeit optimieren und SQL-Anweisungen auf Fehler überprüfen können.

Hinweis

Normalerweise werden die Optionen für die Ablaufverfolgung im SQL-Monitor und nicht über TraceFlags im Quelltext der Anwendung eingestellt.

Der Wert der Eigenschaft TraceFlags einer Sitzungskomponente bestimmt den Anfangswert der Eigenschaft TraceFlags von Komponenten, die der Sitzung zugeordnet wurden.

Im Typ TTraceFlags sind die einzelnen Werte definiert, die in der Eigenschaft TraceFlags eingestellt werden können. In der folgenden Tabelle werden diese Werte erläutert:

Wert	Beschreibung

tfQPrepare	Es werden die Prepare-Anweisungen überwacht.

tfQExecute	Es werden die ExecSQL-Anweisungen überwacht.

tfError	Es werden die Fehlermeldungen des Servers überwacht. Diese Meldungen enthalten möglicherweise einen Fehlercode.

tfStmt	Es werden alle SQL-Anweisungen überwacht.

tfConnect	Es werden die Operationen zur Einrichtung und Aufhebung von Datenbankverbindungen überwacht. Dazu gehört die Zuweisung und die Freigabe von Verbindungs-Handles.

tfTransact	Es werden Anweisungen zu Transaktionen wie StartTransaction, Commit und Rollback überwacht.

tfBlob	Es werden Operationen mit BLOB-Datentypen überwacht.

tfMisc	Es werden alle Anweisungen überwacht, die von den anderen Optionen nicht berücksichtigt werden.

tfVendor	Es werden die direkten API-Funktionsaufrufe an den Datenbank-Server überwacht.

Da TraceFlags eine Menge enthält, können Sie in einer Anwendung verschiedene Kombinationen von Flags angeben. Somit können verschiedene Kombinationen von Anweisungen überwacht werden. Mit der folgenden Anweisung werden beispielsweise nur die Datenbankverbindungen und SQL-Anweisungen überwacht:

TraceFlags << tfConnect << tfQPrepare;


Ereignisse von TSession

TSession	Alphabetisch	Legende

In TSession

OnPassword

OnStartup


Ereignisse von TSession

TSession	Nach Objekten	Legende

OnPassword

OnStartup


TSession::OnPassword

TSession	Siehe auch

Das Ereignis OnPassword wird ausgelöst, wenn in einer Anwendung eine Paradox-Tabelle zum ersten Mal geöffnet wird und von der Borland Database Engine (BDE) unzureichende Zugriffsrechte gemeldet werden.

__property TPasswordEvent OnPassword;

Beschreibung

Mit einer Ereignisbehandlungsroutine für OnPassword können Sie eine bestimmte Aktion durchführen, wenn eine Paradox-Tabelle in einer Anwendung zum ersten Mal geöffnet wird. Um Zugriff auf die Paradox-Tabelle zu erhalten, muß der BDE in der Ereignisbehandlungsroutine ein gültiges Kennwort übergeben werden. In der Ereignisbehandlungsroutine sollte die Methode AddPassword aufgerufen werden, damit das Kennwort für die Sitzung verfügbar wird.

Hinweis

Falls keine Ereignisbehandlungsroutine für OnPassword existiert und von der BDE eine Meldung über unzureichende Zugriffsrechte erzeugt wird, wird in Borland C++Builder ein Standarddialogfeld angezeigt, in dem Sie ein Kennwort eingeben können.


TSession::OnStartup

TSession	Siehe auch

Das Ereignis OnStartup wird ausgelöst, wenn eine Sitzung in einer Anwendung aktiviert wird.

__property Classes::TNotifyEvent OnStartup;

Beschreibung

Mit einer Ereignisbehandlungsroutine für OnStartup können Sie bestimmte Aktionen durchführen, wenn eine Sitzung in einer Anwendung aktiviert wird. Eine Sitzung kann aktiviert werden, indem ihre Eigenschaft Active auf den Wert True gesetzt oder eine der Sitzung zugewiesene Datenbank oder Datenmenge geöffnet wird (bei beiden Vorgängen wird Active auf True gesetzt).


Methoden von TSession

TSession	Alphabetisch

In TSession

~TSession

AddAlias

AddPassword

AddStandardAlias

Close

CloseDatabase

DeleteAlias

DropConnections

FindDatabase

GetAliasDriverName

GetAliasNames

GetAliasParams

GetConfigParams

GetDatabaseNames

GetDriverNames

GetDriverParams

GetPassword

GetStoredProcNames

GetTableNames

IsAlias

ModifyAlias

Open

OpenDatabase

RemoveAllPasswords

RemovePassword

SaveConfigFile

TSession

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TSession

TSession	Nach Objekten

~TSession

AddAlias

AddPassword

AddStandardAlias

Assign

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

CloseDatabase

Close

DefaultHandler

DeleteAlias

DestroyComponents

Destroying

Dispatch

DropConnections

FieldAddress

FindComponent

FindDatabase

FreeInstance

FreeNotification

Free

GetAliasDriverName

GetAliasNames

GetAliasParams

GetConfigParams

GetDatabaseNames

GetDriverNames

GetDriverParams

GetParentComponent

GetPassword

GetStoredProcNames

GetTableNames

HasParent

InheritsFrom

InitInstance

InsertComponent

InstanceSize

IsAlias

MethodAddress

MethodName

ModifyAlias

NewInstance

OpenDatabase

Open

RemoveAllPasswords

RemoveComponent

RemovePassword

SaveConfigFile

TSession


TSession::~TSession

TSession	Siehe auch

Löschen Sie niemals die Standardsitzung. Dies übernimmt C++Builder automatisch, wenn eine Anwendung beendet wird.

__fastcall virtual ~TSession(void);

Beschreibung

~TSession führt die folgenden Aktionen aus, bevor der Destruktor des übergeordneten Objekts aufgerufen wird:

•	Die Sitzung wird deaktiviert. Dadurch werden alle Datenbankverbindungen geschlossen.

•	Die Sitzung wird aus der Sitzungsliste entfernt.

•	Gegebenenfalls werden die Sitzungsreferenzen der Datenbank zurückgesetzt.

•	Die Liste der Datenbank-Komponenten der Sitzung wird freigegeben.

•	Die Liste der Callbacks dieser Sitzung wird freigegeben.


TSession::AddAlias

TSession	Siehe auch

Mit der Methode AddAlias können Sie einen bestimmten Alias der Borland Database Engine (BDE) in die Sitzung eines SQL-Datenbank-Servers einfügen.

void __fastcall AddAlias(const System::AnsiString Name, const System::AnsiString Driver, Classes::TStrings*  List);

Beschreibung

Mit AddAlias können Sie zur Laufzeit einen sitzungsspezifischen BDE-Alias für einen SQL-Datenbank-Server erstellen. Name ist der eindeutige Name, der dem Alias zugewiesen wird. Driver ist der Name des SQL Links-Datenbanktreibers für den Alias. List ist eine Liste von Strings, die die Parameter des Alias enthält.

Mit der Eigenschaft ConfigMode einer Sitzung können Sie bestimmen, ob ein Alias lokal auf die Sitzung begrenzt oder in allen Anwendungen des BDE-Speichers verfügbar ist, solange BDE-Clients aktiv sind. Dieser Zeitraum entspricht der Lebensdauer der Sitzung. Um einen Alias dauerhaft zu speichern, rufen Sie vor dem Ende der Sitzung die Methode SaveConfigFile auf.

Hinweis

Sie können mit AddAlias einen Paradox- oder einen dBASE-Alias erstellen. Mit der Methode AddStandardAlias können Sie diesen Vorgang jedoch einfacher durchführen.

Beispiel

In diesem Beispiel wird ein Alias für einen InterBase-Datenbank-Server erstellt:

TStringList MyList;

try

{

MyList = TStringList.Create();

MyList->Add("SERVER NAME=IB_SERVER:/PATH/DATABASE.GDB");

MyList->Add("USER NAME=MYNAME");

}

catch(...)

{

    Session1->AddAlias("NewIBAlias", "INTRBASE", MyList);

}

delete MyList;


TSession::AddPassword

TSession	Siehe auch

Mit der Methode AddPassword können Sie ein Kennwort in die aktuelle Sitzung einfügen, um auf verschlüsselte Paradox-Tabellen zuzugreifen.

void __fastcall AddPassword(const System::AnsiString Password);

Beschreibung

Mit der Methode AddPassword können Sie ein Kennwort für eine Sitzung bereitstellen, bevor Sie eine verschlüsselte Paradox-Tabelle öffnen, für die ein Kennwort erforderlich ist. Wird in einer Anwendung eine Paradox-Tabelle geöffnet, auf die nur mit Hilfe eines Kennworts zugegriffen werden kann, wurde der Tabelle in der Sitzung kein Kennwort zugeordnet und wird in der Anwendung keine Ereignisbehandlungsroutine für OnPassword bereitgestellt, wird ein Dialogfeld angezeigt. In dieses müssen Sie ein gültiges Kennwort eingeben, bevor Sie auf die Tabelle zugreifen können.

Hinweis

Wird in einer Anwendung eine Ereignisbehandlungsroutine für OnPassword definiert, können Sie darin mit dieser Methode Kennwörter für die Sitzung bereitstellen. Bevor eine Anwendung geschlossen wird, sollten alle mit AddPassword eingerichteten Kennwörter mit RemoveAllPasswords oder RemovePassword gelöscht werden.


TSession::AddStandardAlias

TSession	Siehe auch

Mit der Methode AddStandardAlias können Sie einen Standardalias der Borland Database Engine (BDE) für Paradox-, dBASE oder ASCII-Tabellen in die Sitzung einfügen.

void __fastcall AddStandardAlias(const System::AnsiString Name, const System::AnsiString Path, const System::AnsiString  DefaultDriver);

Beschreibung

Mit AddStandardAlias können Sie zur Laufzeit einen sitzungsspezifischen BDE-Alias für Paradox-, dBASE- oder ASCII-Tabellen erstellen. Name ist der eindeutige Name, der dem Alias zugewiesen wird. Mit Path können Sie das Verzeichnis angeben, in dem sich die Datenbank befindet. DefaultDriver ist der Name des Standard-BDE-Treibers für den Alias. Falls der Parameter angegeben wird, muß er den Wert „Paradox“, „DBASE“ oder „ASCIIDRV“ erhalten. Andernfalls wird er auf „Paradox“ voreingestellt. DefaultDriver wird beim öffnen einer Tabelle verwendet, die keine Erweiterung besitzt und als Tabelle des Typs ttDefault definiert ist.

Mit der Eigenschaft ConfigMode einer Sitzung können Sie bestimmen, ob ein Alias lokal auf die Sitzung begrenzt oder in allen Anwendungen des BDE-Speichers verfügbar ist, solange BDE-Clients aktiv sind. Dieser Zeitraum entspricht der Lebensdauer der Sitzung. Um einen Alias dauerhaft zu speichern, rufen Sie vor dem Ende der Sitzung die Methode SaveConfigFile auf.

Hinweis

Um einen Alias für eine SQL-Datenbank zu erstellen, rufen Sie statt AddStandardAlias die Methode AddAlias auf.


TSession::Close

TSession	Siehe auch

Mit der Methode Close können Sie die Sitzung von allen Datenbanken trennen und die Sitzung schließen.

void __fastcall Close(void);

Beschreibung

Mit Close können Sie eine Sitzung beenden. Die Sitzung wird von allen aktiven Datenbanken getrennt, indem die temporären Datenbank-Komponenten freigegeben werden und die Methode Close der dauerhaften Datenbank-Komponenten aufgerufen wird. Anschließend wird das Sitzungs-Handle von Close auf NULL gesetzt.

Hinweis

Durch Setzen der Eigenschaft Active auf False wird eine Sitzung ebenfalls geschlossen.


TSession::CloseDatabase

TSession	Siehe auch

Mit der Methode CloseDatabase können Sie eine der aktuellen Sitzung zugeordnete Datenbankverbindung schließen.

void __fastcall CloseDatabase(TDatabase* Database);

Beschreibung

Mit CloseDatabase können Sie eine dauerhafte Datenbankverbindung schließen oder eine temporäre Datenbankverbindung schließen und freigeben. In Database können Sie den Namen der Datenbank-Komponente angeben, deren Verbindung geschlossen werden soll.

Mit CloseDatabase wird der Referenzzähler der angegebenen Datenbank-Komponente um Eins verringert. Falls der Zähler den Wert Null hat und die Eigenschaft KeepConnection der Datenbank-Komponente False enthält, wird mit CloseDatabase entweder eine temporäre Datenbank-Komponente freigegeben oder die Verbindung einer dauerhaften Datenbank-Komponente geschlossen.

Hinweis

Wird CloseDatabase auf eine dauerhafte Datenbank-Komponente angewendet, wird die Verbindung nicht geschlossen. Um die Verbindung einer dauerhaften Datenbank-Komponente zu schließen, rufen Sie die Methode Close der Datenbank-Komponente direkt auf.

Temporäre Datenbank-Komponenten werden automatisch geschlossen, wenn die letzte ihr zugeordnete Datenmenge geschlossen wird. Zuvor können Sie jedoch in einer Anwendung das Schließen mit CloseDatabase durchführen. Falls die Eigenschaft KeepConnections der Sitzung auf True (Standardwert) gesetzt wurde, wird die Komponente durch das Schließen einer für eine temporäre Datenbank-Komponente eingerichteten Verbindung nicht freigegeben. Mit DropConnections können Sie die temporäre Datenbank-Komponente freigeben, nachdem deren Verbindungen geschlossen wurden.


TSession::DeleteAlias

TSession	Siehe auch

Mit der Methode DeleteAlias können Sie einen bestimmten Alias der Borland Database Engin (BDE) aus der Sitzung entfernen.

void __fastcall DeleteAlias(const System::AnsiString Name);

Beschreibung

Mit DeleteAlias können Sie einen BDE-Alias aus einer Sitzung entfernen. Nachdem ein Alias entfernt wurde, ist er in der Sitzung nicht mehr verfügbar. Wurde der Alias bei der Erstellung in der BDE-Konfigurationsdatei gespeichert, wird er nicht aus der Datei entfernt. Um einen Alias aus der BDE-Konfigurationsdatei zu entfernen, rufen Sie nach DeleteAlias die Methode SaveConfigFile auf.


TSession::DropConnections

TSession	Siehe auch

Mit der Methode DropConnections können Sie alle inaktiven temporären Datenbank-Komponenten freigeben, die einer Sitzung zugeordnet wurden.

void __fastcall DropConnections(void);

Beschreibung

Mit DropConnections können Sie alle temporären Datenbank-Komponenten freigeben, die gerade nicht aktiv sind. Hat die Eigenschaft KeepConnections der Sitzung den Wert True (Standardwert), werden die zur Laufzeit in der Sitzung nach Bedarf erstellten temporären Datenbank-Komponenten nicht automatisch freigegeben, wenn ihre Datenbankverbindungen geschlossen werden. Mit DropConnections können Sie diese Komponenten in einer Anwendung freigeben, wenn sie nicht mehr benötigt werden.


TSession::FindDatabase

TSession	Siehe auch

Mit der Methode FindDatabase können Sie in einer Sitzung die Liste der Komponenten nach einer angegebenen Datenbank durchsuchen.

TDatabase* __fastcall FindDatabase(const System::AnsiString DatabaseName);

Beschreibung

Mit FindDatabase können Sie bestimmen, ob eine bestimmte Datenbank mit einer Sitzung verknüpft ist. In DatabaseName können Sie den Namen der gesuchten Datenbank-Komponente angeben.

Mit FindDatabase können Sie DatabaseName mit der Eigenschaft DatabaseName jeder Datenbank-Komponente der Sitzungsliste vergleichen. Bei einer Übereinstimmung wird ein Zeiger auf die Datenbank-Komponente zurückgegeben. Andernfalls gibt FindDatabase den Wert NULL zurück.

In einer Anwendung kann mit FindDatabase die Existenz einer Datenbank-Komponente festgestellt werden, bevor eine neue Datenbank-Komponente für die Sitzung erstellt wird.


TSession::GetAliasDriverName

TSession	Siehe auch

Mit der Methode GetAliasDriverName können Sie den Namen des Datenbanktreibers bereitstellen, der von dem angegebenen und der Sitzung zugeordneten Alias der Borland Database Engine (BDE) verwendet wird.

System::AnsiString __fastcall GetAliasDriverName(const System::AnsiString AliasName);

Beschreibung

Mit GetAliasDriverName können Sie den BDE-Datenbanktreiber bestimmen, der von einem bestimmten Alias verwendet wird. AliasName ist der Name des Alias, dessen Treiber ermittelt werden soll.

Bei Aliasen für Paradox- und dBASE-Tabellen wird mit GetAliasDriverName der Wert „STANDARD“ zurückgegeben. Bei ASCII-Tabellen lautet der Rückgabewert „ASCIIDRV“. Bei SQL-Datenbanken hängt der Treibername vom Datenbank-Server ab.


TSession::GetAliasNames

TSession	Siehe auch

Mit der Methode GetAliasNames können Sie die Namen der dauerhaften Aliase der Borland Database Engine (BDE) in eine String-Liste einfügen.

void __fastcall GetAliasNames(Classes::TStrings* List);

Beschreibung

Mit GetAliasNames können Sie eine Liste der dauerhaften BDE-Aliase abrufen. Dazu gehören die Aliase im BDE-Speicher und in der BDE-Konfigurationsdatei. Bei List handelt es sich um eine String-Liste, die von der Anwendung erstellt und verwaltet wird und in der die Aliasnamen gespeichert werden.

Mit der Eigenschaft ConfigMode einer Sitzung können Sie bestimmen, ob ein im Kontext dieser Sitzung erstellter Alias von der Methode GetAliasNames berücksichtigt wird. Hat ConfigMode den Wert cmAll oder cmPersistent, werden die in der Sitzung erstellten Aliase bereitgestellt.


TSession::GetAliasParams

TSession	Siehe auch

Mit der Methode GetAliasParams können Sie die Parameter ermitteln, die einem Alias der Borland Database Engine (BDE) zugeordnet sind.

void __fastcall GetAliasParams(const System::AnsiString AliasName, Classes::TStrings* List);

Beschreibung

Mit GetAliasParams können Sie die BDE-Konfigurationsparameter eines bestimmten Alias abrufen. AliasName ist der Name des Alias, dessen Parameter ermittelt werden sollen. Bei List handelt es sich um eine String-Liste, die von der Anwendung erstellt und verwaltet wird und in der die Parameter gespeichert werden.


TSession::GetConfigParams

TSession	Siehe auch

Mit der Methode GetConfigParams können Sie Informationen über die Konfiguration der Borland Database Engine (BDE) abrufen.

void __fastcall GetConfigParams(const System::AnsiString Path, const System::AnsiString Section, Classes::TStrings*  List);

Beschreibung

Mit GetConfigParams können Sie bestimmte Informationen über die Konfiguration aus der BDE-Konfigurationsdatei abrufen, mit der die Anwendung initialisiert wurde.

Der Parameter Path repräsentiert die interne Knotenstruktur der BDE-Konfigurationsdatei. Sein Anfangswert muß immer das Hauptverzeichnis sein, das durch einen umgekehrten Schrägstrich gekennzeichnet wird. Jeder Knoten muß von anderen Knoten durch einen umgekehrten Schrägstrich getrennt werden. Kein Knoten darf leer sein. Mit Hilfe des Pfades \SYSTEM\FORMATS\TIME können Sie beispielsweise das Zeitformat ermitteln, das in der BDE-Konfigurationsdatei verwendet wird.

Der Parameter Path kann in einer seiner Knotenbezeichnungen einen Platzhalter (%s) enthalten. In diesem Fall muß der fehlende Knoten in Section enthalten sein. Ist dies der Fall, können Sie mit GetConfigParams den Inhalt von Section in Path einfügen, bevor die angeforderten Informationen von der BDE abgerufen werden.

Bei List handelt es sich um eine String-Liste, die von der Anwendung erstellt und verwaltet wird und in der die Konfigurationsdaten gespeichert werden. Hat Path beispielsweise den Wert \DATABASES\%s\DB INFO und ist in Section ein Aliasname enthalten, werden mit GetConfigParams die Parameter des Alias in die String-Liste eingefügt.

Weitere Informationen über die BDE-Konfigurationsdatei finden Sie in der Online-Hilfe zur BDE.


TSession::GetDatabaseNames

TSession	Siehe auch

Mit der Methode GetDatabaseNames können Sie die Namen der dauerhaften Aliase der Borland Database Engine (BDE) und die Namen der in der Sitzung bekannten Datenbank-Komponenten in eine String-Liste einfügen.

void __fastcall GetDatabaseNames(Classes::TStrings* List);

Beschreibung

Mit GetDatabaseNames können Sie eine sortierte Liste der dauerhaften BDE-Aliase und der Namen aller in der Sitzung bekannten Datenbank-Komponenten abrufen. Bei den BDE-Aliasen handelt es sich um die Aliase des BDE-Speichers und der BDE-Konfigurationsdatei. Bei List handelt es sich um eine String-Liste, die von der Anwendung erstellt und verwaltet wird und in der die Datenbank- und Aliasnamen gespeichert werden.


TSession::GetDriverNames

TSession	Siehe auch

Mit der Methode GetDriverNames können Sie die Namen der in der Sitzung verfügbaren Treiber der Borland Database Engine (BDE) in eine String-Liste einfügen.

void __fastcall GetDriverNames(Classes::TStrings* List);

Beschreibung

Mit GetDriverNames können Sie die Namen aller BDE-Treiber abrufen, die in einer Sitzung verwendet werden können. Bei List handelt es sich um eine String-Liste, die von der Anwendung erstellt und verwaltet wird und in der die Treibernamen gespeichert werden.


TSession::GetDriverParams

TSession	Siehe auch

Mit der Methode GetDriverParams können Sie die Parameter eines bestimmten Treibers der Borland Database Engine (BDE) in eine String-Liste einfügen.

void __fastcall GetDriverParams(const System::AnsiString DriverName, Classes::TStrings* List);

Beschreibung

Mit GetDriverParams können Sie eine Liste der Parameter abrufen, die einem bestimmten BDE-Treiber zugeordnet sind. Bei DriverName handelt es sich um den BDE-Treiber, dessen Parameter ermittelt werden sollen. List ist eine String-Liste, die von der Anwendung erstellt und verwaltet wird und in der die Parameter des Treibers gespeichert werden.

Die Anzahl der von GetDriverNames ermittelten Parameter hängt vom angegebenen Treiber ab. Der von Paradox und dBASE verwendete Treiber STANDARD besitzt beispielsweise nur wenige Parameter. Für SQL Links-Treiber werden zusätzliche Parameter zurückgegeben.


TSession::GetPassword

TSession	Siehe auch

Mit der Methode GetPassword können Sie in der Sitzung die Ereignisbehandlungsroutine für OnPassword auslösen oder das Standarddialogfeld für die Kennworteingabe anzeigen.

bool __fastcall GetPassword(void);

Beschreibung

Mit GetPassword können Sie in der Sitzung die Ereignisbehandlungsroutine für OnPassword auslösen und die Kennworteingabe verarbeiten, wenn in einer Anwendung mit kennwortgeschützten Paradox-Dateien gearbeitet wird. Ist für OnPassword keine Ereignisbehandlungsroutine definiert, wird mit GetPassword das Standarddialogfeld für Kennwörter angezeigt.

In einer Anwendung kann der Programmablauf mit Hilfe des Rückgabewertes von GetPassword gesteuert werden. Wird vom Benutzer OK gewählt, gibt GetPassword den Wert True zurück. Bei Abbrechen wird False zurückgegeben.


TSession::GetStoredProcNames

TSession	Siehe auch

Mit der Methode GetStoredProcNames können Sie die Namen aller gespeicherten Prozeduren in eine String-Liste einfügen, die einer angegebenen, mit einem SQL-Datenbank-Server verbundenen Datenbank-Komponente zugeordnet sind.

void __fastcall GetStoredProcNames(const System::AnsiString DatabaseName, Classes::TStrings* List);

Beschreibung

Mit GetStoredProcNames können Sie eine Liste aller gespeicherten Prozeduren einer Datenbank-Komponente abrufen, die mit einem SQL-Datenbank-Server verbunden ist. In DatabaseName können Sie den Namen der Datenbank angeben, zu der die Namen der gespeicherten Prozeduren abgerufen werden sollen. Bei List handelt es sich um eine String-Liste, die von der Anwendung erstellt und verwaltet wird und in die die Namen der gespeicherten Prozeduren eingefügt werden.

Hinweis

GetStoredProcNames löst eine Exception aus, falls die Methode für Paradox- oder dBASE-Datenbanken aufgerufen wird.


TSession::GetTableNames

TSession	Siehe auch

Mit der Methode GetTableNames können Sie die Namen der einer bestimmten Datenbank-Komponente zugeordneten Tabellen in eine String-Liste einfügen.

void __fastcall GetTableNames(const System::AnsiString DatabaseName, const System::AnsiString Pattern, bool Extensions, bool SystemTables, Classes::TStrings* List);

Beschreibung

Mit GetTableNames können Sie eine Liste der Tabellen abrufen, die einer gegebenen Datenbank zugeordnet wurden. In DatabaseName können Sie den Namen der Datenbank angeben, aus der die Namen die Tabellen abgerufen werden sollen.

In Pattern können Sie einen String angeben. Dadurch werden nur die Tabellen zurückgegeben, die mit dem String übereinstimmen. Der Parameter Pattern kann Platzhalter enthalten. Wenn Sie im Parameter Pattern einen Leerstring übergeben, können Sie eine Übereinstimmung mit allen Dateien herbeiführen, die nicht durch andere Kriterien gefiltert werden.

Setzen Sie Extensions für Paradox- und dBASE-Tabellen auf True, damit die Dateinamenerweiterung als Teil des Tabellennamens betrachtet wird. Setzen Sie für SQL-Datenbanken Extensions auf False.

Setzen Sie SystemTables für SQL-Datenbanken auf True. Damit können Sie sowohl die Datentabellen als auch die Systemtabellen ermitteln, die die Struktur der Datenbank beschreiben. Setzen Sie SystemTables für Paradox- und dBASE-Tabellen auf False.

Bei List handelt es sich um eine String-Liste, die von der Anwendung erstellt und verwaltet wird und in die die Tabellennamen eingefügt werden.


TSession::IsAlias

TSession	Siehe auch

Mit der Methode IsAlias können Sie bestimmen, ob es sich bei einem String um einen bestehenden und in der Sitzung bekannten Datenbankalias der Borland Database Engine (BDE) handelt.

bool __fastcall IsAlias(const System::AnsiString Name);

Beschreibung

Mit IsAlias können Sie bestimmen, ob ein String dem Namen eines bestehenden BDE-Alias entspricht, der in der Sitzung verwendet werden kann. Name ist der zu testende String.

Gibt IsAlias den Wert True zurück, ist Name ein gültiger Alias.

Hinweis

Die Aliase, die mit IsAlias abgerufen werden können, hängen von der Eigenschaft ConfigMode der Sitzung ab. Hat ConfigMode den Wert cmAll, sind alle Aliase in der Sitzung verfügbar.


TSession::ModifyAlias

TSession	Siehe auch

Mit der Methode ModifyAlias können Sie Parameter in einen Alias der Borland Database Engine (BDE) einfügen oder seine Parameter ändern.

void __fastcall ModifyAlias( System::AnsiString Name, Classes::TStrings* List);

Beschreibung

Mit ModifyAlias können Sie die Parameter eines bestimmten BDE-Alias ändern. Name ist der Name des zu ändernden Alias. Bei List handelt es sich um eine String-Liste, die bereits die zu erweiternden oder zu ändernden Parameterwerte enthält. Die Liste muß in einer Anwendung erstellt und verwaltet werden.

Weisen Sie vor dem Aufruf von ModifyAlias List die Parameterstrings zu. In der Liste müssen nur die zu ändernden Parameter enthalten sein. Wird mit Modify ein Parameter übergeben, der bereits einen Wert hat, wird der bestehende Parameter durch den neuen ersetzt. Neue Parameter werden in die Parameterliste eingefügt. Enthält die Liste keine Parameter, können mit ModifyAlias keine bestehenden Parameter geändert werden.


TSession::Open

TSession	Siehe auch

Mit der Methode Open können Sie eine Sitzung starten. Die Sitzung wird zur aktuellen Sitzung.

void __fastcall Open(void);

Beschreibung

Mit Open können Sie in einer Datenbankanwendung eine Sitzung starten, bei der es sich nicht um die Standardsitzung handelt. Mit Open können Sie Active auf True setzen, eine Ereignisbehandlungsroutine für OnStartup aufrufen und die Eigenschaften NetFileDir, PrivateDir und ConfigMode initialisieren.


TSession::OpenDatabase

TSession	Siehe auch

Mit der Methode OpenDatabase können Sie eine bestehende Datenbank öffnen oder eine temporäre Datenbank-Komponente erstellen und öffnen.

TDatabase* __fastcall OpenDatabase(const System::AnsiString DatabaseName);

Beschreibung

Mit OpenDatabase können Sie eine Verbindung zu einer Datenbank herstellen, für die bereits eine dauerhafte Datenbank-Komponente erstellt wurde, oder eine temporäre Datenbank-Komponente erstellen und mit einer Datenbank verbinden. In DatabaseName können Sie die zu öffnende Datenbank angeben.

Mit OpenDatabase können Sie die aktuelle Sitzung aktivieren. Anschließend wird mit FindDatabase bestimmt, ob der Parameter DatabaseName der Eigenschaft DatabaseName einer bestehenden Datenbank-Komponente entspricht. Ist dies nicht der Fall, wird eine temporäre Datenbank-Komponente erstellt und ihrer Eigenschaft DatabaseName der Wert des Parameters DatabaseName zugewiesen. Schließlich wird die Methode Open der Datenbank aufgerufen, um sie mit einem Datenbank-Server zu verbinden. Anschließend wird der Datenbankreferenzzähler der Sitzung um Eins erhöht.


TSession::RemoveAllPasswords

TSession	Siehe auch

Mit der Methode RemoveAllPasswords können Sie alle Kennwörter für verschlüsselte Paradox-Tabellen löschen, die in die aktuelle Sitzung eingefügt wurden.

void __fastcall RemoveAllPasswords(void);

Beschreibung

Mit RemoveAllPasswords können Sie alle Kennwörter für Paradox-Tabellen löschen, die für die aktuelle Sitzung bereitgestellt wurden. Eine verschlüsselte Paradox-Tabelle kann anschließend nur geöffnet werden, wenn mit AddPassword ein neues Kennwort eingerichtet wird.

Hinweis

Normalerweise sollten in einer Anwendung mit RemoveAllPasswords alle sitzungsspezifischen Kennwörter aus dem BDE-Speicher gelöscht werden, bevor die Anwendung beendet wird.


TSession::RemovePassword

TSession	Siehe auch

Mit der Methode RemovePasswords können Sie einzelne Kennwörter für verschlüsselte Paradox-Tabellen löschen, die in die aktuelle Sitzung eingefügt wurden.

void __fastcall RemovePassword(const System::AnsiString Password);

Beschreibung

Mit RemovePassword können Sie ein einzelnes, der aktuellen Sitzung zugeordnetes Kennwort für eine Paradox-Tabelle aus dem BDE-Speicher löschen. Die verschlüsselte Paradox-Tabelle kann anschließend nur geöffnet werden, wenn mit AddPassword ein neues Kennwort angegeben wird.


TSession::SaveConfigFile

TSession	Siehe auch

Mit der Methode SaveConfigFile können Sie die aktuellen Informationen im BDE-Speicher aus dem Arbeitsspeicher in die BDE-Konfigurationsdatei auf der Festplatte übertragen.

void __fastcall SaveConfigFile(void);

Beschreibung

Mit SaveConfigFile können Sie alle im Arbeitsspeicher befindlichen Änderungen der BDE-Konfiguration in die Konfigurationsdatei auf der Festplatte schreiben. Wenn die BDE zum ersten Mal initialisiert wird, wird die aktuelle BDE-Konfigurationsdatei in den BDE-Speicher im Arbeitsspeicher eingelesen. In Anwendungen kann die im Arbeitsspeicher befindliche Konfigurationsdatei gelesen oder geändert werden. Die Änderung wird zunächst jedoch nur im Speicher durchgeführt und nicht auf die Festplatte geschrieben.

Wird beispielsweise in einer Anwendung mit AddAlias ein neuer BDE-Alias definiert, befindet sich dieser im Speicher, solange die BDE im Speicher vorhanden ist. Mit SaveConfigFile können Sie den neuen Alias speichern, um ihn später in BDE-Anwendungen verwenden zu können. Mit SaveConfigFile wird die Konfigurationsdatei auf der Festplatte mit der Konfigurationsdatei im Speicher überschrieben.

Hinweis

Hat die Eigenschaft ConfigMode einer Sitzung den Wert cmSession, kann ein eingefügter Alias nicht in der BDE-Konfigurationsdatei gespeichert werden.


TSession::TSession

TSession	Siehe auch

Mit der Methode TSession können Sie eine Komponente der Klasse TSession erstellen.

__fastcall virtual TSession(Classes::TComponent* AOwner);

constructor Create(AOwner: TComponent);

Beschreibung

Rufen Sie TSession nicht direkt auf. Die Standard-Sitzungskomponente Session wird für alle Datenbankanwendungen automatisch erstellt. Um während der Laufzeit zusätzliche Sitzungen für eine Multithread-Datenbankanwendung zu erstellen, rufen Sie statt TSession die Methode OpenSession auf. TSession wird von OpenSession nur aufgerufen, wenn die Sitzung noch nicht existiert. (Während des Entwurfs können Sie zusätzliche Sitzungen erstellen, indem Sie sie auf ein Datenmodul ziehen und dort ablegen.)

TSession ruft den geerbten Konstruktor auf. Es wird sichergestellt, daß die Sitzungskomponente nicht geerbt werden kann, falls das Datenmodul oder das Formular, in dem sie sich befindet, in der Objektablage gespeichert werden soll. Mit TSession werden auch folgende Aktionen durchgeführt:

•	Eine leere Liste mit Datenbank-Komponenten für die Sitzung wird erstellt.

•	Eine leere Liste mit den Callbacks für die Sitzung wird erstellt.

•	Die Eigenschaft KeepConnection wird auf True gesetzt.

•	Die Sitzung wird in die Sitzungsliste eingefügt.

•	Die Eigenschaft Handle wird auf NULL gesetzt.


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent


TSession Beispiel

TSession


 TShape

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/extctrls.hpp

Die Komponente TShape dient dazu, in einem Formular eine geometrische Figur darzustellen.

Beschreibung

Mit Hilfe eines TShape-Objekts lassen sich einfache geometrische Figuren in ein Formular einfügen. TShape führt Eigenschaften ein, welche die Gestaltung des Umrisses sowie der Füllung beschreiben.

Wenn die Figur nur einen Teil des Bildes eines TCustomControl-Objekts darstellt, verwenden Sie die Methoden der Zeichenfläche des Steuerelements.


Eigenschaften von TShape

TShape	Alphabetisch	Legende

In TShape

Brush

Pen

Shape

Abgeleitet von TControl

Align

BoundsRect

ClientHeight

ClientOrigin

ClientRect

ClientWidth

ControlState

ControlStyle

Cursor

DragCursor

DragMode

Enabled

Height

Hint

Left

Name

Parent

ParentShowHint

ShowHint

Top

Visible

Width

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TShape

TShape	Nach Objekten	Legende

Align

BoundsRect

Brush

ClientHeight

ClientOrigin

ClientRect

ClientWidth

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlState

ControlStyle

Cursor

DesignInfo

DragCursor

DragMode

Enabled

Height

Hint

Left

Name

Owner

ParentShowHint

Parent

Pen

Shape

ShowHint

Tag

Top

Visible

Width


TShape::Brush

TShape	Siehe auch 	Beispiel

Mit der Eigenschaft Brush wird die Farbe und das Muster festgelegt, mit dem eine geometrische Figur gefüllt werden soll.

__property Graphics::TBrush* Brush;

Beschreibung

Mit einem Lesezugriff auf Brush kann das TBrush-Objekt ermittelt werden, das Farbe und Muster der Füllung repräsentiert. Über die Eigenschaften können Farbe und Muster geändert werden.


TShape::Pen

TShape	Siehe auch

Mit der Eigenschaft Pen wird der Stifttyp für den Umriß einer geometrischen Figur festgelegt.

__property Graphics::TPen* Pen;

Beschreibung

Mit einem Lesezugriff auf Pen kann das TPen-Objekt ermittelt werden, daß Farbe und Stil der Umrißlinie repräsentiert. Über die Eigenschaften von Pen können Farbe und Stil geändert werden.

Sie können die Eigenschaft Pen so setzen, daß ein anderes TPen-Objekt dem zugeordnet wird, das von TShape verwaltet wird.


TShape::Shape

TShape	Siehe auch

Die Eigenschaft Shape beschreibt die Form einer geometrischen Figur.

__property TShapeType Shape;

Beschreibung

Für Shape sind die folgenden Werte möglich:

Wert	Bedeutung

stCircle	Kreis

stEllipse	Ellipse

stRectangle	Rechteck

stRoundRect	Rechteck mit abgerundeten Ecken

stRoundSquare	Quadrat mit abgerundeten Ecken

stSquare	Quadrat


Ereignisse von TShape

TShape	Alphabetisch	Legende

Abgeleitet von TControl

OnDragDrop

OnDragOver

OnEndDrag

OnMouseDown

OnMouseMove

OnMouseUp

OnStartDrag


Ereignisse von TShape

TShape	Nach Objekten	Legende

OnDragDrop

OnDragOver

OnEndDrag

OnMouseDown

OnMouseMove

OnMouseUp

OnStartDrag


Methoden von TShape

TShape	Alphabetisch	Legende

In TShape

~TShape

Paint

TShape

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

GetTextLen

Hide

Invalidate

Perform

Refresh

Repaint

ScreenToClient

SendToBack

SetBounds

SetTextBuf

Show

Update

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TShape

TShape	Nach Objekten	Legende

~TShape

Assign

BeginDrag

BringToFront

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

ClientToScreen

DefaultHandler

DestroyComponents

Destroying

Dispatch

DragDrop

Dragging

EndDrag

FieldAddress

FindComponent

FreeInstance

FreeNotification

Free

GetParentComponent

GetTextBuf

GetTextLen

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InstanceSize

Invalidate

MethodAddress

MethodName

NewInstance

Paint

Perform

Refresh

RemoveComponent

Repaint

ScreenToClient

SendToBack

SetBounds

SetTextBuf

Show

TShape

Update


TShape::~TShape

TShape	Siehe auch

Der Destruktor ~TShape gibt den Speicher frei, der für das TShape-Objekt reserviert war. Rufen Sie ~TShape nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TShape automatisch aufgerufen wird.

__fastcall virtual ~TShape(void);


TShape::Paint

TShape	Siehe auch

Die Methode Paint stellt die geometrische Figur im Formular dar.

virtual void __fastcall Paint(void);

Beschreibung

Paint wird automatisch aufgerufen, sobald das Steuerelement eine Botschaft WM_Paint empfängt. Das zugehörige Bild wird dann auf der Zeichenfläche dargestellt.


TShape::TShape

TShape	Siehe auch

Der Konstruktor TShape erzeugt ein neues TShape-Objekt.

__fastcall virtual TShape(Classes::TComponent* AOwner);

Beschreibung

Mit TShape instantiieren Sie zur Laufzeit ein TShape-Objekt. Alle geometrischen Figuren, die während des Entwurfs in das Formular eingefügt wurden, werden zur Laufzeit automatisch erzeugt.

TShape reserviert Speicher und setzt die Eigenschaften Height und Width auf den Vorgabewert 65.


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Protected


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TControl

TGraphicControl


TShape Beispiel

TShape


TSimpleFrameSite

Hierarchie	Methoden

Header

vcl/olectrls.hpp

TSimpleFrameSite ist ein Objekt, das die ISimpleFrameSite-Schnittstelle kapselt.

Beschreibung

Verwenden Sie TSimpleFrameSite, wenn Sie mit Steuerelementen arbeiten, die die ISimpleFrameSite-Schnittstelle unterstützen.

Weitere Informationen über diese Schnittstelle finden Sie in den WWW-Seiten von Microsoft unter http://www.microsoft.com oder auf der neuesten Microsoft Developer Network-CD.


Methoden von TSimpleFrameSite

TSimpleFrameSite	Alphabetisch

In TSimpleFrameSite

~TSimpleFrameSite

AddRef

PostMessageFilter

PreMessageFilter

QueryInterface

Release

TSimpleFrameSite

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TSimpleFrameSite

TSimpleFrameSite	Nach Objekten

~TSimpleFrameSite

AddRef

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance

PostMessageFilter

PreMessageFilter

QueryInterface

Release

TSimpleFrameSite


TSimpleFrameSite::~TSimpleFrameSite

TSimpleFrameSite

Der Destruktor ~TSimpleFrameSite gibt den Speicher frei, der für das TSimpleFrameSite-Objekt reserviert war. Rufen Sie ~TSimpleFrameSite nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TSimpleFrameSite automatisch aufgerufen wird.

__fastcall virtual ~TSimpleFrameSite(void);


TSimpleFrameSite::AddRef

TSimpleFrameSite	Siehe auch

Die Methode AddRef erhöht den Referenzzähler des TSimpleFrameSite-Objekts.

virtual long __stdcall AddRef(void);

Beschreibung

Mit AddRef können Sie den Referenzzähler des TSimpleFrameSite-Objekts hochzählen. Das Objekt wird nur freigegeben, wenn der Referenzzähler Null ist.

AddRef gibt den neuen Stand des Referenzzählers zurück.


TSimpleFrameSite::PostMessageFilter

TSimpleFrameSite	Siehe auch

Mit der Methode PostMessageFilter kann auf Windows-Botschaften reagiert werden, die an das TSimpleFrameSite-Objekt gesendet werden.

virtual long __stdcall PostMessageFilter(HWND wnd, int msg, int wp, int lp, int &res, long Cookie);

Beschreibung

Überschreiben Sie PostMessageFilter, wenn Sie individuell auf Windows-Botschaften reagieren wollen, die an das TSimpleFrameSite-Objekt gesendet werden.

Standardmäßig gibt PostMessageFilter einfach S_OK zurück.


TSimpleFrameSite::PreMessageFilter

TSimpleFrameSite	Siehe auch

Mit der Methode PostMessageFilter können Sie auf Windows-Botschaften reagieren, die an das TSimpleFrameSite-Objekt gesendet werden.

virtual long __stdcall PreMessageFilter(HWND wnd, int msg, int wp, int lp, int &res, long &Cookie);

Beschreibung

Überschreiben Sie PreMessageFilter, wenn Sie individuell auf Windows-Botschaften reagieren wollen, die an das TSimpleFrameSite-Objekt gesendet werden.

Standardmäßig gibt PreMessageFilter einfach S_OK zurück.


TSimpleFrameSite::QueryInterface

TSimpleFrameSite

Die Methode QueryInterface fragt für das TSimpleFrameSite-Objekt eine Schnittstelle ab.

virtual long __stdcall QueryInterface(const GUID &iid, void *obj);

Beschreibung

Mit QueryInterface können Sie für das TSimpleFrameSite-Objekt eine Schnittstelle abfragen.

Der Parameter iid gibt die IID der Schnittstelle an. Eine IID ist eine spezielle GUID-Struktur, die einen Schnittstellenbezeichner enthält. Weitere Informationen finden Sie in der Datei OLE.HLP unter GUID.

Der Parameter obj ist die Variable, in der die Schnittstelle gespeichert wird.

QueryInterface gibt S_OK zurück, wenn das Objekt die Schnittstelle unterstützt, andernfalls S_FALSE.

Weitere Informationen über die Methode QueryInterface finden Sie in der Datei OLE.HLP unter QueryInterface.


TSimpleFrameSite::Release

TSimpleFrameSite	Siehe auch

Die Methode Release erniedrigt den Referenzzähler des TSimpleFrameSite-Objekts.

virtual long __stdcall Release(void);

Beschreibung

Mit Release können Sie den Referenzzähler des TSimpleFrameSite-Objekts herunterzählen. Das Objekt wird freigegeben, wenn der Referenzzähler Null ist.

Release gibt den neuen Stand des Referenzzählers zurück.


TSimpleFrameSite::TSimpleFrameSite

TSimpleFrameSite

TSimpleFrameSite erzeugt eine neue Instanz von TSimpleFrameSite.

__fastcall TSimpleFrameSite(TOleControl* Control);

Beschreibung

Mit TSimpleFrameSite wird eine neue Instanz von TSimpleFrameSite erzeugt.


Hierarchie

TObject

IUnknown

ISimpleFrameSite


TSimpleFrameSite Beispiel

TSimpleFrameSite


TSmallIntField

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/dbtables.hpp

Ein TSmallintField-Objekt repräsentiert ein vorzeichenbehaftetes 16-Bit-Integer-Feld in einer Datenmenge.

Beschreibung

Felder des Typs SmallInt können Werte im Bereich von -32.768 bis 32.767 enthalten, also vorzeichenbehaftete Zahlen mit einer Breite von 16 Bit.

TSmallIntField unterscheidet sich von seinem direkten Vorfahren TIntegerField nur im Datentyp, der repräsentiert wird. Mit Ausnahme des Konstruktors sind alle Eigenschaften, Methoden und Ereignisse mit denen von TIntegerField identisch. Der Funktionsumfang eignet sich für die Verwaltung des Wertes und der Eigenschaften eines numerischen Integer-Feldes in einer Datenbank.


Eigenschaften von TSmallIntField

TSmallIntField	Alphabetisch	Legende

Abgeleitet von TIntegerField

MaxValue

MinValue

Value

Abgeleitet von TNumericField

DisplayFormat

EditFormat

Abgeleitet von TField

Alignment

AsBoolean

AsCurrency

AsDateTime

AsFloat

AsInteger

AsString

AsVariant

AttributeSet

BDECalcField

Calculated

CanModify

DataSet

DataSize

DataType

DisplayLabel

DisplayName

DisplayText

DisplayWidth

EditMask

EditMaskPtr

FieldKind

FieldName

FieldNo

Index

IsIndexField

IsNull

KeyFields

Lookup

LookupDataSet

LookupKeyFields

LookupResultField

NewValue

OldValue

ReadOnly

Required

Size

Text

Visible

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Name

Owner

Tag


Eigenschaften von TSmallIntField

TSmallIntField	Nach Objekten	Legende

Alignment

AsBoolean

AsCurrency

AsDateTime

AsFloat

AsInteger

AsString

AsVariant

AttributeSet

BDECalcField

Calculated

CanModify

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

DataSet

DataSize

DataType

DesignInfo

DisplayFormat

DisplayLabel

DisplayName

DisplayText

DisplayWidth

EditFormat

EditMaskPtr

EditMask

FieldKind

FieldName

FieldNo

Index

IsIndexField

IsNull

KeyFields

LookupDataSet

LookupKeyFields

LookupResultField

Lookup

MaxValue

MinValue

Name

NewValue

OldValue

Owner

ReadOnly

Required

Size

Tag

Text

Value

Visible


Ereignisse von TSmallIntField

TSmallIntField	Alphabetisch	Legende

Abgeleitet von TField

OnChange

OnGetText

OnSetText

OnValidate


Ereignisse von TSmallIntField

TSmallIntField	Nach Objekten	Legende

OnChange

OnGetText

OnSetText

OnValidate


Methoden von TSmallIntField

TSmallIntField	Alphabetisch

Abgeleitet von TSmallintField

~TSmallIntField

TSmallintField

Abgeleitet von TIntegerField

IsValidChar

Abgeleitet von TField

Assign

AssignValue

Clear

FocusControl

GetData

SetData

SetFieldType

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TSmallIntField

TSmallIntField	Nach Objekten

~TSmallIntField

Assign

AssignValue

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

Clear

DefaultHandler

DestroyComponents

Destroying

Dispatch

FieldAddress

FindComponent

FocusControl

FreeInstance

FreeNotification

Free

GetData

GetParentComponent

HasParent

InheritsFrom

InitInstance

InsertComponent

InstanceSize

IsValidChar

MethodAddress

MethodName

NewInstance

RemoveComponent

SetData

SetFieldType

TSmallIntField


TSmallIntField::~TSmallIntField
~TSmallIntField

Der Destruktor ~TSmallIntField gibt den Speicher frei, der für das TSmallIntField-Objekt reserviert war. Rufen Sie ~TSmallIntField nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TSmallIntField automatisch aufgerufen wird.

__fastcall virtual ~TSmallintField(void);


TSmallIntField::TSmallIntField
TSmallIntField

Die Methode TSmallIntField erzeugt eine Instanz eines TSmallintField-Objekts.

__fastcall virtual TSmallintField(Classes::TComponent* AOwner);

Beschreibung

Es ist selten notwendig, TSmallIntField direkt aufzurufen. Die Instantiierung erfolgt für alle SmallInt-Felder in einer Datenmenge automatisch.

Nach dem Aufruf des geerbten Konstruktors nimmt TSmallIntField die folgenden Initialisierungen vor:

•	DataType wird auf ftSmallint gesetzt.

•	MinValue wird auf -32768 gesetzt.

•	MaxValue wird auf 32767 gesetzt.


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TField

TNumericField

TIntegerField


TSmallIntField Beispiel

TSmallIntField


 TSpeedButton

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/buttons.hpp

TSpeedButton ist eine Schaltfläche, die normalerweise mit einer Grafik versehen ist und zur Ausführung von Befehlen oder zum Setzen von Modi dient.

Beschreibung

TSpeedButton führt Eigenschaften ein, mit deren Hilfe grafische Bilder festgelegt werden können, die unterschiedliche Schaltflächen-Modi darstellen (gedrückt, nicht gedrückt, deaktiviert usw.). Weitere Eigenschaften ermöglichen die Verwendung mehrerer Bilder oder die Neuanordnung der Bilder und des Textes auf der Schaltfläche. Mit den Eigenschaften eines Mauspalettenschalters können Sie Schaltflächen auch zu einer Gruppe zusammenfassen. Solche Gruppen werden häufig zusammen mit Tafeln (TPanel) als Werzeugleisten und Werkzeugtafeln verwendet.


Eigenschaften von TSpeedButton

TSpeedButton	Alphabetisch	Legende

In TSpeedButton

AllowAllUp

Down

Glyph

GroupIndex

Layout

Margin

NumGlyphs

Spacing

Abgeleitet von TControl

Align

BoundsRect

Caption

ClientHeight

ClientOrigin

ClientRect

ClientWidth

ControlState

ControlStyle

Cursor

Enabled

Font

Height

Hint

Left

Name

Parent

ParentFont

ParentShowHint

ShowHint

Top

Visible

Width

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TSpeedButton

TSpeedButton	Nach Objekten	Legende

Align

AllowAllUp

BoundsRect

Caption

ClientHeight

ClientOrigin

ClientRect

ClientWidth

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlState

ControlStyle

Cursor

DesignInfo

Down

Enabled

Font

Glyph

GroupIndex

Height

Hint

Layout

Left

Margin

Name

NumGlyphs

Owner

ParentFont

ParentShowHint

Parent

ShowHint

Spacing

Tag

Top

Visible

Width


TSpeedButton::AllowAllUp

TSpeedButton	Siehe auch 	Beispiel

Die Eigenschaft AllowAllUp legt fest, ob alle Mauspalettenschalter der Gruppe, zu der ein Schalter gehört, gleichzeitig den Status nicht gedrückt haben können.

__property bool AllowAllUp;

Beschreibung

AllowAllUp sollte nur bei Mauspalettenschaltern in einer Gruppe verwendet werden (also nur, wenn die Eigenschaft GroupIndex aller Schalter den Wert Null hat). Informationen über das Erstellen einer Gruppe von Mauspalettenschaltern finden Sie bei der Beschreibung der Eigenschaft GroupIndex. Wenn GroupIndex den Wert Null hat, zeigt AllowAllUp keine Wirkung.

Ist AllowAllUp True, können alle Mauspalettenschalter der Gruppe den Status nicht gedrückt haben. Alle Schaltflächen zugleich können dann als nicht gedrückt angezeigt werden.

Wenn AllowAllUp False ist, muß einer der Mauspalettenschalter der Gruppe immer gedrückt sein (Status gedrückt). Das Klicken auf eine gedrückte Schaltfläche führt nicht zu einer Änderung des Status in nicht gedrückt. Die Schaltfläche erhält nur dann den Status nicht gedrückt, wenn der Benutzer auf eine andere Schaltfläche in der Gruppe klickt. In einer solchen Gruppe muß immer eine Schaltfläche gedrückt sein. Setzen Sie die Eigenschaft Down der Schaltfläche, die zu Beginn den Status gedrückt haben soll, auf True.

Die Voreinstellung für AllowAllUp ist False.

Wenn Sie den Wert der Eigenschaft AllowAllUp für eine Schaltfläche in der Gruppe ändern, ändert sich dieser Wert für alle Schaltflächen in der Gruppe.

Sie können mit AllowAllUp für die einzige Bitmap-Schaltfläche (mit einem GroupIndex-Wert höher als 0) einer Gruppe erreichen, daß sie gedrückt werden kann und so lange gedrückt bleibt, bis der Benutzer erneut darauf klickt. Der Status der Schaltfläche wechselt dann zu nicht gedrückt. Mit anderen Worten: Diese Schaltfläche verhält sich wie ein Kontrollfeld. Wenn eine Schaltfläche dieses Verhalten zeigen soll, weisen Sie ihrer Eigenschaft GroupIndex einen Wert größer 0 zu. Dieser Wert muß sich aber von den GroupIndex-Werten aller anderen Mauspalettenschalter unterscheiden. Zusätzlich muß die Eigenschaft AllowAllUp True sein.


TSpeedButton::Down

TSpeedButton	Siehe auch

Die Eigenschaft Down legt fest, ob die Schaltfläche im Status nicht gedrückt oder im Status gedrückt angezeigt wird.

__property bool Down;

Beschreibung

Mauspalettenschalter haben anfänglich den Status nicht gedrückt, weil die Eigenschaft Down per Voreinstellung False ist.

Soll ein Mauspalettenschalter zu Beginn den Status gedrückt haben, setzen Sie die Eigenschaft Down auf True. Wenn Sie beispielsweise eine Tafelkomponente mit mehreren Mauspalettenschaltern als Werkzeugpalette verwenden wollen, können Sie es so einrichten, daß ein Mauspalettenschalter bei der ersten Anzeige der Palette im Status gedrückt angezeigt wird.

Sie können eine Gruppe von Mauspalettenschaltern mit Hilfe der Eigenschaft AllowAllUp (auf False gesetzt) als Gruppe definieren. Dabei muß allerdings die Eigenschaft Down für denjenigen Schalter gesetzt werden, der anfänglich den Status gedrückt haben soll. Außerdem können Sie mit der Eigenschaft Down einem Schalter zur Laufzeit den Status gedrückt zuweisen, ohne daß der Benutzer auf den Schalter zu klicken braucht.


TSpeedButton::Glyph

TSpeedButton	Siehe auch 	Beispiel

Die Eigenschaft Glyph legt das Bitmap fest, das auf dem ausgewählten Mauspalettenschalter angezeigt wird.

__property Graphics::TBitmap* Glyph;

Beschreibung

Im Dialogfeld Bild laden, das als Editor im Objektinspektor eingeblendet wird, können Sie eine Bitmap-Datei (Erweiterung BMP) für die Schaltfläche auswählen. Sie können das Bitmap aber auch zur Laufzeit zuweisen.

Einem Mauspalettenschalter können mit einem einzigen Bitmap bis zu vier Bilder zugewiesen werden. Borland C++Builder zeigt dann entsprechend dem jeweiligen Status der Schaltfläche eines dieser Bilder an.

Position im Bitmap	Status der Schaltfläche	Beschreibung

Erstes Bild	Nicht gedrückt	Dieses Bild wird angezeigt, wenn die Schaltfläche den Status nicht gedrückt hat. Falls keine weiteren Bilder im Bitmap vorhanden sind, verwendet Borland C++Builder dieses Bild auch für alle anderen Zustände.

Zweites Bild	Deaktiviert	Dieses Bild wird normalerweise grau dargestellt, um anzuzeigen, daß die Schaltfläche nicht ausgewählt werden kann.

Drittes Bild	Gedrückt	Dieses Bild wird angezeigt, wenn auf die Schaltfläche geklickt wurde. Das Bild für den Status nicht gedrückt wird wieder angezeigt, wenn der Benutzer die Maustaste losläßt.

Viertes Bild	Dauerhaft gedrückt	Dieses Bild wird angezeigt, wenn eine Schaltfläche gedrückt wird und in diesem Zustand bleibt. (Dieser vierte Status wird nur von Mauspalettenschaltern verwendet.)

Wenn nur ein Bild existiert, versucht Borland C++Builder, die anderen Zustände durch leichte Abänderungen des vorhandenen Bildes darzustellen. Dabei wird der Status dauerhaft gedrückt auf dieselbe Weise dargestellt wie nicht gedrückt. Sollten Ihnen die Ergebnisse nicht gefallen, können Sie weitere Bilder in das Bitmap einfügen.

Wenn ein Bitmap aus mehreren Bildern besteht, müssen Sie der Eigenschaft NumGlyphs ihre Anzahl zuweisen. Außerdem müssen alle Bilder dieselbe Größe haben und horizontal nebeneinander angeordnet sein.

Hinweis

Das untere linke Pixel des Bitmaps ist für die Farbe „Transparent“ reserviert. Alle Pixel des Bitmaps, deren Farbe mit diesem unteren linken Pixel übereinstimmt, werden transparent dargestellt.


TSpeedButton::GroupIndex

TSpeedButton	Siehe auch 	Beispiel

Die Eigenschaft GroupIndex legt die Mauspalettenschalter fest, die in einer Gruppe zusammengefaßt werden.

__property int GroupIndex;

Beschreibung

Die Eigenschaft GroupIndex hat für Mauspalettenschalter per Voreinstellung den Wert 0. Dies zeigt an, daß die Schalter zu keiner Gruppe gehören. Wenn der Benutzer auf einen Mauspalettenschalter klickt, wird dieser gedrückt dargestellt. Sobald der Benutzer die Maustaste losläßt, wird der Schalter wieder in seinem normalen, nicht gedrückten Status angezeigt.

Mauspalettenschalter, die denselben Wert in der Eigenschaft GroupIndex aufweisen (dieser Wert darf nicht Null sein), fungieren als Gruppe. Wenn der Benutzer auf einen dieser Mauspalettenschalter klickt, bleibt dieser gedrückt, bis der Benutzer auf einen anderen Schalter der Gruppe klickt. Auf diese Weise verwendete Mauspalettenschalter bieten dem Benutzer Auswahlmöglichkeiten an, die sich gegenseitig ausschließen.


TSpeedButton::Layout

TSpeedButton	Siehe auch 	Beispiel

Die Eigenschaft Layout bestimmt, an welcher Position das Bild auf der Bitmap-Schaltfläche oder auf einem Mauspalettenschalter angezeigt wird.

__property TButtonLayout Layout;

Beschreibung

Die Eigenschaft Layout kann folgende Werte annehmen:

Wert	Bedeutung

blGlyphLeft	Das Bild wird am linken Rand der Schaltfläche angezeigt.

blGlyphRight	Das Bild wird am rechten Rand der Schaltfläche angezeigt.

blGlyphTop	Das Bild wird am oberen Rand der Schaltfläche angezeigt.

blGlyphBottom	Das Bild wird am unteren Rand der Schaltfläche angezeigt.

Der Typ TButtonLayout definiert die Werte der Eigenschaft Layout, die ein Mauspalettenschalter annehmen kann.


TSpeedButton::Margin

TSpeedButton	Siehe auch 	Beispiel

Die Eigenschaft Margin legt die Anzahl der Pixel zwischen dem Rand des Bildes (angegeben in der Eigenschaft Glyph) und dem Rand der Schaltfläche fest.

__property int Margin;

Beschreibung

Der Abstand zwischen den Rändern hängt vom Layout des Bildes und des Textes ab (Eigenschaft Layout). Wenn Layout beispielsweise den Wert blGlyphLeft hat, bezieht sich der Abstand auf den linken Rand des Bildes und den linken Rand der Schaltfläche. Hat Margin den Wert 3, beträgt der Abstand zwischen dem Bild und dem rand der Schaltfläche drei Pixel. Wenn Margin den Wert 0 hat, liegt das Bild direkt am Rand der Schaltfläche an.

Hat Margin den (voreingestellten) Wert -1, sind Bild und Text (Eigenschaft Caption) zentriert. Das heißt, daß die Anzahl der Pixel zwischen dem Bild und dem Rand der Schaltfläche gleich der Anzahl der Pixel zwischen dem gegenüberliegenden Rand der Schaltfläche und dem Text ist.


TSpeedButton::NumGlyphs

TSpeedButton	Siehe auch 	Beispiel

Die Eigenschaft NumGlyphs gibt die Anzahl der Bilder an, die sich in der Grafik der Eigenschaft Glyph befinden.

__property TNumGlyphs NumGlyphs;

Beschreibung

Wenn ein Bitmap mehrere Bilder enthält, müssen Sie der Eigenschaft NumGlyphs die Anzahl dieser Bilder zuweisen. Alle Bilder müssen dieselbe Größe haben und nebeneinander angeordnet sein.  Gültige Werte für NumGlyphs sind 1 bis 4. Voreingestellt ist 1.

Einer Bitmap-Schaltfläche oder einem Mauspalettenschalter lassen sich mit einem einzigen Bitmap bis zu vier Bilder zuweisen. Borland C++Builder zeigt dann entsprechend dem jeweiligen Status der Schaltfläche eines dieser Bilder an. In einem Bitmap muß mindestens ein Bild vorhanden sein.

Position im Bitmap	Status der Schaltfläche	Beschreibung

Erstes Bild	Nicht gedrückt	Dieses Bild wird angezeigt, wenn die Schaltfläche den Status nicht gedrückt hat. Falls keine weiteren Bilder im Bitmap vorhanden sind, verwendet Borland C++Builder dieses Bild auch für alle anderen Zustände.

Zweites Bild	Deaktiviert	Dieses Bild wird normalerweise grau dargestellt, um anzuzeigen, daß die Schaltfläche nicht ausgewählt werden kann.

Drittes Bild	Gedrückt	Dieses Bild wird angezeigt, wenn auf die Schaltfläche geklickt wurde. Das Bild für den Status nicht gedrückt wird wieder angezeigt, wenn der Benutzer die Maustaste losläßt.

Viertes Bild	Dauerhaft gedrückt	Dieses Bild wird angezeigt, wenn eine Schaltfläche gedrückt wird und in diesem Zustand bleibt.

Wenn nur ein Bild existiert, versucht Borland C++Builder, die anderen Zustände durch leichte Abänderungen des vorhandenen Bildes darzustellen. Dabei wird der Status dauerhaft gedrückt auf dieselbe Weise dargestellt wie der Status nicht gedrückt. Sollten Ihnen die Ergebnisse nicht gefallen, können Sie weitere Bilder in das Bitmap einfügen.

Der Typ TNumGlyphs definiert den Wertebereich (1-4), den die Eigenschaft NumGlyphs eines Mauspalettenschalters annehmen kann.


TSpeedButton::Spacing

TSpeedButton	Siehe auch 	Beispiel

Die Eigenschaft Spacing bestimmt, an welcher Position das Bild und der Text auf einem Mauspalettenschalter angezeigt werden sollen.

__property int Spacing;

Beschreibung

Spacing legt die Anzahl der Pixel zwischen dem Bild (Eigenschaft Glyph) und dem Text (Eigenschaft Caption) fest. Voreingestellt sind 4 Pixel.

Wenn Spacing mit einer positiven Zahl belegt ist, handelt es sich bei diesem Wert um die Anzahl der Pixel zwischen dem Bild und dem Text. Hat Spacing den Wert 0, grenzen Bild und Text direkt aneinander. Bei -1 erscheint der Text zentriert zwischen dem Bild und dem Rand der Schaltfläche. Das heißt, die Anzahl der Pixel zwischen dem Bild und dem Text entspricht der Anzahl der Pixel zwischen dem Text und dem Rand der Schaltfläche gegenüber dem Bild.


Ereignisse von TSpeedButton

TSpeedButton	Alphabetisch	Legende

Abgeleitet von TControl

OnClick

OnDblClick

OnMouseDown

OnMouseMove

OnMouseUp


Ereignisse von TSpeedButton

TSpeedButton	Nach Objekten	Legende

OnClick

OnDblClick

OnMouseDown

OnMouseMove

OnMouseUp


Methoden von TSpeedButton

TSpeedButton	Alphabetisch

In TSpeedButton

~TSpeedButton

Click

TSpeedButton

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

GetTextLen

Hide

Invalidate

Perform

Refresh

Repaint

ScreenToClient

SendToBack

SetBounds

SetTextBuf

Show

Update

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TSpeedButton

TSpeedButton	Nach Objekten

~TSpeedButton

Assign

BeginDrag

BringToFront

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

Click

ClientToScreen

DefaultHandler

DestroyComponents

Destroying

Dispatch

DragDrop

Dragging

EndDrag

FieldAddress

FindComponent

FreeInstance

FreeNotification

Free

GetParentComponent

GetTextBuf

GetTextLen

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InstanceSize

Invalidate

MethodAddress

MethodName

NewInstance

Perform

Refresh

RemoveComponent

Repaint

ScreenToClient

SendToBack

SetBounds

SetTextBuf

Show

TSpeedButton

Update


TSpeedButton::~TSpeedButton

TSpeedButton	Siehe auch

Der Destruktor ~TSpeedButton gibt den Speicher frei, der für das TSpeedButton-Objekt reserviert war. Rufen Sie ~TSpeedButton nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TSpeedButton automatisch aufgerufen wird.

__fastcall virtual ~TSpeedButton(void);

Beschreibung

~TSpeedButton gibt das Bitmap-Objekt frei und ruft dann den Destruktor des übergeordneten Objekts auf.


TSpeedButton::Click

TSpeedButton

Click simuliert einen Mausklick des Benutzers auf den Mauspalettenschalter.

virtual void __fastcall Click(void);

Beschreibung

Click ruft die geerbte Methode Click auf.


TSpeedButton::TSpeedButton

TSpeedButton	Siehe auch

TSpeedButton erzeugt einen Mauspalettenschalter.

__fastcall virtual TSpeedButton(Classes::TComponent* AOwner);

Beschreibung

TSpeedButton ruft den Konstruktor seines übergeordneten Objekts auf und initialisiert den Mauspalettenschalter.


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TControl

TGraphicControl


TSpeedButton Beispiel

TSpeedButton


 TStoredProc

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/dbtables.hpp

TStoredProc kapselt eine gespeicherte Prozedur auf einem Datenbankserver.

Beschreibung

Benutzen Sie ein TStoredProc-Objekt, wenn eine Client-Anwendung eine gespeicherte Prozedur auf einem Datenbankserver verwenden muß. Eine gespeicherte Prozedur besteht aus einer Gruppe von Anweisungen, die als Teil der Metadaten eines Datenbankservers (z.B. Tabellen, Indizes und Domänen) gespeichert werden. Sie führt eine sich häufig wiederholende Aufgabe auf dem Server durch und übergibt die Ergebnisse an den Client.

Hinweis

Gespeicherte Prozeduren werden nicht von allen Datenbankservern untersützt. Detaillierte Informationen dazu finden Sie in der jeweiligen Serverdokumentation.

Viele gespeicherte Prozeduren erwarten eine Reihe von Eingabeargumenten oder Parametern, die während der Verarbeitung verwendet werden. TStoredProc stellt die Eigenschaft Params zur Verfügung, durch die eine Anwendung vor der Ausführung der gespeicherten Prozedur die Parameter setzen kann.

TStoredProc verwendet die Eigenschaft Params ein zweites Mal, um die von einer gespeicherten Prozedur zurückgegebenen Ergebnisse zu speichern. Params ist ein Array von Werten. Abhängig von der Serverimplementation kann eine gespeicherte Prozedur entweder einzelne Werte oder eine Ergebnismenge zurückgeben, ähnlich der von einer Abfrage zurückgegebenen Menge.


Eigenschaften von TStoredProc

TStoredProc	Alphabetisch	Legende

In TStoredProc

Overload

ParamBindMode

ParamCount

Params

Prepared

StmtHandle

StoredProcName

Abgeleitet von TDBDataSet

Database

DatabaseName

DBHandle

DBLocale

DBSession

SessionName

Abgeleitet von TDataSet

Active

AutoCalcFields

BOF

Bookmark

DataSource

DefaultFields

Designer

EOF

FieldCount

FieldDefs

Fields

FieldValues

Found

Modified

State

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TStoredProc

TStoredProc	Nach Objekten	Legende

Active

AutoCalcFields

BOF

Bookmark

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

DatabaseName

Database

DataSource

DBHandle

DBLocale

DBSession

DefaultFields

Designer

DesignInfo

EOF

FieldCount

FieldDefs

Fields

FieldValues

Found

Modified

Overload

Owner

ParamBindMode

ParamCount

Params

Prepared

SessionName

State

StmtHandle

StoredProcName

Tag


TStoredProc::Overload

TStoredProc	Siehe auch

Die Eigenschaft Overload gibt an, welche überladene, gespeicherte Oracle-Prozedur ausgeführt wird.

__property unsigned short Overload;

Beschreibung

Mit Overload können Sie festlegen, welche überladene, gespeicherte Prozedur auf einem Oracle-Server ausgeführt wird. Eine überladene, gespeicherte Oracle-Prozedur teilt sich den Namen mit einer oder mehreren anderen gespeicherten Prozeduren. Oracle unterscheidet zwischen überladenen, gespeicherten Prozeduren, indem jeder Prozedur ein eindeutiger numerischer Bezeichner zugewiesen wird. Eine Anwendung kann diesen Bezeichner mit Hilfe der Eigenschaft Overload angeben.

Standardmäßig ist Overload auf Null gesetzt, d.h. es wird angenommen, daß keine Prozedur überladen wird. €ndern Sie diesen Wert nur bei Oracle-Servern. Wenn eine Anwendung versucht, auf einem Oracle-Server auf eine überladene Prozedur zuzugreifen, ohne daß Overload gesetzt ist, greift die Borland Database Engine (BDE) auf die erste überladene Prozedur auf dem Server zu bzw. auf diejenige, die den kleinsten Wert hat.

Wenn Overload den Wert 1 hat, führt die BDE die erste überladene Prozedur auf dem Server aus. Bei einem Wert von 2 wird die zweite Prozedur ausgeführt usw.

Hinweis

Überladene Oracle-Prozeduren teilen sich zwar Namen, aber keine Parameterlisten. Eine Anwendung muß also sicherstellen, daß die richtige Parameterliste an die überladene Prozedur übergeben wird.


TStoredProc::ParamBindMode

TStoredProc	Siehe auch

Die Eigenschaft ParamBindMode bestimmt die Reihenfolge, in der die Parameter einer Komponente an die gespeicherte Prozedur auf dem Server übergeben werden.

__property TParamBindMode ParamBindMode;

Beschreibung

Mit ParamBindMode können Sie die Reihenfolge ermitteln oder festlegen, in der die Parameter in der Eigenschaft Params den von der gespeicherten Prozedur auf dem Server verwendeten Parametern zugeordnet werden. ParamBindMode kann einen der folgenden Werte annehmen:

Wert	Sortierreihenfolge

pbByName	Die in der Eigenschaft Params angegebenen Parameter werden den gleichnamigen Parametern auf dem Server zugeordnet. Dies ist die Voreinstellung.

pbByNumber	Die Parameter in Params werden dem nächsten verfügbaren Parameter auf dem Server einzeln zugewiesen (der erste Parameter in Params wird dem ersten von der gespeicherten Prozedur verwendeten Parameter zugewiesen usw.).

ParamBindMode sollte, wenn möglich, auf pbByName gesetzt werden. Dadurch ist sichergestellt, daß die Parameter unabhängig von der Sortierreihenfolge in Params den richtigen von der gespeicherten Prozedur verwendeten Parametern zugeordnet werden. Zur Entwurfszeit werden die Namen von bekannten Parametern im Parameter-Editor angezeigt.

In einigen Fällen werden von der gespeicherten Prozedur auf dem Server keine  Parameternamen an die Borland Database Engine übergeben. Wenn auf dem Server vorhandene Parameternamen zur Entwurfs- oder Laufzeit nicht bekannt sind, kann es erforderlich sein, ParamBindMode auf pbByNumber zu setzen. In diesem Fall muß jedoch die richtige Reihenfolge für die Datentypen der Parameter eingehalten werden, da sonst bei der Ausführung eine Exception auftreten kann.


TStoredProc::ParamCount

TStoredProc	Siehe auch

Die Eigenschaft ParamCount gibt die Anzahl der Parameter für die gespeicherte Prozedur an.

__property unsigned short ParamCount;

Beschreibung

Mit ParamCount können Sie die Anzahl der gegenwärtig in der Eigenschaft Params gespeicherten Parameter ermitteln. Wenn eine Anwendung eine gespeicherte Prozedur zur Ausführung vorbereitet, gibt ParamCount die Anzahl der Parameter an, die an den Server übergeben werden. Nach der Ausführung einer gespeicherten Prozedur gibt ParamCount die Zahl der zurückgegebenen Parameter an.


TStoredProc::Params

TStoredProc	Siehe auch

Die Eigenschaft Params speichert die Ein- und Ausgabeparameter für eine gespeicherte Prozedur.

__property TParams* Params;

Beschreibung

Mit Params können Sie zur Laufzeit die Namen, Werte und Datentypen für Eingabeparameter dynamisch setzen (zur Entwurfszeit verwenden Sie dazu den Parameter-Editor). Params ist ein Array von Parameterwerten.

Eine Anwendung kann auch nach dem Ausführen einer gespeicherten Prozedur auf Params zugreifen, um die vom Server an die Prozedur zurückgegebenen Ausgabeparameter oder die Ergebnismenge abzurufen.

Hinweis

Eine Anwendung sollte zum Setzen der Parameterwerte die Methode SetParams aufrufen, anstatt über einen Index auf das Params-Array zuzugreifen. Um den nach der Ausführung einer gespeicherten Prozedur für einen Parameter zurückgegebenen Wert zu ermitteln, rufen Sie die Methode ParamByName auf.


TStoredProc::Prepared

TStoredProc	Siehe auch

Die Eigenschaft Gibt an, ob eine gespeicherte Prozedur für die Ausführung vorbereitet wird.

__property bool Prepared;

Beschreibung

Überprüfen Sie Prepared, um zu bestimmen, ob eine gespeicherte Prozedur bereits für die Ausführung vorbereitet wurde. Bei einem Wert von True ist die gespeicherte Prozedur zur Ausführung bereit, bei einem Wert von False ist diese nicht bereit. Eine gespeicherte Prozedur muß vorbereitet werden, bevor sie ausgeführt werden kann.

Hinweis

Eine Anwendung kann die aktuelle Einstellung von Prepared ändern und dadurch für eine gespeichert Prozedur eine der Methoden Prepare oder Unprepare aufrufen. Wenn Prepared True ist, ruft die Zuweisung von False die Methode Unprepare auf, die die gespeicherte Prozedur in den Status ‘nicht bereit’ versetzt. Wenn Prepared False ist, ruft die Zuweisung von True die Methode Prepare auf, die die gespeicherte Prozedur zur Ausführung vorbereitet. Normalerweise besteht jedoch die bessere Programmiertechnik darin, Prepare und Unprepare direkt aufzurufen. Die Eigenschaft Prepared wird von diesen Methoden automatisch aktualisiert.


TStoredProc::StmtHandle

TStoredProc

Die Eigenschaft StmtHandle gibt das Anweisungs-Handle der Borland Database Engine (BDE) für die gespeicherte Prozedur zurück.

__property Bde::hDBIStmt StmtHandle;

Beschreibung

Verwenden Sie StmtHandle, wenn eine Anwendung die BDE direkt aufruft und die Methoden von TStoredProc umgeht. Einige BDE API-Aufrufe erwarten ein Anweisungs-Handle als Parameter. In allen anderen Fällen braucht eine Anwendung nicht auf diese Eigenschaft zugreifen.


TStoredProc::StoredProcName

TStoredProc	Siehe auch

Die Eigenschaft StoredProcName gibt den Namen der gespeicherten Prozedur auf dem Server an, die von diesem Objekt gekapselt wird.

__property System::AnsiString StoredProcName;

Beschreibung

Weisen Sie StoredProcName den Namen der gespeicherten Prozedur zu, die auf dem Server aufgerufen werden soll. Wenn der Wert in StoredProcName nicht mit dem Namen einer vorhandenen gespeicherten Prozedur auf dem Server übereinstimmt, löst ein Versuch der Anwendung, die Prozedur vor der Ausführung vorzubereiten, eine Exception aus.


Ereignisse von TStoredProc

TStoredProc	Alphabetisch	Legende

Abgeleitet von TDataSet

AfterCancel

AfterClose

AfterDelete

AfterEdit

AfterInsert

AfterOpen

AfterPost

BeforeCancel

BeforeClose

BeforeDelete

BeforeEdit

BeforeInsert

BeforeOpen

BeforePost

OnCalcFields

OnDeleteError

OnEditError

OnFilterRecord

OnNewRecord

OnPostError


Ereignisse von TStoredProc

TStoredProc	Nach Objekten	Legende

AfterCancel

AfterClose

AfterDelete

AfterEdit

AfterInsert

AfterOpen

AfterPost

BeforeCancel

BeforeClose

BeforeDelete

BeforeEdit

BeforeInsert

BeforeOpen

BeforePost

OnCalcFields

OnDeleteError

OnEditError

OnFilterRecord

OnNewRecord

OnPostError


Methoden von TStoredProc

TStoredProc	Alphabetisch

In TStoredProc

~TStoredProc

CopyParams

DescriptionsAvailable

ExecProc

GetResults

ParamByName

Prepare

TStoredProc

UnPrepare

Abgeleitet von TDBDataSet

CheckOpen

Abgeleitet von TDataSet

ActiveBuffer

Append

AppendRecord

CheckBrowseMode

ClearFields

Close

ControlsDisabled

CursorPosChanged

Delete

DisableControls

Edit

EnableControls

FieldByName

FindField

FindFirst

FindLast

FindNext

FindPrior

First

FreeBookmark

GetBookmark

GetFieldList

GetFieldNames

GotoBookmark

Insert

InsertRecord

IsLinkedTo

Last

MoveBy

Next

Open

Post

Prior

Refresh

Resync

SetFields

UpdateCursorPos

UpdateRecord

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TStoredProc

TStoredProc	Nach Objekten

~TStoredProc

ActiveBuffer

AppendRecord

Append

Assign

CheckBrowseMode

CheckOpen

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

ClearFields

Close

ControlsDisabled

CopyParams

CursorPosChanged

DefaultHandler

Delete

DescriptionsAvailable

DestroyComponents

Destroying

DisableControls

Dispatch

Edit

EnableControls

ExecProc

FieldAddress

FieldByName

FindComponent

FindField

FindFirst

FindLast

FindNext

FindPrior

First

FreeBookmark

FreeInstance

FreeNotification

Free

GetBookmark

GetFieldList

GetFieldNames

GetParentComponent

GetResults

GotoBookmark

HasParent

InheritsFrom

InitInstance

InsertComponent

InsertRecord

Insert

InstanceSize

IsLinkedTo

Last

MethodAddress

MethodName

MoveBy

NewInstance

Next

Open

ParamByName

Post

Prepare

Prior

Refresh

RemoveComponent

Resync

SetFields

TStoredProc

UnPrepare

UpdateCursorPos

UpdateRecord


TStoredProc::~TStoredProc

TStoredProc	Siehe auch

Der Destruktor ~TStoredProc gibt den Speicher frei, der für das TStoredProc-Objekt reserviert war. Rufen Sie ~TStoredProc nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TStoredProc automatisch aufgerufen wird.

__fastcall virtual ~TStoredProc(void);

Beschreibung

~TStoredProc trennt die Verbindung zum Server, gibt die Parameterliste frei und ruft den Destruktor des übergeordneten Objekts auf.


TStoredProc::CopyParams

TStoredProc	Siehe auch

Die Methode CopyParams kopiert die Parameter einer gespeicherten Prozedur in eine andere Parameterliste.

void __fastcall CopyParams(TParams* Value);

Beschreibung

Mit einem Aufruf von CopyParams können Sie die Parameter dieser gespeicherten Prozedur in eine separate Parameterliste kopieren. Value ist die Parameterliste, der die Parameter dieser gespeicherten Prozedur zugewiesen werden. Value kann auch die Parameterliste einer anderen gespeicherten Prozedur sein. Ein Beispiel:

TStoredProc1.CopyParams(TStoredProc2.Params);

Wenn die gespeicherte Prozedur beim Aufruf von CopyParams durch eine Anwendung nicht bereit ist, ruft CopyParams vor der Zuweisung der Parameter an die Zielparameterliste zuerst Prepare und dann Unprepare auf, um die gespeicherte Prozedur wieder in den vorherigen Status zu versetzen.


TStoredProc::DescriptionsAvailable

TStoredProc	Siehe auch

Die Methode DescriptionsAvailable legt fest, ob Parameterinformationen für die gespeicherte Prozedur auf dem Server verfügbar sind.

bool __fastcall DescriptionsAvailable(void);

Beschreibung

Mit DescriptionsAvailable können Sie festlegen, ob eine auf dem Server gespeicherte Prozedur Parameterinformationen an die Anwendung zurückgeben kann. Wenn DescriptionAvailable True zurückgibt, sind Parameterinformationen vom Server verfügbar, andernfalls nicht.

Hinweis

Wenn DescriptionsAvailable False zurückgibt, muß die Anwendung dennoch die richtigen Parameterinformationen an die gespeicherte Prozedur auf dem Server übergeben. Der Entwickler der Anwendung muß zur Entwurfszeit die erforderlichen Parameter kennen.


TStoredProc::ExecProc

TStoredProc	Siehe auch

Die Methode ExecProc führt die gespeicherte Prozedur auf dem Server aus.

void __fastcall ExecProc(void);

Beschreibung

Mit ExecProc können Sie eine gespeicherte Prozedur auf dem Server ausführen. Führen Sie vor dem Aufruf von ExecProc folgende Schritte aus:

1	Geben Sie sämtliche Eingabeparameter in der Eigenschaft Params an. Zur Entwurfszeit kann sich der Entwickler dazu des Parameter-Editors bedienen. Zur Laufzeit muß die Anwendung direkt auf Params zugreifen.

2	Rufen Sie Prepare auf, um die Parameter zu binden.

Wenn eine gespeicherte Prozedur Ausgabeparameter zurückgibt, werden diese in der Eigenschaft Params gespeichert, wenn die Steuerung an die Anwendung zurückgegeben wird. Die Anwendung kann auf diese Liste über einen Index zugreifen oder die Methode ParamByName verwenden.


TStoredProc::GetResults

TStoredProc	Siehe auch

Die Methode GetResults gibt die Werte der Ausgabeparameter einer gespeicherten Sybase-Prozedur zurück.

void __fastcall GetResults(void);

Beschreibung

Mit GetResults kann eine gespeicherte Sybase-Prozedur veranlaßt werden, ihre Ergebnismenge (falls vorhanden) an den Client zurückzugeben. Für gespeicherte Prozeduren auf allen anderen Servern werden die Ergebnismengen automatisch an den Client übergeben. Gespeicherte Sybase-Prozeduren geben die Ergebnismenge jedoch erst dann zurück, wenn der Cursor am Ende der Ergebnismenge positioniert wird. GetResults setzt den Cursor an das Ende der Ergebnismenge.

Wenn eine gespeicherte Sybase-Prozedur als Antwort auf GetResults eine Ergebnismenge zurückgibt, wird diese in der Eigenschaft Params gespeichert. Die Anwendung kann auf diese Liste über einen zugreifen oder die Methode ParamByName verwenden.


TStoredProc::ParamByName

TStoredProc	Siehe auch

Die Methode ParamByName greift über den angegebenen Parameternamen auf Parameterinformationen zu.

TParam* __fastcall ParamByName(const System::AnsiString Value);

Beschreibung

Mit ParamByName können Sie Parameterinformationen für einen bestimmten Parameter abrufen. Value gibt den Namen dieses Parameters an. Normalerweise wird mit ParamByName der Wert eines Eingabeparameters gesetzt oder der Wertes eines Ausgabeparameters ermittelt. Die folgende Anweisung ruft beispielsweise den aktuellen Wert eines Parameters mit dem Namen “Contact“ ab und zeigt ihn in einem Bearbeitungsfeld an:

Edit1.Text := StoredProc1.ParamsByName('Contact').AsString;


TStoredProc::Prepare

TStoredProc	Siehe auch

Die Methode Prepare bereitet eine gespeicherte Prozedur auf die Ausführung vor.

void __fastcall Prepare(void);

Beschreibung

Mit Prepare können die Parameter einer gespeicherten Prozedur gebunden werden, bevor die Methode ExecProc die Prozedur ausführt. Prepare bereitet die Parameter der gespeicherten Prozedur vor, initialisiert die Borland Database Engine (ΒDE) und informiert den Server darüber, daß die gespeicherte Prozedur zur Ausführung bereit ist. Dabei werden Systemressourcen zugewiesen, und die Abfrage wird für die Ausführung auf dem Server optimiert.

Hinweis

Eine nicht vorbereitete Prozedur kann von einer Anwendung nicht ausgeführt werden. Die Eigenschaft Prepared ist True, wenn die gespeicherte Prozedur bereits vorbereitet ist.


TStoredProc::TStoredProc

TStoredProc	Siehe auch

Der Konstruktor TStoredProc erzeugt ein neues TStoredProc-Objekt.

__fastcall virtual TStoredProc(Classes::TComponent* AOwner);

Description

Beschreibung

Mit TStoredProc können Sie eine in einer Anwendung deklarierte, gespeicherte Prozedur instantiieren. TStoredProc ruft den Konstruktor des übergeordneten Objekts auf, erzeugt eine leere Parameterliste für die neu instantiierte gespeicherte Prozedur und initialisiert ihre Parameter-, Server- und Datensatzpuffer mit NULL.


TStoredProc::UnPrepare

TStoredProc	Siehe auch

Die Methode UnPrepare gibt die Ressourcen frei, die einer vorbereiteten gespeicherten Prozedur zuvor zugewiesen wurden.

void __fastcall UnPrepare(void);

Beschreibung

Mit UnPrepare können Sie die Ressourcen freigeben, die einer zuvor vorbereiteten gespeicherten Prozedur sowohl auf dem Server als auch auf dem Client zugewiesen wurden.

Hinweis

Eine Anwendung muß UnPrepare aufrufen, bevor sie €nderungen an den Eingabeparametern einer zuvor vorbereiteten gespeicherten Prozedur vornimmt. Wenn UnPrepare für eine gespeicherte Prozedur aufgerufen wird, gehen alle aktuellen Parameterinformationen verloren.


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TDataSet

TDBDataSet


TStoredProc Beispiel

TStoredProc


TStream

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/classes.hpp

TStream ist der abstrakte Basisklassentyp für Borland C++Builder-Stream-Objekte, die binäre Daten auf verschiedenen Speichermedien wie Festplatten oder im dynamischen Speicher usw. speichern können.

Beschreibung

TStream kapselt Methoden für generische Dateieingaben und -ausgaben. Dazu definiert TStream Methoden, um Bytes aus dem Stream zu lesen, in ihn zu schreiben und zu kopieren, und um die aktuelle Position im Stream zu suchen. In den Eigenschaften von TStream werden Informationen über den Stream wie dessen Größe und die aktuelle Position bereitgestellt.

Außerdem besitzt TStream Methoden, die mit Komponenten und Filer-Objekten arbeiten, um Komponenten in einfachen und geerbten Formularen in den Stream zu stellen. Diese Methoden werden automatisch von globalen Routinen aufgerufen, die diesen Vorgang initiieren. Sie können aber auch direkt aufgerufen werden, um den Prozeß zu initiieren. In jedem Fall ist zu beachten, daß an der Stream-Operation immer zwei weitere Objekte beteiligt sind:

•	Ein Komponentenobjekt, das den Methoden des Streams als Parameter übergeben wird.

•	Ein Filer-Objekt, das automatisch vom Stream erstellt und mit ihm verbunden wird.

Als abstrakte Klasse kann TStream nicht instantiiert werden. Abgeleitete Stream-Objekte wie Speicher- und Datei-Streams, die für Stream-Operationen mit Komponenten eingesetzt werden, werden beim Einsatz der globalen Funktionen ReadComponentRes und WriteComponentRes automatisch erstellt. Wenn andere Arten von Informationen in den Stream gestellt werden sollen, wählen Sie eine abgeleitete Klasse, die den jeweiligen Daten- und Speicherbedarf erfüllt.


Eigenschaften von TStream

TStream	Alphabetisch	Legende

In TStream

Position

Size


Eigenschaften von TStream

TStream	Nach Objekten	Legende

Position

Size


TStream::Position

TStream	Siehe auch	Beispiel

Die Eigenschaft Position gibt den aktuellen Offset im Stream für Lese- und Schreiboperationen an.

__property long Position;

Beschreibung

Mit Position können Sie die aktuelle Position im Stream ermitteln. Position wird intern von Filer-Objekten beim Lesen und Schreiben von Daten aus dem und in den Stream verwendet.


TStream::Size

TStream	Siehe auch

Die Eigenschaft Size gibt die Größe des Streams in Byte an.

__property long Size;

Beschreibung

Mit Size können Sie die Größe des Streams ermitteln. Size wird intern in Routinen verwendet, die aus dem Stream lesen und in ihn schreiben.


Methoden von TStream

TStream	Alphabetisch

In TStream

~TStream

CopyFrom

Read

ReadBuffer

ReadComponent

ReadComponentRes

ReadResHeader

Seek

TStream

Write

WriteBuffer

WriteComponent

WriteComponentRes

WriteDescendent

WriteDescendentRes

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TStream

TStream	Nach Objekten

~TStream

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

CopyFrom

DefaultHandler

Dispatch

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance

ReadBuffer

ReadComponentRes

ReadComponent

ReadResHeader

Read

Seek

TStream

WriteBuffer

WriteComponentRes

WriteComponent

WriteDescendentRes

WriteDescendent

Write


TStream::~TStream

TStream	Siehe auch

Der Destruktor ~TStream gibt den Speicher frei, der für das TStream-Objekt reserviert war. Rufen Sie ~TStream nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TStream automatisch aufgerufen wird.

__fastcall virtual ~TStream(void);


TStream::CopyFrom

TStream

Die Methode CopyFrom kopiert die angegebene Anzahl Bytes aus einem Stream in einen anderen.

long __fastcall CopyFrom(TStream* Source, long Count);

Beschreibung

Mit CopyFrom können Sie Daten aus einem Stream in einen anderen kopieren. Der Benutzer muß keinen Pufferspeicher erstellen, lesen, beschreiben und freigeben, um Daten zu kopieren.

CopyFrom kopiert die in Count angegebene Anzahl Bytes aus dem in Source angegebenen Stream in den Stream. Dann verschiebt es die aktuelle Position um die in Count angegebene Anzahl Bytes und gibt die Anzahl der kopierten Bytes zurück.

Wenn Count 0 enthält, setzt CopyFrom vor dem Lesen die Position in Source auf 0 und kopiert dann den gesamten Inhalt von Source in den Stream. Wenn Count größer oder kleiner als 0 ist, liest CopyFrom ab der aktuellen Position in Source.


TStream::Read

TStream	Siehe auch

Die Klasse TStream führt Read als abstrakte Methode ein.

virtual long __fastcall Read(void *Buffer, long Count);

Beschreibung

Jedes abgeleitete Stream-Objekt definiert eine Methode Read, die Daten vom jeweiligen Speichermedium (wie Arbeitsspeicher oder Festplattendatei) liest.

Read wird verwendet, wenn die Anzahl der aus dem Stream zu lesenden Bytes nicht feststeht.

Bei allen anderen Methoden zum Lesen von Daten aus einem Stream (ReadBuffer, ReadComponent) wird für die Leseoperation Read aufgerufen.


TStream::ReadBuffer

TStream	Siehe auch

Die Methode ReadBuffer liest Bytes aus dem Stream in den Buffer (Puffer).

void __fastcall ReadBuffer(void *Buffer, long Count);

Beschreibung

Mit ReadBuffer wird die in Count angegebene Anzahl Bytes aus dem Stream in den Buffer (Puffer) gelesen, wenn die Anzahl der Bytes bekannt und nicht variabel ist, beispielsweise beim Einlesen von Strukturen. Intern wird ReadBuffer zum Laden und Kopieren aus einem Stream eingesetzt.

ReadBuffer ruft für die Leseoperation Read auf. Falls die Leseoperation am Ende des Streams nicht beendet wird, wird eine EReadError-Exception ausgelöst.


TStream::ReadComponent

TStream	Siehe auch

Die Methode ReadComponent stellt eine von verschiedenen Möglichkeiten dar, Stream-Operationen für Komponenten und deren Eigenschaften einzuleiten.

TComponent* __fastcall ReadComponent(TComponent* Instance);

Beschreibung

Zur Einleitung der Stream-Operation für Komponenten wird ReadComponent indirekt von der globalen Routine ReadComponentRes oder der Methode ReadComponentRes oder direkt aufgerufen.

ReadComponent liest Datenwerte aus dem Stream und weist sie Eigenschaften zu. Dann erstellt sie ein Reader-Objekt und ruft die Methode ReadRootComponent des Reader-Objekts auf, um die Eigenschaftswerte zu lesen und untergeordnete Objekte zu erstellen, die im Stream als Nachkommen definiert sind. ReadComponent gibt die Komponente zurück.

Wenn Instance NULL ist, erstellt ReadComponent auf Grundlage der Typinformationen im Stream eine Komponente und gibt die neue Komponente zurück.


TStream::ReadComponentRes

TStream	Siehe auch

Die Methode ReadComponentRes stellt eine von verschiedenen Möglichkeiten dar, Stream-Operationen für Komponenten und deren Eigenschaften einzuleiten.

TComponent* __fastcall ReadComponentRes(TComponent* Instance);

Beschreibung

ReadComponentRes wird automatisch von der globalen Routine ReadComponentResFile aufgerufen. Sie kann auch direkt aufgerufen werden, wenn die aktuelle Position des Streams auf eine Komponente zeigt, die mit der Methode WriteComponentRes geschrieben wurde.

ReadComponentResFile erstellt ein Datei-Stream-Objekt, das dann die Methode ReadComponentRes aufruft.

Zuerst ruft ReadComponentRes die Methode ReadResHeader auf, um einen Ressourcen-Header aus dem Stream zu lesen. Falls der Stream an der aktuellen Position keinen Ressourcen-Header enthält, löst ReadResHeader eine EInvalidImage-Exception aus. Anschließend ruft ReadComponentRes die Methode ReadComponent auf, um Instance zu lesen.


TStream::ReadResHeader

TStream	Siehe auch

Die Methode ReadResHeader wird intern vom Streaming-System verwendet, um den Header einer Windows-Ressourcendatei aus dem Stream zu lesen.

void __fastcall ReadResHeader(void);

Beschreibung

Rufen Sie ReadResHeader nicht direkt auf. Die Methode wird von ReadComponentRes vor dem Lesen einer Komponente aus einer Ressourcendatei automatisch aufgerufen.

Nachdem der Header der Ressourcendatei gelesen wurde, verschiebt ReadResHeader die aktuelle Position im Stream auf das Byte hinter dem Header. Falls der Stream keinen gültigen Header einer Ressourcendatei enthält, löst ReadResHeader eine EInvalidImage-Exception aus.


TStream::Seek

TStream

TStream führt Seek als abstrakte Methode ein.

virtual long __fastcall Seek(long Offset, unsigned short Origin);

Beschreibung

Jedes abgeleitete Stream-Objekt definiert eine Methode Seek, die die aktuelle Position im Stream im jeweiligen Speichermedium (wie Speicher oder Festplattendatei) verschiebt.

Seek wird von den Eigenschaften Position und Size aufgerufen.


TStream::TStream

TStream	Siehe auch

TStream erzeugt ein neues TStream-Objekt.

__fastcall TStream(void);


TStream::Write

TStream	Siehe auch

TStream führt Write als abstrakte Methode ein.

virtual long __fastcall Write(const void *Buffer, long Count);

Beschreibung

Jedes abgeleitete Stream-Objekt definiert eine Methode Write, die Daten auf das jeweilige Speichermedium (wie Speicher oder Festplattendatei) schreibt. Alle anderen Methoden eines Streams, die Daten schreiben (WriteBuffer, WriteComponent), rufen zur Durchführung der Schreiboperation Write auf.


TStream::WriteBuffer

TStream	Siehe auch

WriteBuffer schreibt die in Count angegebene Anzahl Bytes aus Buffer in den Stream und verschiebt die aktuelle Position im Stream um diese Anzahl Bytes.

void __fastcall WriteBuffer(const void *Buffer, long Count);

Beschreibung

Mit WriteBuffer können Sie Daten in einem Stream speichern. WriteBuffer und ReadBuffer werden verwendet, wenn die Anzahl der Bytes bekannt ist und eingehalten werden muß, beispielsweise beim Einlesen von Strukturen. WriteBuffer wird für Standard-Stream-Operationen (Dateieingaben und -ausgaben) verwendet.

Intern wird WriteBuffer zum Schreiben in einen Stream und Kopieren aus einem Stream eingesetzt. Die Methode wird von anderen Objekten wie Strings und Listen verwendet, um Strings in einen Puffer zu schreiben.

WriteBuffer ruft für die Schreiboperation Write auf. Falls der Stream nicht alle erforderlichen Bytes schreibt, wird eine EWriteError-Exception ausgelöst.


TStream::WriteComponent

TStream	Siehe auch

Die Methode WriteComponent stellt eine von verschiedenen Möglichkeiten dar, das Schreiben von Komponenten und deren Eigenschaften in einen Stream einzuleiten.

void __fastcall WriteComponent(TComponent* Instance);

Beschreibung

Intern wird WriteComponent im Borland C++Builder-Streaming-System verwendet. Die Methode kann aber auch direkt aufgerufen werden, wenn Komponenten in Speicher-Streams oder Datenbank-BLOBs geschrieben werden sollen.

WriteComponent erstellt ein Writer-Objekt und ruft dessen Methode WriteRootComponent auf, um die in Instance angegebene Komponente und deren untergeordnete Objekte in den Stream zu schreiben.


TStream::WriteComponentRes

TStream	Siehe auch

Die Methode WriteComponentRes stellt eine von verschiedenen Möglichkeiten dar, das Schreiben von Komponenten und deren Eigenschaften in einen Stream einzuleiten.

void __fastcall WriteComponentRes(const System::AnsiString ResName, TComponent* Instance);

Beschreibung

WriteComponentRes wird intern im Borland C++Builder-Streaming-System verwendet. Die Methode kann aber auch direkt aufgerufen werden, wenn Daten an andere Anwendungen auf der Festplatte gesendet werden. Mit WriteComponentRes können Komponenten in den Stream gestellt werden, die Daten wie z.B. ein Bitmap oder ein Symbol im Format einer Windows-Ressourcendatei speichern müssen.

WriteComponentRes ruft WriteDescendentRes auf und übergibt NULL im Parameter Ancestor. WriteDescendentRes startet also die verbleibende Stream-Operation für eine Komponente, die in diesem Fall kein Nachfahr ist.

Zum Lesen einer Komponente, die mit WriteComponentRes geschrieben wurde, rufen Sie die Methode ReadComponentRes auf.


TStream::WriteDescendent

TStream	Siehe auch

Die Methode WriteDescendent wird intern vom Streaming-System verwendet, um Komponenten und ihre Eigenschaften in geerbten Formularen in den Stream zu stellen.

void __fastcall WriteDescendent(TComponent* Instance, TComponent* Ancestor);

Beschreibung

Rufen Sie WriteDescendent nicht direkt auf. WriteDescendent wird von WriteComponent automatisch aufgerufen.

WriteDescendent erstellt ein Writer-Objekt und ruft dann die Methode WriteDescendent des Writer-Objekts auf, um die in Instance übergebene Komponente in den Stream zu schreiben. Instance ist entweder ein geerbtes Formular, ein Nachkomme von Ancestor oder NULL. WriteDescendent wird jedoch nie verwendet, um zugehörige Komponenten zu schreiben. Die Methode dient ausschließlich dem Einleiten der Stream-Operation für die übergeordnete Komponente.


TStream::WriteDescendentRes

TStream	Siehe auch

Die Methode WriteDescendentRes wird intern vom Streaming-System verwendet, um Komponenten und ihre Eigenschaften in geerbten Formularen in den Stream zu stellen.

void __fastcall WriteDescendentRes(const System::AnsiString ResName, TComponent* Instance, TComponent*  Ancestor);

Beschreibung

Rufen Sie WriteDescendentRes nicht direkt auf. WriteDescendentRes wird von WriteComponentRes automatisch aufgerufen.

WriteDescendentRes schreibt einen Standard-Header einer Windows-Ressourcendatei in den Stream. Dabei wird der in ResName übergebene Ressourcenname verwendet. Anschließend wird WriteDescendent aufgerufen, um Instance als Nachfahren von Ancestor in den Stream zu schreiben.


Zugriff

Read-only


Hierarchie

TObject


TStream Beispiel

TStream


TStrings

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/classes.hpp

TStrings ist eine abstrakte Basisklasse für Objekte, die eine Liste mit Strings darstellen.

Beschreibung

Von TStrings abgeleitete Objekte ermöglichen die Speicherung und Bearbeitung von String-Listen. Hierbei lassen sich Strings entweder als unterschiedliche Zeichenketten (wie z.B. die einzelnen Zeilen eines Listenfeldes) oder als eine einzige lange Texteinheit auffassen, deren Elemente dann separat bearbeitet werden können.

Die Eigenschaften und Methoden von TStrings bieten zahlreiche Werkzeuge zur String-Listenbearbeitung an. Folgende Möglichkeiten stehen zur Verfügung:

•	Strings können mittels Index in die Liste eingefügt bzw. gelöscht werden.

•	Die Reihenfolge der String-Einträge läßt sich verändern.

•	Strings können über ihre Listenposition angesprochen werden.

•	Strings können aus bzw. in eine Datei oder einen Stream gelesen bzw. geschrieben werden.

•	String-Einträge können mit Objekten verbunden werden.


Eigenschaften von TStrings

TStrings	Alphabetisch	Legende

In TStrings

CommaText

Count

Names

Objects

Strings

Text

Values


Eigenschaften von TStrings

TStrings	Nach Objekten	Legende

CommaText

Count

Names

Objects

Strings

Text

Values


TStrings::CommaText

TStrings	Siehe auch

Die Eigenschaft CommaText ist die String-Liste eines TString-Objekts. Sie wird im SDF-Format (System Data Format) dargestellt.

__property System::AnsiString CommaText;

Die Eigenschaft CommaText bietet beim Schreiben oder Lesen die Möglichkeit, sämtliche Listeneinträge eines Objekts von TStrings wie einen einzigen, durch Kommas getrennten String zu behandeln.

Wenn die Eigenschaft CommaText gelesen wird, gelten folgende Konventionen: Jeder Eintrag der String-Liste, der Leerzeichen, Kommas oder Anführungszeichen enthält, wird in Anführungszeichen (“) gesetzt. Ist ein Anführungszeichen (“) selbst Teil eines Strings, wird es verdoppelt. Ein Beispiel: Die String-Liste

Stri,ng 1

Stri"ng 2

String 3

String4

wird von der Eigenschaft CommaText in der folgenden Form zurückgegeben:

„Stri,ng 1“,„Stri“„ng 2“,„String 3“,String4

Wenn eine Wertzuweisung an CommaText erfolgt, wird der Wert entsprechend dem SDF-Format zerlegt. Dies setzt voraus, daß Zeichenketten durch Kommas oder Leerzeichen getrennt und optional in Anführungszeichen eingeschlossen sind. Anführungszeichen, die Teil des Strings sind, müssen zweimal hintereinander stehen („“), sonst werden sie als Begrenzungszeichen interpretiert. Leerzeichen und Kommas, die nicht von Anführungszeichen eingeschlossen sind, werden als Trennzeichen behandelt. Zwei aufeinanderfolgende Kommas gelten als Leer-String. Leerzeichen, die unmittelbar vor oder nach einem Trennzeichen stehen, werden dagegen ignoriert. Nehmen wir an, CommaText wird folgendermaßen gesetzt:

„Stri,ng 1“, „Stri“„ng 2“ , String 3,String4

Die String-Liste enthält danach folgende Einträge:

Stri,ng 1

Stri"ng 2

String

3

String4

Hinweis

Die Eigenschaft CommaText verwendet für das Lesen von Text die Eigenschaft Strings, für Textzuweisungen hingegen die Methode Add.


TStrings::Count

TStrings	Siehe auch

Mit der Einführung der abstrakten Eigenschaft Count durch TStrings läßt sich die Anzahl der String-Einträge in der String-Liste feststellen.

__property int Count;

Beschreibung

Nachkommen der Basisklasse TStrings können mit Hilfe der Eigenschaft Count die Anzahl der Einträge in der String-Liste ermitteln.

Verwenden Sie die Eigenschaft Count beispielsweise als Startwert für einen Schleifenzähler, um nacheinander auf alle String-Listeneinträge zuzugreifen. Ebenso kann über Count die Position eines Strings relativ zur Position des letzten Listeneintrags bestimmt werden.


TStrings::Names

TStrings	Siehe auch

Enthält die String-Liste Einträge in der Form “Bezeichner=Wert“, so gibt die Eigenschaft Names den Teil des Strings zurück, der dem Bezeichner entspricht.

__property System::AnsiString Names[int Index];

Beschreibung

Enthält die String-Liste eines TStrings-Objekts Einträge in der Form “Bezeichner=Wert“, dann bietet die Eigenschaft Names die Möglichkeit, auf den Teil-String zuzugreifen, der dem Bezeichner entspricht. Der Integer-Parameter Index bestimmt die Listenposition des jeweiligen Strings, wobei sich der Wert 0 auf den ersten, der Wert 1 auf den zweiten Stringeintrag usw. bezieht. Hat der indizierte String nicht die Form “Bezeichner=Wert“, so gibt die Eigenschaft Names einen leeren String zurück.

Strings in diesem Format findet man häufig in INI-Dateien:

DisplayGrid=1

SnapToGrid=1

GridSizeX=8

GridSizeY=8

Das Format “Bezeichner=Wert“ gilt übrigens auch für die Strings der Eigenschaft Params einer Datenbank-Komponente (TDatabase).

Der Teil-String Name steht als Bezeichner auf der linken Seite des Gleichheitszeichens (=), der aktuelle Wert rechts davon. Zwischen dem Gleichheitszeichen und den beiden Teil-Strings sind keine Leerschritte zulässig.

Hinweis

Die Eigenschaft Names verwendet die Eigenschaft Strings zum Zugriff auf die String-Einträge.


TStrings::Objects

TStrings	Siehe auch

Die Eigenschaft Objects repräsentiert eine definierte Menge von Objekten, von denen jedes mit einem bestimmten Eintrag in der Eigenschaft Strings verknüpft ist.

__property System::TObject* Objects[int Index];

Beschreibung

Wenn der Eigenschaft Objects eines TStrings-Objekts ein Wert zugewiesen wird, hat dies keinen Effekt. Entsprechend wird beim Lesen NULL zurückgegeben. Erst die Nachkommen dieser Klasse können einzelnen Strings mit Hilfe der Eigenschaft Objects Objekte zuordnen.

In einer von TStrings abgeleiteten Klasse kann über die Eigenschaft Objects das Objekt ermittelt bzw. festgelegt werden, das dem String zugeordnet ist, der mit dem Parameter Index referenziert wird. Dabei verweist der Indexwert 0 auf den ersten String, der Wert 1 auf den zweiten und so fort. Verfügt ein Nachkomme von TStrings nicht über die Eigenschaft Objects, so gibt ein Lesevorgang den Wert NULL zurück.


TStrings::Strings

TStrings	Siehe auch

Die Klasse TStrings führt die abstrakte Eigenschaft Strings ein, mit der Einträge der String-Liste über ihre Position angesprochen werden können.

__property System::AnsiString Strings[int Index]

Beschreibung

Für den indizierten Zugriff auf einen String muß für die Eigenschaft Strings (der Nachkommen der Klasse TStrings) eine eigene Funktion bereitgestellt werden, wobei der erste String mit dem Indexwert 0, der zweite mit dem Wert 1 usw. anzusprechen ist.

Mit der Eigenschaft Strings wird auf einen String an einer bestimmten Position der Liste zugegriffen. Da es sich hier um eine Standardeigenschaft aller TStrings-Objekte handelt, kann der entsprechende Bezeichner (Strings) auch entfallen. So sind beispielsweise die beiden folgenden Programmzeilen zulässig und haben die gleiche Wirkung:

MeineStrings::Strings[0] := "Das ist der erste String";

MeineStrings[0] := "Das  ist der erste String";


TStrings::Text

TStrings	Siehe auch	Beispiel

Die Eigenschaft Text bezeichnet die String-Liste eines TStrings-Objekts. Die Besonderheit der Eigenschaft Text besteht darin, daß die Liste als ein ganzer String aufgefaßt wird, dessen Elemente durch Wagenrücklauf- und Zeilenvorschubzeichen voneinander getrennt sind.

__property System::AnsiString Text;

Beschreibung

Mit der Eigenschaft Text lassen sich alle Strings eines TStrings-Objekts als ein ganzer String ansprechen, dessen Elemente durch das Code-Paar für Wagenrücklauf (Carriage Return, CR) und Zeilenvorschub (Line Feed, LF) voneinander getrennt sind.

Bei einem Lesezugriff auf die Eigenschaft Text werden Strings zurückgegeben, die jeweils durch ein CR/LF-Paar getrennt sind. Enthält einer der Listen-Strings selbst dieses Code-Paar, dann liefert die Eigenschaft Count einen entsprechend höheren Wert für die Anzahl der Strings.

Bei einem Schreibzugriff wird der übergebene Text auf Basis der enthaltenen Codes für Wagenrücklauf oder Zeilenvorschub zerlegt. Das heißt, die Codes müssen bei einem Schreibzugriff auf die Eigenschaft Text nicht paarweise vorliegen.

Die hierin angelegte Mehrdeutigkeit läßt sich vermeiden, wenn man die Eigenschaft CommaText verwendet.

Hinweis

Die Eigenschaft Text verwendet für das Lesen die Eigenschaft Strings und bedient sich für die Wertzuweisung der Methode Add.


TStrings::Values

TStrings	Siehe auch

Enthält die String-Liste Einträge der Form “Bezeichner=Wert“, so gibt die Eigenschaft Values den Teil-String zurück, der den Wert enthält.

__property System::AnsiString Values[System::AnsiString Name];

Beschreibung

Enthält die String-Liste eines TStrings-Objekts Einträge in der Form “Bezeichner=Wert“, dann läßt sich mit der Eigenschaft Values auf den Teil-String zugreifen, der den Wert enthält. Enthält die Liste keine String-Einträge in dem erwarteten Format, oder entspricht keiner der String-Einträge dem Parameter Name, so gibt die Eigenschaft Values einen Leer-String zurück.

Strings mit diesem Format findet man gewöhnlich in INI-Dateien:

DisplayGrid=1

SnapToGrid=1

GridSizeX=8

GridSizeY=8

Das Format “Bezeichner=Wert“ gilt übrigens auch für die Strings der Eigenschaft Params einer Datenbank-Komponente (TDatabase).

Der Teil-String Name steht als Bezeichner auf der linken Seite des Gleichheitszeichens (=), der aktuelle Wert rechts davon. Zwischen dem Gleichheitszeichen und den beiden Teil-Strings sind keine Leerzeichen zulässig.

Hinweis

Die Eigenschaft Values verwendet für das Lesen der Werte die Eigenschaft Strings und bedient sich für die Wertzuweisung der Methode Insert.


Methoden von TStrings

TStrings	Alphabetisch

In TStrings

~TStrings

Add

AddObject

AddStrings

Append

Assign

BeginUpdate

Clear

Delete

EndUpdate

Equals

Exchange

GetText

IndexOf

IndexOfName

IndexOfObject

Insert

InsertObject

LoadFromFile

LoadFromStream

Move

SaveToFile

SaveToStream

SetText

TStrings

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TStrings

TStrings	Nach Objekten

~TStrings

AddObject

AddStrings

Add

Append

Assign

BeginUpdate

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

Clear

DefaultHandler

Delete

Dispatch

EndUpdate

Equals

Exchange

FieldAddress

FreeInstance

Free

GetText

IndexOfName

IndexOfObject

IndexOf

InheritsFrom

InitInstance

InsertObject

Insert

InstanceSize

LoadFromFile

LoadFromStream

MethodAddress

MethodName

Move

NewInstance

SaveToFile

SaveToStream

SetText

TStrings


TStrings::~TStrings

TStrings	Siehe auch

Der Destruktor ~TStrings gibt den Speicher frei, der für das TStrings-Objekt reserviert war. Rufen Sie ~TStrings nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TStrings automatisch aufgerufen wird.

__fastcall virtual ~TStrings(void);


TStrings::Add

TStrings	Siehe auch

Mit der Methode Add läßt sich ein String am Ende der String-Liste anfügen.

virtual int __fastcall Add(const System::AnsiString S);

Beschreibung

Mit Hilfe der Methode Add wird ein String am Listenende hinzugefügt. Die Methode gibt den Index des neuen Strings als Wert zurück.

Hinweis

Um Strings einzufügen, verwendet die Methode Add die Methode Insert.


TStrings::AddObject

TStrings	Siehe auch

Mit der Methode AddObject wird ein neuer String in die String-Liste eingetragen und mit einem Objekt verbunden.

virtual int __fastcall AddObject(const System::AnsiString S, System::TObject* AObject);

Beschreibung

Mit der Methode AddObject läßt sich der String-Liste ein String sowie dessen zugeordnetes Objekt hinzufügen. Die Methode gibt einen Index zurück, der die Position des neuen Strings und seines Objekts bezeichnet.

Hinweis

Die Methode AddObject verwendet die Methode Add, um der Liste einen String hinzuzufügen, bzw. die Eigenschaft Objects, um dem String ein Objekt zuzuordnen.


TStrings::AddStrings

TStrings	Siehe auch

Mit der Methode AddStrings wird eine Gruppe von String-Einträgen zu einer Liste hinzugefügt.

virtual void __fastcall AddStrings(TStrings* Strings);

Beschreibung

Mit der Methode AddStrings lassen sich die String-Einträge eines anderen TStrings-Objekts zu einer String-Liste hinzufügen. Wenn beide TStrings-Objekte Strings mit zugeordneten Objekten unterstützen, werden mit den Strings auch die zugehörigen Objekt-Referenzen übertragen.

Hinweis

Die Methode AddStrings verwendet die Methode Add, um Strings an eine Liste anzufügen. Die Zuordnung der Objekte erfolgt auf Basis der Eigenschaft Objects.

Methode Add, Methode AddObject, Methode Assign, Eigenschaft Count, Eigenschaft Objects


TStrings::Append

TStrings	Siehe auch

Die Methode Append fügt der String-Liste einen Eintrag hinzu. Der neue String wird im Parameter S übergeben.

void __fastcall Append(const System::AnsiString S);

Beschreibung

Die Methode Append unterscheidet sich von der Methode Add lediglich dadurch, daß sie keinen Wert zurückgibt. Append wird eingesetzt, wenn der Index des hinzugefügten Strings nicht benötigt wird, oder wenn der zurückgegebene Index für ein von TStrings abgeleitetes Objekt bedeutungslos wäre.

Beispielsweise kann ein Memo-Objekt einen Nachkommen von TStrings verwenden, um einen String mit Hilfe eines Index an einer bestimmten Listenposition einzufügen. Es ist jedoch nicht unbedingt erforderlich, daß der neue Eintrag weiterhin als Einzel-String ansprechbar ist. Ein Teil des Strings wird in der Folge möglicherweise dem vorhergehenden, ein anderer Teil dem folgenden String zugeordnet. Der Index, den die Methode Add zurückgibt, wäre in diesem Fall unwichtig.

Benötigt eine Funktion ein TGetStrProc-Objekt, sollte als Parameter nicht die Methode Add, sondern die Methode Append verwendet werden.


TStrings::Assign

TStrings	Siehe auch

Mit der Methode Assign lassen sich der String-Liste die Strings eines anderen Objekts zuweisen. Die Zuweisung umfaßt auch eventuell vorhandene Objekt-Referenzen dieser Strings.

virtual void __fastcall Assign(TPersistent* Source);

Beschreibung

Mit der Methode Assign wird einem TStrings-Objekt der Wert eines anderen Objekts zugewiesen. Ist das Quell-Objekt ebenfalls vom Typ TStrings, enthalten beide Objekte anschließend die gleiche Liste. Falls den String-Werten der Quelle Objekte zugeordnet sind, werden auch diese übernommen, wenn das Zielobjekt diese Eigenschaft unterstützt.

Wenn das mit dem Parameter Source bezeichnete Quellobjekt nicht vom Typ TStrings ist, übernimmt die geerbte Assign-Methode den Listenwert von einem beliebigen anderen Objekt, das in seiner AssignTo-Methode die Klasse TStrings unterstützt.


TStrings::BeginUpdate

TStrings	Siehe auch

Mit der Methode BeginUpdate wird ein TStrings-Objekt darüber informiert, daß eine Änderung der String-Liste im Gange ist.

void __fastcall BeginUpdate(void);

Beschreibung

Die Methode BeginUpdate wird automatisch von jeder Eigenschaft oder Methode aufgerufen, die Änderungen an der String-Liste vornimmt. Nach Abschluß der Änderungen ruft die jeweilige Eigenschaft oder Methode die Methode EndUpdate auf. Vor direkten Änderungen der String-Liste muß die Methode BeginUpdate, danach die Methode EndUpdate explizit aufgerufen werden. Dies gilt auch für die Implementierung neuer Eigenschaften oder Methoden, mit denen die Liste eines TStrings-Objekts geändert werden soll.

TStrings stellt lediglich die Information zur Verfügung, daß eine Änderung der String-Liste im Gange ist. Die Nachkommen von TStrings können diese Information verwenden, um bestimmte Aktionen auszulösen. So kann ein Steuerelement beispielsweise nach Abschluß der Änderungen veranlaßt werden, seine Bildschirmdarstellung neu aufzubauen.


TStrings::Clear

TStrings	Siehe auch

Mit Clear wird eine abstrakte Methode in TStrings eingeführt, die alle String-Einträge und eventuell damit verbundene Objekte aus der Liste löscht.

virtual void __fastcall Clear(void);

Beschreibung

Nachkommen von TStrings implementieren eine Clear-Methode, mit der sich alle String-Einträge der Liste löschen lassen. Hierbei werden auch eventuell vorhandene Objekt-Referenzen der Strings entfernt.


TStrings::Delete

TStrings	Siehe auch

Die Klasse TStrings führt Delete als abstrakte Methode ein, die einen bestimmten String aus der Liste löscht.

virtual void __fastcall Delete(int Index);

Beschreibung

Den Nachkommen von TStrings steht mit Delete eine Methode zur Verfügung, um String-Einträge aus der Liste zu entfernen. Ist dem String ein Objekt zugeordnet, so wird auch diese Referenz entfernt. Der Parameter Index bezeichnet die Position des Strings in der Liste, wobei der Wert 0 den ersten, der Wert 1 den zweiten String usw. indiziert.


TStrings::EndUpdate

TStrings	Siehe auch

Über die Methode EndUpdate kann ein TStrings-Objekt feststellen, wann Änderungen der String-Liste abgeschlossen sind.

void __fastcall EndUpdate(void);

Beschreibung

Die Methode EndUpdate wird automatisch von jeder Eigenschaft oder Methode aufgerufen, die Änderungen an der String-Liste vornimmt. Eine direkte Änderung der String-Liste wird mit dem Aufruf der Methode BeginUpdate eingeleitet und mit dem Aufruf von EndUpdate abgeschlossen. Bei der Implementierung neuer Eigenschaften oder Methoden, mit denen die Liste eines TStrings-Objekts geändert werden soll, muß vor der eigentlichen Änderung die Methode BeginUpdate und danach die Methode EndUpdate aufgerufen werden.

Die Klasse TStrings stellt lediglich die Information zur Verfügung, daß eine Änderung der String-Liste im Gange ist. Die Nachkommen von TStrings können diese Information verwenden, um bestimmte Aktionen auszulösen. So kann ein Steuerelement beispielsweise nach Abschluß der Änderungen veranlaßt werden, seine Bildschirmdarstellung neu aufzubauen.


TStrings::Equals

TStrings	Siehe auch

Mit der Methode Equals lassen sich die String-Listen zweier TStrings-Objekte miteinander vergleichen. Sind die Listen identisch, wird der Wert True zurückgegeben.

bool __fastcall Equals(TStrings* Strings);

Beschreibung

Mit der Methode Equals werden die Listen zweier TStrings-Objekte verglichen. Der Vergleich erfaßt nur die String-Einträge, jedoch nicht eventuelle Referenzen auf zugeordnete Objekte. Die Methode gibt den Wert True zurück, wenn beide Listen die gleiche Anzahl von String-Einträgen enthalten und die Strings beider Listen identisch sind. Die Methode gibt den Wert False zurück, wenn die Listen unterschiedlich lang sind, verschiedene Einträge enthalten oder wenn sich die Reihenfolge der Strings in beiden Listen unterscheidet.


TStrings::Exchange

TStrings	Siehe auch

Mit der Methode Exchange wird die Position zweier String-Einträge vertauscht.

virtual void __fastcall Exchange(int Index1, int Index2);

Beschreibung

Mit der Methode Exchange lassen sich die Strings einer Liste neu ordnen. Die Parameter Index1 und Index2 bestimmen, welche Strings ausgetauscht werden. Die Indizes beginnen mit dem Startwert 0, d.h. der erste Listen-String wird über den Indexwert 0, der zweite über den Wert 1 usw. angesprochen.

Wenn beiden Strings jeweils ein Objekt zugeordnet ist, so wird auch die Position dieser Objekte vertauscht.


TStrings::GetText

TStrings	Siehe auch

Die Methode GetText reserviert Speicher für einen Textpuffer und fällt ihn mit dem Wert der Eigenschaft Text.

virtual char * __fastcall GetText(void);

Beschreibung

Mit der Methode GetText wird ein dynamisch verwalteter Speicherbereich angelegt, der alle Einträge der String-Liste aufnimmt. Die einzelnen Strings sind durch Zeilenvorschub- und Wagenrücklaufzeichen voneinander getrennt. Es ist Sache des Programmierers, den belegten Speicherbereich später wieder freizugeben, wenn er nicht mehr benötigt wird.

Hinweis

Die Methode GetText verwendet für das Lesen der Strings die Eigenschaft Strings.


TStrings::IndexOf

TStrings	Siehe auch

Mit der Methode IndexOf läßt sich die Position eines bestimmten Strings in der Liste ermitteln.

virtual int __fastcall IndexOf(const System::AnsiString S);

Beschreibung

Die Methode IndexOf gibt die Listenposition zurück, an welcher der String S zum ersten Mal vorkommt. Der zurückgegebene Integer-Wert ist der Index des Strings mit dem Startwert 0, d.h., wenn die String-Konstante S dem ersten Listeneintrag entspricht, wird 0 zurückgegeben, stimmt sie mit dem zweiten Eintrag überein, ist der Rückgabewert 1 usw. Ist der gesuchte String nicht in der Liste enthalten, gibt die Methode den Wert -1 zurück.

Hinweis

Ist der gesuchte String mehrfach in der Liste enthalten, dann gibt die Methode die Position zurück, an welcher der String zum ersten Mal gefunden wird.


TStrings::IndexOfName

TStrings	Siehe auch

Mit der Methode IndexOfName läßt sich die Listenposition des ersten Strings ermitteln, der im Format “Bezeichner=Wert“ vorliegt und dessen Teil-String, der den Bezeichner enthält, mit der gesuchten String-Konstante übereinstimmt.

int __fastcall IndexOfName(const System::AnsiString Name);

Beschreibung

Enthält eine String-Liste Einträge der Form “Bezeichner=Wert“, so gibt die Methode IndexOfName die Position zurück, an welcher der Parameterwert von Name zum ersten Mal dem Teil-String entspricht, der den Bezeichner enthält. Der verwendete Index beginnt mit dem Startwert 0. Ist der gesuchte String nicht in der Liste enthalten, dann gibt die Methode den Wert -1 zurück.

Strings mit diesem Format finden sich normalerweise in INI-Dateien:

DisplayGrid=1

SnapToGrid=1

GridSizeX=8

GridSizeY=8

Das Format “Bezeichner=Wert“ gilt übrigens auch für die Strings der Eigenschaft Params einer Datenbank-Komponente (TDatabase).

Der Teil-String Name steht als Bezeichner auf der linken Seite des Gleichheitszeichens (=), der aktuelle Wert rechts davon. Leerzeichen zwischen dem Gleichheitszeichen und den beiden Teil-Strings sind nicht zulässig.

Hinweis

Ist der gesuchte String-Parameter in mehreren Einträgen enthalten, so gibt die Methode IndexOfName den Index der ersten Übereinstimmung zurück.


TStrings::IndexOfObject

TStrings	Siehe auch

Die Methode IndexOfObject gibt den Index des ersten Strings in der Liste zurück, dem ein bestimmtes Objekt zugeordnet ist.

int __fastcall IndexOfObject(System::TObject* AObject);

Beschreibung

Mit der Methode IndexOfObject läßt sich der Index des ersten Strings bestimmen, dem das mit AObject bezeichnete Objekt zugeordnet ist. Der Rückgabewert von IndexOfObject ist ein Index mit dem Startwert 0. Ist das gesuchte Objekt keinem der String-Einträge zugeordnet, gibt die Methode IndexOfObject den Wert -1 zurück.


TStrings::Insert

TStrings	Siehe auch

Die Klasse TStrings führt Insert als abstrakte Methode ein, mit der sich an einer bestimmten Position der String-Liste ein neuer Eintrag einfügen läßt.

virtual void __fastcall Insert(int Index, const System::AnsiString S);

Beschreibung

Nachkommen von TStrings können mit der Methode Insert den String S in eine Liste eintragen. Die Position des Strings in der Liste wird im Parameter Index angegeben. Der Index beginnt mit dem Startwert 0, d.h. der Index 0 plaziert den String an die erste Stelle der Liste, der Index 1 fügt ihn an der zweiten Listenposition ein usw.

Alle Methoden, mit denen sich die String-Liste erweitern läßt, verwenden dazu die Methode Insert.

Ist dem einzufügenden String ein Objekt zugeordnet, muß die Methode InsertObject verwendet werden.


TStrings::InsertObject

TStrings	Siehe auch

Die Methode InsertObject fügt an der vorgegebenen Position einen String in die Liste ein und ordnet diesem ein Objekt zu.

void __fastcall InsertObject(int Index, const System::AnsiString S, System::TObject* AObject);

Beschreibung

Mit Hilfe der Methode InsertObject läßt sich der String S an der Position Index in die Liste einfügen und dem Objekt AObject zuordnen. Hierbei definiert der Indexwert 0 die erste Listenposition, der Indexwert 1 die zweite Position usw.


TStrings::LoadFromFile

TStrings	Siehe auch

Die Methode LoadFromFile füllt die Liste mit Textzeilen aus einer angegebenen Datei.

virtual void __fastcall LoadFromFile(const System::AnsiString FileName);

Beschreibung

Durch den Aufruf der Methode LoadFromFile wird der Inhalt einer Textdatei in die Liste eines TStrings-Objekts geladen. Dabei wird jede Zeile der Textdatei, die mit einem Zeichen für Zeilenvorschub oder Wagenrücklauf endet, als String an die Liste angefügt. Der Name der Datei wird im Parameter FileName übergeben.

Hinweis

LoadFromFile verwendet die Methode Add, um die Liste aus einer Textdatei zu füllen.


TStrings::LoadFromStream

TStrings	Siehe auch

Die Methode LoadFromStream füllt die Liste mit Textzeilen, die aus einem Stream gelesen werden.

virtual void __fastcall LoadFromStream(TStream* Stream);

Beschreibung

Mit der Methode LoadFromStream läßt sich die String-Liste eines TStrings-Objekts mit Strings aus einem Stream belegen. Der aus dem Stream gelesene Text wird in einzelne Strings zerlegt, wobei Zeilenvorschub- oder Wagenrücklaufzeichen als Trennzeichen interpretiert werden. Die Methode LoadFromStream dient also dazu, den Wert der Eigenschaft Text zu lesen.

Handelt es sich bei dem Stream um einen Datei-Stream, dann führen die Methoden LoadFromStream und LoadFromFile zum gleichen Ergebnis. Ein Unterschied besteht jedoch darin, daß das Programm beim Einsatz von LoadFromStream den Stream zuerst erzeugen und später wieder freigeben muß.

Hinweis

Die Methode LoadFromStream verwendet die Methode Add, um die Strings aus dem Stream in die Liste aufzunehmen.


TStrings::Move

TStrings	Siehe auch

Die Methode Move verändert die Position eines String-Eintrags innerhalb der Liste.

virtual void __fastcall Move(int CurIndex, int NewIndex);

Beschreibung

Mit Hilfe der Methode Move wird der String-Eintrag an der Position CurIndex an die Listenposition NewIndex verschoben. Die Zählung der verwendeten Indizes beginnt mit dem Startwert 0. Die folgende Programmzeile verschiebt beispielsweise den ersten String-Eintrag auf die letzte Listenposition.

MyStringsObject->Move(0, MyStringsObject->Count - 1);

Ist dem betreffenden String ein Objekt zugeordnet, so bleibt diese Referenz auch an der neuen Position des Strings erhalten.


TStrings::SaveToFile

TStrings	Siehe auch

Mit der Methode SaveToFile werden die Einträge der String-Liste in der angegebenen Datei gespeichert.

virtual void __fastcall SaveToFile(const System::AnsiString FileName);

Beschreibung

Mit der Methode SaveToFile lassen sich die Einträge der String-Liste in der Datei speichern, die mit dem Parameter FileName angegeben wird. Hierbei wird jeder String als eigene Zeile in der Datei abgelegt.

Hinweis

Die Methode SaveToFile liest die String-Liste mit Hilfe der Methode Strings.


TStrings::SaveToStream

TStrings	Siehe auch

Die Methode SaveToStream schreibt den Wert der Eigenschaft Text in ein Stream-Objekt.

virtual void __fastcall SaveToStream(TStream* Stream);

Beschreibung

Mit der Methode SaveToStream werden die Einträge einer String-Liste in dem Stream gespeichert, der durch den entsprechenden Parameter bezeichnet wird. Als Trennzeichen wird dabei das Code-Paar CR/LF eingefügt (Wagenrücklauf, Zeilenvorschub). Handelt es sich bei dem Stream um einen Datei-Stream, so hat die Methode SaveToStream die gleiche Wirkung wie die Methode SaveToFile. Ein Unterschied besteht jedoch darin, daß das Programm beim Einsatz von SaveToStream den Stream zuerst erzeugen und später wieder freigeben muß.

Hinweis

Die Methode SaveToStream verwendet die Eigenschaft Strings, um die zu speichernden String-Einträge zu ermitteln.


TStrings::SetText

TStrings	Siehe auch

Die Methode SetText setzt den Wert der Eigenschaft Text.

virtual void __fastcall SetText(char * Text);

Beschreibung

SetText bewirkt, daß der Inhalt der Liste durch die Strings ersetzt wird, auf die der Parameter Text verweist. Die Strings werden einzeln in die Liste geschrieben, wobei Zeilenvorschub- oder Wagenrücklaufzeichen als Trennzeichen interpretiert werden.

Hinweis

Die Methode SetText verwendet die Methode Add für das Hinzufügen der Strings.


TStrings::TStrings

TStrings	Siehe auch

Der Konstruktor TStrings erzeugt ein neues TStrings-Objekt.

__fastcall TStrings(void);


Zugriff

Read-only


Hierarchie

TObject

TPersistent


TStrings Beispiel

TStrings


TStringStream

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/classes.hpp

TStringStream ist ein Streamobjekt, mit dem Sie zu Ein-/Ausgabezwecken auf Informationen zugreifen können, die als langer String gespeichert sind.

Beschreibung

Mit einem TStringStream-Objekt können Sie mit erweiterten Funktionen zur Ein-/Ausgabe Daten in Form eines langen Strings speichern. TStringStream dient als Zwischenobjekt, das Text speichern, aus einem anderen Speichermedium lesen und in ein anderes Speichermedium schreiben kann. Mit TStringStream können Sie Text bearbeiten, auf den Sie sonst viel umständlicher zugreifen müßten.


Eigenschaften von TStringStream

TStringStream	Alphabetisch	Legende

In TStringStream

DataString

Abgeleitet von TStream

Position

Size


Eigenschaften von TStringStream

TStringStream	Nach Objekten	Legende

DataString

Position

Size


TStringStream::DataString

TStringStream	Siehe auch

Mit der Eigenschaft DataString können Sie direkt auf den String zugreifen, in dem der vom TStringStream-Objekt repräsentierte Text gespeichert ist.

Beschreibung

Mit DataString können Sie auf den Text des Streams zugreifen. Der Text steht für die Daten, die mit Hilfe des String-Streams übertragen werden. Size ist die Anzahl der im String enthaltenen Bytes. Position bezeichnet die aktuelle Position in DataString.

Hinweis

DataString ist eine Nur-Lesen-Eigenschaft, mit der Sie den Inhalt des Strings ändern können. Anwendungen können DataString selbst jedoch nicht ändern.


Methoden von TStringStream

TStringStream	Alphabetisch

In TStringStream

~TStringStream

Read

ReadString

Seek

TStringStream

Write

WriteString

Abgeleitet von TStream

CopyFrom

ReadBuffer

ReadComponent

ReadComponentRes

ReadResHeader

WriteBuffer

WriteComponent

WriteComponentRes

WriteDescendent

WriteDescendentRes

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TStringStream

TStringStream	Nach Objekten

~TStringStream

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

CopyFrom

DefaultHandler

Dispatch

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance

ReadBuffer

ReadComponentRes

ReadComponent

ReadResHeader

ReadString

Read

Seek

TStringStream

WriteBuffer

WriteComponentRes

WriteComponent

WriteDescendentRes

WriteDescendent

WriteString

Write


TStringStream::~TStringStream

TStringStream	Siehe auch

Der Destruktor ~TStringStream gibt den Speicher frei, der für das TStringStream-Objekt reserviert war. Rufen Sie ~TStringStream nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TStringStream automatisch aufgerufen wird.


TStringStream::Read

TStringStream	Siehe auch

Die Methode Read liest maximal Count Bytes aus dem String-Stream und schreibt sie in Buffer. Die aktuelle Position im Stream wird um die Anzahl der gelesenen Bytes verschoben.

Beschreibung

Mit Read können Sie den Inhalt des Strings in einen Puffer lesen. Der Lesevorgang beginnt an der aktuellen Position. Zeigt Count über das Ende von DataString hinaus, werden nur die Zeichen bis zum Ende von DataString übertragen. Die aktuelle Position wird entsprechend verschoben. Ist der Rückgabewert kleiner als Count, wurde das Ende des Strings erreicht.

Die Methoden ReadBuffer und ReadComponent verwenden Read für den eigentlichen Lesevorgang.

Hinweis

Read betrachtet Count als obere Grenze. Die Methode ReadBuffer erzeugt im Gegensatz dazu eine Exception, falls nicht die entsprechende Anzahl von Bytes gelesen werden kann.


TStringStream::ReadString

TStringStream	Siehe auch

Die Methode ReadString gibt einen String zurück, der aus maximal Count Bytes besteht. Der Lesevorgang beginnt an der aktuellen Position im String-Stream. Die aktuelle Position im Stream wird um die Anzahl der gelesenen Bytes verschoben.

Beschreibung

Mit ReadString können Sie den Inhalt des Strings in einen String lesen. Der Lesevorgang beginnt an der aktuellen Position. Zeigt Count über das Ende von DataString hinaus, enthält der zurückgegebene String nur die Zeichen bis zum Ende von DataString. Die aktuelle Position wird entsprechend verschoben. Ist der Rückgabewert kleiner als Count, wurde das Ende des Strings erreicht.

Hinweis

ReadString hat dieselbe Funktion wie Read. Der einzige Unterschied ist, daß ReadString in einen String und nicht in einen Puffer liest.


TStringStream::Seek

TStringStream	Siehe auch

Mit der Methode Seek können Sie die aktuelle Position im Stream relativ zu dem in Origin festgelegten Ausgangspunkt um Offset Bytes verschieben.

Beschreibung

Mit Seek können Sie die aktuelle Position im String-Stream um den angegebenen Offset verschieben. Mit dieser Methode kann eine Anwendung einen bestimmten Teil von DataString lesen oder schreiben.

Ist Offset eine negative Zahl, erfolgt die Suche rückwärts vom angegeben Ausgangspunkt . Die folgende Tabelle enthält die verschiedenen Werte von Origin und ihre Auswirkung auf die Suche.

Wert	Bedeutung

soFromBeginning	Ausgangspunkt für Offset ist der Anfang von DataString. Seek positioniert auf Offset. Offset muß größer oder gleich Null sein.

soFromCurrent	Ausgangspunkt für Offset ist die aktuelle Position. Seek positioniert auf Position + Offset.

soFromEnd	Ausgangspunkt für Offset ist das Ende von DataString. Offset muß kleiner oder gleich Null sein, um auf eine Position vor dem Ende von DataString zu verweisen.

Seek gibt den neuen Wert der Eigenschaft Position zurück.


TStringStream::TStringStream

TStringStream	Siehe auch

Die Methode TStringStream erzeugt eine Instanz von TStringStream.

Beschreibung

Mit TStringStream können Sie ein TStringStream-Objekt instantiieren. Die Methode initialisiert die Eigenschaft DataString mit dem Parameter AString.


TStringStream::Write

TStringStream	Siehe auch

Die Methode Write schreibt Count Bytes aus Buffer in den String-Stream an die aktuelle Position und aktualisiert diese.

Beschreibung

Mit Write können Sie beginnend an der aktuellen Position das Ende des Strings durch die ersten Count Bytes von Buffer ersetzen. Write aktualisiert die Eigenschaft Size mit der neuen Länge von DataString.

Write schreibt immer Count Bytes aus dem Puffer, auch wenn darin ein NULL-Zeichen enthalten ist. Somit sind Write und WriteBuffer äquivalent.


TStringStream::WriteString

TStringStream	Siehe auch

Die Methode WriteString schreibt maximal Count Bytes von AString an die aktuelle Position des String-Streams und führt die aktuelle Position entsprechend nach.

Beschreibung

Mit WriteString können Sie beginnend an der aktuellen Position das Ende des Strings durch die ersten Count Bytes von AString ersetzen. Enthält AString weniger als Count Bytes, erfolgt der Schreibvorgang nur bis zum Ende von AString. Write aktualisiert die Eigenschaft Size mit der neuen Länge von DataString.


Zugriff

Read-only


Hierarchie

TObject

TStream


TStringStream Beispiel

TStringStream


TStringList

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/classes.hpp

TStringList verwaltet eine Liste, die Strings enthält.

Beschreibung

TStringList-Objekte dienen zum Speichern und Verwalten von String-Listen. TStringList implementiert die von TStrings eingeführten abstrakten Eigenschaften und Methoden und führt selbst neue Eigenschaften, Ereignisse und Methoden ein, die

•	die in der Liste enthaltenen Strings sortieren.

•	doppelte Strings aus sortierten Listen entfernen.

•	auf Änderungen des Listeninhalts reagieren.


Eigenschaften von TStringList

TStringList	Alphabetisch	Legende

In TStringList

Count

Duplicates

Objects

Sorted

Strings

Abgeleitet von TStrings

CommaText

Names

Text

Values


Eigenschaften von TStringList

TStringList	Nach Objekten	Legende

CommaText

Count

Duplicates

Names

Objects

Sorted

Strings

Text

Values


TStringList::Count

TStringList	Siehe auch

Die Eigenschaft Count gibt die Anzahl der Strings in der Liste an.

Beschreibung

Mit Count können Sie alle Strings in der Liste durchlaufen oder die Position eines Strings relativ zum letzten String in der Liste ermitteln.


TStringList::Duplicates

TStringList	Siehe auch

Die Eigenschaft Duplicates legt fest, ob eine sortierte Liste String-Duplikate akzeptiert.

__property TDuplicates Duplicates;

Beschreibung

Mit Duplicates können Sie festlegen, welche Aktion ausgeführt werden soll, wenn ein String mehrfach zu einer sortierten Liste hinzugefügt wird. Die Eigenschaft Duplicates kann folgende Werte annehmen:

Wert	Bedeutung

dupIgnore	Der Versuch, der sortierten Liste ein String-Duplikat hinzuzufügen, wird ignoriert.

dupError	Der Versuch, der sortierten Liste ein String-Duplikat hinzuzufügen, führt zu einer EListError-Exception.

dupAccept	Doppelte Strings in der sortierten Liste sind erlaubt.

Setzen Sie Duplicates, bevor Sie der Liste Strings hinzufügen. Wenn Sie Duplicates auf dupIgnore oder dupError setzen, hat das keine Auswirkungen auf doppelte Strings, die bereits in der Liste enthalten sind.

Hinweis

Duplicates hat keinerlei Auswirkungen, wenn die Liste nicht sortiert ist.


TStringList::Objects

TStringList	Siehe auch

Die Eigenschaft Objects bezeichnet eine Menge mit Objekten, von denen jedes mit einem String in der Eigenschaft Strings verknüpft ist.

Beschreibung

Um ein Objekt mit einem vorhandenen String zu verknüpfen, weisen Sie der Eigenschaft Objects den Index zu, den auch der String in der Eigenschaft Strings hat. Sie können ermitteln, welches Objekt mit einem String verknüpft ist, indem Sie die Eigenschaft Objects unter Angabe des String-Index abfragen. Index gibt die Position des mit dem Objekt verknüpften Strings an, wobei 0 den ersten String bezeichnet, 1 den zweiten usw. Mit der Methode IndexOf läßt sich der Index des Strings ermitteln.

Mit Objects können Sie beispielsweise Bitmap-Objekte mit den Strings der Liste verbinden. Die Anwendung kann dann sehr schnell ermitteln, welche Bitmaps neben den Strings in einem Listenfeld angezeigt bzw. gezeichnet werden sollen, wenn der String in einem Steuerelement ausgewählt wird.


TStringList::Sorted

TStringList	Siehe auch	Beispiel

Die Eigenschaft Sorted legt fest, ob die Strings in der Liste automatisch sortiert werden sollen.

__property bool Sorted;

Beschreibung

Setzen Sie Sorted auf True, wenn die Strings in der Liste automatisch in aufsteigender Reihenfolge sortiert werden sollen. Wenn Sie Sorted auf False setzen, bleiben die Strings an der Position, an der sie eingefügt wurden. In diesem Fall können die Strings in der Liste jederzeit durch einen Aufruf der Methode Sort in aufsteigender Reihenfolge sortiert werden.

Wenn Sorted True ist, dürfen Sie mit der Methode Insert keine Strings in die Liste einfügen. Verwenden Sie statt dessen die Methode Add, die die neuen Strings an der entsprechenden Position einfügt. Wenn Sorted False ist, können Sie Strings mit der Methode Insert an einer beliebigen Position in die Liste einfügen oder mit Add an das Ende der Liste anhängen.


TStringList::Strings

TStringList	Siehe auch

Die Eigenschaft Strings stellt die String-Liste dar, deren Index bei 0 beginnt.

Beschreibung

Mit Strings können Sie einen String an einer bestimmten Position lesen oder ändern. Index gibt die Position des Strings an, wobei 0 den ersten String, 1 den zweiten usw. bezeichnet. Mit der Methode IndexOf läßt sich ein bestimmter String in der Liste ermitteln.

Strings stellt die vorgegebene Eigenschaft von TStringList-Objekten dar. Der Bezeichner Strings braucht beim Zugiff auf diese Eigenschaft nicht angegeben zu werden.


Ereignisse von TStringList

TStringList	Alphabetisch

In TStringList

OnChange

OnChanging


Ereignisse von TStringList

TStringList	Nach Objekten

OnChange

OnChanging


TStringList::OnChange

TStringList	Siehe auch

Das Ereignis OnChange tritt sofort nach einer Änderung der String-Liste ein.

__property TNotifyEvent OnChange;

Beschreibung

Mit einer Ereignisbehandlungsroutine für OnChange können Sie auf Änderungen an der String-Liste reagieren. Wenn die String-Liste beispielsweise mit einem Steuerelement verknüpft ist, kann die Ereignisbehandlungsroutine das Steuerelement auffordern, sich selbst neu zu zeichnen, sobald sich der Inhalt der Liste ändert.

Die folgenden Ereignisse treten ein, wenn Strings eingefügt, gelöscht, verschoben oder geändert werden:

1	Vor der Änderung tritt das Ereignis OnChanging ein.

2	Die Strings werden hinzugefügt, gelöscht, verschoben oder geändert.

3	Das Ereignis OnChange tritt ein.


TStringList::OnChanging

TStringList	Siehe auch

OnChanging tritt unmittelbar vor einer Änderung der String-Liste ein.

__property TNotifyEvent OnChanging;

Beschreibung

Mit einer Ereignisbehandlungsroutine für OnChanging können Sie auf Änderungen an der Liste reagieren. Wenn die String-Liste beispielsweise mit einem Steuerelement verknüpft ist, kann die Ereignisbehandlungsroutine das Steuerelement auffordern, sich nicht neu zu zeichnen, bevor nicht nach der Änderung das Ereignis OnChange eingetreten ist.

Die folgenden Ereignisse treten ein, wenn Strings eingefügt, gelöscht, verschoben oder geändert werden.

1	Vor der Änderung tritt das Ereignis OnChanging ein.

2	Die Strings werden hinzugefügt, gelöscht, verschoben oder geändert.

3	Das Ereignis OnChange tritt ein.


Methoden von TStringList

TStringList	Alphabetisch

In TStringList

~TStringList

Add

Clear

Delete

Exchange

Find

IndexOf

Insert

Sort

TStringList

Abgeleitet von TStrings

AddObject

AddStrings

Append

Assign

BeginUpdate

EndUpdate

Equals

GetText

IndexOfName

IndexOfObject

InsertObject

LoadFromFile

LoadFromStream

Move

SaveToFile

SaveToStream

SetText

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TStringList

TStringList	Nach Objekten

~TStringList

AddObject

AddStrings

Add

Append

Assign

BeginUpdate

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

Clear

DefaultHandler

Delete

Dispatch

EndUpdate

Equals

Exchange

FieldAddress

Find

FreeInstance

Free

GetText

IndexOfName

IndexOfObject

IndexOf

InheritsFrom

InitInstance

InsertObject

Insert

InstanceSize

LoadFromFile

LoadFromStream

MethodAddress

MethodName

Move

NewInstance

SaveToFile

SaveToStream

SetText

Sort

TStringList


TStringList::~TStringList

TStringList	Siehe auch

Der Destruktor ~TStringList gibt das TStringList-Objekt frei.

__fastcall virtual ~TStringList(void);

Beschreibung

Rufen Sie ~TStringList nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TStringList automatisch aufgerufen wird.

~TStringList gibt den Speicher frei, der für die Liste der Strings und Objektreferenzen reserviert war und ruft danach den übergeordneten Destruktor auf.


TStringList::Add

TStringList	Siehe auch

Die Methode Add fügt der Liste einen neuen String hinzu.

virtual int __fastcall Add(const System::AnsiString S);

Beschreibung

Rufen Sie Add auf, um der Liste den String S hinzuzufügen. Bei einer sortierten Liste wird der String entsprechend der Sortierreihenfolge eingefügt. Wenn die Liste nicht sortiert ist, wird S an das Ende der Liste angehängt. Add gibt die Position des Eintrags in der Liste zurück, wobei der erste Eintrag den Index 0 hat.

Hinweis

Bei sortierten Listen verursacht Add eine EListError-Exception, wenn der String S bereits in der Liste existiert und Duplicates auf dupError gesetzt ist. Hat Duplicates den Wert dupIgnore, zeigt der Versuch, einen doppelten String in die sortierte Liste einzufügen, keinerlei Auswirkung.


TStringList::Clear

TStringList	Siehe auch

Die Methode Clear löscht alle Strings aus der Liste.

virtual void __fastcall Clear(void);

Beschreibung

Rufen Sie Clear auf, wenn Sie alle Strings aus der Liste löschen wollen. Dabei werden auch alle Referenzen auf verbundene Objekte entfernt.


TStringList::Delete

TStringList	Siehe auch

Die Methode Delete entfernt den im Parameter Index angegebenen String.

virtual void __fastcall Delete(int Index);

Rufen Sie Delete auf, wenn Sie einen String aus der Liste löschen wollen. Ist mit dem String ein Objekt verbunden, wird zugleich die Referenz auf das Objekt entfernt. Index gibt die Position des Strings an, wobei 0 den ersten String bezeichnet, 1 den zweiten usw.


TStringList::Exchange

TStringList	Siehe auch

Die Methode Exchange tauscht die Position von zwei Strings in der Liste aus.

virtual void __fastcall Exchange(int Index1, int Index2);

Beschreibung

Mit Exchange können Sie die Strings in der Liste neu anordnen. Die Strings werden über Index-Werte in den Parametern Index1 und Index2 angegeben. Die Indizes basieren auf 0, d.h. der erste String in der Liste hat den Wert 0, der zweite 1 usw.

Wenn mit einem der Strings ein Objekt verbunden ist, ändert Exchange auch den Index des betreffenden Objekts.

Hinweis

In einer sortierten Liste sollten Sie Exchange nur dann aufrufen, wenn Sie zwei identische Strings mit unterschiedlichen verknüpften Objekten austauschen wollen. Exchange überprüft nicht, ob eine Liste sortiert ist, und kann deshalb die Sortierreihenfolge einer sortierten Liste zerstören.


TStringList::Find

TStringList	Siehe auch

Die Methode Find sucht in einer sortierten Liste den Index eines Strings und gibt an, ob bereits ein String mit diesem Wert vorhanden ist.

virtual bool __fastcall Find(const System::AnsiString S, int &Index);

Beschreibung

Mit Find können Sie ermitteln, an welcher Position einer sortierten Liste der String S eingefügt werden soll. Ist der String S in der Liste bereits vorhanden, gibt Find True zurück, andernfalls False. Die Position, an der S eingefügt werden soll, wird im Parameter Index angegeben. Der Index basiert auf 0, d.h. der erste Eintrag hat den Index 0, der zweite 1 usw.

Hinweis

Setzen Sie Find nur bei sortierten Listen ein. Für unsortierte Listen steht Ihnen die Methode IndexOf zur Verfügung.


TStringList::IndexOf

TStringList	Siehe auch

Die Methode IndexOf gibt die Position eines Strings in der Liste zurück.

virtual int __fastcall IndexOf(const System::AnsiString S);

Beschreibung

Mit IndexOf können Sie das erste Auftreten des Strings S ermitteln. IndexOf gibt den auf Null basierenden Index des Strings zurück. Wenn S also mit dem ersten String in der Liste übereinstimmt, liefert IndexOf 0 zurück, beim zweiten String 1 usw. Ist der String nicht vorhanden, gibt IndexOf -1 zurück.


TStringList::Insert

TStringList	Siehe auch

Die Methode Insert fügt an der mit Index angegebenen Position einen String in die Liste ein.

virtual void __fastcall Insert(int Index, const System::AnsiString S);

Beschreibung

Mit Insert können Sie der Liste den String S an der mit Index bezeichneten Position hinzufügen. Hat Index den Wert 0, wird der String am Anfang der Liste eingefügt. Wenn Index 1 ist, wird der String an der zweiten Position in die Liste eingefügt usw.

Verwenden Sie die Methode InsertObject, wenn der String mit einem Objekt verbunden ist.

Hinweis

Bei einer sortierten Liste verursacht der Aufruf von Insert oder InsertObject eine EListError-Exception. Verwenden Sie deshalb bei sortierten Listen Add oder AddObject.


TStringList::Sort

TStringList	Siehe auch

Die Methode Sort sortiert die Strings der Liste in aufsteigender Reihenfolge.

virtual void __fastcall Sort(void);

Beschreibung

Mit Sort können Sie die Strings einer Liste sortieren, deren Eigenschaft Sorted auf False gesetzt ist. String-Listen, bei denen die Eigenschaft Sorted True ist, werden automatisch sortiert.


TStringList::TStringList

TStringList	Siehe auch

TStringList erzeugt ein neues TStringList-Objekt.

__fastcall TStringList(void);


Zugriff

Read-only


Hierarchie

TObject

TPersistent

TStrings


TStringList Beispiel

TStringList


TStringField

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/: dbtables.hpp

Ein TStringField-Objekt repräsentiert ein String-Feld in einer Datenmenge.

Beschreibung

Der Wert eines String-Feldes wird physikalisch als Folge von maximal 8192 Zeichen gespeichert. In String-Feldern wird normalerweise Text gespeichert, beispielsweise Namen und Adressen.

Mit Hilfe der Eigenschaften von TStringField können Strings in andere Datentypen umgewandelt und Konvertierungen zwischen verschiedenen Sprachtreibern vorgenommen werden. Als Nachkomme von TField erbt TStringField viele Eigenschaften, Methoden und Ereignisse, mit denen Werte und Eigenschaften von Datenbankfeldern bearbeitet werden können.


Eigenschaften von TStringField

TStringField	Alphabetisch	Legende

In TStringField

AsBoolean

AsDateTime

AsFloat

AsInteger

AsString

Transliterate

Value

Abgeleitet von TField

Alignment

AsCurrency

AttributeSet

BDECalcField

Calculated

CanModify

DataSet

DataSize

DataType

DisplayLabel

DisplayName

DisplayText

DisplayWidth

EditMask

FieldKind

FieldName

FieldNo

Index

IsIndexField

IsNull

KeyFields

Lookup

LookupDataSet

LookupKeyFields

LookupResultField

NewValue

OldValue

ReadOnly

Required

Size

Text

Visible

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Name

Owner

Tag


Eigenschaften von TStringField

TStringField	Nach Objekten	Legende

Alignment

AsBoolean

AsCurrency

AsDateTime

AsFloat

AsInteger

AsString

AttributeSet

BDECalcField

Calculated

CanModify

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

DataSet

DataSize

DataType

DesignInfo

DisplayLabel

DisplayName

DisplayText

DisplayWidth

EditMask

FieldKind

FieldName

FieldNo

Index

IsIndexField

IsNull

KeyFields

LookupDataSet

LookupKeyFields

LookupResultField

Lookup

Name

NewValue

OldValue

Owner

ReadOnly

Required

Size

Tag

Text

Transliterate

Value

Visible


TStringField::AsBoolean

TStringField	Siehe auch

Die Eigenschaft AsBoolean wandelt den Wert des Feldes in einen booleschen Wert um und umgekehrt.

Beschreibung

Mit der Eigenschaft AsBoolean können Sie

•	einer booleschen Variable den Wert des String-Feldes zuweisen.

•	dem String-Feld einen booleschen Wert zuweisen.

AsBoolean gibt True zurück, wenn der Text des Feldes mit den Buchstaben Y, y, T oder t (für Yes oder True) beginnt, andernfalls False. Wenn Sie mit AsBoolean einem TStringField-Objekt einen Wert zuweisen, ist das Resultat entweder T oder F.


TStringField::AsDateTime

TStringField	Siehe auch

Die Eigenschaft AsDateTime wandelt den Wert des Feldes in einen Datums-/Zeitwert um oder umgekehrt.

Beschreibung

Mit dieser Eigenschaft können Sie

•	einem TDateTime-Wert den Wert des String-Feldes zuweisen.

•	dem String-Feld einen TDateTime-Wert zuweisen.

Ein Lesezugriff auf AsDateTime wandelt den Wert des Feldes mit Hilfe der Funktion StrToDateTime in einen Datums- und Zeitwert um. Ein Schreibzugriff wandelt den Datums- und Zeitwert mit Hilfe der Funktion DateTimeToStr in einen String um.


TStringField::AsFloat

TStringField	Siehe auch

Die Eigenschaft AsFloat wandelt den Wert des Feldes in eine Gleitkommazahl um oder umgekehrt.

Beschreibung

Mit dieser Eigenschaft können Sie

•	einem Gleitkommawert den Wert des String-Feldes zuweisen.

•	dem String-Feld einen Gleitkommawert zuweisen.

Der folgende Code weist beispielsweise einem String-Feld einen Gleitkommawert zu:

MeinStringFeld::AsFloat := 7.345;

Mit folgender Anweisung wird einem Gleitkommawert der Wert eines String-Feldes zugewiesen:

FloatVariable := MeinStringFeld::AsFloat;

Ein Lesezugriff auf AsFloat wandelt den Wert des Feldes mit Hilfe der Funktion StrToFloat in einen Gleitkommawert um. Ein Schreibzugriff wandelt den Gleitkommawert mit Hilfe der Funktion FloatToStr in einen String um.


TStringField::AsInteger

TStringField	Siehe auch

Die Eigenschaft AsInteger wandelt den Wert des Feldes in eine Ganzzahl um oder umgekehrt.

Beschreibung

Mit dieser Eigenschaft können Sie

•	einer Ganzzahl den Wert des String-Feldes zuweisen.

•	dem String-Feld eine Ganzzahl zuweisen.

Der folgende Code weist beispielsweise einem String-Feld eine Ganzzahl zu:

MeinStringFeld.AsInteger := 12;

Mit folgender Anweisung wird einer Ganzzahl der Wert eines String-Feldes zugewiesen:

Integervariable := MeinStringFeld.AsInteger;

Ein Lesezugriff auf AsInteger wandelt den Wert des Feldes mit Hilfe der Funktion StrToInt in eine Ganzzahl um. Ein Schreibzugriff wandelt die Ganzzahl mit Hilfe der Funktion IntToStr in einen String um.


TStringField::AsString

TStringField	Siehe auch

Mit der Eigenschaft AsString können Sie den Wert des Feldes lesen oder ihn zuweisen.

Beschreibung

String-Werte brauchen nicht umgewandelt zu werden, da das ursprüngliche Format eines String-Feldes ein String ist. Bei String-Feldern sind die Eigenschaften AsString und Value identisch. AsString stellt eine einheitliche Schnittstelle dar, die es Anwendungen ermöglicht, bei allgemeinen Feldkomponenten mit String-Werten zu arbeiten, wenn das interne Format der Daten unbekannt ist.

Wenn der Eigenschaft AsString ein Wert zugewiesen wird, wandelt TStringField den betreffenden String unter Verwendung des der Datenmenge zugeordneten Sprachtreibers aus dem ANSI-Zeichensatz um, vorausgesetzt, die Eigenschaft Transliterate ist True. Strings, die die in der Eigenschaft Size festgelegte Anzahl von Zeichen überschreiten, werden bei der Zuweisung abgeschnitten.


TStringField::Transliterate

TStringField	Siehe auch

Die Eigenschaft Transliterate legt fest, ob der Wert des String-Feldes vom ANSI-Zeichensatz in den Zeichensatz der Datenmenge oder umgekehrt umgewandelt werden soll, wenn Daten in die physikalischen Datenbanktabellen geschrieben oder aus ihnen gelesen werden.

__property bool Transliterate;

Beschreibung

Verwenden Sie die Eigenschaft Transliterate, wenn die durch die Datenmenge bezeichnete physikalische Datenbanktabelle keinen ANSI-Sprachtreiber verwendet und die Daten möglicherweise ASCII-Sonderzeichen enthalten.

Wenn Transliterate den Wert True hat, wird bei der Zuweisung eines Wertes an das String-Feld die Funktion AnsiToNative aufgerufen, die die ANSI-Zeichen in den von der Datenmenge verwendeten Zeichensatz übersetzt. Umgekehrt wird beim Lesen eines Wertes die Funktion NativeToAnsi aufgerufen, die die Zeichen aus der Datenbanktabelle in den ANSI-Zeichensatz übersetzt.


TStringField::Value

TStringField	Siehe auch

Die Eigenschaft Value repräsentiert die aktuellen Daten im String-Feld.

__property System::AnsiString Value;

Beschreibung

Mit Hilfe dieser Eigenschaft können Sie zur Laufzeit Daten in eine String-Feld-Komponente schreiben oder aus ihr lesen. Die Eigenschaften Value und AsString sind identisch. Verwenden Sie Value, wenn Sie wissen, daß es sich bei der Feldkomponente um ein String-Feld handelt. Verwenden Sie AsString, wenn Sie mit einer generischen Feldkomponente arbeiten.

Wenn der Eigenschaft Value ein Wert zugewiesen wird, wandelt TStringField den betreffenden String unter Verwendung des der Datenmenge zugeordneten Sprachtreibers aus dem ANSI-Zeichensatz um, vorausgesetzt, die Eigenschaft Transliterate ist True. Strings, die die in der Eigenschaft Size festgelegte Anzahl von Zeichen überschreiten, werden bei der Zuweisung abgeschnitten.


Ereignisse von TStringField

TStringField	Alphabetisch	Legende

Abgeleitet von TField

OnChange

OnGetText

OnSetText

OnValidate


Ereignisse von TStringField

TStringField	Nach Objekten	Legende

OnChange

OnGetText

OnSetText

OnValidate


Methoden von TStringField

TStringField	Alphabetisch

In TStringField

~TStringField

TStringField

Abgeleitet von TField

Assign

AssignValue

Clear

FocusControl

GetData

IsValidChar

SetData

SetFieldType

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TStringField

TStringField	Nach Objekten

~TStringField

Assign

AssignValue

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

Clear

DefaultHandler

DestroyComponents

Destroying

Dispatch

FieldAddress

FindComponent

FocusControl

FreeInstance

FreeNotification

Free

GetData

GetParentComponent

HasParent

InheritsFrom

InitInstance

InsertComponent

InstanceSize

IsValidChar

MethodAddress

MethodName

NewInstance

RemoveComponent

SetData

SetFieldType

TStringField


TStringField::~TStringField

TStringField

Der Destruktor ~TStringField gibt den Speicher frei, der für das TStringField-Objekt reserviert war. Rufen Sie ~TStringField nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TStringField automatisch aufgerufen wird.

__fastcall virtual ~TStringField(void);


TStringField::TStringField

TStringField	Siehe auch

Die Methode TStringField erzeugt eine Instanz eines TStringField-Objekts.

__fastcall virtual TStringField(Classes::TComponent* AOwner);

Beschreibung

Es ist nur selten erforderlich, TStringField direkt aufzurufen, da für alle String-Felder einer Datenmenge automatisch eine String-Feld-Komponente instantiiert wird.

Nachdem der geerbte Konstruktor aufgerufen wurde, setzt TStringField die folgenden Eigenschaften:

•	DataType auf ftString.

•	Size auf 20.

•	Transliterate auf True.


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TField


TStringField Beispiel

TStringField


TStatusPanel

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/comctrls.hpp

TStatusPanel repräsentiert eine bestimmte Tafel in einer Statusleiste.

Beschreibung

Jedes TStatusBar-Objekt verwaltet eine Kollektion von TStatusPanel-Objekten in einem TStatusPanel-Objekt.


Eigenschaften von TStatusPanel

TStatusPanel	Alphabetisch	Legende

In TStatusPanel

Alignment

Bevel

Style

Text

Width

Abgeleitet von TCollectionItem

Collection

Index


Eigenschaften von TStatusPanel

TStatusPanel	Nach Objekten	Legende

Alignment

Bevel

Collection

Index

Style

Text

Width


TStatusPanel::Alignment

TStatusPanel	Siehe auch	Beispiel

Diese Eigenschaft legt fest, wie der Text innerhalb einer Statusleistentafel ausgerichtet wird.

__property Classes::TAlignment Alignment;

Beschreibung

Folgende Werte sind möglich:

Wert	Bedeutung

taLeftJustify	Der Text wird am linken Rand der Tafel ausgerichtet.

taCenter	Der Text wird auf der Tafel zentriert.

taRightJustify	Der Text wird am rechten Rand der Tafel ausgerichtet.

Hinweis

Wenn die Statusleiste über einen Griff zur Größenänderung verfügt, verdeckt dieser teilweise den Text in der am weitesten rechts liegenden Tafel, wenn deren Eigenschaft Alignment auf taRightJustify gesetzt ist.


TStatusPanel::Bevel

TStatusPanel	Siehe auch

Diese Eigenschaft bestimmt den Stil des Tafelrahmens.

__property TStatusPanelBevel Bevel;

Beschreibung

Für Bevel sind folgende Werte möglich:

Wert	Bedeutung

pbNone	Die Tafel hat keinen abgeschrägten Rahmen und erscheint flach.

pbLowered	Der Rahmen simuliert eine Vertiefung der Tafel in die Bildschirmfläche.

pbRaised	Der Rahmen simuliert eine Erhebung der Tafel über die Bildschirmfläche.


TStatusPanel::Style

TStatusPanel	Siehe auch

Diese Eigenschaft legt fest, wie der Text einer Tafel in der Statusleiste dargestellt wird.

__property TStatusPanelStyle Style;

Beschreibung

Wenn Style den Vorgabewert psText besitzt, wird der in der Eigenschaft Text enthaltene String in der Statusleiste angezeigt. Die Ausrichtung hängt dabei von der Eigenschaft Alignment ab. Die verwendete Schrift ist in der Eigenschaft Font der Statusleiste festgelegt.

Wenn Style den Wert psOwnerDraw besitzt, steuert der Code einer Ereignisbehandlungsroutines für TStatusBar.OnDrawPanel zur Laufzeit den Inhalt der Tafel.


TStatusPanel::Text

TStatusPanel	Beispiel

Diese Eigenschaft enthält den Text, der auf einer Tafel angezeigt wird.

__property System::AnsiString Text;

Beschreibung

Wenn die Eigenschaft Style den Wert psText hat, wird der in der Eigenschaft Text enthaltene String in der Statusleiste angezeigt.


TStatusPanel::Width

TStatusPanel	Beispiel

Die Breite der Statusleistentafel.

__property int Width;

Beschreibung

Die Eigenschaft Width bestimmt die horizontale Ausdehnung der Statusleistentafel. Als Maßeinheit gelten Pixel.


Methoden von TStatusPanel

TStatusPanel	Alphabetisch

In TStatusPanel

~TStatusPanel

Assign

TStatusPanel

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TStatusPanel

TStatusPanel	Nach Objekten

~TStatusPanel

Assign

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance

TStatusPanel


TStatusPanel::~TStatusPanel

TStatusPanel

Der Destruktor ~TStatusPanel gibt den Speicher frei, der für das TStatusPanel-Objekt reserviert war. Rufen Sie ~TStatusPanel nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TStatusPanel automatisch aufgerufen wird.

__fastcall virtual ~TStatusPanel(void);


TStatusPanel::Assign

TStatusPanel	Siehe auch

Der Inhalt einer Statusleistentafel wird in eine neue kopiert.

virtual void __fastcall Assign(Classes::TPersistent* Source);

Beschreibung

Assign erzeugt eine neue Statusleistentafel. Die Werte der Eigenschaften Alignment, Bevel, Style, Text und Width stimmen dabei mit denen des ursprünglichen Objekts überein.


TStatusPanel::TStatusPanel

TStatusPanel	Siehe auch

Mit dieser Methode wird eine Statusleistentafel erzeugt und initialisiert.

__fastcall virtual TStatusPanel(Classes::TCollection* Collection);

Beschreibung

TStatusPanel sollte als Argument eine Instanz von TStatusPanels entgegennehmen.


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TCollectionItem


TStatusPanel Beispiel

TStatusPanel


TStatusPanels

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/comctrls.hpp

TStatusPanels ist ein Container für TStatusPanel-Objekte.

Beschreibung

TStatusPanels enthält eine Kollektion von TStatusPanel-Objekten in einem TStatusBar-Objekt. TStatusPanels verwaltet in seinem Array Items einen Index der Statusleistentafeln. Die Anzahl der Tafeln in der Kollektion ist in der Eigenschaft Count enthalten. Zur Entwurfszeit wird der entsprechende Editor verwendet, um Tafeln zur Statusleiste hinzuzufügen, daraus zu entfernen oder zu ändern.


Eigenschaften von TStatusPanels

TStatusPanels	Alphabetisch	Legende

In TStatusPanels

Items

Abgeleitet von TCollection

Count


Eigenschaften von TStatusPanels

TStatusPanels	Nach Objekten	Legende

Count

Items


TStatusPanels::Items

TStatusPanels	Siehe auch

Ein Index in der Kollektion der Statusleistentafeln.

__property TStatusPanel* Items[int Index];

Beschreibung

Der Wert des Parameters Index entspricht der Eigenschaft Index von TStatusPanel. Er repräsentiert die Position der Tafel innerhalb der Statusleiste.


Methoden von TStatusPanels

TStatusPanels	Alphabetisch

In TStatusPanels

~TStatusPanels

Add

TStatusPanels

Abgeleitet von TCollection

Assign

BeginUpdate

Clear

EndUpdate

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TStatusPanels

TStatusPanels	Nach Objekten

~TStatusPanels

Add

Assign

BeginUpdate

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

Clear

DefaultHandler

Dispatch

EndUpdate

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance

TStatusPanels


TStatusPanels::~TStatusPanels

TStatusPanels

Der Destruktor ~TStatusPanels gibt den Speicher frei, der für das TStatusPanels-Objekt reserviert war. Rufen Sie ~TStatusPanels nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TStatusPanels automatisch aufgerufen wird.

__fastcall virtual ~TStatusPanels(void);


TStatusPanels::Add

TStatusPanels	Siehe auch

Die Methode erzeugt eine neue Instanz von TStatusPanel und fügt diese dem Array Items hinzu.

TStatusPanel* __fastcall Add(void);

Beschreibung

Die Methode Add gibt die neue Tafel zurück. Zur Entwurfszeit wird der zugehörige Editor verwendet, um der Statusleiste weitere Tafeln hinzuzufügen.


TStatusPanels::TStatusPanels

TStatusPanels	Siehe auch

Die Methode erzeugt und initialisiert ein TStatusPanels-Objekt.

__fastcall TStatusPanels(TStatusBar* StatusBar);

Beschreibung

Die Methode TStatusPanels nimmt eine Instanz von TStatusBar als Parameter entgegen.


Zugriff

Read-only


Hierarchie

TObject

TPersistent

TCollection


TStatusPanels Beispiel

TStatusPanels


 TStatusBar

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/comctrls.hpp

TStatusBar repräsentiert eine Windows-Statusleiste.

Beschreibung

Die Komponente TStatusBar ist normalerweise am unteren Rand des Formulars angeordnet und besteht aus einer Anzahl von nebeneinander liegenden Tafeln, die während des Programmablaufs Informationen anzeigen. Die einzelnen Tafeln werden durch TStatusPanel-Objekte in der Eigenschaft Panels repräsentiert. Mit der Eigenschaft SimplePanel kann zur Laufzeit gesteuert werden, ob die Statusleiste aus einer einzigen oder aus mehreren Tafeln besteht.


Eigenschaften von TStatusBar

TStatusBar	Alphabetisch	Legende

In TStatusBar

Canvas

Panels

SimplePanel

SimpleText

SizeGrip

Abgeleitet von TWinControl

Brush

ClientOrigin

ClientRect

ControlCount

Controls

Handle

HelpContext

Showing

TabOrder

TabStop

Abgeleitet von TControl

Align

BoundsRect

ClientHeight

ClientWidth

ControlState

ControlStyle

Cursor

DragCursor

DragMode

Enabled

Font

Height

Hint

Left

Name

Parent

ParentFont

ParentShowHint

PopupMenu

ShowHint

Top

Visible

Width

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TStatusBar

TStatusBar	Nach Objekten	Legende

Align

BoundsRect

Brush

Canvas

ClientHeight

ClientOrigin

ClientRect

ClientWidth

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlCount

ControlState

Controls

ControlStyle

Cursor

DesignInfo

DragCursor

DragMode

Enabled

Font

Handle

Height

HelpContext

Hint

Left

Name

Owner

Panels

ParentFont

ParentShowHint

Parent

PopupMenu

ShowHint

Showing

SimplePanel

SimpleText

SizeGrip

TabOrder

TabStop

Tag

Top

Visible

Width


TStatusBar::Canvas

TStatusBar	Siehe auch

Die Eigenschaft Canvas ermöglicht zur Laufzeit den Zugriff auf die Zeichenoberfläche der Statusleiste.

__property Graphics::TCanvas* Canvas;

Beschreibung

Die Nur-Lesen-Eigenschaft Canvas ermöglicht den Zugriff auf die Zeichenoberfläche der Statusleiste. Diesen Zugriff verwenden Sie, wenn Sie eine Ereignisbehandlungsroutine für das Ereignis OnDrawPanel implementieren.


TStatusBar::Panels

TStatusBar	Siehe auch

Eine Liste der Tafeln (TStatusPanel) in der Statusleiste.

__property TStatusPanels* Panels;

Beschreibung

Die Eigenschaft Panels enthält ein Objekt des Typs TStatusPanels, eine Kollektion von TStatusPanel-Objekten. Zur Entwurfszeit können Sie Tafeln mit dem entsprechenden Editor hinzufügen, entfernen und verändern. Sie öffnen den Editor für Tafeln, indem Sie die Eigenschaft Panels im Objektinspektor markieren und dann in die Wertespalte doppelklicken oder auf die Schaltfläche mit dem Punktsymbol (...) klicken.


TStatusBar::SimplePanel

TStatusBar	Siehe auch

Diese Eigenschaft legt fest, ob die Statusleiste eine oder mehrere Tafeln enthält.

__property bool SimplePanel;

Beschreibung

Wenn SimplePanel den Wert True hat, besteht die Statusleiste aus einer einzigen Tafel, die den in SimpleText gespeicherten String anzeigt. Wenn SimplePanel den Wert False hat, enthält die Statusleiste für jedes Element in der Eigenschaft Panels eine eigene Tafel. Zur Laufzeit kann das Aussehen der Statusleiste programmseitig über den Wert von SimplePanel geändert werden.


TStatusBar::SimpleText

TStatusBar	Siehe auch

Diese Eigenschaft enthält den String, der in der Statusleiste angezeigt wird, wenn SimplePanel den Wert True hat.

__property System::AnsiString SimpleText;

Beschreibung

SimpleText enthält einen Textstring. Dieser wird in der Statusleiste angezeigt, wenn SimplePanel den Wert True hat.


TStatusBar::SizeGrip

TStatusBar	Siehe auch

Mit der Eigenschaft SizeGrip wird festgelegt, ob die Statuszeile zur Laufzeit in der Größe verändert werden kann.

__property bool SizeGrip;

Beschreibung

Wenn SizeGrip auf True gesetzt ist, befindet sich an der unteren rechten Ecke der Statusleiste ein dreieckiger Griff. Der Anwender kann diesen Griff mit der Maus ziehen und so die Größe der Statusleiste verändern.

Hinweis

Wenn die Eigenschaft Align auf einen der Werte alBottom, alRight oder alClient gesetzt ist, bleibt der Griff ohne Funktion. Wenn die Eigenschaft Alignment der letzten Tafel in der Statusleiste auf taRightJustify gesetzt ist, wird der Text innerhalb dieser Tafel durch das Griffsymbol teilweise verdeckt.


Ereignisse von TStatusBar

TStatusBar	Alphabetisch	Legende

In TStatusBar

OnDrawPanel

OnResize

Abgeleitet von TControl

OnClick

OnDblClick

OnDragDrop

OnDragOver

OnEndDrag

OnMouseDown

OnMouseMove

OnMouseUp

OnStartDrag


Ereignisse von TStatusBar

TStatusBar	Nach Objekten	Legende

OnClick

OnDblClick

OnDragDrop

OnDragOver

OnDrawPanel

OnEndDrag

OnMouseDown

OnMouseMove

OnMouseUp

OnResize

OnStartDrag


TStatusBar::OnDrawPanel

TStatusBar	Siehe auch

Das Ereignis OnDrawPanel wird ausgelöst, wenn eine Tafel innerhalb einer Statusleiste neu gezeichnet werden muß.

typedef void __fastcall (__closure *TDrawPanelEvent)(TStatusBar* StatusBar, TStatusPanel* Panel, const Windows::TRect &Rect);

__property TDrawPanelEvent OnDrawPanel;

Beschreibung

Das Ereignis OnDrawPanel wird ausgelöst, wenn eine Tafel in einer Statusleiste erneut angezeigt werden muß, beispielsweise weil der Benutzer die Größe verändert hat. Der Parameter Rect enthält die neuen Abmessungen der Tafel. OnDrawPanel wird nur dann ausgelöst, wenn die Eigenschaft Style der Tafel auf psOwnerDraw gesetzt ist.

TDrawPanelEvent ist der Typ der Eigenschaft OnDrawPanel.


TStatusBar::OnResize

TStatusBar	Siehe auch

Das Ereignis OnResize wird ausgelöst, wenn die Größe der Statusleiste verändert wurde.

typedef void __fastcall (__closure *TNotifyEvent)(System::TObject* Sender);

__property Classes::TNotifyEvent OnResize;

Beschreibung

Das Ereignis OnResize wird zur Laufzeit ausgelöst, sobald die gesamte Statuszeile in der Größe verändert wurde.


Methoden von TStatusBar

TStatusBar	Alphabetisch

In TStatusBar

~TStatusBar

TStatusBar

Abgeleitet von TWinControl

Broadcast

CanFocus

ContainsControl

ControlAtPos

DisableAlign

EnableAlign

Focused

GetTabOrderList

HandleAllocated

HandleNeeded

InsertControl

Invalidate

PaintTo

Realign

RemoveControl

Repaint

ScaleBy

ScrollBy

SetBounds

SetFocus

Update

UpdateControlState

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

GetTextLen

Hide

Perform

Refresh

ScreenToClient

SendToBack

SetTextBuf

Show

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TStatusBar

TStatusBar	Nach Objekten

~TStatusBar

Assign

BeginDrag

BringToFront

Broadcast

CanFocus

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

ClientToScreen

ContainsControl

ControlAtPos

DefaultHandler

DestroyComponents

Destroying

DisableAlign

Dispatch

DragDrop

Dragging

EnableAlign

EndDrag

FieldAddress

FindComponent

Focused

FreeInstance

FreeNotification

Free

GetParentComponent

GetTabOrderList

GetTextBuf

GetTextLen

HandleAllocated

HandleNeeded

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InsertControl

InstanceSize

Invalidate

MethodAddress

MethodName

NewInstance

PaintTo

Perform

Realign

Refresh

RemoveComponent

RemoveControl

Repaint

ScaleBy

ScreenToClient

ScrollBy

SendToBack

SetBounds

SetFocus

SetTextBuf

Show

TStatusBar

UpdateControlState

Update


TStatusBar::~TStatusBar

TStatusBar	Siehe auch

Der Destruktor ~TStatusBar gibt den Speicher frei, der für das TStatusBar-Objekt reserviert war. Rufen Sie ~TStatusBar nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TStatusBar automatisch aufgerufen wird.

__fastcall virtual ~TStatusBar(void);

Beschreibung

Die Statusleiste wird zusammen mit der Zeichenfläche und den Statusleistentafeln freigegeben.


TStatusBar::TStatusBar

TStatusBar	Siehe auch

Mit der Methode TStatusBar wird eine TStatusBar-Komponente erzeugt und initialisiert.

__fastcall virtual TStatusBar(Classes::TComponent* AOwner);

Beschreibung

Die Methode TStatusBar erzeugt eine Statusleiste zusammen mit deren Zeichenfläche und ihren Tafeln.


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TControl

TWinControl


TStatusBar Beispiel

TStatusBar


 TTabControl

Hierarchie	Eigenschaften	Methoden	Ereignisse

Header

vcl/comctrls.hpp

Die Komponente TTabControl ist ein Registersatz, der ähnlich wie ein TTabSet-Objekt funktioniert und das Aussehen von Registern auf einer Registerkarte hat.

Beschreibung

Mit einem TPageControl-Objekt können Sie ein mehrseitiges Dialogfeld erzeugen. Wenn Sie einen Registersatz benötigen, verwenden Sie ein TTabControl-Objekt. Wenn Sie ein TTabControl-Objekt deaktivieren, werden alle Register deaktiviert, da das Objekt als ein einziges Steuerelement angesehen wird. Um einzelne Register deaktivieren zu können, müssen Sie ein TPageControl-Objekt verwenden und die einzelnen TTabSheet-Objekte deaktivieren, die die Seiten darstellen.


Eigenschaften von TTabControl

TTabControl	Alphabetisch	Legende

Abgeleitet von TCustomTabControl

DisplayRect

MultiLine

TabHeight

TabIndex

Tabs

TabWidth

Abgeleitet von TWinControl

Brush

ClientOrigin

ClientRect

ControlCount

Controls

Handle

HelpContext

Showing

TabOrder

TabStop

Abgeleitet von TControl

Align

BoundsRect

ClientHeight

ClientWidth

ControlState

ControlStyle

Cursor

DragCursor

DragMode

Enabled

Font

Height

Hint

Left

Name

Parent

ParentFont

ParentShowHint

PopupMenu

ShowHint

Top

Visible

Width

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TTabControl

TTabControl	Nach Objekten	Legende

Align

BoundsRect

Brush

ClientHeight

ClientOrigin

ClientRect

ClientWidth

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlCount

ControlState

Controls

ControlStyle

Cursor

DesignInfo

DisplayRect

DragCursor

DragMode

Enabled

Font

Handle

Height

HelpContext

Hint

Left

MultiLine

Name

Owner

ParentFont

ParentShowHint

Parent

PopupMenu

ShowHint

Showing

TabHeight

TabIndex

TabOrder

Tabs

TabStop

TabWidth

Tag

Top

Visible

Width


Ereignisse von TTabControl

TTabControl	Alphabetisch	Legende

Abgeleitet von TCustomTabControl

OnChange

OnChanging

Abgeleitet von TWinControl

OnEnter

OnExit

Abgeleitet von TControl

OnDragDrop

OnDragOver

OnEndDrag

OnMouseDown

OnMouseMove

OnMouseUp

OnStartDrag


Ereignisse von TTabControl

TTabControl	Nach Objekten	Legende

OnChange

OnChanging

OnDragDrop

OnDragOver

OnEndDrag

OnEnter

OnExit

OnMouseDown

OnMouseMove

OnMouseUp

OnStartDrag


Methoden von TTabControl

TTabControl	Alphabetisch

In TTabControl

~TTabControl

TTabControl

Abgeleitet von TWinControl

Broadcast

CanFocus

ContainsControl

ControlAtPos

DisableAlign

EnableAlign

Focused

GetTabOrderList

HandleAllocated

HandleNeeded

InsertControl

Invalidate

PaintTo

Realign

RemoveControl

Repaint

ScaleBy

ScrollBy

SetBounds

SetFocus

Update

UpdateControlState

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

GetTextLen

Hide

Perform

Refresh

ScreenToClient

SendToBack

SetTextBuf

Show

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TTabControl

TTabControl	Nach Objekten

~TTabControl

Assign

BeginDrag

BringToFront

Broadcast

CanFocus

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

ClientToScreen

ContainsControl

ControlAtPos

DefaultHandler

DestroyComponents

Destroying

DisableAlign

Dispatch

DragDrop

Dragging

EnableAlign

EndDrag

FieldAddress

FindComponent

Focused

FreeInstance

FreeNotification

Free

GetParentComponent

GetTabOrderList

GetTextBuf

GetTextLen

HandleAllocated

HandleNeeded

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InsertControl

InstanceSize

Invalidate

MethodAddress

MethodName

NewInstance

PaintTo

Perform

Realign

Refresh

RemoveComponent

RemoveControl

Repaint

ScaleBy

ScreenToClient

ScrollBy

SendToBack

SetBounds

SetFocus

SetTextBuf

Show

TTabControl

UpdateControlState

Update


TTabControl::~TTabControl

TTabControl

Der Destruktor ~TTabControl gibt den Speicher frei, der für das TTabControl-Objekt reserviert war. Rufen Sie ~TTabControl nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TTabControl automatisch aufgerufen wird.

__fastcall virtual ~TTabControl(void);


TTabControl::TTabControl

TTabControl

Der Konstruktor TTabControl erzeugt ein neues TTabControl-Objekt.

__fastcall virtual TTabControl(Classes::TComponent* AOwner);


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TControl

TWinControl

TCustomTabControl


TTabControl Beispiel

TTabControl


 TTable

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/dbtables.hpp

TTable ist eine Datenmengen-Komponente, die eine Datenbanktabelle kapselt.

Beschreibung

Mit Hilfe von TTable können Sie über die Borland Database Engine (BDE) auf Daten in einer Datenbanktabelle zugreifen. TTable bietet direkten Zugriff auf jeden Datensatz und jedes Feld der zugrundeliegenden Datenbanktabelle. Dabei kann es sich um eine Paradox-, dBASE-, Access-, FoxPro-, eine ODBC-konforme oder eine SQL-Datenbank auf einem Remote-Server handeln (wie InterBase, Oracle, Sybase, MS SQL Server, Informix oder DB2).

Eine Tabellenkomponente kann auch mit einer Untermenge der Datensätze in einer Datenbanktabelle arbeiten, in dem Bereiche und Filter verwendet werden.


Eigenschaften von TTable

TTable	Alphabetisch	Legende

In TTable

CanModify

DataSource

Exclusive

IndexDefs

IndexFieldCount

IndexFieldNames

IndexFields

IndexFiles

IndexName

KeyExclusive

KeyFieldCount

MasterFields

MasterSource

ReadOnly

TableLevel

TableName

TableType

Abgeleitet von TDBDataSet

Database

DatabaseName

DBHandle

DBLocale

DBSession

SessionName

UpdateMode

Abgeleitet von TDataSet

Active

AutoCalcFields

BOF

Bookmark

DefaultFields

Designer

EOF

FieldCount

FieldDefs

Fields

FieldValues

Found

Modified

State

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TTable

TTable	Nach Objekten	Legende

Active

AutoCalcFields

BOF

Bookmark

CanModify

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

DatabaseName

Database

DataSource

DBHandle

DBLocale

DBSession

DefaultFields

Designer

DesignInfo

EOF

Exclusive

FieldCount

FieldDefs

Fields

FieldValues

Found

IndexDefs

IndexFieldCount

IndexFieldNames

IndexFields

IndexFiles

IndexName

KeyExclusive

KeyFieldCount

MasterFields

MasterSource

Modified

Owner

ReadOnly

SessionName

State

TableLevel

TableName

TableType

Tag

UpdateMode


TTable::CanModify

TTable	Siehe auch

Die Eigenschaft CanModify gibt an, ob von einer Anwendung Daten in eine Tabelle eingefügt bzw. in dieser bearbeitet oder aus ihr gelöscht werden können.

Beschreibung

Überprüfen Sie den Status von CanModify, um festzustellen, ob eine Anwendung eine Datenmenge ändern kann. Wenn CanModify den Wert True hat, kann die Datenmenge geändert werden. Wenn CanModify den Wert False hat, kann die Tabelle nur gelesen werden.

CanModify wird beim öffnen einer Tabelle durch eine Anwendung automatisch ein Wert zugewiesen. Wenn die Eigenschaft ReadOnly einer Tabellenkomponente den Wert True hat, wird CanModify der Wert False zugewiesen. CanModify kann außerdem in folgenden Fällen den Wert False enthalten:

•	Eine andere Anwendung besitzt exklusiven Schreibzugriff auf die Tabelle.

•	Die Tabelle wurde mit dem Attribut Nur-Lesen definiert.

Hinweis

Auch wenn CanModify den Wert True hat, bedeutet das nicht zwangsläufig, daß der Benutzer Datensätze in eine Tabelle einfügen oder aktualisieren kann. Dies hängt von weiteren Faktoren ab, beispielsweise den SQL-Zugriffsrechten.


TTable::DataSource

TTable	Siehe auch

Die Eigenschaft DataSource gibt die Datenquelle für die Tabelle an.

Beschreibung

Mit der Eigenschaft DataSource kann die der Tabelle gegenwärtig zugewiesene Datenquelle bestimmt werden. Wenn eine Anwendung die Eigenschaft DataSet einer DataSource-Komponente auf den Namen dieser Tabellenkomponente setzt, wird die Eigenschaft DataSource dieser Tabelle automatisch mit dem Namen der Datenquellenkomponente aktualisiert, die diese verwendet.


TTable::Exclusive

TTable	Siehe auch

Die Eigenschaft Exclusive ermöglicht es einer Anwendung, exklusiven Zugriff auf eine Paradox- oder dBASE-Tabelle zu erhalten.

__property bool Exclusive;

Beschreibung

Mit Exclusive kann der Zugriff auf eine Paradox- oder dBASE-Tabelle durch andere Anwendungen verhindert werden, während diese von der aktuellen Anwendung verwendet wird. Weisen Sie vor dem öffnen der Tabelle Exclusive den Wert True zu.

Wenn Exclusive den Wert True hat, kann nach dem erfolgreichen öffnen der Tabelle durch die Anwendung keine andere Anwendung auf die Tabelle zugreifen. Wenn die Tabelle bereits von einer anderen Anwendung verwendet wird, wird eine Exception ausgelöst. Für diese Exceptions muß ein Exception-Handler geschrieben werden.

Die Tabelle muß vor einer €nderung des Wertes der Eigenschaft Exclusive geschlossen werden. Weisen Sie Exclusive während des Entwurfs nicht den Wert True zu, wenn Sie beabsichtigen, der Eigenschaft Active ebenfalls den Wert True zuzuweisen. In diesem Fall wird eine Exception ausgelöst, da die Tabelle bereits von der IDE geöffnet wurde.

Hinweis

Eine Anwendung kann Exclusive für SQL-Tabellen auf True setzen. Diese Funktion wird jedoch nicht von allen SQL-Servern unterstützt. Andere Server gewähren exklusive Lese-/Schreibzugriffssperren und ermöglichen gleichzeitig anderen Anwendungen den Lesezugriff. Nähere Information zum exklusiven Sperren von Datenbanktabellen eines spezifischen Servers finden Sie in der Dokumentation des Servers.


TTable::IndexDefs

TTable	Siehe auch

Die Eigenschaft IndexDefs enthält Informationen über die Indizes einer Tabelle.

__property TIndexDefs* IndexDefs;

Beschreibung

Überprüfen Sie IndexDefs auf Indexinformationen. IndexDefs ist ein Array mit Indexeinträgen, die jeweils einen verfügbaren Index der Tabelle beschreiben. Normalerweise greift eine Anwendung auf Indizes zu oder gibt diese in den Eigenschaften IndexFieldNames oder IndexFields an.

Hinweis

Die in IndexDefs enthaltenen Indexeinträge berücksichtigen nicht immer die für die Tabelle verfügbaren Indizes. Rufen Sie vor der Überprüfung von IndexDefs die Methode Update auf, um die Liste zu aktualisieren.


TTable::IndexFieldCount

TTable	Siehe auch

Die Eigenschaft IndexFieldCount gibt die Anzahl der Felder an, die den aktuellen Schlüssel bilden.

__property int IndexFieldCount;

Beschreibung

Überprüfen Sie IndexFieldCount, um die Anzahl der Felder zu ermitteln, die den aktuellen Schlüssel bilden. Für auf einer einzelnen Spalte basierende Indizes gibt IndexFieldCount den Wert 1 zurück. Bei mehrspaltigen Indizes gibt IndexFieldCount die Anzahl der Felder an, auf denen der Index basiert.


TTable::IndexFieldNames

TTable	Siehe auch

Die Eigenschaft IndexFieldNames gibt die Spalten an, die als Index für eine Tabelle verwendet werden.

__property System::AnsiString IndexFieldNames;

Beschreibung

IndexFieldNames ist eine alternative Methode zur Angabe des Index, der für eine Tabelle verwendet werden soll. Geben Sie in IndexFieldNames den Namen jeder Spalte an, die als Index für eine Tabelle verwendet wird. Die Reihenfolge von Spaltennamen ist wesentliches Merkmal des Index. Trennen Sie Namen durch Semikolons.

Für Paradox und dBASE müssen sämtliche in IndexFieldNames angegebenen Spaltennamen bereits indizierte Spalten bezeichnen. Für SQL-Tabellen ist dies nicht erforderlich.

Hinweis

Die Eigenschaften IndexFieldNames und IndexName schließen sich gegenseitig aus. Das Setzen einer dieser Eigenschaften löscht die andere.


TTable::IndexFields

TTable	Siehe auch

Die Eigenschaft IndexFields ruft ein Feld für einen Index ab oder weist diesem einen Wert zu.

__property Db::TField* IndexFields[int Index];

Beschreibung

Mit Hilfe von IndexFields können Sie Informationen über ein bestimmtes Feld in einem Index abrufen oder ein Feld für die Verwendung in einem Index angeben. IndexFields ist ein Array mit Feldkomponenten, die den Index bilden. Der Parameter Index ist der Ordinalwert des Feldes, das abgerufen oder zugewiesen werden soll.

Hinweis

Eine Anwendung sollte IndexFields nur zum Abrufen von Feldinformationen verwenden. Verwenden Sie zum Erstellen eines neuen Index die Methode AddIndex.


TTable::IndexFiles

TTable	Siehe auch

Die Eigenschaft IndexFiles gibt eine oder mehrere dBASE-Indexdateien an, die von einer dBASE-Tabelle mit nicht-gewarteten Indizes verwendet werden.

__property Classes::TStrings* IndexFiles;

Beschreibung

Mit IndexFiles können dBASE-Indexdateien für eine Tabelle verfügbar gemacht werden, die nicht-gewartete Indizes verwendet. Eine dBASE-Indexdatei kann mehrere Indizes enthalten. Jeder Index einer Indexdatei kann für die Eigenschaft IndexName ausgewählt werden, die den zu einem bestimmten Zeitpunkt zu verwendenden Index angibt.

Wenn der Liste der verfügbaren Indizes Indexdateien hinzugefügt werden, werden diese von der Tabellenkomponente geöffnet. Einfügungen in die und €nderungen an der Tabelle werden in den Indexdateien berücksichtigt. Beim Entfernen von Dateien aus der Liste werden diese geschlossen und nicht mehr aktualisiert.

Hinweis

Verwenden Sie während des Entwurfs den Objektinspektor zum Einfügen oder Entfernen von Index-Dateinamen aus der bzw. in die Eigenschaft IndexFiles. Zur Laufzeit können mehrere Indexdateien angegeben werden, indem IndexFiles auf einen String gesetzt wird, der eine Liste von Dateinamen enthält, die durch Semikolons voneinander getrennt sind.


TTable::IndexName

TTable	Siehe auch

Die Eigenschaft IndexName bezeichnet einen Sekundärindex für die Tabelle.

__property System::AnsiString IndexName;

Beschreibung

Mit IndexName kann ein alternativer Index für eine Tabelle festgelegt werden. Ist IndexName leer, wird der Primärindex zur Sortierung der Tabelle verwendet. dBASE-Tabellen werden in der physischen Reihenfolge der Datensätze angezeigt.

Wenn IndexName ein gültiger Indexname zugewiesen wurde, bestimmt dieser Index die Sortierreihenfolge der Datensätze. Bei dBASE-Tabellen muß der Indexname in der Eigenschaft IndexName in der Hauptindexdatei der Tabelle enthalten oder einer anderen Indexdatei zugeordnet sein, die bereits in der Eigenschaft IndexFiles angegeben wurde.

Hinweis

Die Eigenschaften IndexFieldNames und IndexName schließen sich gegenseitig aus. Das Setzen einer dieser Eigenschaften löscht die andere.


TTable::KeyExclusive

TTable	Siehe auch

Die Eigenschaft KeyExclusive legt die obere und untere Grenze eines Bereichs fest.

__property bool KeyExclusive;

Beschreibung

Mit KeyExclusive können Sie festlegen, ob ein Bereich die Datensätze enthält, die mit der festgelegten Ober- und Untergrenze des Bereichs übereinstimmen. Standardmäßig hat KeyExclusive den Wert True: übereinstimmende Werte werden berücksichtigt.

Durch das Setzen von KeyExclusive auf False kann ein Bereich auf die Datensätze beschränkt werden, deren Wert größer als die festgelegte Untergrenze und kleiner als die festgelegte Obergrenze ist.


TTable::KeyFieldCount

TTable	Siehe auch

Die Eigenschaft KeyFieldCount bezeichnet die Anzahl der Felder, die zur Suche von Teilübereinstimmungen verwendet werden.

__property int KeyFieldCount;

Beschreibung

Mit KeyFieldCount kann eine Suche auf eine Untermenge der verfügbaren Schlüsselfelder beschränkt werden, wenn sich ein Schlüssel aus mehr als einem Feld zusammensetzt. Setzen Sie den Wert von KeyFieldCount auf die Anzahl der zu verwendenden Felder. Der angegebene Wert muß kleiner oder gleich der Anzahl der für den Schlüssel verwendeten Felder sein. Wenn eine Tabelle beispielsweise aus einem Primärschlüssel mit drei Feldern besteht, muß KeyFieldCount auf 1 gesetzt werden, wenn nur basierend auf dem ersten Feld nach Werten gesucht werden soll.

Die Suche kann nur für zusammenhängende Felder definiert werden. Bei einem aus drei Feldern bestehenden Schlüssel kann KeyFieldCount beispielsweise der Wert 1 zugewiesen werden, wenn nur das erste Feld durchsucht werden soll, 2, wenn das erste und zweite Feld und 3, wenn alle Felder durchsucht werden sollen.

Hinweis

Standardmäßig erstreckt sich die Suche auf alle Felder. KeyFieldCount muß daher kein Wert zugewiesen werden, wenn die Suche nicht auf einen Teil der verfügbaren Felder beschränkt werden soll.


TTable::MasterFields

TTable	Siehe auch

Die Eigenschaft MasterFields gibt ein oder mehrere Felder in einer Haupttabelle an, die mit den entsprechenden Feldern in dieser Tabelle verknüpft wird, um eine Haupt/Detail-Verbindung zwischen den Tabellen zu erzeugen.

__property System::AnsiString MasterFields;

Beschreibung

Verwenden Sie MasterFields nach dem Setzen der Eigenschaft MasterSource, um die Namen eines oder mehrerer Felder festzulegen, die für die Erstellung einer Haupt/Detail-Verbindung zwischen dieser und der in MasterSource angegebenen Tabelle genutzt werden sollen.

MasterFields ist ein String, der einen oder mehrere Feldnamen der Haupttabelle enthält. Trennen Sie Feldnamen durch ein Semikolon.

Bei jeder €nderung des aktuellen Datensatzes in der Haupttabelle werden die neuen Werte dieser Felder verwendet, um die entsprechenden Datensätze in dieser Tabelle für die Anzeige auszuwählen.

Hinweis

Während des Entwurfs können Sie die Haupt/Detail-Verbindung zwischen zwei Tabellen mit dem entsprechenden Designer einrichten.


TTable::MasterSource

TTable	Siehe auch

Die Eigenschaft MasterSource gibt den Namen der Datenquellenkomponente für die Datenmenge an, die als Haupttabelle bei der Einrichtung einer Haupt/Detail-Verbindung zwischen dieser und einer anderen Tabelle dient.

__property Db::TDataSource* MasterSource;

Beschreibung

In der Eigenschaft MasterSource können Sie den Namen der Datenquellenkomponente angeben, deren Eigenschaft DataSet eine Datenmenge bezeichnet, die als Haupttabelle für die Einrichtung einer Detail-Haupt-Verbindung zwischen dieser und einer anderen Tabelle dient.

Hinweis

Wählen Sie während des Entwurfs eine verfügbare Datenquelle aus der Dropdown-Liste der Eigenschaft MasterSource im Objektinspektor.

Geben Sie nach dem Setzen der Eigenschaft MasterSource an, welche Felder in der Haupttabelle verwendet werden sollen, indem Sie die Eigenschaft MasterFields setzen. Zur Laufzeit werden bei jeder Wertänderung des aktuellen Datensatzes in der Haupttabelle die neuen Werte dieser Felder verwendet, um die entsprechenden Datensätze in dieser Tabelle für die Anzeige auszuwählen.

Hinweis

Während des Entwurfs können Sie die Haupt/Detail-Verbindung zwischen zwei Tabellen mit dem entsprechenden Designer einrichten.


TTable::ReadOnly

TTable	Siehe auch

Die Eigenschaft ReadOnly gibt an, ob eine Tabelle in dieser Anwendung bearbeitet werden kann.

__property bool ReadOnly;

Beschreibung

Mit der Eigenschaft ReadOnly läßt sich verhindern, daß Benutzer Daten in der Tabelle aktualisieren, einfügen oder löschen. Die Standardeinstellung von ReadOnly ist False. In diesem Fall können die Daten einer Tabelle durch den Benutzer geändert werden.

Hinweis

Auch wenn ReadOnly den Wert False hat, können Benutzer der Tabelle die Daten nicht ändern, wenn andere Faktoren wie beispielsweise nicht ausreichende SQL-Zugriffsrechte für die Anwendung oder den Benutzer dies verhindern.

Führen Sie folgende Schritte aus, um sicherzustellen, daß Benutzer keine Daten hinzufügen bzw. ändern können:

1	Weisen Sie der Eigenschaft Active den Wert False zu.

2	Setzen Sie ReadOnly auf True.

Wenn ReadOnly den Wert True hat, hat die Eigenschaft CanModify der Tabelle den Wert False.


TTable::TableLevel

TTable	Siehe auch

Die Eigenschaft TableLevel bezeichnet die treiberabhängige Tabellenstufe der Borland Database Engine (BDE).

Beschreibung

Mit TableLevel können Sie festlegen, daß die mit dieser Datenmenge verbundene Tabelle eine bestimmte BDE-Treiberstufe voraussetzt. Wenn TableLevel der Standardwert 0 zugewiesen wurde, wird diese Eigenschaft nicht berücksichtigt.

Nähere Informationen über BDE-Treiberstufen finden Sie in der BDE-Hilfedatei BDE32.HLP.


TTable::TableName

TTable	Siehe auch

Die Eigenschaft TableName gibt den Namen der Datenbanktabelle an, die diese Komponente kapselt.

__property System::AnsiString TableName;

Beschreibung

In TableName geben Sie den Namen der Datenbanktabelle an, die diese Komponente kapselt. Bevor Sie TableName einen gültigen Wert zuweisen, sollte die Eigenschaft DatabaseName bereits gesetzt sein. Wenn DatabaseName während des Entwurfs gesetzt wird, kann ein gültiger Tabellenname in der TableName-Dropdown-Liste im Objektinspektor gewählt werden.

Hinweis

Damit TableName ein Wert zugewiesen werden kann, muß die Eigenschaft Active den Wert False haben.


TTable::TableType

TTable	Siehe auch

Die Eigenschaft TableType gibt die Tabellenstruktur für die Tabelle an, die diese Komponente kapselt.

__property TTableType TableType;

Beschreibung

Mit TableType kann die Tabellenstruktur für eine dBASE-, Paradox- oder ASCII-Tabelle angegeben werden. TableType wird für Tabellen auf Remote-SQL-Servern nicht verwendet. TableType kann jeder der folgenden Werte zugewiesen werden:

Wert	Bedeutung

ttDefault	(Standard) Bestimmt den Tabellentyp der Tabelle, basierend auf der Dateinamenerweiterung.

ttParadox	Paradox-Tabelle.

ttDBase	dBASE-Tabelle.

ttASCII	Die Tabelle ist eine Comma-Delimited-Textdatei mit Strings in Anführungszeichen für jedes Feld.

Wenn TableType auf ttDefault gesetzt ist, bestimmt die Dateinamenerweiterung der Tabelle den Tabellentyp.

Extension	Bedeutung

DB oder keine	Paradox-Tabelle

DBF	dBASE-Tabelle

TXT	ASCII-Tabelle

Wenn TableType auf ttParadox, ttDBase oder ttASCII gesetzt ist, wird unabhängig von der Dateinamenerweiterung der Tabelle der entsprechende Tabellentyp zugrundegelegt.


Ereignisse von TTable

TTable	Alphabetisch	Legende

Abgeleitet von TDataSet

AfterCancel

AfterClose

AfterDelete

AfterEdit

AfterInsert

AfterOpen

AfterPost

BeforeCancel

BeforeClose

BeforeDelete

BeforeEdit

BeforeInsert

BeforeOpen

BeforePost

OnCalcFields

OnDeleteError

OnEditError

OnFilterRecord

OnNewRecord

OnPostError


Ereignisse von TTable

TTable	Nach Objekten	Legende

AfterCancel

AfterClose

AfterDelete

AfterEdit

AfterInsert

AfterOpen

AfterPost

BeforeCancel

BeforeClose

BeforeDelete

BeforeEdit

BeforeInsert

BeforeOpen

BeforePost

OnCalcFields

OnDeleteError

OnEditError

OnFilterRecord

OnNewRecord

OnPostError


Methoden von TTable

TTable	Alphabetisch

In TTable

~TTable

AddIndex

ApplyRange

BatchMove

CancelRange

CloseIndexFile

CreateTable

DeleteIndex

DeleteTable

EditKey

EditRangeEnd

EditRangeStart

EmptyTable

FindKey

FindNearest

GetIndexNames

GotoCurrent

GotoKey

GotoNearest

LockTable

OpenIndexFile

RenameTable

SetKey

SetRange

SetRangeEnd

SetRangeStart

TTable

UnlockTable

Abgeleitet von TDBDataSet

CheckOpen

Abgeleitet von TDataSet

ActiveBuffer

Append

AppendRecord

CheckBrowseMode

ClearFields

Close

ControlsDisabled

CursorPosChanged

Delete

DisableControls

Edit

EnableControls

FieldByName

FindField

FindFirst

FindLast

FindNext

FindPrior

First

FreeBookmark

GetBookmark

GetFieldList

GetFieldNames

GotoBookmark

Insert

InsertRecord

IsLinkedTo

Last

MoveBy

Next

Open

Post

Prior

Refresh

Resync

SetFields

UpdateCursorPos

UpdateRecord

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TTable

TTable	Nach Objekten

~TTable

ActiveBuffer

AddIndex

AppendRecord

Append

ApplyRange

Assign

BatchMove

CancelRange

CheckBrowseMode

CheckOpen

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

ClearFields

CloseIndexFile

Close

ControlsDisabled

CreateTable

CursorPosChanged

DefaultHandler

DeleteIndex

DeleteTable

Delete

DestroyComponents

Destroying

DisableControls

Dispatch

EditKey

EditRangeEnd

EditRangeStart

Edit

EmptyTable

EnableControls

FieldAddress

FieldByName

FindComponent

FindField

FindFirst

FindKey

FindLast

FindNearest

FindNext

FindPrior

First

FreeBookmark

FreeInstance

FreeNotification

Free

GetBookmark

GetFieldList

GetFieldNames

GetIndexNames

GetParentComponent

GotoBookmark

GotoCurrent

GotoKey

GotoNearest

HasParent

InheritsFrom

InitInstance

InsertComponent

InsertRecord

Insert

InstanceSize

IsLinkedTo

Last

LockTable

MethodAddress

MethodName

MoveBy

NewInstance

Next

OpenIndexFile

Open

Post

Prior

Refresh

RemoveComponent

RenameTable

Resync

SetFields

SetKey

SetRangeEnd

SetRangeStart

SetRange

TTable

UnlockTable

UpdateCursorPos

UpdateRecord


TTable::~TTable

TTable	Siehe auch

Der Destruktor ~TTable gibt den Speicher frei, der für das TTable-Objekt reserviert war. Rufen Sie ~TTable nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TTable automatisch aufgerufen wird.

__fastcall virtual ~TTable(void);


TTable::AddIndex

TTable	Siehe auch

Die Methode AddIndex erzeugt einen neuen Index für die Tabelle.

void __fastcall AddIndex(const System::AnsiString Name, const System::AnsiString Fields,  TIndexOptions  Options);

Beschreibung

Durch den Aufruf von AddIndex kann ein neuer Index für die mit einer Datenmenge verbundene Tabelle erzeugt werden. Name bezeichnet den Namen des neuen Index. Fields ist eine Liste der Felder, die in den Index aufgenommen werden sollen. Die Feldnamen werden durch Semikolons voneinander getrennt. Options ist eine Menge mit einem oder mehreren der folgenden Werte:

Wert	Beschreibung	Beschränkungen

ixPrimary	Erzeugt einen Primärindex.	Kann nicht mit dBASE verwendet werden.

Kann nicht mehr als einen Primärindex pro Tabelle erzeugen.

isUnique	Erzeugt einen eindeutigen Index.

ixDescending	Sortiert in absteigender alphanumerischer Reihenfolge.

ixCaseInsensitive	Berücksichtigt die Groß-/Kleinschreibung beim Sortieren nicht.	Kann nicht mit dBASE verwendet werden.

ixExpression	Erzeugt einen berechneten Index.	Nur dBASE.

Der Versuch, einen Index unter Verwendung von Optionen zu erzeugen, die für einen Tabellentyp nicht geeignet sind, löst eine Exception aus.


TTable::ApplyRange

TTable	Siehe auch

Die Methode ApplyRange wendet einen Bereich auf die Datenmenge an.

void __fastcall ApplyRange(void);

Beschreibung

Rufen Sie ApplyRange auf, um einen Bereich einzurichten, der mit SetRangeStart und SetRangeEnd oder EditRangeStart und EditRangeEnd definiert wurde. Wenn ein Bereich aktiv ist, sind nur die Datensätze im Bereich für die Anwendung zur Anzeige und Bearbeitung verfügbar.


TTable::BatchMove

TTable	Siehe auch

Die Methode BatchMove verschiebt Datensätze aus einer Datenmenge in die Tabelle.

long __fastcall BatchMove(Db::TDataSet* ASource, TBatchMode AMode);

Beschreibung

Rufen Sie BatchMove auf, um folgende Operationen durchzuführen:

•	Kopieren von Datensätzen aus einer anderen in diese Tabelle.

•	Aktualisieren von Datensätzen in dieser Tabelle, die auch in einer anderen Tabelle existieren.

•	Datensätze aus einer anderen Tabelle am Ende dieser Tabelle anfügen.

•	Löschen von Datensätzen aus dieser Tabelle, die in einer anderen Tabelle existieren.

ASource ist eine Datenmengen-Komponente, die Datensätze zum Import in dieser Tabelle enthält. AMode hat einen der folgenden Werte:

Wert	Beschreibung

batAppend	Alle Datensätze aus der Quelltabelle werden am Ende dieser Tabelle angefügt.

batAppendUpdate	Fügt alle Datensätze aus der Quelltabelle am Ende dieser Tabelle an und aktualisiert bestehende Datensätze in der Tabelle mit entsprechenden Datensätzen der Quelltabelle.

batCopy	Kopiert alle Datensätze aus der Quelltabelle in diese Tabelle.

batDelete	Löscht alle Datensätze in dieser Tabelle, die auch in der Quelltabelle existieren.

batUpdate	Aktualisiert in dieser Tabelle vorhandene Datensätze mit den Gegenstücken in der Quelltabelle.

BatchMove gibt die Anzahl der bearbeiteten Datensätze zurück.


TTable::CancelRange

TTable	Siehe auch

Die Methode CancelRange entfernt alle Bereiche, die gegenwärtig für die Tabelle aktiviert sind.

void __fastcall CancelRange(void);

Beschreibung

Durch den Aufruf von CancelRange kann ein Bereich entfernt werden, der gegenwärtig in einer Tabelle aktiv ist. Das Entfernen eines Bereichs ermöglicht wieder den Zugriff auf alle Datensätze in der Datenmenge.


TTable::CloseIndexFile

TTable	Siehe auch

Die Methode CloseIndexFile schließt die angegebene dBASE-Indexdatei mit einem nicht gewarteten Index.

void __fastcall CloseIndexFile(const System::AnsiString IndexFileName);

Beschreibung

Durch den Aufruf von CloseIndexFile kann die angegebene Indexdatei mit einem nicht gewarteten Index geschlossen werden. IndexFileName ist der Name der zu schließenden Datei. Dabei handelt es sich entweder um den Namen einer zuvor mit OpenIndexFile geöffneten Datei oder um eine zuvor geöffnete Datei, deren Dateiname in der Eigenschaft IndexFiles enthalten ist.

Nach dem Schließen werden die betreffenden Indexdateien nicht mehr aktualisiert. Anschließende €nderungen der Datenmenge werden im Index nicht berücksichtigt.


TTable::CreateTable

TTable	Siehe auch

Die Methode CreateTable erzeugt die Datenmenge mit neuen Strukturinformationen.

void __fastcall CreateTable(void);

Beschreibung

Mit dem Aufruf von CreateTable zur Laufzeit kann die aktuelle Definition der Datenmenge durch eine neue Definition ersetzt werden.

Wenn die Eigenschaft FieldDefs Werte enthält, werden diese zur Erzeugung der Felddefinitionen verwendet. Andernfalls wird die Eigenschaft Fields verwendet. Zur erneuten Erzeugung einer Datenmenge muß mindestens eine dieser Eigenschaften Werte enthalten.

Wenn die Eigenschaft IndexDefs Werte enthält, werden diese zum Erzeugen von Indexdefinitionen für die Datenmenge verwendet.


TTable::DeleteIndex

TTable	Siehe auch

Die Methode DeleteIndex löscht einen Sekundärindex der Tabelle.

void __fastcall DeleteIndex(const System::AnsiString Name);

Beschreibung

Mit dem Aufruf von DeleteIndex kann ein Sekundärindex einer Tabelle entfernt werden. Name ist der Name des zu löschenden Index. Mit DeleteIndex kann kein Primärindex entfernt werden.

Hinweis

Damit ein Index gelöscht werden kann, muß die Anwendung die Tabelle im Exklusivmodus öffnen.


TTable::DeleteTable

TTable	Siehe auch

Die Methode DeleteTable löscht eine vorhandene Datenbanktabelle.

void __fastcall DeleteTable(void);

Beschreibung

Mit dem Aufruf von DeleteTable kann eine Datenbanktabelle gelöscht werden, die mit der Tabellenkomponente über die Eigenschaften DatabaseName und TableName verbunden ist. Die Tabelle muß vor dem Löschen geschlossen werden.

Warnung

Das Löschen einer Tabelle entfernt sämtliche in der Tabelle enthaltenen Daten und löscht die Strukturinformationen.


TTable::EditKey

TTable	Siehe auch

Mit der Methode EditKey kann der Inhalt des Suchschlüsselpuffers geändert werden.

void __fastcall EditKey(void);

Beschreibung

Durch den Aufruf von EditKey kann der Datenmenge der Status dsSetKey zugewiesen werden, während der aktuelle Inhalt der Eigenschaft Fields erhalten bleibt. Das Array der Eigenschaft Fields kann bearbeitet werden, bevor eine neue Suche gestartet wird.

Die Eigenschaft Fields ist eine Stringliste, die bestimmte Feldwerte für die Suche angibt. Während des Suchvorgangs werden die Werte in Fields in der Reihenfolge ihrer Ordinalzahlen auf die Spalten der Tabelle angewendet. Fields[0] entspricht der ersten Spalte, Fields [1] der zweiten Spalte der Tabelle usw.

EditKey ist hilfreich, wenn mehrere Suchvorgänge durchgeführt und zwischen den Suchvorgängen nur einer oder zwei der Feldwerte geändert werden.


TTable::EditRangeEnd

TTable	Siehe auch

Mit der Methode EditRangeEnd kann der Endwert eines vorhandenen Bereichs geändert werden.

void __fastcall EditRangeEnd(void);

Beschreibung

Mit dem Aufruf von EditRangeEnd können Sie festlegen, daß nachfolgende Feldzuweisungen der Eigenschaft FieldValue eine neue Menge von Endwerten für einen Bereich angeben, die in Verbindung mit bereits vorhandenen Endwerten eines Bereichs verwendet werden.

Rufen Sie nach der Zuweisung von neuen Werten für FieldValues ApplyRange auf, um den geänderten Bereich zu aktivieren.

Hinweis

In Paradox- oder dBASE-Tabellen kann EditRangeEnd nur für indizierte Felder verwendet werden. In SQL-Datenbanken kann EditRangeEnd für jede in der Eigenschaft IndexFieldNames angegebene Spalte verwendet werden.


TTable::EditRangeStart

TTable	Siehe auch

Mit der Methode EditRangeEnd kann der Anfangswert eines vorhandenen Bereichs geändert werden.

void __fastcall EditRangeStart(void);

Beschreibung

Mit dem Aufruf von EditRangeStart können Sie festlegen, daß nachfolgende Feldzuweisungen der Eigenschaft FieldValue eine neue Menge von Anfangswerten für einen Bereich angeben, die in Verbindung mit bereits vorhandenen Anfangswerten eines Bereichs verwendet werden.

Rufen Sie nach der Zuweisung von neuen Werten für FieldValues ApplyRange auf, um den geänderten Bereich zu aktivieren.

Hinweis

In Paradox- oder dBASE-Tabellen kann EditRangeStart nur für indizierte Felder verwendet werden. In SQL-Datenbanken kann EditRangeStart für jede in der Eigenschaft IndexFieldNames angegebene Spalte verwendet werden.


TTable::EmptyTable

TTable	Siehe auch

Die Methode EmptyTable löscht alle Datensätze aus der Tabelle.

void __fastcall EmptyTable(void);

Beschreibung

Die Methode EmptyTable löscht sämtliche Datensätze aus der Datenbanktabelle, die mit den Eigenschaften DatabaseName und TableName angegeben wird.

Hinweis

Datensätze können nicht gelöscht werden, wenn der Benutzer keine ausreichenden Zugriffsrechte für die Löschoperation besitzt.


TTable::FindKey

TTable	Siehe auch

Die Methode FindKey sucht nach einem Datensatz, der die angegebenen Feldwerte enthält.

bool __fastcall FindKey(const System::TVarRec *KeyValues, const int KeyValues_Size);

Beschreibung

Mit FindKey können Sie nach einem bestimmten Datensatz in einer Datenmenge suchen. KeyValues enthält ein Comma-Delimited-Array mit Feldwerten, das auch als Schlüssel bezeichnet wird. Jeder Wert des Schlüssels kann ein Literal, eine Variable, Null oder NULL sein. Wenn die in KeyValues übergebene Anzahl von Werten kleiner als die Anzahl der für die Suche verwendeten Indexspalten ist, wird für die fehlenden Werte Null verwendet.

Für Paradox- und dBASE-Tabellen muß der Schlüssel immer ein Index sein, der in der Eigenschaft IndexName angegeben werden kann. Wenn für IndexName kein Wert angegeben wurde, wird der Primärindex der Tabelle verwendet.

Bei SQL-Tabellen kann der Schlüssel einem in IndexName angegebenen Index oder einer Liste von Feldnamen in der Eigenschaft IndexFieldNames entsprechen.

Wenn die Suche erfolgreich war, positioniert FindKey den Cursor auf dem gefundenen Datensatz und gibt den Wert True zurück. Andernfalls wird der Cursor nicht verschoben, und FindKey gibt den Wert False zurück.


TTable::FindNearest

TTable	Siehe auch

Die Methode FindNearest bewegt den Cursor zum ersten Datensatz, der die größte Übereinstimmung mit den angegebenen Schlüsselwerten aufweist.

void __fastcall FindNearest(const System::TVarRec *KeyValues, const int KeyValues_Size);

Beschreibung

Mit FindNearest kann der Cursor zu einem bestimmten Datensatz in einer Datenmenge oder zum ersten Datensatz der Datenmenge bewegt werden, der größer als die im Parameter KeyValues angegebenen Werte ist. KeyValues enthält ein Comma-Delimited-Array mit Feldwerten, das als Schlüssel bezeichnet wird. Jeder Wert des Schlüssels kann ein String-Literal, eine Stringvariable, Null oder NULL sein. Wenn die in KeyValues übergebene Anzahl der Werte kleiner als die Anzahl der Spalten des für die Suche verwendeten Index ist, wird für die fehlenden Werte Null verwendet.

Hinweis

FindNearest kann nur für String-Datentypen verwendet werden.

Für Paradox- und dBASE-Tabellen muß der Schlüssel immer ein Index sein, der in der Eigenschaft IndexName angegeben werden kann. Wenn für IndexName kein Wert angegeben wurde, wird der Primärindex der Tabelle verwendet.

Bei SQL-Tabellen kann der Schlüssel einem in IndexName angegebenen Index oder einer Liste von Feldnamen in der Eigenschaft IndexFieldNames entsprechen.

FindNearest positioniert den Cursor entweder auf einem Datensatz, der genau mit den Suchkriterien übereinstimmt oder auf dem ersten Datensatz, dessen Werte größer als die in den Suchkriterien angegebenen Werte sind.


TTable::GetIndexNames

TTable	Siehe auch

Die Methode GetIndexNames ruft eine Liste aller verfügbaren Indizes einer Tabelle ab.

void __fastcall GetIndexNames(Classes::TStrings* List);

Beschreibung

Der Aufruf von GetIndexNames zeigt eine Liste aller verfügbaren Indizes einer Tabelle an. List ist ein Stringlistenobjekt, das von der Anwendung erzeugt und verwaltet wird. Die Indexnamen werden in diese Stringliste eingefügt.


TTable::GotoCurrent

TTable	Siehe auch

Die Methode GotoCurrent synchronisiert den aktuellen Datensatz der Tabelle mit dem aktuellen Datensatz der angegebenen Tabellenkomponente.

void __fastcall GotoCurrent(TTable* Table);

Beschreibung

Der Aufruf von GotoCurrent synchronisiert die Cursorposition dieser Tabelle basierend auf der Cursorposition in einer anderen Datenmenge, die eine unterschiedliche Datenquellenkomponente verwendet, jedoch mit derselben Datenbanktabelle verbunden ist. Table ist der Name der Tabellenkomponente, deren Cursorposition für die Synchronisierung verwendet wird.

Hinweis

Dieses Verfahren kann nur für Tabellenkomponenten verwendet werden, deren Eigenschaften DatabaseName und TableName übereinstimmen. Anderfalls wird eine Exception ausgelöst.

GotoCurrent ist vorwiegend für die Verwendung in Anwendungen vorgesehen, die zwei Tabellenkomponenten besitzen, die mit derselben Datenbanktabelle über unterschiedliche Datenquellenkomponenten verknüpft sind. In der Anwendung können dadurch separate Ansichten der Daten wie verknüpfte Ansichten verwendet werden.


TTable::GotoKey

TTable	Siehe auch

Die Methode GotoKey verschiebt den Cursor auf einen über den aktuellen Schlüssel angegebenen Datensatz.

bool __fastcall GotoKey(void);

Beschreibung

Mit GotoKey können Sie zu einem Datensatz wechseln, der mit Schlüsselwerten angegeben wird, die durch vorhergehende Aufrufe von SetKey oder EditKey und die Angabe der Suchwerte in der Eigenschaft Fields definiert wurden.

Wenn GotoKey einen übereinstimmenden Datensatz findet, wird der Cursor auf diesem positioniert und der Wert True zurückgegeben. Andernfalls wird die aktuelle Cursorposition nicht geändert, und GotoKey gibt den Wert False zurück.


TTable::GotoNearest

TTable	Siehe auch

Die Methode GotoNearest positioniert den Cursor auf dem Datensatz, der die größtmögliche Übereinstimmung mit dem aktuellen Schlüssel aufweist.

void __fastcall GotoNearest(void);

Beschreibung

Mit dem Aufruf von GotoNearest kann der Cursor auf dem Datensatz positioniert werden, der entweder genau mit dem durch die Schlüsselwerte in der Eigenschaft Fields angegebenen Datensatz übereinstimmt oder dessen Werte die angegebenen Werte überschreiten.

Vor dem Aufruf von GotoNearest muß die Anwendung Schlüsselwerte festlegen. Dies erfolgt durch den Aufruf von SetKey oder EditKey, um der Datenmenge den Status dsSetKey zuzuweisen. Anschließend müssen Werte für die Eigenschaft Fields angegeben werden.


TTable::LockTable

TTable	Siehe auch

Die Methode LockTable sperrt eine Paradox- oder dBASE-Tabelle.

void __fastcall LockTable(TLockType LockType);

Beschreibung

Mit dem Aufruf von LockTable kann eine Paradox- oder dBASE-Tabelle gesperrt und damit verhindert werden, daß andere Anwendungen die Tabelle sperren. LockType bezeichnet die von der Anwendung angeforderte Sperre.

Die Anforderung einer Lesesperre verhindert den Lesezugriff auf die Tabelle durch andere Anwendungen. Die Anforderung einer Schreibsperre verhindert den Schreibzugriff auf die Tabelle durch andere Anwendungen.

Eine Anwendung kann beide Sperrtypen anfordern, indem LockTable einmal für jeden Sperrtyp aufgerufen wird.


TTable::OpenIndexFile

TTable	Siehe auch

Die Methode OpenIndexFile öffnet die angegebene dBASE-Indexdatei mit einem nicht gewarteten Index.

void __fastcall OpenIndexFile(const System::AnsiString IndexName);

Beschreibung

Durch den Aufruf von OpenIndexFile kann die angegebene Indexdatei mit einem nicht gewarteten Index geöffnet werden. IndexFileName ist der Name der zu öffnenden Datei. OpenIndexFile öffnet die Datei und fügt ihren Namen der Liste der Indexdateien in der Eigenschaft IndexFiles hinzu.

Ein nicht gewarteter Index wird aktualisiert, wenn die betreffende Indexdatei geöffnet ist.


TTable::RenameTable

TTable	Siehe auch

Die Methode RenameTable bennent die Paradox- oder dBASE-Tabelle um, die mit dieser Tabellenkomponente verknüpft ist.

void __fastcall RenameTable(const System::AnsiString NewTableName);

Beschreibung

Durch den Aufruf von RenameTable kann der dieser Tabellenkomponente zugrundeliegenden Paradox- oder dBASE-Tabelle ein neuer Name zugewiesen werden. RenameTable benennt die Tabelle und die zugehörigen Dateien (für Paradox z.B. DB- und MB-Dateien) um.


TTable::SetKey

TTable	Siehe auch

Mit der Methode SetKey können Schlüssel und Bereiche für eine Datenmenge vor dem Beginn einer Suche gesetzt werden.

void __fastcall SetKey(void);

Beschreibung

Mit Hilfe von SetKey kann der Datenmenge der Status dsSetKey zugewiesen und der aktuelle Inhalt der Eigenschaft Fields freigegeben werden. Dem Array der Eigenschaft Fields kann dann vor dem Ausführen einer Suche eine neue Wertemenge zugewiesen werden.

Die Eigenschaft Fields ist eine Stringliste, die bestimmte Feldwerte für die Suche angibt. Während des Suchvorgangs werden die Werte in Fields in der Reihenfolge der Ordinalzahlen auf die Spalten der Tabelle angewendet. Fields[0] entspricht der ersten Spalte der Tabelle, Fields[1] der zweiten Spalte usw.

Hinweis

Mit dem Aufruf von EditKey kann ein vorhandener Schlüssel oder Bereich geändert werden.


TTable::SetRange

TTable	Siehe auch

Die Methode SetRange setzt die Anfangs- und Endwerte eines Bereichs und wendet sie an.

void __fastcall SetRange(const System::TVarRec *StartValues, const int StartValues_Size, const System::TVarRec  *EndValues, const int EndValues_Size);

Beschreibung

Mit Hilfe von SetRange kann ein Bereich angegeben und auf die Datenmenge angewendet werden. StartValues gibt die Feldwerte an, die den ersten Datensatz im Bereich bezeichnen. EndValues gibt die Feldwerte an, die den letzten Datensatz im Bereich bezeichnen.

SetRange kombiniert die Funktionalität von SetRangeStart, SetRangeEnd und ApplyRange in einem Prozeduraufruf. SetRange führt folgende Operationen durch:

1	Die Datenmenge erhält den Status dsSetKey.

2	Zuvor festgelegte Werte für den Anfang und das Ende des Bereichs werden gelöscht.

3	Anfangs- und Endwerte für den Bereich werden zugewiesen.

4	Der Bereich wird auf die Datenmenge angewendet.

Wenn der Anfangs- oder der Endwert weniger Elemente als der aktuelle Index Felder enthält, werden die restlichen Einträge auf NULL gesetzt.

Hinweis

Bei Paradox- oder dBASE-Tabellen arbeitet EditRangeStart nur mit indizierten Feldern. Bei SQL-Datenbanken arbeitet EditRangeStart mit jeder in der Eigenschaft IndexFieldNames angegebenen Spalte.


TTable::SetRangeEnd

TTable	Siehe auch

Die Methode SetRangeEnd gibt an, daß folgende Zuweisungen von Feldwerten das Ende des Bereichs der Zeilen angeben, die in die Datenmenge einbezogen werden sollen.

void __fastcall SetRangeEnd(void);

Beschreibung

Rufen Sie SetRangeEnd auf, um der Datenmenge den Status dsSetKey zuzuweisen. Alle vorherigen Endwerte des Bereichs werden gelöscht und auf NULL gesetzt. Anschließende Feldzuweisungen für die Eigenschaft FieldValues geben die Menge der Endwerte für einen Bereich an.

Rufen Sie nach der Zuweisung von Endbereichswerten für FieldValues ApplyRange auf, um den geänderten Bereich zu aktivieren.

Hinweis

Bei Paradox- oder dBASE-Tabellen arbeitet EditRangeEnd nur mit indizierten Feldern. In SQL-Datenbanken arbeitet EditRangeEnd mit jeder in der Eigenschaft IndexFieldNames angegebenen Spalte.


TTable::SetRangeStart

TTable	Siehe auch

Die Methode SetRangeStart gibt an, daß anschließende Zuweisungen von Feldwerten den Anfang des Bereichs der Zeilen angeben, die in die Datenmenge einbezogen werden sollen.

void __fastcall SetRangeStart(void);

Beschreibung

Rufen Sie SetRangeStart auf, um der Datenmenge den Status dsSetKey zuzuweisen. Alle vorherigen Anfangswerte des Bereichs werden gelöscht und auf NULL gesetzt. Anschließende Feldzuweisungen für die Eigenschaft FieldValues geben die Menge der Anfangswerte für einen Bereich an.

Rufen Sie nach der Zuweisung von Anfangswerten des Bereichs für FieldValues ApplyRange auf, um den geänderten Bereich zu aktivieren.

Hinweis

Bei Paradox- oder dBASE-Tabellen arbeitet EditRangeEnd nur mit indizierten Feldern. In SQL-Datenbanken arbeitet EditRangeEnd mit jeder in der Eigenschaft IndexFieldNames angegebenen Spalte.


TTable::TTable

TTable	Siehe auch

Die Methode TTable erzeugt eine Instanz einer Tabellenkomponente.

__fastcall virtual TTable(Classes::TComponent* AOwner);

Beschreibung

Mit dem Aufruf von TTable kann eine in einer Anwendung deklarierte Tabelle instantiiert werden, wenn diese während des Entwurfs nicht in ein Formular eingefügt wurde. TTable ruft den Konstruktor TTable des übergeordneten Objekts auf, erzeugt eine leere Index-Definitionsliste, eine leere Datenverknüpfung sowie eine leere Liste der Indexdateien.


TTable::UnlockTable

TTable	Siehe auch

Die Methode UnlockTable entfernt eine vorher zugewiesene Sperre von einer Paradox- oder dBASE-Tabelle.

void __fastcall UnlockTable(TLockType LockType);

Beschreibung

Mit dem Aufruf von UnlockTable können Sie die einer Paradox- oder dBASE-Tabelle zugewiesene Sperre aufheben, die verhindern sollte, daß andere Anwendungen die Tabelle sperren. LockType gibt die zu entfernende Sperre an.

Das Entfernen einer Lesesperre ermöglicht den Lesezugriff auf die Tabelle durch andere Anwendungen. Das Entfernen einer Schreibsperre ermöglicht anderen Anwendungen den Schreibzugriff auf die Tabelle.

Eine Anwendung kann beide Sperrtypen entfernen, indem UnlockTable einmal für jeden Sperrtyp aufgerufen wird.


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TDataSet

TDBDataSet


TTable Beispiel

TTable


TTabbedNotebook

Hierarchie	Eigenschaften	Methoden	Ereignisse

Die Komponente TTabbedNotebook enthält mehrere Seiten, die wiederum eine Anzahl von Steuerelementen enthalten können. Der grafische Aufbau dieser Komponente erinnert an ein Notizbuch mit eingelegtem Register.

Header

vcl/tabnotbk.hpp

Beschreibung

Der Benutzer wählt eine bestimmte Seite aus, indem er auf eines der Register am oberen Rand des Steuerelements klickt. TTabbedNotebook ist in C++Builder aus Gründen der Abwärtskompatibilität enthalten. Wenn Sie Anwendungen für Windows95 oder Windows NT entwickeln, sollten Sie statt dessen die Komponente TPageControl einsetzen.

Die Eigenschaft Pages enthält eine Liste von Strings, welche die einzelnen Seiten des Notizbuchs identifizieren. Der Zugriff auf eine bestimmte Seite erfolgt über die Eigenschaft PageIndex oder ActivePage.

Wenn Sie den Wert PageIndex für eine bestimmte Seite ermitteln müssen, rufen Sie die Methode GetIndexForPage auf.

Die Anzahl der Registerreiter, die nebeneinander in einer Reihe stehen sollen, wird mit der Eigenschaft TabsPerRow festgelegt. Bei Bedarf werden mehrere Reihen untereinander angeordnet. Die Schriftart für die Register wird mit der Eigenschaft TabFont vorgegeben.

Zusätzlich zu den hier beschriebenen Eigenschaften, Methoden und Ereignissen besitzt die Komponente auch die Eigenschaften, Methoden und Ereignisse, die allen fensterorientierten Steuerelementen gemeinsam sind.


Eigenschaften von TTabbedNotebook

TTabbedNotebook	Alphabetisch	Legende

In TTabbedNotebook

ActivePage

PageIndex

Pages

TabFont

TabsPerRow

TopFont

Abgeleitet von TWinControl

Brush

ClientOrigin

ClientRect

ControlCount

Controls

Handle

HelpContext

Showing

TabOrder

TabStop

Abgeleitet von TControl

Align

BoundsRect

ClientHeight

ClientWidth

ControlState

ControlStyle

Cursor

Enabled

Font

Height

Hint

Left

Name

Parent

ParentShowHint

PopupMenu

ShowHint

Top

Visible

Width

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TTabbedNotebook

TTabbedNotebook	Nach Objekten	Legende

ActivePage

Align

BoundsRect

Brush

ClientHeight

ClientOrigin

ClientRect

ClientWidth

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlCount

ControlState

Controls

ControlStyle

Cursor

DesignInfo

Enabled

Font

Handle

Height

HelpContext

Hint

Left

Name

Owner

PageIndex

Pages

ParentShowHint

Parent

PopupMenu

ShowHint

Showing

TabFont

TabOrder

TabsPerRow

TabStop

Tag

TopFont

Top

Visible

Width


TTabbedNotebook::ActivePage

TTabbedNotebook	Siehe auch

Die Eigenschaft ActivePage bestimmt, welche Seite im Notizbuch sichtbar ist.

__property System::AnsiString ActivePage;

Beschreibung

Der Wert von ActivePage muß einem der Strings in der Eigenschaft Pages entsprechen.


TTabbedNotebook::PageIndex

TTabbedNotebook	Siehe auch

Die Eigenschaft PageIndex bestimmt, welche Seite im Notizbuch sichtbar ist.

__property int PageIndex;

Beschreibung

Sobald der Wert von PageIndex geändert wird, ist eine andere Notizbuchseite sichtbar.

Jedem String in der Eigenschaft Pages wird automatisch ein Wert PageIndex zugewiesen, wenn die Seite erzeugt wird. Die erste Seite erhält den Index 0, die zweite den Index 1 und so fort. Wenn ein String aus der Liste gelöscht wird, wird der Index neu aufgebaut, so daß er immer bei 0 beginnt und keine Lücken aufweist.


TTabbedNotebook::Pages

TTabbedNotebook	Siehe auch

Die Eigenschaft Pages enthält eine Liste von Strings, welche die einzelnen Seiten des Notizbuchs bezeichnen.

__property Classes::TStrings* Pages;

Beschreibung

Jeder neue String in der Eigenschaft Pages erzeugt eine neue Seite. Wenn Pages beispielsweise die Strings Eins, Zwei und Drei enthält, besteht das Notizbuch aus drei getrennten Seiten.

Der Zugriff auf eine bestimmte Seite erfolgt über die Eigenschaft ActivePage oder PageIndex.


TTabbedNotebook::TabFont

TTabbedNotebook	Siehe auch

Die Eigenschaft TabFont bestimmt die Schriftart, die in den Registerreitern verwendet wird..

__property Graphics::TFont* TabFont;

Beschreibung

Der Text des ausgewählten Registers wird fett dargestellt, wenn die Eigenschaft TabFont nicht ebenfalls eine fette Schrift bezeichnet.


TTabbedNotebook::TabsPerRow

TTabbedNotebook	Siehe auch

Die Eigenschaft TabsPerRow dieent lediglich der Abwärtskompatibilität.

__property int TabsPerRow;

Beschreibung

TabsPerRow bestimmt die Anzahl der Registerreiter, die in einer einzelnen Reihe über dem Steuerelement angeordnet werden können. Bei Bedarf werden mehrere Reihen gebildet. Der Wert dieser Eigenschaft bestimmt auch die Breite der Reiter.


TTabbedNotebook::TopFont

TTabbedNotebook	Siehe auch

Die Eigenschaft TopFont bezeichnet die Schriftart, die in den Registern verwendet wird.

__property Graphics::TFont* TopFont;

Beschreibung

Mit einem Lesezugriff auf TopFont kann der Wert von TabFont ermittelt werden.


Ereignisse von TTabbedNotebook

TTabbedNotebook	Alphabetisch	Legende

In TTabbedNotebook

OnChange

OnClick

Abgeleitet von TWinControl

OnEnter

OnExit


Ereignisse von TTabbedNotebook

TTabbedNotebook	Nach Objekten	Legende

OnChange

OnClick

OnEnter

OnExit


TTabbedNotebook::OnChange

TTabbedNotebook	Siehe auch

Das Ereignis OnChange wird ausgelöst, wenn im Notizbuch eine andere Seite ausgewählt wird.

__property TPageChangeEvent OnChange;

Beschreibung

Der Methodenzeiger TPageChangeEvent verweist auf die Methode, mit der auf einen Seitenwechsel reagiert werden soll. Der Parameter NewTab bezeichnet das Register, das zum aktuellen wird. Der Parameter AllowChange steuert, ob ein Wechsel zu einer anderen Seite überhaupt möglich ist. Wenn AllowChange den Wert False hat, ist ein Seitenwechsel unmöglich.


TTabbedNotebook::OnClick

TTabbedNotebook	Siehe auch	Example

Das Ereignis OnClick wird ausgelöst, wenn auf ein Register geklickt wird.

__property Classes::TNotifyEvent OnClick;

Beschreibung

Der Methodenzeiger TNotifyEvent verweist auf die Methode, mit der auf ein Klick-Ereignis reagiert werden soll. Unmittelbar nach dem Auftreten von OnClick wird das Ereignis OnChange ausgelöst.


Methoden von TTabbedNotebook

TTabbedNotebook	Alphabetisch

In TTabbedNotebook

~TTabbedNotebook

GetIndexForPage

TTabbedNotebook

Abgeleitet von TWinControl

Broadcast

CanFocus

ContainsControl

ControlAtPos

DisableAlign

EnableAlign

Focused

GetTabOrderList

HandleAllocated

HandleNeeded

InsertControl

Invalidate

PaintTo

Realign

RemoveControl

Repaint

ScaleBy

ScrollBy

SetBounds

SetFocus

Update

UpdateControlState

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

GetTextLen

Hide

Perform

Refresh

ScreenToClient

SendToBack

SetTextBuf

Show

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TTabbedNotebook

TTabbedNotebook	Nach Objekten

~TTabbedNotebook

Assign

BeginDrag

BringToFront

Broadcast

CanFocus

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

ClientToScreen

ContainsControl

ControlAtPos

DefaultHandler

DestroyComponents

Destroying

DisableAlign

Dispatch

DragDrop

Dragging

EnableAlign

EndDrag

FieldAddress

FindComponent

Focused

FreeInstance

FreeNotification

Free

GetIndexForPage

GetParentComponent

GetTabOrderList

GetTextBuf

GetTextLen

HandleAllocated

HandleNeeded

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InsertControl

InstanceSize

Invalidate

MethodAddress

MethodName

NewInstance

PaintTo

Perform

Realign

Refresh

RemoveComponent

RemoveControl

Repaint

ScaleBy

ScreenToClient

ScrollBy

SendToBack

SetBounds

SetFocus

SetTextBuf

Show

TTabbedNotebook

UpdateControlState

Update


TTabbedNotebook::~TTabbedNotebook

TTabbedNotebook	Siehe auch

Der Destruktor gibt eine TTabbedNotebook-Komponente frei.

__fastcall virtual ~TTabbedNotebook(void);

Beschreibung

~TTabbedNotebook gibt das Schriftobjekt und Listenobjekt frei, in dem die einzelnen Notizbuchseiten hinterlegt sind. Anschließend wird der Destruktor des übergeordneten Objekts aufgerufen.


TTabbedNotebook::GetIndexForPage

TTabbedNotebook	Siehe auch

Die Methode gibt den Indexwert (PageIndex) einer bestimmten Seite zurück.

int __fastcall GetIndexForPage(const System::AnsiString PageName);

Beschreibung

Der Wert der Eigenschaft PageIndex einer bestimmten Seite wird durch die Position der Seite in der Array-Eigenschaft Pages bestimmt. Übergeben Sie den Namen der Seite im Parameter PageName. Der Name muß einem der Strings in der Eigenschaft Pages entsprechen.


TabFontChange

Die Methode sendet eine Botschaft CM_TABFONTCHANGED.

Beschreibung

TabFontChanged ruft die Methode Perform auf, die wiederum die Botschaft CM_TABFONTCHANGED als Reaktion auf eine Änderung der Schriftart im Register sendet.


TTabbedNotebook::TTabbedNotebook

TTabbedNotebook	Siehe auch

Die Methode erzeugt eine Notizbuchkomponente mit Register.

__fastcall virtual TTabbedNotebook(Classes::TComponent* AOwner);

Beschreibung

TTabbedNotebook ruft den Konstruktor des übergeordneten Objekt auf und initialisiert die Komponente. Dazu wird ein TList-Objekt erzeugt, in dem die einzelnen Seiten des Notizbuchs per Name hinterlegt sind, sowie ein TFont-Objekt für die Schriftart in den Registern.


Gültigkeitsbereich

Published

Zugriff

Nur Lesen


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TControl

TWinControl

TCustomTabControl


Beispiel für TTabbedNotebook

TTabbedNotebook


TTabPage

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/tabnotbk.hpp

Die Komponente TTabPage implementiert das Verhalten einer einzelnen Seite einer Registerkarte.

Beschreibung

Jede Instanz dieser Klasse enthält die Steuerelemente, die angezeigt werden, wenn die entsprechende Seite der Registerkarte aktiviert wird.


Eigenschaften von TTabPage

TTabPage	Alphabetisch	Legende

Abgeleitet von TWinControl

Brush

ClientOrigin

ClientRect

ControlCount

Controls

Handle

HelpContext

Showing

TabOrder

TabStop

Abgeleitet von TControl

Align

BoundsRect

Caption

ClientHeight

ClientWidth

ControlState

ControlStyle

Cursor

Enabled

Height

Hint

Left

Name

Parent

ShowHint

Top

Visible

Width

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TTabPage

TTabPage	Nach Objekten	Legende

Align

BoundsRect

Brush

Caption

ClientHeight

ClientOrigin

ClientRect

ClientWidth

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlCount

ControlState

Controls

ControlStyle

Cursor

DesignInfo

Enabled

Handle

Height

HelpContext

Hint

Left

Name

Owner

Parent

ShowHint

Showing

TabOrder

TabStop

Tag

Top

Visible

Width


Methoden von TTabPage

TTabPage	Alphabetisch

In TTabPage

~TTabPage

TTabPage

Abgeleitet von TWinControl

Broadcast

CanFocus

ContainsControl

ControlAtPos

DisableAlign

EnableAlign

Focused

GetTabOrderList

HandleAllocated

HandleNeeded

InsertControl

Invalidate

PaintTo

Realign

RemoveControl

Repaint

ScaleBy

ScrollBy

SetBounds

SetFocus

Update

UpdateControlState

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

GetTextLen

Hide

Perform

Refresh

ScreenToClient

SendToBack

SetTextBuf

Show

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TTabPage

TTabPage	Nach Objekten

~TTabPage

Assign

BeginDrag

BringToFront

Broadcast

CanFocus

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

ClientToScreen

ContainsControl

ControlAtPos

DefaultHandler

DestroyComponents

Destroying

DisableAlign

Dispatch

DragDrop

Dragging

EnableAlign

EndDrag

FieldAddress

FindComponent

Focused

FreeInstance

FreeNotification

Free

GetParentComponent

GetTabOrderList

GetTextBuf

GetTextLen

HandleAllocated

HandleNeeded

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InsertControl

InstanceSize

Invalidate

MethodAddress

MethodName

NewInstance

PaintTo

Perform

Realign

Refresh

RemoveComponent

RemoveControl

Repaint

ScaleBy

ScreenToClient

ScrollBy

SendToBack

SetBounds

SetFocus

SetTextBuf

Show

TTabPage

UpdateControlState

Update


TTabPage::~TTabPage

TTabPage

Der Destruktor ~TTabPage gibt den Speicher frei, der für das TTabPage-Objekt reserviert war. Rufen Sie ~TTabPage nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TTabPage automatisch aufgerufen wird.

__fastcall virtual ~TTabPage(void);


TTabPage::TTabPage

TTabPage

Die Methode TTabPage erzeugt eine Seite für eine Registerkarte.

__fastcall virtual TTabPage(Classes::TComponent* AOwner);

Beschreibung

TTabPage ruft den Konstruktor des übergeordneten Objekts auf und initialisiert anschließend die Seite.


Gültigkeitsbereich

Published

Zugriff

Read-only


Hierarchie

TObject

TPersistent

TComponent

TControl

TWinControl


TTabPage Beispiel

TTabPage


TTabSet
Ð [image] TTabSet

Hierarchie	Eigenschaften	Methoden	Ereignisse

Header

vcl/tabs.hpp

Die Komponente TTabSet dient zur Anzeige horizontal angeordneter Register, auf die Benutzer klicken können.

Beschreibung

Register werden häufig zusammen mit TNotebook-Steuerelementen eingesetzt, um in einem Dialogfeld mehrere Seiten anzuzeigen. Die TTabSet-Komponente dient der Abwärtskompatibilität. Sie wird in Microsoft Windows 95- und Windows NT-Anwendungen eingesetzt.

Die Erstellung der Register eines Registersteuerelements erfolgt durch die Angabe einer Liste mit Strings, die als Wert für die Eigenschaft Tabs übergeben wird. Für jeden String wird ein Register erzeugt. Wenn Sie einen Registersatz mit einem Notizbuch-Steuerelement (TNotebook) verbinden wollen, können Sie mit der folgenden Quelltextzeile für jede Seite des Notizbuchs ein Register erstellen:

In der Ereignisbehandlungsroutine für OnClick des Registersteuerelements kann mit folgendem Quelltext der Wechsel der aktuellen Seite im Notizbuch implementiert werden (der Seitenwechsel erfolgt, wenn der Benutzer auf ein Register klickt):

Mit Hilfe der Eigenschaft TabIndex kann festgestellt werden, welches Register aktuell ausgewählt ist. Sie können TabIndex aber auch verwenden, um ein Register auszuwählen. Die Eigenschaft FirstIndex legt fest, welches Register im Registersatz das erste sichtbare Register darstellt. Sie können FirstIndex auch abfragen, um das betreffende Register zu ermitteln.


Eigenschaften von TTabSet

TTabSet	Alphabetisch	Legende

In TTabSet

AutoScroll

BackgroundColor

DitherBackground

EndMargin

FirstIndex

SelectedColor

StartMargin

Style

TabHeight

TabIndex

Tabs

UnselectedColor

VisibleTabs

Abgeleitet von TCustomControl

Canvas

Abgeleitet von TWinControl

Brush

ClientOrigin

ClientRect

ControlCount

Controls

Handle

HelpContext

Showing

TabOrder

TabStop

Abgeleitet von TControl

Align

BoundsRect

ClientHeight

ClientWidth

ControlState

ControlStyle

Cursor

DragMode

Enabled

Font

Height

Hint

Left

Name

Parent

ParentShowHint

PopupMenu

ShowHint

Top

Visible

Width

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TTabSet

TTabSet	Nach Objekten	Legende

Align

AutoScroll

BackgroundColor

BoundsRect

Brush

Canvas

ClientHeight

ClientOrigin

ClientRect

ClientWidth

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlCount

ControlState

Controls

ControlStyle

Cursor

DesignInfo

DitherBackground

DragMode

Enabled

EndMargin

FirstIndex

Font

Handle

Height

HelpContext

Hint

Left

Name

Owner

ParentShowHint

Parent

PopupMenu

SelectedColor

ShowHint

Showing

StartMargin

Style

TabHeight

TabIndex

TabOrder

TabStop

Tabs

Tag

Top

UnselectedColor

VisibleTabs

Visible

Width


TTabSet::AutoScroll

TTabSet	Siehe auch

Die Eigenschaft AutoScroll bestimmt, ob die Bildlaufschaltflächen automatisch in einem Registersatz-Steuerelement angezeigt werden, wenn nicht alle Register darin Platz finden.

__property bool AutoScroll;

Beschreibung

Wenn AutoScroll den Wert False hat, kann die Anwendung über die Eigenschaften FirstIndex bzw. TabIndex zur Entwurfs- oder Laufzeit trotzdem auf Register zugreifen, die nicht sichtbar sind. Der Benutzer kann allerdings zur Laufzeit nicht auf die Register klicken.


TTabSet::BackgroundColor

TTabSet	Siehe auch

Die Eigenschaft BackgroundColor bestimmt die Hintergrundfarbe für den Registersatz.

__property Graphics::TColor BackgroundColor;

Beschreibung

Der Hintergrund eines Registersatz-Steuerelements ist der Bereich zwischen den einzelnen Registern und dem Rahmen des Steuerelements. Eine Liste der verfügbaren Farbwerte finden Sie in der Beschreibung der Eigenschaft Color.


TTabSet::DitherBackground

TTabSet	Siehe auch

Die Eigenschaft DitherBackground legt fest, ob die mit BackgroundColor festgelegte Hintergrundfarbe aufgehellt wird.

__property bool DitherBackground;

Beschreibung

Die Aufhellung bewirkt eine um 50% hellere Darstellung des Hintergrund. Die Register sind dadurch leichter zu erkennen. Wenn DitherBackground den Wert True hat, wird der Hintergrund des Registersatzes aufgehellt. Ist der Wert False, findet keine Aufhellung statt.


TTabSet::EndMargin

TTabSet	Siehe auch

Die Eigenschaft EndMargin legt den Abstand (in Pixel) zwischen dem rechten Register und dem rechten Rand des Registersatzes fest.

__property int EndMargin;

Beschreibung

Mit der Eigenschaft EndMargin bestimmen Sie den Abstand zwischen dem rechten Register und dem rechten Rand des Registersatz-Steuerelements. Die Angabe erfolgt in Pixel. Zusammen mit der Eigenschaft StartMargin kann so festgelegt werden, wie viele Register im Steuerelement Platz haben.

Wenn AutoScroll den Wert True hat und der Registersatz Bildlaufschaltflächen enthält, gibt EndMargin den Abstand (in Pixel) zwischen dem rechten Register und dem linken Rand der Bildlaufschaltflächen an.


TTabSet::FirstIndex

TTabSet	Siehe auch

Die Eigenschaft FirstIndex gibt das Register an, das ganz links im Registersatz angezeigt wird.

__property int FirstIndex;

Beschreibung

Register, die in der Eigenschaft FirstIndexeinen niedrigeren Wert aufweisen, werden im Registersatz-Steuerelement ganz nach links verschoben und sind unsichtbar, bis der Benutzer den Bildausschnitt verschiebt.

Der Standardwert für FirstIndex ist 0, d.h. die Registerkarte mit dem Index 0 nimmt die Position ganz links ein. Existieren drei Registerkarten mit den Beschriftungen Eins, Zwei und Drei und den Werten 0, 1 und 2 in der Eigenschaft TabIndex wird das Register Eins zuerst angezeigt (sie hat den Indexwert 0). Wenn nun die Reihenfolge der Register geändert werden soll (d.h. das Register Zwei oder Drei soll die linke Position im Steuerelement einnehmen), muß der Wert der Eigenschaft FirstIndex des Registers Eins in 1 oder 2 geändert werden.


TTabSet::SelectedColor

TTabSet	Siehe auch

Die Eigenschaft SelectedColor bestimmt die Farbe des Registers, das im Registersatz ausgewählt ist.

__property Graphics::TColor SelectedColor;

Beschreibung

Mit der Eigenschaft SelectedColor legen Sie die Farbe des Registers fest, das im Registersatz-Steuerelement ausgewählt ist. Eine Liste der verfügbaren Farbwerte finden Sie in der Beschreibung der Eigenschaft Color.


TTabSet::StartMargin

TTabSet	Siehe auch

Die Eigenschaft StartMargin legt den Abstand (in Pixel) zwischen dem ersten Register und dem linken Rand des Registersatzes fest.

__property int StartMargin;

Beschreibung

Mit Hilfe der Eigenschaften StartMargin und EndMargin kann festgelegt werden, wie viele Register im Registersatz-Steuerelement Platz haben.


TTabSet::Style

TTabSet	Siehe auch

Die Eigenschaft Style legt das Aussehen eines Registers fest.

__property TTabStyle Style;

Beschreibung

Die Eigenschaft Style kann folgende Werte annehmen:

Wert	Beschreibung

tsStandard	Jedes Register besitzt die Standardgröße und das Standardaussehen.

tsOwnerDraw	Jedes Register hat die in der Eigenschaft TabHeight festgelegte Höhe. Die Breite wird an den enthaltenen Text bzw. das enthaltene Bitmap angepaßt.

In benutzerdefinierten Register können neben den üblichen Strings auch Grafiken usw. angezeigt werden. Für diese Register ist allerdings ein größerer Programmieraufwand erforderlich als für Standardregister, da Informationen zur Anzeige der Bilder in den einzelnen Register des Steuerelements an die Anwendung übergeben werden müssen.

Sobald ein Eintrag in einer Registerkarte mit dem Status tsOwnerDraw angezeigt wird, treten zwei Ereignisse ein. Zuerst wird das OnMeasureTab-Ereignis ausgelöst. In der Ereignisbehandlungsroutine für OnMeasureTab definieren Sie den Quelltext zur Berechnung der Breite, die das Register zur Aufnahme des Textes bzw. des Bildes aufweisen muß. Nach dem OnMeasureTab-Ereignis tritt das Ereignis OnDrawTab ein. Die Ereignisbehandlungsroutine für OnDrawTab muß den Quelltext zum Zeichnen des Registers und seines Inhalts enthalten. Dabei wird die im Ereignis OnMeasureTab angegebene Breite und die in der Eigenschaft TabHeight festgelegte Höhe verwendet.


TTabSet::TabHeight

TTabSet	Siehe auch

Die Eigenschaft TabHeight legt die Höhe der Register in einem Registersatz fest, wenn dessen Eigenschaft Style den Wert tsOwnerDraw besitzt.

__property int TabHeight;

Beschreibung

Hat die Eigenschaft Style den Wert tsStandard, wird der Wert der Eigenschaft TabHeight ignoriert.


TTabSet::TabIndex

TTabSet	Siehe auch

Die Eigenschaft TabIndex gibt an, welches Register in einem Registersatz ausgewählt ist.

__property int TabIndex;

Beschreibung

Für TabIndex kann ein Wert angegeben werden, der zwischen -1 und einer Zahl liegt, die um Eins kleiner als die Anzahl der Strings im Array der Eigenschaft Tabs (Tabs::Count - 1) ist. Mit dem Wert 0 wird das erste Register im Registersatz ausgewählt, mit dem Wert 1 die zweite usw. Wenn keine Register ausgewählt sind, hat TabIndex einen Wert von -1.

TabIndex kann als Index für das Array der Eigenschaft Tabs verwendet werden.

Bei der Zuweisung eines Wertes an TabIndex wird zuerst das Ereignis OnClick und anschließend das Ereignis OnChange für den Registersatz ausgelöst. Dies entspricht dem Klicken auf ein Register.


TTabSet::Tabs

TTabSet	Siehe auch 	Beispiel

Die Eigenschaft Tabs enthält eine Liste mit den Strings, die in den Register angezeigt werden.

__property Classes::TStrings* Tabs;

Beschreibung

Für jeden String in der Eigenschaft Tabs wird ein neues Register erzeugt, das den betreffenden Text enthält. Die gewünschten Strings können während des Entwurfs im Stringlisteneditor eingegeben werden. Durch einen Doppelklick auf die Wertespalte der Eigenschaft Tabs öffnen Sie den Stringlisteneditor. Es besteht aber auch die Möglichkeit, Strings in der Eigenschaft Tabs zur Laufzeit zu ändern.


TTabSet::UnselectedColor

TTabSet	Siehe auch

Die Eigenschaft UnselectedColor bestimmt die Farbe der Register, die im Registersatz aktuell nicht ausgewählt sind.

__property Graphics::TColor UnselectedColor;

Beschreibung

Mit Hilfe der Eigenschaft UnselectedColor legen Sie die Farbe der Register fest, die im Registersatz-Steuerelement aktuell nicht ausgewählt sind.


TTabSet::VisibleTabs

TTabSet	Siehe auch

Die Eigenschaft VisibleTabs enthält die Anzahl der Register, die im Registersatz momentan sichtbar sind.

__property int VisibleTabs;

Beschreibung

Mit Hilfe der Eigenschaft VisibleTabs kann festgestellt werden, wie viele Register im Registersatz-Steuerelement aktuell sichtbar sind.


Ereignisse von TTabSet

TTabSet	Alphabetisch	Legende

In TTabSet

OnChange

OnDrawTab

OnMeasureTab

Abgeleitet von TWinControl

OnEnter

OnExit

Abgeleitet von TControl

OnClick

OnDragDrop

OnDragOver

OnEndDrag

OnMouseDown

OnMouseMove

OnMouseUp

OnStartDrag


Ereignisse von TTabSet

TTabSet	Nach Objekten	Legende

OnChange

OnClick

OnDragDrop

OnDragOver

OnDrawTab

OnEndDrag

OnEnter

OnExit

OnMeasureTab

OnMouseDown

OnMouseMove

OnMouseUp

OnStartDrag


TTabSet::OnChange

TTabSet

Das Ereignis OnChange tritt ein, bevor ein neues Register ausgewählt wird.

__property TTabChangeEvent OnChange;

Beschreibung

OnChange tritt ein, bevor sich der Wert von TabIndex ändert. Sie können eine Änderung des Wertes in TabIndex verhindern, indem Sie entsprechenden Quelltext in die Ereignisbehandlungsroutine für OnChange aufnehmen.

Der Typ TTabChangeEvent zeigt auf eine Methode, die aufgerufen wird, wenn sich das ausgewählte Register in einem Registersatz ändert. Das auszuwählende Register wird im Parameter NewTab angegeben. Mit der Variablen AllowChange wird festgelegt, ob die Änderung zulässig ist. Ist AllowChange False, kann der Benutzer nicht zum neuen Register wechseln (das Register ist nicht aktivierbar).


TTabSet::OnDrawTab

TTabSet	Siehe auch

Das Ereignis OnDrawTab tritt bei der Neuanzeige eines Registers in einem benutzerdefinierten Registersatz ein.

__property TDrawTabEvent OnDrawTab;

Beschreibung

OnDrawTab tritt bei der Neuanzeige eines Registers ein, wenn die Eigenschaft Style den Wert tsOwnerDraw besitzt. Dies ist zum Beispiel der Fall, wenn der Benutzer ein Register auswählt oder den Bildausschnitt verschiebt.

Der Quelltext zum Zeichnen des Registers muß in der Ereignisbehandlungsroutine für OnDrawTab bereitgestellt werden.

OnDrawTab tritt direkt nach dem Ereignis OnMeasureTab ein. In diesem Ereignis ist der Quelltext zur Berechnung der Breite und Höhe des Registersenthalten. Die Höhe des Registers wird durch den Wert der Eigenschaft TabHeight für das Registersatz-Steuerelement festgelegt. Der Quelltext in der Ereignisbehandlungsroutine für OnDrawTab muß deshalb die Breite benutzen, die vom Ereignis OnMeasureTab bestimmt wurde.

Der Typ TDrawTabEvent zeigt auf eine Methode, die das Zeichnen eines Elements in einem benutzerdefinierten Register übernimmt. Der Parameter TabCanvas gibt die Zeichenfläche an, auf der das Element gezeichnet wird. Der Parameter Index bezeichnet die Position des Registers im Registersatz. R ist der Bereich, in dem das Element gezeichnet werden soll, und Selected bestimmt, ob das Register ausgewählt ist.


TTabSet::OnMeasureTab

TTabSet	Siehe auch

Das Ereignis OnMeasureTab tritt ein, wenn eine Anwendung ein Register in einem benutzerdefinierten Registersatz neu anzeigen muß.

__property TMeasureTabEvent OnMeasureTab;

Beschreibung

OnMeasureTab tritt nur ein, wenn die Eigenschaft Style den Wert tsOwnerDraw hat. In der Ereignisbehandlungsroutine für OwnerMeasureTab muß der Quelltext bereitgestellt werden, der die Breite des zu zeichnenden Registers berechnet. Nach dem Ereignis OnMeasureTab tritt das Ereignis OnDrawTab ein. Verwenden Sie im Quelltext zum Zeichnen des Registers die Breite, die in OnMeasureTab in der Ereignisbehandlungsroutine für OnDrawTab berechnet wurde.

Der Typ TMeasureTabEvent zeigt auf eine Methode, die die Maße eines Registers in einem benutzerdefinierten Registersatz einstellt. Der Quelltext muß die Breite des Registers in Abhängigkeit von deren Inhalt berechnen und zurückgeben (wenn die Eigenschaft Style des Registers auf tsOwnerDraw gesetzt ist). Der Parameter Index bezeichnet die Position des Registers im Registersatz. TabWidth gibt die Breite des Registers an.


Methoden von TTabSet

TTabSet	Alphabetisch

In TTabSet

~TTabSet

ItemAtPos

ItemRect

SelectNext

TTabSet

Abgeleitet von TWinControl

Broadcast

CanFocus

ContainsControl

ControlAtPos

DisableAlign

EnableAlign

Focused

GetTabOrderList

HandleAllocated

HandleNeeded

InsertControl

Invalidate

PaintTo

Realign

RemoveControl

Repaint

ScaleBy

ScrollBy

SetBounds

SetFocus

Update

UpdateControlState

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

GetTextLen

Hide

Perform

Refresh

ScreenToClient

SendToBack

SetTextBuf

Show

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TTabSet

TTabSet	Nach Objekten

~TTabSet

Assign

BeginDrag

BringToFront

Broadcast

CanFocus

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

ClientToScreen

ContainsControl

ControlAtPos

DefaultHandler

DestroyComponents

Destroying

DisableAlign

Dispatch

DragDrop

Dragging

EnableAlign

EndDrag

FieldAddress

FindComponent

Focused

FreeInstance

FreeNotification

Free

GetParentComponent

GetTabOrderList

GetTextBuf

GetTextLen

HandleAllocated

HandleNeeded

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InsertControl

InstanceSize

Invalidate

ItemAtPos

ItemRect

MethodAddress

MethodName

NewInstance

PaintTo

Perform

Realign

Refresh

RemoveComponent

RemoveControl

Repaint

ScaleBy

ScreenToClient

ScrollBy

SelectNext

SendToBack

SetBounds

SetFocus

SetTextBuf

Show

TTabSet

UpdateControlState

Update


TTabSet::~TTabSet

TTabSet	Siehe auch

Der Destruktor ~TTabSet gibt den Speicher frei, der für das TTabSet-Objekt reserviert war. Rufen Sie ~TTabSet nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TTabSet automatisch aufgerufen wird.

__fastcall virtual ~TTabSet(void);

Beschreibung

~TTabSet gibt das TTabList-Objekt mit der Liste der Register frei und ruft anschließend den Destruktor des übergeordneten Objekts auf.


TTabSet::ItemAtPos

TTabSet	Siehe auch

Die Methode ItemAtPos gibt den Index des Registers zurück, die über ihre Koordinaten im Steuerelement angegeben ist.

int __fastcall ItemAtPos(const POINT &Pos);

Beschreibung

Der Parameter Pos bezeichnet einen Punkt im Steuerelement. Er wird in Fensterkoordinaten angegeben. Lautet der zurückgegebene Index 0, handelt es sich um das erste Register im Registersatz, ein Wert von 1 bezeichnet das zweite Register usw.

Mit Hilfe von ItemAtPos läßt sich auf einfach Weise feststellen, welches Register sich an einer bestimmten Position im Registersatz befindet.


TTabSet::ItemRect

TTabSet	Siehe auch

Die Methode ItemRect gibt das Rechteck zurück, das im Parameter Item angegebene Element umschließt.

Windows::TRect __fastcall ItemRect(int Item);

Beschreibung

Mit ItemRect können Sie beim Zeichnen in einem benutzerdefinierten Registersatz das Rechteck ermitteln, das ein bestimmtes Register umgibt.


TTabSet::SelectNext

TTabSet	Siehe auch

SelectNext wählt das nächste Register in einem Registersatz aus. Gegebenenfalls wird der Bildausschnitt verschoben, um das betreffende Register anzuzeigen.

void __fastcall SelectNext(bool Direction);

Beschreibung

Der Wert des Parameters Direction bestimmt, ob das Register links oder rechts ausgewählt wird. Hat Direction den Wert True, wird das nächste Register auf der rechten Seite ausgewählt. Ist Direction False, wird zum nächsten Register auf der linken Seite gewechselt. Befindet sich rechts bzw. links neben dem aktuellen Register kein weiteres Register, wird bei einem Aufruf von SelectNext an den Anfang bzw. an das Ende der Register gesprungen. Wenn beispielsweise in einer Anwendung die drei Register Eins, Zwei und Drei existieren und Drei das aktuelle Register ist, führt der Aufruf von SelectNext(True) zur Auswahl des Registers Eins. Ist Eins das aktuelle Register, wird durch einen Aufruf von SelectNext(False) das Register Drei zum aktuellen Register.

Durch den Aufruf von SelectNext wird zuerst das Ereignis OnClick und anschließend das Ereignis OnChange für den Registersatz ausgelöst (entspricht dem Klicken auf ein Register).


TTabSet::TTabSet

TTabSet	Siehe auch

Die Methode TTabSet erzeugt ein Registersatz-Steuerelement.

__fastcall virtual TTabSet(Classes::TComponent* AOwner);

Beschreibung

TTabSet ruft den Konstruktor des übergeordneten Objekts auf, initialisiert das Steuerelement und erzeugt unter anderem ein TTabList-Objekt, das die Register des Steuerelements enthält.


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TControl

TWinControl

TCustomControl


TTabSet Beispiel

TTabSet


TTabSheet

Hierarchie	Eigenschaften	Methoden	Ereignisse

Header

vcl/comctrls.hpp

Die Komponente TTabSheet repräsentiert eine einzelne Seite einer TPageControl-Komponente.

Beschreibung

Registerkarten, wie sie als Komponenten der Benutzeroberfläche existieren, werden auch als Seiten bezeichnet. Die Komponente TPageControl verwaltet ein Array ihrer Registerkarten in der Eigenschaft Pages. Der Index des Arrays beginnt bei 0. Die Eigenschaft PageCount gibt die Zahl der Registerkarten an, die Eigenschaft ActivePage die gegenwärtig aktive Registerkarte. Mit einem Klick auf ein Register wird die entsprechende Registerkarte aktiviert. Mit den Methoden FindNextPage und SelectNectPage können Sie alle Registerkarten des TPageControl-Objekts durchlaufen.

Zur Entwurfszeit wird der Registerkarte automatisch ein Wert für PageIndex zugewiesen (die erste Registerkarte erhält den Index 0). Die Eigenschaft TabVisible ist standardmäßig True. Zur Laufzeit gibt die Nur-Lesen-Eigenschaft TabIndex den Index des Registers zurück. Wenn TabIndex den Wert -1 hat, ist das Register nicht sichtbar. Die Eigenschaft PageControl legt fest, zu welchem TPageControl-Objekt die Registerkarte gehört.

Neben dem beschriebenen Verhalten verfügt die Komponente über die Eigenschaften, Methoden und Ereignisse, die allen fensterorientierten Steuerelementen eigen sind.


Eigenschaften von TTabSheet

TTabSheet	Alphabetisch	Legende

Abgeleitet von TTabSheet

PageControl

PageIndex

TabIndex

TabVisible

Abgeleitet von TWinControl

Brush

ClientOrigin

ClientRect

ControlCount

Controls

Handle

HelpContext

Showing

TabOrder

TabStop

Abgeleitet von TControl

Align

BoundsRect

Caption

ClientHeight

ClientWidth

ControlState

ControlStyle

Cursor

Enabled

Font

Height

Hint

Left

Name

Parent

ParentFont

ParentShowHint

PopupMenu

ShowHint

Top

Visible

Width

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TTabSheet

TTabSheet	Nach Objekten	Legende

Align

BoundsRect

Brush

Caption

ClientHeight

ClientOrigin

ClientRect

ClientWidth

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlCount

ControlState

Controls

ControlStyle

Cursor

DesignInfo

Enabled

Font

Handle

Height

HelpContext

Hint

Left

Name

Owner

PageControl

PageIndex

ParentFont

ParentShowHint

Parent

PopupMenu

ShowHint

Showing

TabIndex

TabOrder

TabStop

TabVisible

Tag

Top

Visible

Width


TTabSheet::PageControl

TTabSheet	Siehe auch

Die Eigenschaft PageControl gibt das TPageControl-Objekt zurück, das mit dem TTabSheet-Objekt verknüpft ist.

__property TPageControl* PageControl;

Registerkarten repräsentieren die einzelnen Seiten eines TPageControl-Objekts.


TTabSheet::PageIndex

TTabSheet	Siehe auch

Mit der Eigenschaft PageIndex können Sie auf den Index der Registerkarte zugreifen.

__property int PageIndex;

Beschreibung

Registerkarten repräsentieren die Seiten eines TPageControl-Objekts. Jeder Registerkarte eines TPageControl-Objekts wird bei ihrer Erzeugung automatisch ein Index zugewiesen. Die erste Registerkarte erhält den Index 0, die zweite 1 usw. Die Werte für PageIndex werden neu zugewiesen, wenn eine Registerkarte gelöscht wird.

Mit PageIndex können Sie auf den Index der Registerkarte zugreifen. Um auf eine bestimmte Registerkarte über ihren Index zuzugreifen, verwenden Sie die Eigenschaft Pages des TPageControl-Objekts.


TTabSheet::TabIndex

TTabSheet	Siehe auch

Die Eigenschaft TabIndex gibt den Index der Registerkarte in einem Array der sichtbaren Register eines TPageControl-Objekts zurück.

__property int TabIndex;

Beschreibung

Eine Registerkarte kann beispielsweise einen PageIndex-Wert von 3 und einen TabIndex-Wert von 2 haben, wenn eine vorherige Registerkarte des TPageControl-Objekts nicht sichtbar ist. Wenn die Eigenschaft TabVisible einer Registerkarte False ist, hat TabIndex den Wert -1.


TTabSheet::TabVisible

TTabSheet	Siehe auch

Die Eigenschaft TabVisible gibt an, ob das Register einer TTabSheet-Komponente in einem TPageControl-Objekt sichtbar ist.

__property bool TabVisible;

Beschreibung

Wenn TabVisible False ist, hat die Eigenschaft TabIndex den Wert -1. Eine Registerkarte wird durch Anklicken des entsprechenden Registers aktiviert. Wenn TabVisible False ist, wird das Register jedoch nicht angezeigt. In diesem Fall können Sie CheckTabVisible auf False setzen und mit der Methode FindNextPage sowohl die sichtbaren als auch die nicht sichtbaren TPageControl-Objekte durchlaufen und die Registerkarte aktivieren. Mit folgendem Code können Sie beispielsweise ein Register zur Laufzeit verbergen:


Ereignisse von TTabSheet

TTabSheet	Alphabetisch	Legende

Abgeleitet von TWinControl

OnEnter

OnExit

Abgeleitet von TControl

OnDragDrop

OnDragOver

OnMouseDown

OnMouseMove

OnMouseUp


Ereignisse von TTabSheet

TTabSheet	Nach Objekten	Legende

OnDragDrop

OnDragOver

OnEnter

OnExit

OnMouseDown

OnMouseMove

OnMouseUp


Methoden von TTabSheet

TTabSheet	Alphabetisch

Abgeleitet von TTabSheet

~TTabSheet

TTabSheet

Abgeleitet von TWinControl

Broadcast

CanFocus

ContainsControl

ControlAtPos

DisableAlign

EnableAlign

Focused

GetTabOrderList

HandleAllocated

HandleNeeded

InsertControl

Invalidate

PaintTo

Realign

RemoveControl

Repaint

ScaleBy

ScrollBy

SetBounds

SetFocus

Update

UpdateControlState

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

GetTextLen

Hide

Perform

Refresh

ScreenToClient

SendToBack

SetTextBuf

Show

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TTabSheet

TTabSheet	Nach Objekten

~TTabSheet

Assign

BeginDrag

BringToFront

Broadcast

CanFocus

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

ClientToScreen

ContainsControl

ControlAtPos

DefaultHandler

DestroyComponents

Destroying

DisableAlign

Dispatch

DragDrop

Dragging

EnableAlign

EndDrag

FieldAddress

FindComponent

Focused

FreeInstance

FreeNotification

Free

GetParentComponent

GetTabOrderList

GetTextBuf

GetTextLen

HandleAllocated

HandleNeeded

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InsertControl

InstanceSize

Invalidate

MethodAddress

MethodName

NewInstance

PaintTo

Perform

Realign

Refresh

RemoveComponent

RemoveControl

Repaint

ScaleBy

ScreenToClient

ScrollBy

SendToBack

SetBounds

SetFocus

SetTextBuf

Show

TTabSheet

UpdateControlState

Update


TTabSheet::~TTabSheet

TTabSheet	Siehe auch

Der Destruktor ~TTabSheet gibt den Speicher frei, der für das TTabSheet-Objekt reserviert war. Rufen Sie ~TTabSheet nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TTabSheet automatisch aufgerufen wird.

__fastcall virtual ~TTabSheet(void);

Beschreibung

~TTabSheet entfernt die Seite aus dem Register und ruft den Destruktor seines übergeordneten Objekts auf.


TTabSheet::TTabSheet

TTabSheet	Siehe auch

Die Methode TTabSheet erzeugt eine Registerkarte.

__fastcall virtual TTabSheet(Classes::TComponent* AOwner);

Beschreibung

TTabSheet ruft die geerbte Version der Methode TTabSheet auf und initialisiert anschließend die Registerkarte.


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TControl

TWinControl


TTabSheet Beispiel

TTabSheet


TTableDataLink

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/dbtables.hpp

TTableDataLink ist ein Hilfsobjekt, das es einem TTable-Objekt ermöglicht, auch solche Datensätze zu repräsentieren, die nicht aus einer physikalischen Datenbanktabelle stammen, sondern aus einer anderen Datenquelle.

Beschreibung

TTableDataLink ist für den Einsatz in Verbindung mit einem TTable-Objekt vorgesehen. Es sollte nur von der Klasse TTable verwendet werden.


Eigenschaften von TTableDataLink

TTableDataLink	Alphabetisch	Legende

Abgeleitet von TDataLink

Active

ActiveRecord

BufferCount

DataSet

DataSource

DataSourceFixed

Editing

ReadOnly

RecordCount


Eigenschaften von TTableDataLink

TTableDataLink	Nach Objekten	Legende

ActiveRecord

Active

BufferCount

DataSet

DataSourceFixed

DataSource

Editing

ReadOnly

RecordCount


Methoden von TTableDataLink

TTableDataLink	Alphabetisch	Legende

In TTableDataLink

~TTableDataLink

ActiveChanged

CheckBrowseMode

LayoutChanged

RecordChanged

TTableDataLink

Abgeleitet von TDataLink

Edit

UpdateRecord

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TTableDataLink

TTableDataLink	Nach Objekten	Legende

~TTableDataLink

ActiveChanged

Assign

CheckBrowseMode

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

Edit

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

LayoutChanged

MethodAddress

MethodName

NewInstance

RecordChanged

TTableDataLink

UpdateRecord


TTableDataLink::~TTableDataLink

TTableDataLink	Siehe auch

Der Destruktor ~TTableDataLink gibt den Speicher frei, der für das TTableDataLink-Objekt reserviert war. Rufen Sie ~TTableDataLink nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TTableDataLink automatisch aufgerufen wird.

__fastcall virtual ~TTableDataLink(void);


TTableDataLink::ActiveChanged

TTableDataLink	Siehe auch

Die Methode ActiveChanged baut die Feldliste neu auf und unterstützt dadurch das TTable-Objekt bei einer Reaktion auf Änderungen der Eigenschaft Active.

virtual void __fastcall ActiveChanged(void);

Beschreibung

Anwendungen können ActiveChanged nicht direkt aufrufen, denn diese Prozedur wird von Änderungen an der Eigenschaft Active ausgelöst. ActiveChanged regeneriert die Feldliste und ruft dann die Methode MasterChanged des TTable-Objekts auf, das Eigentümer dieses TTableDataLink-Objekts ist. Das TTableLink-Objekt kann nur dann Datenereignisse empfangen, wenn die Datenmenge aktiv ist. ActiveChanged sorgt dafür, daß in der Feldliste alle Änderungen berücksichtigt werden, die an der zugrundeliegenden Datenbank vorgenommen wurden, während die Datenmenge nicht aktiv war.


TTableDataLink::CheckBrowseMode

TTableDataLink	Siehe auch

Die CheckBrowseMode benachrichtigt das TTable-Objekt, daß eine Änderung in der Datenmenge bevorsteht.

virtual void __fastcall CheckBrowseMode(void);

Beschreibung

CheckBrowseMode wird aufgerufen, kurz bevor Änderungen an der Datenmenge des TTableDataLink-Objekts stattfinden. CheckBrowseMode übergibt diese Ereignisse an das TTable-Objekt mit einem Aufruf von TTable::CheckBrowseMode.


TTableDataLink::LayoutChanged

TTableDataLink	Siehe auch

Die Methode LayoutChanged ermöglicht es dem TTable-Objekt, auf Änderungen im Layout eines Steuerelements zu reagieren, das von TTable repräsentiert wird.

virtual void __fastcall LayoutChanged(void);

Beschreibung

LayoutChanged wird automatisch nach einer Änderung am Layout eines beliebigen Objekts aufgerufen, das TTable repräsentiert, wenn die Reihenfolge oder die Anzahl der Felder in der Feldliste verändert wurde. Die Feldliste wird entsprechend neu aufgebaut. Anschließend erfolgt ein Aufruf der MasterChanged-Methode des TTable-Objekts, das Eigentümer dieses TTableDataLink-Objekts ist.


TTableDataLink::RecordChanged

TTableDataLink	Siehe auch

RecordChanged benachrichtigt das TTable-Objekt, wenn sich der aktuelle Datensatz bzw. das aktuelle Feld der Datenmenge geändert hat.

virtual void __fastcall RecordChanged(Db::TField* Field);

Beschreibung

RecordChanged wird aufgerufen, sobald der Inhalt des aktiven Datensatzes in der Datenmenge geändert wurde. RecordChanged ermöglicht es dem TTable-Objekt, auf diese Änderungen mit einem Aufruf seiner Methode MasterChanged zu reagieren.


TTableDataLink::TTableDataLink

TTableDataLink	Siehe auch

Der Konstruktor TTableDataLink erzeugt ein neues TTableDataLink-Objekt.

__fastcall TTableDataLink(TTable* Table);

Beschreibung

Anwendungen sollten den Konstruktor TTableDataLink nicht direkt aufrufen. Das TTable-Objekt, das Eigentümer des TTableDataLink-Objekts ist, ruft TTableDataLink in seinem eigenen Konstruktor auf.


Zugriff

Read-only


Gültigkeitsbereich

Protected


Hierarchie

TObject

TPersistent

TDataLink


TTableDataLink Beispiel

TTableDataLink


TTextAttributes

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/comctrls.hpp

TTextAttributes ist ein Hilfsobjekt, das die Schriftmerkmale eines Textbereichs in einem RTF-Eingabefeld repräsentiert.

Beschreibung

TTextAttributes enthält eine Reihe von Eigenschaften, welche die Schriftmerkmale von Text in einem RTF-Dokument beschreiben. TTextAttributes ist so konzipiert, daß ein Nachkomme von TCustomRichEdit entweder die Standard-Textmerkmale lesen und schreiben kann (über die Eigenschaft DefAttributes) oder die Merkmale des markierten Textes (über die Eigenschaft SelAttributes). Die Eigenschaften eines TTextAttributes-Objekts sind nur dann gültig, wenn ein Nachkomme von TCustomRichEdit der Eigentümer ist.

Die meisten Schriftmerkmale, die von einem TTextAttributes-Objekt repräsentiert werden, sind dieselben wie die Eigenschaften eines TFont-Objekts, wobei auch die Namen identisch sind. Schriftarten können einem Textattribut zugewiesen werden und umgekehrt.


Eigenschaften von TTextAttributes

TTextAttributes	Alphabetisch	Legende

In TTextAttributes

Color

ConsistentAttributes

Height

Name

Pitch

Protected

Size

Style


Eigenschaften von TTextAttributes

TTextAttributes	Nach Objekten	Legende

Color

ConsistentAttributes

Height

Name

Pitch

Protected

Size

Style


TTextAttributes::Color

TTextAttributes	Siehe auch

Die Eigenschaft Color bestimmt die Vordergrundfarbe des Textes.

__property Graphics::TColor Color;

Beschreibung

Mit Color wird die Farbe der eigentlichen Textzeichen festgelegt. Die Hintergrundfarbe ist ebenfalls eine Eigenschaft des RTF-Eingabefeldes (Background).

Color kann einen der folgenden Werte annehmen:

Wert	Bedeutung

clBlack	Schwarz

clMaroon	Rotbraun

clGreen	Grün

clOlive	Olivgrün

clNavy	Marineblau

clPurple	Violett

clTeal	Blaugrün

clGray	Grau

clSilver	Silbergrau

clRed	Rot

clLime	Limonengrün

clBlue	Blau

clFuchsia	Pink

clAqua	Türkis

clWhite	Weiß

clBackground	Aktuelle Farbe des Windows-Desktop

clActiveCaption	Aktuelle Farbe der Titelleiste von aktiven Fenstern

clInactiveCaption	Aktuelle Farbe der Titelleiste inaktiver Fenster

clMenu	Aktuelle Hintergrundfarbe der Menüs

clWindow	Aktuelle Hintergrundfarbe der Fenster

clWindowFrame	Aktuelle Farbe der Fensterrahmen

clMenuText	Aktuelle Farbe von Menütext

clWindowText	Aktuelle Farbe von Fenstertext

clCaptionText	Aktuelle Farbe des Textes in der Titelleiste des aktiven
Fensters

clActiveBorder	Aktuelle Rahmenfarbe des aktiven Fensters

clInactiveBorder	Aktuelle Rahmenfarbe inaktiver Fenster

clAppWorkSpace	Aktuelle Farbe des Arbeitsbereichs der Anwendung

clHighlight	Aktuelle Hintergrundfarbe von markiertem Text

clHightlightText	Aktuelle Farbe von markiertem Text

clBtnFace	Aktuelle Farbe einer Schaltfläche

clBtnShadow	Aktuelle Farbe des Schattens einer Schaltfläche

clGrayText	Aktuelle Farbe von grau dargestelltem Text

clBtnText	Aktuelle Farbe von Text auf einer Schaltfläche

clInactiveCaptionText	Aktuelle Farbe des Textes in der Titelleiste eines inaktiven Fensters

clBtnHighlight	Aktuelle Farbe des Markierungsrahmens einer Schaltfläche

cl3DDkShadow 	Nur Windows 95 oder NT 4.0: dunkler Schatten für dreidimensionale Dialogelemente

cl3DLight 	Nur Windows 95 oder NT 4.0: helle Farbe für dreidimensionale Dialogelemente (für Kanten, die dem Licht zugewandt sind)

clInfoText 	Nur Windows 95 oder NT 4.0: Textfarbe für Tool-Tip-Steuerelemente

clInfoBk 	Nur Windows 95 oder NT 4.0: Hintergrundfarbe für Tool-Tip-Steuerelemente

Die Farben in der zweiten Hälfte dieser Liste sind Windows-Systemfarben. Welche Farbe tatsächlich angezeigt wird, hängt davon ab, welches Farbschema Sie für Windows definiert haben. Diese Festlegung erfolgt in der Systemsteuerung. Eine Änderung der Farbe in der Windows-Farbpalette hat nur dann einen Effekt auf den Text im RTF-Eingabefeld, wenn Color auf clWindowText gesetzt ist. Der wirkliche Farbton kann auf verschiedenen Systemen unterschiedlich sein. Beispielsweise enthalten Farben im violetten Bereich einen mehr oder weniger starken Anteil an Blau.


TTextAttributes::ConsistentAttributes

TTextAttributes	Siehe auch

Die Eigenschaft ConsistentAttributes zeigt an, welche der Eigenschaften des TTextAttributes-Objekts innerhalb der aktuellen Auswahl im RTF-Steuerlement konsistent sind.

__property TConsistentAttributes ConsistentAttributes;

Beschreibung

Mit einem Lesezugriff auf ConsistentAttributes der Eigenschaft SelAttributes eines RTF-Objekts können Sie feststellen, welche der Eigenschaften von TTextAttributes für die aktuelle Auswahl von Bedeutung sind. Diese Information ist relevant, wenn Sie anschließend die Textmerkmale der Auswahl ermitteln wollen. Wenn eine Eigenschaft von TTextAttributes gesetzt wird, wird diese zu einem konsistenten Attribut, bis die Auswahl verändert wird.

Für ConsistentAttributes sind folgende Werte möglich:

Wert	Bedeutung

caBold	Alle ausgewählten Zeichen sind einheitlich entweder fett oder nicht fett.

caColor	Alle ausgewählten Schriftzeichen besitzen eine einheitliche Farbe.

caFace	Alle ausgewählten Zeichen besitzen dieselbe Schriftart.

caItalic	Alle ausgewählten Zeichen sind einheitlich kursiv oder nicht kursiv.

caSize	Alle ausgewählten Zeichen besitzen denselben Schriftgrad.

caStrikeout	Alle ausgewählten Zeichen sind entweder durchgestrichen oder nicht.

caUnderline	Alle ausgewählten Zeichen sind entweder unterstrichen oder nicht.

caProtected	Der Text ist insgesamt geschützt oder nicht.

Hinweis

Verwenden Sie ConsistentAttributes in Verbindung mit der Eigenschaft SelAttributes des RTF-Eingabefeldes. Für die Eigenschaft DefAttributes ist ConsistentAttributes eine leere Menge, selbst wenn alle Attribute in dem Textbereich konsistent sind, der die Standardattribute besitzt.


TTextAttributes::Height

TTextAttributes	Siehe auch	Beispiel

Die Eigenschaft Height bezeichnet die Höhe einer Schrift in Pixel.

__property int Height;

Beschreibung

Mit Height wird die Höhe einer Schrift in Pixel festgelegt. Soll die Höhe dagegen in Punkt bemessen werden, verwenden Sie die Eigenschaft Size. Der Benutzer einer Anwendung legt den Schriftgrad normalerweise in Punkt fest, während für den Programmierer die tatsächliche Größe in Pixel bei der Darstellung auf dem Bildschirm entscheidender ist.

Für den Zusammenhang zwischen den Eigenschaften Height und Size gilt folgende Formel:

Height = Size * 72 / ScreenPixelsPerInch

Hinweis

Im Gegensatz zur Eigenschaft Height eines TFont-Objekts ist bei einem TTextAttributes-Objekt im Wert von Height auch der Leerraum berücksichtigt, der über den Textzeichen einen Abstand erzeugt.


TTextAttributes::Name

TTextAttributes	Siehe auch	Beispiel

Die Eigenschaft Name bezeichnet die Schriftart, die vom TTextAttributes-Objekt beschrieben wird.

__property Graphics::TFontName Name;

Beschreibung

Mit Name wird die Schriftart identifiziert. Zur Benennung dient ein String mit bis zu 32 Zeichen, der von Windows verwendet wird. Dieser Bezeichner ist den meisten Auswahldialogen zu finden, wie sie beispielsweise in Textverarbeitungsprogrammen vorkommen.


TTextAttributes::Pitch

TTextAttributes	Siehe auch

Die Eigenschaft Pitch legt fest, ob alle Zeichen einer Schrift denselben Platz in der Breite beanspruchen.

__property Graphics::TFontPitch Pitch;

Beschreibung

Jeder Schriftart sind individuelle Zeichenbreiten zugeordnet. Bei Schriftarten mit festem Zeichenabstand hat jedes Zeichen dieselbe Breite, bei Schriftarten mit variablem Zeichenabstand dagegen nicht. Ein fester Zeichenabstand wird beispielsweise bei der Darstellung von Quelltext verwendet, weil sich damit auf einfache Weise saubere Einrückungen erzeugen lassen. Ein variabler Zeichenabstand erzeugt ein harmonisches Schriftbild, wie man es z.B. aus Buch- und Zeitschriftentexten kennt. Man spricht dann von „Proportionalschrift“.

Für Pitch sind folgende Werte möglich:

Wert	Bedeutung

fpDefault	Der Zeichenabstand wird auf den Standardwert gesetzt, der von der jeweiligen Schriftart abhängt, die mit der Eigenschaft Name bezeichnet wird.

fpFixed	Der Zeichenabstand ist fest. Alle Zeichen beanspruchen denselben Raum in der Breite.

fpVariable	Der Zeichenabstand ist variabel. Jedem Zeichen ist eine eigene Breit zugeordnet.

Wenn Sie die Eigenschaft Pitch einer Schriftart mit festem Zeichenabstand auf fpVariable setzen, oder umgekehrt bei einer Proportionalschrift auf fpFixed, dann versucht Windows, die bestmögliche Übereinstimmung mit allen vorgegebenen Schriftmerkmalen zu erzielen. Das hat entweder gar keinen Effekt auf die Darstellung der Schrift oder führt zum Austausch durch eine andere Schriftart mit dem passenden Zeichenabstand. Wenn Sie beispielsweise bei der Schriftart MS Serif (Proportionalschrift) die Eigenschaft Pitch auf fpFixed setzen, wird als bestmögliche Angleichung an Ihre Vorgaben die Schriftart Courier angezeigt.


TTextAttributes::Protected

TTextAttributes	Siehe auch

Die Eigenschaft Protected gibt an, ob der vom TTextAttributes-Objekt repräsentierte Text geschützt ist.

__property bool Protected = {read=GetProtected, write=SetProtected, nodefault};

Beschreibung

Geschützter Text kann vom Anwender zuerst einmal nicht geändert werden. Sobald ein entsprechender Versuch erfolgt, ruft das RTF-Eingabefeld die Ereignisbehandlungsroutine für OnProtectChange auf. Diese kann dann die Bearbeitung des geschützten Textes zulassen oder nicht. Wenn es keine Ereignisbehandlungsroutine für OnProtectChange gibt, kann der Text auf keinen Fall bearbeitet werden.


TTextAttributes::Size

TTextAttributes	Siehe auch

Die Eigenschaft Size bestimmt die Höhe der Schrift in Pixel.

__property int Size;

Beschreibung

Mit Size wird die Höhe einer Schrift in Punkt festgelegt. Soll die Höhe dagegen in Pixel bemessen werden, verwenden Sie die Eigenschaft Height. Der Benutzer einer Anwendung legt den Schriftgrad normalerweise in Punkt fest, während für den Programmierer die tatsächliche Größe in Pixel bei der Darstellung auf dem Bildschirm entscheidender ist.

Für den Zusammenhang zwischen den Eigenschaften Height und Size gilt folgende Formel:

Height = Size * 72 / ScreenPixelsPerInch

Hinweis

Im Gegensatz zur Eigenschaft Size eines TFont-Objekts ist bei einem TTextAttributes-Objekt im Wert von Size immer auch der Leerraum berücksichtigt, der über den Textzeichen einen Abstand erzeugt.


TTextAttributes::Style

TTextAttributes	Siehe auch

Die Eigenschaft Style legt fest, ob die Schriftzeichen normal, kursiv, unterstrichen, fett oder durchgestrichen dargestellt werden.

__property Graphics::TFontStyles Style;

Beschreibung

Die Eigenschaft kann die folgenden Werte annehmen:

Wert	Bedeutung

fsBold	Fett

fsItalic	Kursiv

fsUnderline	Unterstrichen

fsStrikeout	Durchgestrichen (horizontale Linie durch die Textzeichen)

Da die Eigenschaft Style als Menge definiert ist, kann Sie gleichzeitig mehrere Werte annehmen. Text kann beispielsweise fett und zugleich kursiv sein.


Methoden von TTextAttributes

TTextAttributes	Alphabetisch	Legende

In TTextAttributes

~TTextAttributes

Assign

AssignTo

InitFormat

TTextAttributes

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TTextAttributes

TTextAttributes	Nach Objekten	Legende

~TTextAttributes

AssignTo

Assign

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

FreeInstance

Free

InheritsFrom

InitFormat

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance

TTextAttributes


TTextAttributes::~TTextAttributes

TTextAttributes

Der Destruktor ~TTextAttributes gibt den Speicher frei, der für das TTextAttributes-Objekt reserviert war. Rufen Sie ~TTextAttributes nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TTextAttributes automatisch aufgerufen wird.

__fastcall virtual ~TTextAttributes(void);


TTextAttributes::Assign

TTextAttributes	Siehe auch

Die Methode Assign setzt die Eigenschaften eines TTextAttributes-Objekts entsprechend den Eigenschaften eines anderen TTextAttributes- oder TFont-Objekts.

virtual void __fastcall Assign(Classes::TPersistent* Source);

Beschreibung

Mit Assign können alle Textattribute auf einmal geändert werden. Die Schriftmerkmale des ausgewählten Textes werden an die Standardwerte angepaßt oder umgekehrt. Wenn der Parameter Source ein TTextAttributes-Objekt bezeichnet, gleicht Assign nur die Eigenschaften Color, Name, Style und Pitch an. Bei einem TFont-Objekt als Source wird auch die Eigenschaft Size angepaßt.

Hinweis

Assign kann zur Laufzeit nur dann erfolgreich ausgeführt werden, wenn der Parameter Source ein TTextAttributes-Objekt, ein TFont-Objekt oder ein anderes Objekt bezeichnet, das eine AssignTo-Methode implementiert, die sich auf das TTextAttributes-Objekt bezieht. Andere Quellobjekte führen zu einer EConvertError-Exception.


TTextAttributes::AssignTo

TTextAttributes	Siehe auch

Die Methode AssignTo ermöglicht es, daß die Eigenschaften eines TTextAttributes-Objekts einem TFont-Objekt zugewiesen werden.

virtual void __fastcall AssignTo(Classes::TPersistent* Dest);

Beschreibung

TTextAttributes überschreibt die geerbte Version von AssignTo, damit dessen Schrifteigenschaften einem TFont-Objekt zugewiesen werden können. Anwendungen sollten AssignTo nicht direkt aufrufen. Dies geschieht, wenn die Methode Assign des TFont-Objekts aufgerufen wird. AssignTo kopiert die Eigenschaften Color, Name, Style, Size und Pitch auf das TFont-Objekt.


TTextAttributes::InitFormat

TTextAttributes	Siehe auch

Die Methode InitFormat initialisiert eine TCharFormat-Struktur.

void __fastcall InitFormat(CHARFORMAT &Format);

Beschreibung

TTextAttributes kommuniziert mit dem RTF-Eingabefeld über die Struktur TCharFormat, wenn Eigenschaftswerte abgefragt oder eingestellt werden. InitFormat initialisiert diese Struktur vor einem Lese- oder Schreibzugriff auf Eigenschaften. InitFormat ist als geschützte Methode deklariert, so daß abgeleitete Klassen die Struktur TCharFormat in der Implementierung weiterer Texteigenschaften verwenden können.


TTextAttributes::TTextAttributes

TTextAttributes	Siehe auch

TTextAttributes erzeugt eine Instanz von TTextAttributes.

__fastcall TTextAttributes(TCustomRichEdit* AOwner, TAttributeType AttributeType);

Beschreibung

Rufen Sie den Konstruktor für TTextAttributes nicht direkt auf. TTextAttributes wird vom Konstruktor des RTF-Eingabefeldes aufgerufen.


Zugriff

Read-only


Gültigkeitsbereich

Protected


Hierarchie

TObject

TPersistent


TTextAttributes Beispiel

TTextAttributes


TThread

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/classes.hpp

TThread ist eine abstrakte Klasse und ermöglicht in einer Anwendung die Existenz mehrerer, getrennter Ablaufstränge (Threads).

Beschreibung

Jede weitere Instanz eines TThread-Objekts in einer Unterklasse bildet einen neuen Ablaufstrang. Wenn eine Borland C++Builder-Anwendung über mehrere solcher Threads verfügt, wird sie als Multithread-Anwendung bezeichnet. Threads entstehen durch Ableitung einer neuen Klasse von TThread und Überschreiben der Methoden von TThread.

Beim Start einer Anwendung wird diese zur Ausführung in den Speicher geladen. In diesem Moment wird sie zu einem Prozeß, der einen oder mehrere Threads umfaßt, die jeweils Daten, den Code und weitere Systemressourcen für das Programm enthalten. Ein Thread führt einen bestimmten Teil einer Anwendung aus und erhält hierfür vom Betriebssystem CPU-Zeit zugewiesen. Alle Threads eines Prozesses greifen auf denselben Adreßbereich und auf die globalen Prozeßvariablen zu.

Threads bieten für die Leistungssteigerung einer Anwendung folgende Möglichkeiten:

•	Eingaben mehrerer Datenübertragungsgeräte verarbeiten.

•	Verschiedene Tasks nach ihrer Priorität unterschieden. Beispielsweise übernimmt ein Thread hoher Priorität zeitkritische Aufgaben.

Im folgenden finden Sie einige Aspekte, die beim Einsatz von Threads beachtet werden sollten:

•	Die Koordination zu vieler Threads verbraucht beträchtliche CPU-Zeit. Auf einem Ein-Prozessor-System stellen 16 Threads die praktikable Obergrenze dar.

•	Wenn mehrere Threads dieselben Ressourcen aktualisieren, ist unbedingt eine Synchronisierung erforderlich, die Konflikte unterbindet.

•	Alle Methoden, die auf eine VCL-Komponente zugreifen und ein Formular aktualisieren, dürfen nur vom VCL-Haupt-Thread aus aufgerufen werden.

So erzeugen und verwenden Sie ein neues Thread-Objekt:

•	Wählen Sie Datei/Neu/Thread-Objekt. Damit legen Sie eine neue Unit an, die ein von TThread abgeleitetes Objekt enthält.

•	Definieren Sie den Konstruktor des neuen Thread-Objekts.

•	Definieren Sie die Execute-Methode des Thread-Objekts. Geben Sie den Code ein, der ausgeführt werden soll, wenn auch der Thread ausgeführt wird.

•	Übergeben Sie alle Aufrufe, die eine VCL-Komponente verwenden, an die Methode Synchronize. Diese wiederum veranlaßt den VCL-Haupt-Thread, den Aufruf vorzunehmen, wodurch Konflikte zwischen mehreren Threads vermieden werden.


Eigenschaften von TThread

TThread	Alphabetisch	Legende

In TThread

FreeOnTerminate

Handle

Priority

ReturnValue

Suspended

Terminated

ThreadID


Eigenschaften von TThread

TThread	Nach Objekten	Legende

FreeOnTerminate

Handle

Priority

ReturnValue

Suspended

Terminated

ThreadID


TThread::FreeOnTerminate

TThread	Siehe auch

Mit FreeOnTerminate wird festgelegt, ob das Thread-Objekt nach Beendigung des Threads automatisch freigegeben wird.

__property bool FreeOnTerminate;

Beschreibung

FreeOnTerminate hat per Vorgabe den Wert False. Das Thread-Objekt muß dann im Programmcode der Anwendung explizit freigegeben werden.


TThread::Handle

TThread	Siehe auch

Die Eigenschaft Handle enthält das Handle des Threads.

__property int Handle;

Beschreibung

Handle wird beim Aufruf von Win32-API-Funktionen zur Thread-Steuerung verwendet.


TThread::Priority

TThread	Siehe auch

Die Eigenschaft bestimmt die Ausführungspriorität eines Threads gegenüber anderen Threads im Prozeß.

__property TThreadPriority Priority;

Beschreibung

Die Eigenschaft Priority ist ein Aufzählungstyp mit dem Vorgabewert tpNormal. Je nach Bedarf kann eine höhere oder niedrigere Priorität zugeordnet werden.

Der Typ TThreadPriority definiert die möglichen Eigenschaftswerte von Priority (siehe Tabelle). Windows übernimmt die Zuteilung von CPU-Zyklen an die einzelnen Threads. Dabei liegt eine Prioritätsskala zugrunde, die sich aus den Priority-Eigenschaften der einzelnen Threads ergibt.

Werte	Bedeutung

tpIdle	Der Thread wird nur dann ausgeführt, wenn sich das System im Leerlauf befindet. Für einen Thread mit der Prioritätsstufe tpIdle unterbricht Windows keine anderen Threads.

tpLowest	Die Priorität des Threads liegt zwei Stufen unter der normalen Ebene.

tpLower	Die Priorität des Threads liegt eine Stufe unter der normalen Ebene.

tpNormal	Der Thread besitzt normale Priorität.

tpHigher	Die Priorität des Threads liegt eine Stufe über der normalen Ebene.

tpHighest	Die Priorität des Threads liegt zwei Stufen über der normalen Ebene.

tpTimeCritical	Der Thread besitzt höchste Priorität.

Achtung

Wenn eine rechenintensive Operation hohe Priorität erhält, kann dies die Ausführung der anderen Threads in der Anwendung blockieren. Es sollten nur solche Threads höchste Prioritätsstufen erhalten, die den Großteil der Zeit auf externe Ereignisse warten.


TThread::ReturnValue

TThread	Siehe auch

Die Eigenschaft ReturnValue eines Threads entspricht dem Rückgabewert einer Funktion.

__property int ReturnValue;

Beschreibung

Mit ReturnValue wird der Anwendung oder anderen Threads signalisiert, ob ein bestimmter Thread erfolgreich ausgeführt wurde oder nicht. Ebenso kann ein numerisches Ergebnis übergeben werden. Die Methode WaitFor gibt den Wert von ReturnValue zurück.


TThread::Suspended

TThread	Siehe auch

Die Eigenschaft Suspended zeigt an, ob ein Thread unterbrochen wurde.

__property bool Suspended;

Beschreibung

Bei unterbrochenen Threads wird der Ablauf ausgesetzt, bis die Wiederaufnahme signalisiert wird. Suspend erhält den Wert True für eine Unterbrechung oder den Wert False für eine Fortsetzung des Threads.


TThread::Terminated

TThread	Siehe auch

Die Eigenschaft Terminated zeigt an, daß der Thread eine Aufforderung zum Beenden erhalten hat. Die Methode Terminate setzt die Eigenschaft Terminated auf True.

__property bool Terminated;

Beschreibung

Die Methode Execute des Threads sollte ebenso wie alle Methoden, die von Execute aufgerufen werden, die Eigenschaft Terminated abfragen und gegebenenfalls die Ausführung beenden.

Die Methode Terminate bietet ein Verfahren, einen Thread kontrolliert abzubrechen, wobei allerdings die Kooperation des Execute-Codes Voraussetzung ist. Ein Aufruf von Terminate erfolgt am besten über den Win32-API-Aufruf von TerminateThread.


TThread::ThreadID

TThread	Siehe auch

Mit ThreadID wird ein Thread innerhalb des Systems eindeutig bezeichnet. ThreadID ist nicht dasselbe wie das Handle des Threads in der Eigenschaft Handle.

__property int ThreadID;

Beschreibung

ThreadID wird in Verbindung mit Win32-API-Funktionen eingesetzt, um den Thread zu steuern.


Ereignisse von TThread

TThread	Alphabetisch

In TThread

OnTerminate


Ereignisse von TThread

TThread	Nach Objekten

OnTerminate


TThread::OnTerminate

TThread	Siehe auch

Das Ereignis OnTerminate wird ausgelöst, sobald die Methode Execute des Threads zurückgekehrt ist, aber bevor der Thread freigegeben wird.

__property TNotifyEvent OnTerminate;

Beschreibung

Die Ereignisbehandlungsroutine für OnTerminate wird im Kontext des VCL-Haupt-Threads gestartet. Das bedeutet, daß VCL-Methoden und -Eigenschaften frei aufgerufen werden können. Das Thread-Objekt kann auch innerhalb der Ereignisbehandlungsroutine freigegeben werden.

TNotifyEvent ist ein Typ für parameterlose Ereignisse. Solche Ereignisse vereinfachen die Benachrichtigung der Komponente, daß ein bestimmtes Ereignis aufgetreten ist (in diesem Fall OnTerminate).


Methoden von TThread

TThread	Alphabetisch	Legende

In TThread

~TThread

DoTerminate

Execute

Resume

Suspend

Synchronize

Terminate

TThread

WaitFor

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TThread

TThread	Nach Objekten	Legende

~TThread

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

DoTerminate

Execute

FieldAddress

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance

Resume

Suspend

Synchronize

Terminate

TThread

WaitFor


TThread::~TThread

TThread	Siehe auch

Die Methode ~TThread löst die Instanz des Thread-Objekts auf und gibt den zugeordneten Speicher frei.

__fastcall virtual ~TThread(void);

Beschreibung

~TThread signalisiert dem Thread, seine Ausführung zu beenden, und wartet auf dessen Rückkehr. Anschließend wird der geerbte Destruktor ausgeführt.


TThread::DoTerminate

TThread	Siehe auch

Die DoTerminate löst die Ereignisbehandlungsroutine für OnTerminate des Threads aus, falls ein solcher zugewiesen wurde.

virtual void __fastcall DoTerminate(void);

Beschreibung

DoTerminate ruft die Ereignisbehandlungsroutine für OnTerminate auf. Die Methode beendet den Thread allerdings nicht.


TThread::Execute

TThread	Siehe auch

Execute ist eine abstrakte Methode, die überschrieben werden muß. Sie enthält den Code, der zu Beginn eines Threads ausgeführt werden soll.

virtual void __fastcall Execute(void);

Beschreibung

Ein Thread beginnt einerseits dann, wenn sein Konstruktor aufgerufen wird, während CreateSuspended den Wert False hat, und andererseits, wenn nach dem Konstruktor zuerst Resume aufgerufen wird, wobei CreateSuspended auf True steht. Überschreiben Sie diese Methode, und fügen Sie den Code ein, der mit Beginn des Threads ausgeführt werden soll. Execute übernimmt die Prüfung von Terminated und stellt dadurch fest, ob der Thread beendet werden muß.


TThread::Resume

TThread	Siehe auch

Die Methode Resume setzt die Ausführung eines unterbrochenen Threads fort.

void __fastcall Resume(void);

Beschreibung

Suspend-Aufrufe können verschachtelt sein. Entsprechend oft muß dann aber auch Resume aufgerufen werden, bevor der Thread fortgeführt wird.


TThread::Suspend

TThread	Siehe auch

Die Methode Suspend unterbricht die Ausführung eines Threads.

void __fastcall Suspend(void);

Beschreibung

Mit Resume kann die Ausführung anschließend wieder aufgenommen werden. Suspend-Aufrufe können verschachtelt sein. Entsprechend oft muß dann aber auch Resume aufgerufen werden, bevor der Thread fortgeführt wird.


TThread::Synchronize

TThread	Siehe auch

Die Methode Synchronize führt innerhalb des VCL-Haupt-Threads diejenige Methode aus, die mit dem Parameter Method bezeichnet ist.

void __fastcall Synchronize(TThreadMethod

Beschreibung

Synchronize löst den Aufruf einer bestimmten Methode aus, die vom VCL-Haupt-Thread ausgeführt werden soll. Durch dieses indirekte Verfahren werden Konflikte in Multithread-Anwendungen vermieden. Alle Methoden, die auf eine VCL-Komponente zugreifen und ein Formular aktualisieren, sollten vom VCL-Haupt-Thread aus nur in dieser Form aufgerufen, das heißt als Parameter an Synchronize übergeben werden.

Hinweis

Der Thread wird unterbrochen, während die angegebene Methode ausgeführt wird.


TThread::Terminate

TThread	Siehe auch

Die Methode Terminate signalisiert die Beendigung eines Threads. Dazu wird die Eigenschaft Terminated auf True gesetzt.

void __fastcall Terminate(void);

Beschreibung

Die Methode Execute eines Threads sowie alle von Execute aufgerufenen Methoden sollten die Eigenschaft Terminated regelmäßig abfragen und die Ausführung gegebenenfalls beenden.


TThread::TThread

TThread	Siehe auch

Die Methode TThread erzeugt eine Instanz eines Thread-Objekts.

__fastcall TThread(bool CreateSuspended);

Beschreibung

Wenn CreateSuspended den Wert False hat, wird sofort Execute aufgerufen. Wenn CreateSuspended dagagen True ist, wird Execute erst nach Resume aufgerufen.


TThread::WaitFor

TThread	Siehe auch

Die Methode WaitFor wartet auf die Beendigung eines Threads und gibt den Wert der Eigenschaft ReturnValue zurück.

int __fastcall WaitFor(void);

Beschreibung

WaitFor kehrt erst zurück, wenn der Thread beendet ist. Dazu muß der Thread entweder die Methode Execute abschließen oder die Beendigung einleiten, sobald die Eigenschaft Terminated den Wert True annimmt. Rufen Sie WaitFor nicht im Kontext des VCL-Haupt-Threads auf, wenn dieser die Methode Synchronize verwendet. Es könnte dann zu einem Deadlock kommen, so daß die Anwendung stehen bleibt oder eine EThread-Exception auslöst.

Die Methode Synchronize wartet, bis der VCL-Haupt-Thread in die Botschaftenschleife eintritt, bevor sie der Methode die Ausführung ermöglicht, die eine Synchronisation versucht. Wenn der VCL-Haupt-Thread aber WaitFor aufgerufen hat, erfolgt kein Eintritt in die Botschaftenschleife, und Synchronize kehrt nicht zurück. TThread erkennt einen solchen Fall und löste eine EThread-Exception aus, die den Thread beendet und ebenso die Anwendung, wenn die Exception nicht in der Methode Execute abgefangen wird. Wenn Synchronize zum Zeitpunkt des Aufrufs von WaitFor bereits im VCL-Haupt-Thread wartet, kann TThread nicht geeignet reagieren, und es kommt zu einem Deadlock.


Gültigkeitsbereich

Protected

Zugriff

Read-only


Gültigkeitsbereich

Protected


Hierarchie

TObject


TThread Beispiel

TThread


TTimeField

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/db.hpp

Ein TTimeField-Objekt repräsentiert ein Datumsfeld in einer Datenmenge.

Beschreibung

Felder dieses Typs enthalten Zeitangaben.

TTimeField führt keine neuen Eigenschaften, Ereignisse oder Methoden ein. Die Klasse überschreibt die Eigenschaft DataSize sowie die Methode TTimeField entsprechend den merkmalen eines Feldes mit dem Typ ftTime.

Als Nachkomme von TDateTimeField enthält TTimeField viele Eigenschaften, Methoden und Ereignisse, die sich für die Verwaltung von Werten und Eigenschaften eines Zeitfeldes in einer Datenbank eignen.


Eigenschaften von TTimeField

TTimeField	Alphabetisch	Legende

Abgeleitet von TDateTimeField

DisplayFormat

Value

Abgeleitet von TField

Alignment

AsBoolean

AsCurrency

AsDateTime

AsFloat

AsInteger

AsString

AsVariant

AttributeSet

BDECalcField

Calculated

CanModify

DataSet

DataSize

DataType

DisplayLabel

DisplayName

DisplayText

DisplayWidth

EditMask

EditMaskPtr

FieldKind

FieldName

FieldNo

Index

IsIndexField

IsNull

KeyFields

Lookup

LookupDataSet

LookupKeyFields

LookupResultField

NewValue

OldValue

ReadOnly

Required

Size

Text

Visible

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Name

Owner

Tag


Eigenschaften von TTimeField

TTimeField	Nach Objekten	Legende

Alignment

AsBoolean

AsCurrency

AsDateTime

AsFloat

AsInteger

AsString

AsVariant

AttributeSet

BDECalcField

Calculated

CanModify

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

DataSet

DataSize

DataType

DesignInfo

DisplayFormat

DisplayLabel

DisplayName

DisplayText

DisplayWidth

EditMaskPtr

EditMask

FieldKind

FieldName

FieldNo

Index

IsIndexField

IsNull

KeyFields

LookupDataSet

LookupKeyFields

LookupResultField

Lookup

Name

NewValue

OldValue

Owner

ReadOnly

Required

Size

Tag

Text

Value

Visible


Ereignisse von TTimeField

TTimeField	Alphabetisch	Legende

Abgeleitet von TField

OnChange

OnGetText

OnSetText

OnValidate


Ereignisse von TTimeField

TTimeField	Nach Objekten	Legende

OnChange

OnGetText

OnSetText

OnValidate


Methoden von TTimeField

TTimeField	Alphabetisch

In TTimeField

~TTimeField

TTimeField

Abgeleitet von TField

Assign

AssignValue

Clear

FocusControl

GetData

IsValidChar

SetData

SetFieldType

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TTimeField

TTimeField	Nach Objekten

~TTimeField

Assign

AssignValue

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

Clear

DefaultHandler

DestroyComponents

Destroying

Dispatch

FieldAddress

FindComponent

FocusControl

FreeInstance

FreeNotification

Free

GetData

GetParentComponent

HasParent

InheritsFrom

InitInstance

InsertComponent

InstanceSize

IsValidChar

MethodAddress

MethodName

NewInstance

RemoveComponent

SetData

SetFieldType

TTimeField


TTimeField::~TTimeField

TTimeField

Der Destruktor ~TTimeField gibt den Speicher frei, der für das TTimeField-Objekt reserviert war. Rufen Sie ~TTimeField nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TTimeField automatisch aufgerufen wird.

__fastcall virtual ~TTimeField(void);


TTimeField::TTimeField

TTimeField

Die Methode TTimeField erzeugt und initialisiert eine Instanz von TTimeField.

__fastcall virtual TTimeField(Classes::TComponent* AOwner);

Beschreibung

Es ist nur selten notwendig, TTimeField direkt aufzurufen, da für alle Zeitfelder in einer Datenmenge automatisch ein entsprechendes Feldobjekt instantiiert wird.

Nach dem Aufruf des geerbten Konstruktors setzt TTimeField die Eigenschaft DataType automatisch auf ftTime.


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TField

TDateTimeField


TTimeField Beispiel

TTimeField


 TTimer

Hierarchie	Eigenschaften	Methoden	Ereignisse

Header

vcl/extctrls.hpp

Die Komponente TTimer ist ein Objekt, das die Timer-Funktionen der Windows-API kapselt.

Beschreibung

Die Komponente TTimer wird nur zur Entwurfszeit verwendet. Sie vereinfacht den Umgang mit den Timer-Funktionen SetTimer und KillTimer der Windows-API und die Bearbeitung von WM_TIMER-Botschaften. Verwenden Sie für jeden Zeitgeber in der Anwendung eine TTimer-Komponente.

Die Eigenschaften und Methoden von TTimer beeinflussen die Funktionalität des Zeitgebers, indem Sie Informationen für das Ereignis OnTimer zur Verfügung stellen. Dazu gehört auch das Intervall, das dem Parameter der API-Funktion SetTimer entspricht. Die eigentliche Ausführung des Zeitgebers erfolgt durch sein Ereignis OnTimer.

Achtung

Die maximale Anzahl der Zeitgeber ist systemabhängig.


Eigenschaften von TTimer

TTimer	Alphabetisch	Legende

In TTimer

Enabled

Interval

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Name

Owner

Tag


Eigenschaften von TTimer

TTimer	Nach Objekten	Legende

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

DesignInfo

Enabled

Interval

Name

Owner

Tag


TTimer::Enabled

TTimer	Siehe auch	Beispiel

Die Eigenschaft Enabled legt fest, ob der Timer auf OnTimer-Ereignisse reagiert.

__property bool Enabled;

Beschreibung

Mit Enabled können Sie den Timer aktivieren oder deaktivieren. Wenn Enabled True ist, reagiert der Zeitgeber in gewohnter Weise. Ist Enabled False, reagiert der Timer nicht auf das Ereignis OnTimer. Der Vorgabewert ist True.


TTimer::Interval

TTimer	Siehe auch

Die Eigenschaft Interval gibt die Zeit in Millisekunden an, die verstreicht, bevor die Timer-Komponente das nächste Ereignis OnTimer initialisiert.

__property unsigned int Interval;

Beschreibung

Die Eigenschaft Interval legt fest, wie häufig das Ereignis OnTimer auftritt. Das Ereignis tritt nach jedem Ablauf des festgelegten Zeitabschnitts ein.

Mit dieser Eigenschaft können Sie die Zeitabschnitte zwischen OnTimer-Ereignissen angeben. Der Vorgabewert ist 1000 (eine Sekunde).

Hinweis

Der Wert 0 ist gültig. Der Zeitgeber löst jedoch für diesen Wert kein Ereignis OnTimer aus.


Ereignisse von TTimer

TTimer	Alphabetisch	Legende

In TTimer

OnTimer


Ereignisse von TTimer

TTimer	Nach Objekten	Legende

OnTimer


TTimer::OnTimer

TTimer	Siehe auch

Das Ereignis OnTimer tritt ein, wenn der in der Eigenschaft Interval festgelegte Zeitabschnitt verstrichen ist.

__property Classes::TNotifyEvent OnTimer;

Beschreibung

Mit dem Ereignis OnTimer können Sie eine Behandlungsroutine schreiben, die in bestimmten Zeitabschnitten eine Aktion ausführt.

Die Eigenschaft Interval des Zeitgebers legt fest, wie häufig das Ereignis OnTimer auftritt. Das Ereignis OnTimer tritt nach jedem Ablauf des festgelegten Zeitabschnitts ein.


Methoden von TTimer

TTimer	Alphabetisch

In TTimer

~TTimer

TTimer

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TTimer

TTimer	Nach Objekten

~TTimer

Assign

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

DestroyComponents

Destroying

Dispatch

FieldAddress

FindComponent

FreeInstance

FreeNotification

Free

GetParentComponent

HasParent

InheritsFrom

InitInstance

InsertComponent

InstanceSize

MethodAddress

MethodName

NewInstance

RemoveComponent

TTimer


TTimer::~TTimer

TTimer

Die Methode TTimer gibt ein TTimer-Objekt frei.

destructor Destroy; override;

Beschreibung

Der Destruktor ~TTimer gibt den Speicher frei, der für das TTimer-Objekt reserviert war. Rufen Sie ~TTimer nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TTimer automatisch aufgerufen wird.

Die Methode TTimer deaktiviert den Zeitgeber, indem es die Eigenschaft Enabled auf False setzt. Anschließend wird vor dem Aufruf des geerbten Destruktors der Zeitgeber durch einen Aufruf der API-Funktion KillTimer gelöscht und das Handle freigegeben.


TTimer::TTimer

TTimer

TTimer instantiiert ein TTimer-Objekt.

__fastcall virtual TTimer(Classes::TComponent* AOwner);

Beschreibung

Mit TTimer können Sie zur Laufzeit ein TTimer-Objekt instantiieren. Für Zeitgeber, die zur Entwurfszeit erzeugt wurden, wird TTimer automatisch aufgerufen.

TTimer weist dem Zeitgeber Speicher zu und ruft geerbte Methode TTimer auf. Dann werden folgende Aktionen durchgeführt:

•	Die Eigenschaft Enabled wird mit True initialisiert.

•	Die Eigenschaft Interval wird mit 1000 initialisiert.

•	Dem Zeitgeber wird ein Fenster-Handle zugewiesen und der Prozedur übergeben, die die WM_TIMER-Botschaften verarbeitet.


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent


TTimer Beispiel

TTimer


 TTrackBar

Hierarchie	Eigenschaften	Methoden	Ereignisse

Header

vcl/comctrls.hpp

Die visuelle Komponente TrackBar enthält einen Regler, der eine relative Position innerhalb eines Bereichs grafisch darstellt. Der Bereich kann mit Teilstrichen versehen werden.

Beschreibung

Während der Programmausführung kann der Regler durch Ziehen mit der Maus oder durch Klicken auf den Reglerbereich zu der gewünschten Position bewegt werden. Auf der Tastatur dienen die Pfeiltasten oder die Tasten BILD AUF und BILD AB diesem Zweck. Die Eigenschaft LineSize gibt an, um wieviele Teilstriche der Regler durch Drücken der Pfeiltasten verschoben wird. Die Eigenschaft PageSize gibt an, um wieviele Teilstriche der Regler durch Drücken der Tasten BILD AUF und BILD AB oder durch Anklicken des Reglerbereichs mit der Maus bewegt wird.

Mit den Eigenschaften TickStyle und TickMarks können Sie Anzahl und Anordnung der Teilstriche festlegen.

Ein TTrackBar-Objekt kann einen Teil des Wertebereichs hervorgehoben darstellen. Beginn und Ende dieses Teilbereichs sind durch dreieckige Teilstriche gekennzeichnet. Mit den Eigenschaften SelStart und SelEnd können Sie die Grenzen des Teilbereichs festlegen.


Eigenschaften von TTrackBar

TTrackBar	Alphabetisch	Legende

Abgeleitet von TTrackBar

Frequency

LineSize

Max

Min

Orientation

PageSize

Position

SelEnd

SelStart

TickMarks

TickStyle

Abgeleitet von TWinControl

Brush

ClientOrigin

ClientRect

ControlCount

Controls

Ctl3D

Handle

HelpContext

ParentCtl3D

Showing

TabOrder

TabStop

Abgeleitet von TControl

Align

BoundsRect

ClientHeight

ClientWidth

ControlState

ControlStyle

Cursor

DragCursor

DragMode

Enabled

Height

Hint

Left

Name

Parent

ParentShowHint

PopupMenu

ShowHint

Top

Visible

Width

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TTrackBar

TTrackBar	Nach Objekten	Legende

Align

BoundsRect

Brush

ClientHeight

ClientOrigin

ClientRect

ClientWidth

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlCount

ControlState

Controls

ControlStyle

Ctl3D

Cursor

DesignInfo

DragCursor

DragMode

Enabled

Frequency

Handle

Height

HelpContext

Hint

Left

LineSize

Max

Min

Name

Orientation

Owner

PageSize

ParentCtl3D

ParentShowHint

Parent

PopupMenu

Position

SelEnd

SelStart

ShowHint

Showing

TabOrder

TabStop

Tag

TickMarks

TickStyle

Top

Visible

Width


TTrackBar::Frequency

TTrackBar

Die Eigenschaft Frequency gibt das Intervall zwischen den Teilstrichen des Schiebereglers an.

__property int Frequency;

Beschreibung

Wenn Sie Frequency beispielsweise den Wert 2 zuweisen, wird bei jedem zweiten Inkrement ein Teilstrich angezeigt.

Diese Eigenschaft wirkt sich nur aus, wenn TickStyle auf tsAuto gesetzt ist.


TTrackBar::LineSize

TTrackBar

Die Eigenschaft LineSize gibt an, um wieviele Teilstriche sich der Regler bewegt, wenn der Anwender eine Pfeiltaste drückt.

__property int LineSize;

Beschreibung

Die aktuelle Position des Reglers ist durch den Wert der Eigenschaft Position festgelegt. Die Tasten RECHTS und AB erhöhen den Wert dieser Eigenschaft um den Wert von LineSize, die Tasten LINKS und AUF verringern ihn entsprechend.

Mit der Eigenschaft PageSize können Sie festlegen, um wieviele Teilstriche der Regler durch Drücken der Tasten BILD AUF und BILD AB bewegt wird.


TTrackBar::Max

TTrackBar

Die Eigenschaft Max legt den maximalen Wert der Eigenschaft Position eines TTrackBar-Objekts fest.

__property int Max;

Beschreibung

Der Regler zeigt den aktuellen Wert der Eigenschaft Position im Bereich zwischen Min und Max an.


TTrackBar::Min

TTrackBar

Die Eigenschaft Min legt den minimalen Wert der Eigenschaft Position eines TTrackBar-Objekts fest.

__property int Min;

Beschreibung

Der Regler zeigt den aktuellen Wert der Eigenschaft Position im Bereich zwischen Min und Max an.


TTrackBar::Orientation

TTrackBar

Die Eigenschaft Orientation legt die relativen Positionen von Min und Max fest.

__property TTrackBarOrientation Orientation;

Beschreibung

Die möglichen Werte für Orientation sind:

Wert	Bedeutung

tbHorizontal	Die längere Seite des Objekts verläuft parallel zum oberen Rand des Formulars. Die Position Min ist links, die Position Max ist rechts..

tbVertical	Die längere Seite des Objekts verläuft parallel zum seitlichen Rand des Formulars. Die Position Min ist oben, die Position Max ist unten.


TTrackBar::PageSize

TTrackBar

Die Eigenschaft PageSize gibt an, um wieviele Teilstriche der Regler durch Drücken der Tasten BILD AUF und BILD AB oder durch Klicken auf den Reglerbereich bewegt wird.

__property int PageSize;

Beschreibung

Die aktuelle Position des Reglers ist durch den Wert der Eigenschaft Position festgelegt. Die Taste BILD AUF erhöht den Wert dieser Eigenschaft um den Wert von PageSize, die Taste BILD AB verringert ihn entsprechend.

Mit der Eigenschaft LineSize können Sie festlegen, um wieviele Teilstriche der Regler durch Drücken der Pfeiltasten bewegt wird.


TTrackBar::Position

TTrackBar 	Beispiel

Die Eigenschaft Position enthält die aktuelle Position des Reglers eines TTrackBar-Objekts.

__property int Position;

Beschreibung

Position ist ein Wert im Bereich zwischen Min und Max (einschließlich), der die aktuelle Position des Reglers eines TTrackBar-Objekts angibt.

Mit den Eigenschaften LineSize und PageSize können Sie festlegen, um welchen Betrag die Eigenschaft Position erhöht oder erniedrigt wird, wenn der Benutzer auf den Reglerbereich klickt oder die Pfeiltasten bzw. BILD AUF oder BILD AB drückt.


TTrackBar::SelEnd

TTrackBar

Die Eigenschaft SelEnd legt den Endpunkt des optional hervorgehobenen Bereichs eines TTrackBar-Objekts fest.

__property int SelEnd;

Beschreibung

Ein Schieberegler kann einen Teilbereich markiert anzeigen. Dieser Bereich wird farblich hervorgehoben und durch spezielle Teilstriche an den durch SelStart und SelEnd festgelegten Positionen gekennzeichnet. Die Eigenschaft SelEnd gibt den höchsten Wert des markierten Bereichs an.


TTrackBar::SelStart

TTrackBar

Die Eigenschaft SelStart legt den Beginn des optional hervorgehobenen Bereichs eines TTrackBar-Objekts fest.

__property int SelStart;

Beschreibung

Ein Schieberegler kann einen Teilbereich markiert anzeigen. Dieser Bereich wird farblich hervorgehoben und durch spezielle Teilstriche an den durch SelStart und SelEnd festgelegten Positionen gekennzeichnet. Die Eigenschaft SelStart gibt den niedrigsten Wert des markierten Bereichs an.


TTrackBar::TickMarks

TTrackBar

Die Eigenschaft TickMarks gibt die Position der optionalen Teilstriche eines TTrackBar-Objekts an.

__property TTickMark TickMarks;

Beschreibung

Die möglichen Werte für TickMarks sind:

Wert	Bedeutung

tmBottomRight	Die Teilstriche werden unten oder rechts angezeigt, abhängig vom Wert der Eigenschaft Orientation.

tmTopLeft	Die Teilstriche werden oben oder links angezeigt, abhängig vom Wert der Eigenschaft Orientation.

tmBoth	Die Teilstriche werden beidseitig angezeigt.


TTrackBar::TickStyle

TTrackBar

Die Eigenschaft TickStyle steuert die Anzeige der optionalen Teilstriche eines TTrackBar-Objekts.

__property TTickStyle TickStyle;

Beschreibung

Die möglichen Werte für TickStyle sind:

Wert	Bedeutung

tsAuto	An jeder Position, die durch Wert der Eigenschaft Frequency teilbar ist, werden automatisch Teilstriche angezeigt.

tsManual	An den Positionen Min und Max werden Teilstriche angezeigt. Mit der Methode SetTick können weitere Teilstriche gesetzt werden.

tsNone	Es werden keine Teilstriche angezeigt.


Ereignisse von TTrackBar

TTrackBar	Alphabetisch	Legende

Abgeleitet von TTrackBar

OnChange

Abgeleitet von TWinControl

OnEnter

OnExit

OnKeyDown

OnKeyPress

OnKeyUp

Abgeleitet von TControl

OnDragDrop

OnDragOver

OnEndDrag

OnStartDrag


Ereignisse von TTrackBar

TTrackBar	Nach Objekten	Legende

OnChange

OnDragDrop

OnDragOver

OnEndDrag

OnEnter

OnExit

OnKeyDown

OnKeyPress

OnKeyUp

OnStartDrag


TTrackBar::OnChange

TTrackBar

Das Ereignis OnChange tritt immer dann ein, wenn sich die Position des Reglers geändert hat.

__property Classes::TNotifyEvent OnChange;

Beschreibung

Mit einer Ereignisbehandlungsroutine für OnChange können Sie bestimmte Aktionen durchführen, wenn sich die Position des Reglers geändert hat. Dieses Ereignis stellt die erste Gelegenheit dar, auf €nderungen am Schieberegler zu reagieren.


Methoden von TTrackBar

TTrackBar	Alphabetisch

Abgeleitet von TTrackBar

~TTrackBar

SetTick

TTrackBar

Abgeleitet von TWinControl

Broadcast

CanFocus

ContainsControl

ControlAtPos

DisableAlign

EnableAlign

Focused

GetTabOrderList

HandleAllocated

HandleNeeded

InsertControl

Invalidate

PaintTo

Realign

RemoveControl

Repaint

ScaleBy

ScrollBy

SetBounds

SetFocus

Update

UpdateControlState

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

GetTextLen

Hide

Perform

Refresh

ScreenToClient

SendToBack

SetTextBuf

Show

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TTrackBar

TTrackBar	Nach Objekten

~TTrackBar

Assign

BeginDrag

BringToFront

Broadcast

CanFocus

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

ClientToScreen

ContainsControl

ControlAtPos

DefaultHandler

DestroyComponents

Destroying

DisableAlign

Dispatch

DragDrop

Dragging

EnableAlign

EndDrag

FieldAddress

FindComponent

Focused

FreeInstance

FreeNotification

Free

GetParentComponent

GetTabOrderList

GetTextBuf

GetTextLen

HandleAllocated

HandleNeeded

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InsertControl

InstanceSize

Invalidate

MethodAddress

MethodName

NewInstance

PaintTo

Perform

Realign

Refresh

RemoveComponent

RemoveControl

Repaint

ScaleBy

ScreenToClient

ScrollBy

SendToBack

SetBounds

SetFocus

SetTextBuf

SetTick

Show

TTrackBar

UpdateControlState

Update


TTrackBar::~TTrackBar

TTrackBar

Der Destruktor ~TTrackBar gibt den Speicher frei, der für das TTrackBar-Objekt reserviert war. Rufen Sie ~TTrackBar nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TTrackBar automatisch aufgerufen wird.

__fastcall virtual ~TTrackBar(void);


TTrackBar::SetTick

TTrackBar

Mit der Methode SetTick können Sie die Position eines einzelnen Teilstrichs festlegen.

void __fastcall SetTick(int Value);

Beschreibung

Mit der Methode SetTick können Sie einen Teilstrich an der im Parameter Value übergegebenen Position setzen. Teilstriche, die Sie auf diese Weise festlegen, werden nur angezeigt, wenn die Eigenschaft TickStyle auf tsManual gesetzt ist.


TTrackBar::TTrackBar

TTrackBar

Der Konstruktor TTrackBar erzeugt ein neues TTrackBar-Objekt.

__fastcall virtual TTrackBar(Classes::TComponent* AOwner);

Beschreibung

Mit TTrackBar wird zur Laufzeit ein TTrackBar-Objekt instantiiert. Während des Entwurfs wird TTrackBar automatisch aufgerufen.

TTrackBar reserviert Speicher für die Instanz des Objekts und setzt die Standardwerte.


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TControl

TWinControl


TTrackBar Beispiel

TTrackBar


TTreeNode

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/comctrls.hpp

Das Objekt TTreeNode stellt einen einzelnen Baumknoten in einem Baumdiagramm (TTreeView) dar.

Beschreibung

Jedes Element eines Baumdiagramms besteht aus einer Bezeichnung sowie einem optionalen Bitmap-Bild und kann darüberhinaus mit einer Liste untergeordneter Elemente verbunden sein. Deren Darstellung läßt sich per Mausklick aus- oder einblenden.


Eigenschaften von TTreeNode

TTreeNode	Alphabetisch	Legende

In TTreeNode

AbsoluteIndex

Count

Cut

Data

Deleting

DropTarget

Expanded

Focused

Handle

HasChildren

ImageIndex

Index

IsVisible

Item

ItemId

Level

OverlayIndex

Owner

Parent

Selected

SelectedIndex

StateIndex

Text

TreeView


Eigenschaften von TTreeNode

TTreeNode	Nach Objekten	Legende

AbsoluteIndex

Count

Cut

Data

Deleting

DropTarget

Expanded

Focused

Handle

HasChildren

ImageIndex

Index

IsVisible

ItemId

Item

Level

OverlayIndex

Owner

Parent

SelectedIndex

Selected

StateIndex

Text

TreeView


TTreeNode::AbsoluteIndex

TTreeNode	Siehe auch

Die Eigenschaft AbsoluteIndex ist der Index eines Baumknotens relativ zum ersten Knoten des Baumelementes.

__property int AbsoluteIndex;

Beschreibung

Mit der Eigenschaft AbsoluteIndex wird die absolute Position eines Knotens in einem Baumknoten-Objekt übergeben. Der erste Knoten eines Baumknoten-Objekts hat den Indexwert 0; der erste Unterknoten den Wert 1 usw. Verfügt ein Knoten über untergeordnete Objekte, so ist sein Index stets um den Wert 1 kleiner als der des ersten untergeordneten Objekts.


TTreeNode::Count

TTreeNode	Siehe auch

Die Eigenschaft Count gibt die Anzahl der untergeordneten Objekte eines Baumknotens an.

__property int Count;

Beschreibung

Mit der Eigenschaft Count läßt sich ermitteln, über wieviele untergeordnete Knoten ein Baumknoten verfügt. Dieser Wert ermöglicht z.B. den iterativen Zugriff auf alle untergeordneten Objekte eines bestimmten Knotens.


TTreeNode::Cut

TTreeNode	Siehe auch

Mit der Eigenschaft Cut wird ermittelt, ob ein Baumknoten-Objekt zur Zeit für eine Cut&Paste-Aktion markiert ist.

__property bool Cut;

Beschreibung

Mit der Eigenschaft Cut läßt sich feststellen, ob ein Knoten für eine Cut&Paste-Aktion markiert ist.


TTreeNode::Data

TTreeNode	Siehe auch

Die Eigenschaft Data enthält einen Zeiger auf die Daten, die mit einem Baumknoten verbunden sind.

__property void * Data;

Beschreibung

Mit der Eigenschaft Data lassen sich Daten -.z.B. ein Texthinweis oder ein Bitmap-Bild - mit einem Baumknoten verbinden.


TTreeNode::Deleting

TTreeNode	Siehe auch

Mit der Eigenschaft Deleting läßt sich feststellen, ob ein Knotenobjekt gerade von seiner Destroy-Methode gelöscht wird.

__property bool Deleting;

Beschreibung

Mit der Eigenschaft Deleting wird festgestellt, ob ein Knoten gerade gelöscht wird.


TTreeNode::DropTarget

TTreeNode	Siehe auch

Mit der Eigenschaft DropTarget wird ermittelt, ob ein Baumknoten als Ziel einer Drag-and-Drop-Aktion markiert wurde.

__property bool DropTarget;

Beschreibung

Mit DropTarget läßt sich feststellen, ob ein Knoten als Ziel einer Drag-and-Drop-Aktion markiert wurde. Hat die Eigenschaft DropTarget den Wert True, zeigt auch die grafische Darstellung des Knotenobjekts, daß es Ziel einer Drag-and-Drop-Aktion ist.


TTreeNode::Expanded

TTreeNode	Siehe auch

Mit der Eigenschaft Expanded läßt sich ermitteln, ob ein Baumknoten gerade erweitert, d.h. zusammen mit seinen untergeordneten Objekten, dargestellt wird.

__property bool Expanded;

Beschreibung

Hat in einem Baumdiagramm-Objekt die Eigenschaft ShowButtons den Wert True, dann wird vor der erweiterten Darstellung eines Knotenobjekts das Minuszeichen (-) als Schaltfläche angezeigt.

Wird ein Knoten zusammen mit seinen untergeordneten Objekten dargestellt, so hat Expanded den Wert True. Ist die Darstellung der Unterknoten ausgeblendet, so hat Expanded den Wert False.


TTreeNode::Focused

TTreeNode	Siehe auch

Mit der Eigenschaft Focused wird ermittelt, ob der Knoten gerade den Fokus hat. Ist dies der Fall, wird der Knoten in einem rechteckigen Rahmen dargestellt. Nur ein Knoten kann zu einem gegebenen Zeitpunkt den Fokus haben.

__property bool Focused;

Beschreibung

Mit Hilfe der Eigenschaft Focused läßt sich feststellen, ob ein bestimmter Knoten eines Baumdiagramms gerade den Fokus hat.


TTreeNode::Handle

TTreeNode	Siehe auch	Beispiel

Die Eigenschaft Handle übergibt einem Knotenobjekt das Handle seines Baumdiagramms.

__property HWND Handle;

Beschreibung

Mit Hilfe der Eigenschaft Handle erhält man das Handle des Baumdiagramms, das Eigentümer des Knotens ist.


TTreeNode::HasChildren

TTreeNode	Siehe auch

Mit der Eigenschaft HasChildren wird ermittelt, ob ein Knoten über untergeordnete Objekte verfügt.

__property bool HasChildren;

Beschreibung

Ist für einen Knoten die erweiterte Darstellung eingestellt, so werden eventuell vorhandene, untergeordnete Objekte nach rechts eingerückt und unterhalb des Knotenobjekts angezeigt. Die Eigenschaft HasChildren hat den Wert True, wenn ein Knoten über untergeordnete Objekte verfügt, und den Wert False, wenn dies nicht der Fall ist. Hat HasChildren den Wert True, wird links vor dem Knoten ein Pluszeichen (+) als Schaltfläche angezeigt, falls auch die Eigenschaft ShowButtons des Baumdiagramms den Wert True hat. Wird HasChildren für ein Knotenobjekt auf True gesetzt, das seinerseits keine untergeordneten Objekte hat, wird zwar das Pluszeichen (+) dargestellt, der Knoten läßt sich jedoch nicht erweitern.


TTreeNode::ImageIndex

TTreeNode	Siehe auch

Die Eigenschaft ImageIndex wählt aus der Bitmap-Liste eine Abbildung, die das Knotenobjekt im Normalzustand, d.h. unmarkiert, darstellt.

__property int ImageIndex;

Beschreibung

ImageIndex dient mit der Eigenschaft Images des Baumdiagramms dazu, für die Normaldarstellung eines Knotens ein Bitmap-Bild festzulegen.


TTreeNode::Index

TTreeNode	Siehe auch

Die Eigenschaft Index übergibt einen eindeutigen Wert für jeden Knoten eines Baumdiagramms.

__property int Index;

Beschreibung

Der erste Knoten hat den Indexwert 1. Dieser wird für jeden nachfolgenden Knoten um den Wert 1 erhöht. Sind also einem Knoten weitere Knoten untergeordnet, so ist sein Index stets um den Wert 1 kleiner als der Index des ersten Unterknotens.


TTreeNode::IsVisible

TTreeNode	Siehe auch

Die Eigenschaft IsVisible stellt fest, ob ein bestimmtes Knotenobjekt in der Darstellung des Baumdiagramms sichtbar ist.

__property bool IsVisible;

Beschreibung

Ein Knoten ist dann sichtbar, wenn er sich auf der Ebene 0 befindet, oder wenn alle seine übergeordneten Knoten erweitert wurden.


TTreeNode::Item

TTreeNode	Siehe auch

Die Eigenschaft Item ermöglicht den Zugriff auf einen untergeordneten Knoten. Der Zugriff erfolgt über den entsprechenden Index auf die Liste der Unterknoten.

__property TTreeNode* Item[int Index];

Beschreibung

Der erste untergeordnete Knoten hat den Index 0, der zweite den Index 1 usw.

Example

In der folgenden Beispielprozedur wird ein markierter Knoten bearbeitet, indem die Texte seiner untergeordneten Knoten einem Listenfeld angefügt werden.

void __fastcall TForm1::Button1CLick(TObject Sender) {

    for(int i=0; i < (TreeView->Selected->Count - 1); i++)

        ListBox1->Items->Add(TreeView1->Selected->Item[i]->Text);

}


TTreeNode::ItemId

TTreeNode	Siehe auch

Die Eigenschaft ItemID ist ein Handle, das auf ein TTreeNode-Objekt vom Typ HTreeItem verweist und durch das jeder Knoten eines Baumdiagramms eindeutig angegeben wird.

__property Commctrl::HTreeItem ItemId;

Beschreibung

Soll extern (d.h. von außerhalb des Baumdiagramms) auf die Knoten eines Baumdiagramms zugegriffen werden, so wird dazu die Eigenschaft ItemID verwendet.


TTreeNode::Level

TTreeNode	Siehe auch

Mit der Eigenschaft Level läßt sich für jeden Knoten eines Baumdiagramms die Verzweigungsebene feststellen.

__property int Level;

Beschreibung

Die Eigenschaft Level gibt für Knotenobjekte der obersten Ebene den Wert 0 an; die unmittelbar untergeordneten Objekte haben den Wert 1 usw.


TTreeNode::OverlayIndex

TTreeNode	Siehe auch

Die Eigenschaft OverlayIndex legt fest, welches Bitmap der Bitmap-Liste als Overlay-Maske verwendet wird.

__property int OverlayIndex;

Beschreibung

Unter einer Overlay-Maske versteht man ein Bitmap, das in einem Baumdiagramm ein anderes Bitmap transparent überlagert. Um beispielsweise zu zeigen, daß der Zugriff auf einen Knoten nicht mehr möglich ist, läßt sich dessen aktuelle Darstellung mit einem X als Overlay-Maske überlagern.


TTreeNode::Owner

TTreeNode	Siehe auch

Die Eigenschaft Owner gibt an, welches Knotenobjekt der Eigentümer des Knotens ist.

__property TTreeNodes* Owner;

Beschreibung

Mit der Eigenschaft Owner läßt sich der Eigentümer eines Baumknotens ermitteln.


TTreeNode::Parent

TTreeNode	Siehe auch	Beispiel

Mit der Eigenschaft Parent wird das Knotenobjekt ermittelt, das einem Knoten übergeordnet ist.

__property TTreeNode* Parent;

Beschreibung

Ein übergeordneter Knoten gehört der nächsthöheren Verzweigungsebene an und enthält den Knoten als Unterknoten.


TTreeNode::Selected

TTreeNode	Siehe auch 	Beispiel

Mit der Eigenschaft Selected läßt sich bestimmen, ob der Knoten gegenwärtig markiert ist.

__property bool Selected;

Beschreibung

Wird der Wert von Selected auf True gesetzt, wird der Knoten markiert. Die Darstellung des markierten Knotens hängt davon ab, ob dazu die Systemfarben verwendet werden und ob das Objekt zu diesem Zeitpunkt den Fokus hat. Die Markierung des Knotens löst im Steuerelement des Baumdiagramms die Ereignisse OnChanging und OnChanged aus.


TTreeNode::SelectedIndex

TTreeNode	Siehe auch

Die Eigenschaft SelectedIndex wählt über einen Index in die Bitmap-Liste (TImageList) das Bitmap aus, mit dem das Knotenobjekt im markierten Zustand dargestellt wird.

__property int SelectedIndex;

Beschreibung

Mit der Eigenschaft SelectedIndex wird die Darstellung des Knotens im markierten Zustand festgelegt.


TTreeNode::StateIndex

TTreeNode	Siehe auch

Die Eigenschaft StateIndex gibt an, welches Bitmap (aus der Bitmap-Liste StateImages) für die Bildschirmdarstellung des Knotens verwendet wird.

__property int StateIndex;

Beschreibung

Hat StateIndex den Wert -1, dann wird kein Bitmap angezeigt.


TTreeNode::Text

TTreeNode	Siehe auch	Beispiel

Die Eigenschaft Text legt den String fest, mit dem das Knotenobjekt beschriftet wird.

__property System::AnsiString Text;

Beschreibung

Der String Text wird im Baumdiagramm angezeigt. Der Stringwert kann der Eigenschaft zur Laufzeit direkt zugewiesen werden. Alternativ läßt sich zu diesem Zweck auch der TreeView Items-Editor verwenden.


TTreeNode::TreeView

TTreeNode	Siehe auch

Mit der Eigenschaft TreeView wird angegeben, welches Baumdiagramm der Eigentümer des Baumknotens (TTreeNode) ist.

__property TCustomTreeView* TreeView;

Beschreibung

Mit der Eigenschaft TreeView läßt sich feststellen, zu welchem Baumdiagramm ein Baumknoten gehört.


Methoden von TTreeNode

TTreeNode	Alphabetisch

In TTreeNode

~TTreeNode

AlphaSort

Assign

Collapse

CustomSort

Delete

DeleteChildren

DisplayRect

EditText

EndEdit

Expand

getFirstChild

GetHandle

GetLastChild

GetNext

GetNextChild

getNextSibling

GetNextVisible

GetPrev

GetPrevChild

getPrevSibling

GetPrevVisible

HasAsParent

IndexOf

MakeVisible

MoveTo

TTreeNode

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TTreeNode

TTreeNode	Nach Objekten

~TTreeNode

AlphaSort

Assign

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

Collapse

CustomSort

DefaultHandler

DeleteChildren

Delete

Dispatch

DisplayRect

EditText

EndEdit

Expand

FieldAddress

FreeInstance

Free

getFirstChild

GetHandle

GetLastChild

GetNextChild

getNextSibling

GetNext

GetNextVisible

GetPrevChild

getPrevSibling

GetPrev

GetPrevVisible

HasAsParent

IndexOf

InheritsFrom

InitInstance

InstanceSize

MakeVisible

MethodAddress

MethodName

MoveTo

NewInstance

TTreeNode


TTreeNode::~TTreeNode

TTreeNode	Siehe auch

Der Destruktor ~TTreeNode gibt den Speicher frei, der für das TTreeNode-Objekt reserviert war. Rufen Sie ~TTreeNode nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TTreeNode automatisch aufgerufen wird.

__fastcall virtual ~TTreeNode(void);

Beschreibung

Zum Löschen eines Baumdiagramms sollten Sie die Methode Delete verwenden.


TTreeNode::AlphaSort

TTreeNode	Siehe auch

Die Methode AlphaSort sortiert alle Haupt- und Unterknoten eines Baumdiagramms alphabetisch nach ihren Bezeichnungen.

bool __fastcall AlphaSort(void);

Beschreibung

Die Methode AlphaSort empfiehlt sich besonders dann, wenn die einem Knoten unmittelbar untergeordneten Objekte alphabetisch sortiert werden sollen. Nach durchgeführter Sortierung gibt die Methode den Wert True zurück.


TTreeNode::Assign

TTreeNode	Siehe auch

Die Methode Assign verwirft alle aktuellen Eigenschaften des Knotenobjekts und ersetzt sie durch die Eigenschaften des Quellobjekts (Source).

virtual void __fastcall Assign(Classes::TPersistent* Source);

Beschreibung

Gehört Source einem anderen Objekt-Typ an, ruft Assign die geerbte Methode auf. Mit Hilfe von Assign lassen sich Informationen zwischen zwei Knotenobjekten kopieren.


TTreeNode::Collapse

TTreeNode	Siehe auch

Mit der Methode Collapse wird ein Knoten verkürzt angezeigt, d.h. seine untergeordneten Objekte werden aus der Darstellung ausgeblendet.

void __fastcall Collapse(bool Recurse);

Beschreibung

In der verkürzten Darstellung eines Knotens werden seine untergeordneten Objekte ausgeblendet. Vor dem Knoten wird das Pluszeichen (+) als Schaltfläche angezeigt, falls die Eigenschaft ShowButtons des Baumdiagramms gesetzt ist. Hat der Parameter Recurse den Wert True, werden auch alle Unterknoten verkürzt angezeigt. Das gilt auch dann, wenn die Darstellung des Knotens das nächste Mal wieder erweitert wird. Hat Recurse den Wert False, wird die Anzeige der untergeordneten Objekte nicht verkürzt. Das gilt auch dann, wenn für den übergeordneten Knoten das nächste Mal wieder die erweiterte Darstellung gewählt wird.


TTreeNode::CustomSort

TTreeNode	Siehe auch

Mit Hilfe dieser Methode lassen sich untergeordnete Knoten nach selbstdefinierten Kriterien sortieren.

bool __fastcall CustomSort(Commctrl::TTVCompare SortProc, long Data);

Beschreibung

Der Aufruf dieser Methode setzt voraus, daß das Programm eine Callback-Funktion bereitgestellt, mit der das Baumdiagramm- bzw. das jeweilige Knotenobjekt die Reihenfolge zweier Unterknoten eindeutig entscheiden kann. Der Parameter SortProc ist ein Zeiger auf diese Funktion. Mit dem Parameter Data kann optional auch ein Wert an die Funktion übergeben werden.

Die CustomSort-Methode des Knotenobjekts sortiert alle Objekte, die dem aufrufenden Objekt untergeordnet sind. Mit der CustomSort-Methode des Baumdiagramms werden hingegen alle Knoten der Diagramm-Anzeige sortiert.

Zur Durchführung des Vergleichs werden der Callback-Funktion zwei Knotenobjekte übergeben. Darüber hinaus läßt sich als dritter Parameter ein 32-Bit-Wert frei definieren.

Die Callback-Funktion muß die folgende Form haben:

Soll der erste Knoten vor dem zweiten eingeordnet werden, so muß die Callback-Funktion einen negativen Wert zurückgeben. Ein positiver Rückgabewert zeigt dagegen an, daß der erste Knoten hinter dem zweiten anzuordnen ist. Der Wert 0 steht für die Gleichrangigkeit beider Objekte. Die Parameter Node1 und Node2 bezeichnen die beiden Knoten, die miteinander verglichen werden sollen.

Hat der Parameter SortProc den Wert NULL, wird als Vorgabe die Methode AlphaSort aufgerufen.

Beispiel

In dem folgenden Code-Beispiel wird ein Baumdiagramm nach einem Mausklick alphabetisch in absteigender Reihenfolge sortiert. Die Callback-Funktion CustomSortProc ruft ihrerseits die API-Function lstrcmp von Windows auf und negiert deren Rückgabewert.

int __fastcall CustomSortProc(TTreeNode* Node1, TTreeNode* Node2, int ParamSort) {

  Result = -lstrcmp(PChar(Item1->Text),  PChar(Item2->Text));

}


TTreeNode::Delete

TTreeNode	Siehe auch

Die Methode Delete löscht das aufrufende Knotenobjekt (TTreeNode).

void __fastcall Delete(void);

Beschreibung

Mit Delete wird ein Baumknoten gelöscht.


TTreeNode::DeleteChildren

TTreeNode	Siehe auch

Die Methode DeleteChildren löscht alle Objekte, die dem aufrufenden Knotenobjekt (TTreeNode) untergeordnet sind.

void __fastcall DeleteChildren(void);

Beschreibung

Mit dieser Methode lassen sich alle Objekte löschen, die einem Knotenobjekt untergeordnet sind.


TTreeNode::DisplayRect

TTreeNode	Siehe auch

Die Methode DisplayRect gibt das Begrenzungsrechteck des Knotens zurück.

Windows::TRect __fastcall DisplayRect(bool TextOnly);

Beschreibung

Hat der Parameter TextOnly den Wert True, enthält der Ausschnitt nur den Text für die Bezeichnung des Knotens. Hat der Parameter dagegen den Wert False, wird die komplette Zeile übergeben, die der Knoten im Baumdiagramm belegt.


TTreeNode::EditText

TTreeNode	Siehe auch

Die Methode EditText ermöglicht die direkte Bearbeitung der Bezeichnung, die mit dem angegebenen Knotenobjekt angezeigt wird. Dabei wird der Text durch ein einzeiliges Eingabefeld ersetzt.

bool __fastcall EditText(void);

Beschreibung

Das angegebene Knotenobjekt wird beim Aufruf dieser Methode automatisch markiert und erhält den Fokus. Im Steuerelement des Baumdiagramms wird das Ereignis OnEditing ausgelöst.


TTreeNode::EndEdit

TTreeNode	Siehe auch

Die Methode beendet die Bearbeitung der Knoten-Bezeichnung.

void __fastcall EndEdit(bool Cancel);

Beschreibung

Nach einer €nderung der Bezeichnung wird im Baumdiagramm das Ereignis OnEdited ausgelöst, falls Cancel den Wert False hat.


TTreeNode::Expand

TTreeNode	Siehe auch

Die Methode Expand erweitert die Darstellung eines Knotens, indem sie seine untergeordneten Objekte einblendet.

void __fastcall Expand(bool Recurse);

Beschreibung

Bei der Erweiterung eines Knotenobjekts werden dessen untergeordnete Objekte in die Darstellung eingeblendet. Ist die Eigenschaft ShowButtons des Baumdiagramms gesetzt, wird vor dem Knotenobjekt ein Minuszeichen (-) als Schaltfläche angezeigt. Hat der Parameter Recurse den Wert True, werden alle untergeordneten Knoten in die Erweiterung mit einbezogen.


TTreeNode::GetFirstChild

TTreeNode	Siehe auch

Die Methode GetFirstChild übergibt das erste untergeordnete Objekt des aufrufenden Knotens (TTreeNode-Objekts).

TTreeNode* __fastcall getFirstChild(void);

Beschreibung

GetFirstChild gibt den Wert NULL zurück, wenn der aufrufende Knoten keine untergeordneten Objekte hat.


TTreeNode::GetHandle

TTreeNode	Siehe auch

Die Methode GetHandle übergibt das Handle eines Knotenobjekts.

HWND __fastcall GetHandle(void);

Beschreibung

Mit GetHandle läßt sich das Handle eines Knotenobjekts abrufen.


TTreeNode::GetLastChild

TTreeNode	Siehe auch

Die Methode GetLastChild übergibt das das letzte Objekt (TTreeNode), das einem Knoten direkt untergeordnet ist.

TTreeNode* __fastcall GetLastChild(void);

Beschreibung

Verfügt das aufrufende Objekt nicht über untergeordnete Knoten, gibt GetLastChild den Wert NULL zurück.


TTreeNode::GetNext

TTreeNode	Siehe auch

Die Methode GetNext hat als Rückgabewert das Knotenobjekt, das dem aufrufenden Objekt unmittelbar untergeordnet ist.

TTreeNode* __fastcall GetNext(void);

Beschreibung

Handelt es sich bei dem aufrufenden Knoten um das letzte Knotenobjekt, dann gibt GetNext den Wert NIL zurück. Andernfalls ist der Rückgabewert das nächste Knotenobjekt einschließlich aller untergeordneten und ausgeblendeten Objekte. Will man den nächsten Knoten der gleichen Verzweigungsebene erhalten, so ist die Methode GetNextSibling zu verwenden. Den nächsten sichtbaren Knoten erhält man mit der Methode GetNextVisible.


TTreeNode::GetNextChild

TTreeNode	Siehe auch

Die Methode GetNextChild spezifiziert mit dem Paramte Value den untergeordneten Knoten, dessen Folgeknoten zurückgegeben werden soll.

TTreeNode* __fastcall GetNextChild(TTreeNode* Value);

Beschreibung

Hat der aufrufende Knoten keine untergeordneten Objekte oder gibt es nach Value keine Knoten mehr, dann gibt die Methode den Wert NULL zurück.


TTreeNode::GetNextSibling

TTreeNode	Siehe auch

Der Rückgabewert der Methode GetNextSibling ist der nächste Knoten der gleichen Verzweigungsebene in einem Baumdiagramm.

TTreeNode* __fastcall getNextSibling(void);

Beschreibung

Der Rückgabewert der Methode GetNextSibling ist das nächste Knotenobjekt. Dabei ist es bedeutungslos, ob dieser Knoten aus- oder eingeblendet ist. Um in einem Baumdiagramm den Folgeknoten einschließlich der ihm untergeordneten Objekte zu finden, muß die Methode GetNext verwendet werden.


TTreeNode::GetNextVisible

TTreeNode	Siehe auch

Die Methode GetNextVisible hat als Rückgabewert das nächste, sichtbar dargestellte Knotenobjekt (TTreeNode-Objekt).

TTreeNode* __fastcall GetNextVisible(void);

Beschreibung

Ein Knotenobjekt ist dann sichtbar, wenn sein übergeordneter Knoten erweitert wurde.


TTreeNode::GetPrev

TTreeNode	Siehe auch

Die Methode GetPrev hat als Rückgabewert das Knotenobjekt, das dem aufrufenden Objekt unmittelbar vorausgeht.

TTreeNode* __fastcall GetPrev(void);

Beschreibung

Die Methode GetPrev hat als Rückgabewert den vorhergehenden Knoten. Dabei ist es unerheblich, ob dieses Knotenobjekt ein- oder ausgeblendet ist. Soll jedoch auf den vorhergehenden, sichtbaren Knoten zugegriffen werden, so ist die Methode GetPrevVisible zu verwenden.


TTreeNode::GetPrevChild

TTreeNode	Siehe auch

Die Methode hat als Rückgabewert das untergeordnete Objekt, das dem mit Value angegebenen Knoten unmittelbar vorausgeht.

TTreeNode* __fastcall GetPrevChild(TTreeNode* Value);

Beschreibung

Steht dem mit Value angegebenen Knoten kein weiteres Knotenobjekt voran, wird von GetPrevChild der Wert NULL zurückgegeben.


TTreeNode::GetPrevSibling

TTreeNode	Siehe auch

Mit der Methode GetPrevSibling wird auf das Knotenobjekt (TTreeNode) zugegriffen, das dem aufrufenden Knoten auf der gleichen Verzweigungsebene vorangeht.

TTreeNode* __fastcall getPrevSibling(void);

Beschreibung

Um den vorausgehenden, sichtbaren Knoten der gleichen Verzeichnisebene zu finden, wird die Methode GetPrevSibling eingesetzt.


TTreeNode::GetPrevVisible

TTreeNode	Siehe auch

Die Methode hat als Rückgabewert das sichtbar dargestellte Knotenobjekt (TTreeNode), das dem aufrufenden Objekt vorausgeht.

TTreeNode* __fastcall GetPrevVisible(void);

Beschreibung

Nur mit der Methode GetPrev läßt sich auf das vorausgehende Objekt auch dann zugreifen, wenn es ausgeblendet ist.


TTreeNode::HasAsParent

TTreeNode	Siehe auch

Die Methode HasAsParent gibt den Wert True zurück, wenn es sich bei dem Parameter Value um ein übergeordnetes Objekt (TTreeNode) des aufrufenden Knotens handelt.

bool __fastcall HasAsParent(TTreeNode* Value);

Beschreibung

Mit der Methode HasAsParent läßt sich ermitteln, ob ein Knotenobjekt einem bestimmten Knoten übergeordnet ist.


TTreeNode::IndexOf

TTreeNode	Siehe auch

Der Rückgabewert dieser Methode ist die Position des Knotenobjekts (Value-Parameter), das dem aufrufenden Objekt unmittelbar untergeordnet ist.

int __fastcall IndexOf(TTreeNode* Value);

Beschreibung

Handelt es sich bei dem Parameter Value nicht um einen Knoten, der dem aufrufenden Objekt unmittelbar untergeordnet ist, dann hat IndexOf den Wert -1. Der erste untergeordnete Knoten wird mit dem Index 0 angegeben, der zweite mit dem Index 1 usw.


TTreeNode::MakeVisible

TTreeNode	Siehe auch

Mit der Methode MakeVisible wird ein Knotenobjekt in das Baumdiagramm eingeblendet.

void __fastcall MakeVisible(void);

Beschreibung

Sind die untergeordneten Objekte eines Knotens ausgeblendet und damit nicht sichtbar, dann lassen sie sich mit der Methode MakeVisible wieder einblenden. Zu diesem Zweck wird der Knoten erweitert.


TTreeNode::MoveTo

TTreeNode	Siehe auch

Mit der Methode MoveTo wird ein Knotenobjekt an eine andere Stelle des Baumdiagramms verschoben.

void __fastcall MoveTo(TTreeNode* Destination, TNodeAttachMode Mode);

Beschreibung

Der Parameter Destination gibt an, wohin das Knotenobjekt verschoben werden soll. Der Parameter Mode vom Typ TNodeAttachMode legt fest, wie das Knotenobjekt wieder in das Diagramm einzufügen ist. Die folgende Tabelle enthält die möglichen Werte dieses Parameters:

Wert	Bedeutung

naAdd	Fügt den Knoten an das Ende der Liste an.

naAddFirst	Fügt den Knoten am Anfang der Liste ein.

naAddChild	Definiert den Knoten als letzten, untergeordneten Knoten des Parameters Destination und fügt ihn entsprechend ein.

naAddChildFirst	Definiert den Knoten als ersten, untergeordneten Knoten des Parameters Destination und fügt ihn entsprechend ein.

naInsert	Fügt den Knoten hinter dem Knoten ein, den der Parameter Destinatin angibt.

Beispiel

void __fastcall TForm1::TreeView1DragDrop(TObject *Sender, TObject *Source, int X, int Y) {

    TTreeNode* AnItem = new TTreeNode(TreeNodes1);

    TNodeAttachMode AttachMode;

    THitTests HT;

    if(TreeView1->Selected == NULL) return;

    HT = TreeView1->GetHitTestInfoAt(X, Y);

    AnItem = TreeView1->GetNodeAt(X, Y);

    if(HT >> htOnItem >> htOnIcon >> htNowhere >> htOnIndent != HT) {

        if((HT >> htOnItem != HT) || (HT >> htOnIcon != HT)) AttachMode << naAddChild;

            else if(HT >> htNowhere != HT) AttachMode << naAdd;

                else if(HT >> htOnIndent != HT) AttachMode << naInsert;

        TreeView1->Selected->MoveTo(AnItem, AttachMode);

    }

}


TTreeNode::TTreeNode

TTreeNode	Siehe auch

Der Konstruktor TTreeNode erzeugt ein neues TTreeNode-Objekt.

__fastcall TTreeNode(TTreeNodes* AOwner);

Beschreibung

TTreeNode ruft den Konstruktor des übergeordneten Objekts auf und setzt die Eigenschaften OverlayIndex und StateIndex auf -1 und Owner auf das im Parameter AOwner übergebene TTreeNodes-Objekt.


Zugriff

Read-only


Hierarchie

TObject

TPersistent


TTreeNode Beispiel

TTreeNode


TTreeNodes

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/comctrls.hpp

Objekte der Klasse TTreeNodes verwalten eine Liste von Baumknoten in einem Baumdiagramm-Steuerelement.

Beschreibung

Auf die verschiedenen Knoten eines Baumdiagramm-Steuerelements kann mit dem TTreeNodes-Objekt in der Eigenschaft Items zugegriffen werden. Knoten können beliebig hinzugefügt, gelöscht, eingefügt und innerhalb des Baumdiagramms verschoben werden.


Eigenschaften von TTreeNodes

TTreeNodes	Alphabetisch	Legende

In TTreeNodes

Count

Handle

Item

Owner


Eigenschaften von TTreeNodes

TTreeNodes	Nach Objekten	Legende

Count

Handle

Item

Owner


TTreeNodes::Count

TTreeNodes	Siehe auch

Die Eigenschaft Count enthält die Anzahl der Knoten in einem Baumdiagramm.

__property int Count;

Beschreibung

Mit der Eigenschaft Count können Sie die Anzahl der Baumknoten im Baumdiagramm bestimmen.


TTreeNodes::Handle

TTreeNodes	Siehe auch	Beispiel

Die Eigenschaft Handle gibt das Handle des Baumdiagramm-Steuerelements zurück, zu dem der Knoten gehört.

__property HWND Handle;

Beschreibung

Mit Hilfe der Eigenschaft Handle kann das Handle des Baumdiagramm-Steuerelements abgerufen werden, zu dem das Baumknoten-Objekt gehört.


TTreeNodes::Item

TTreeNodes	Siehe auch

Die Eigenschaft Item ermöglicht den Zugriff auf einen Knoten über dessen Position in der Baumstruktur. Der erste Knoten hat den Index 0, der zweite hat den Index 1 usw.

Commctrl::HTreeItem __fastcall AddItem(Commctrl::HTreeItem Parent, Commctrl::HTreeItem Target, const  TV_ITEMA &Item, TAddMode AddMode);

Beschreibung

Mit Item kann auf einen Knoten über dessen Indexposition im Baumdiagramm zugegriffen werden. Der erste Knoten hat den Index 0, der zweite hat den Index 1 usw.

Hinweis

Der Zugriff auf die Baumknoten über ihren Index kann sehr lange dauern, wenn das Baumdiagramm viele Elemente enthält. Je kleiner die Zahl der Abhängigkeiten im Baumdiagramm ist, desto höher ist die Ausführungsgeschwindigkeit.


TTreeNodes::Owner

TTreeNodes	Siehe auch

Die Eigenschaft Owner gibt das Baumdiagramm-Steuerelement an, zu dem der Knoten gehört.

__property TCustomTreeView* Owner;

Beschreibung

Mit Owner können Sie feststellen, zu welchem Baumdiagramm-Steuerelement die Knoten gehören.


Methoden von TTreeNodes

TTreeNodes	Alphabetisch

In TTreeNodes

~TTreeNodes

Add

AddChild

AddChildFirst

AddChildObject

AddChildObjectFirst

AddFirst

AddObject

AddObjectFirst

Assign

BeginUpdate

Clear

Delete

EndUpdate

GetFirstNode

GetNode

Insert

InsertObject

TTreeNodes

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TTreeNodes

TTreeNodes	Nach Objekten

~TTreeNodes

AddChildFirst

AddChildObjectFirst

AddChildObject

AddChild

AddFirst

AddObjectFirst

AddObject

Add

Assign

BeginUpdate

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

Clear

DefaultHandler

Delete

Dispatch

EndUpdate

FieldAddress

FreeInstance

Free

GetFirstNode

GetNode

InheritsFrom

InitInstance

InsertObject

Insert

InstanceSize

MethodAddress

MethodName

NewInstance

TTreeNodes


TTreeNodes::~TTreeNodes

TTreeNodes	Siehe auch

Der Destruktor ~TTreeNodes gibt den Speicher frei, der für das TTreeNodes-Objekt reserviert war. Rufen Sie ~TTreeNodes nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TTreeNodes automatisch aufgerufen wird.

__fastcall virtual ~TTreeNodes(void);


TTreeNodes::Add

TTreeNodes	Siehe auch

Die Methode Add fügt einem Baumdiagramm-Steuerelement einen neuen Baumknoten hinzu.

TTreeNode* __fastcall Add(TTreeNode* Node, const System::AnsiString S);

Beschreibung

Der neue Baumknoten wird am Ende der Liste hinzugefügt, zu der der mit Node angegebene Knoten gehört. Mit dem Parameter S wird der Eigenschaft Text des neuen Knotens ein Wert zugewiesen. Nach der Operation gibt Add den hinzugefügten Knoten zurück.

Beispiel

Im folgenden Beispiel wird ein neuer Baumknoten am Ende der Liste mit dem ausgewählten Knoten hinzugefügt.

TreeView1->Items->Add(TreeView1->Selected,"Sub Item1");


TTreeNodes::AddChild

TTreeNodes	Siehe auch

Die Methode AddChild fügt einem Baumdiagramm einen neuen Knoten hinzu.

TTreeNode* __fastcall AddChild(TTreeNode* Node, const System::AnsiString S);

Beschreibung

AddChild fügt einen neuen untergeordneten Knoten am Ende der Liste des mit Node angegebenen Baumknoten hinzu. Mit dem Parameter S wird der Wert der Eigenschaft Text des neuen Knotens angegeben. Nach der Operation gibt AddChild den neuen Knoten zurück.

Beispiel

Im folgenden Beispiel wird ein neuer untergeordneter Knoten der Liste des im Baumdiagramm ausgewählten Baumknotens hinzugefügt.

TreeView1->Items->AddChild(TreeView1->Selected,'SubItem1');


TTreeNodes::AddChildFirst

TTreeNodes	Siehe auch

Die Methode AddChildFirst fügt einem Baumdiagramm einen neuen Knoten hinzu.

TTreeNode* __fastcall AddChildFirst(TTreeNode* Node, const System::AnsiString S);

Beschreibung

AddChildFirst fügt einen neuen untergeordneten Knoten am Anfang der Liste des mit Node angegebenen Baumknotens hinzu. Der Parameter S legt den Wert der Eigenschaft Text des neuen Knotens fest. Die Baumknoten nach dem hinzugefügten Knoten werden dadurch um eine Zeile nach unten verschoben und neu indiziert. Nach der Operation gibt AddChildFirst den hinzugefügten Knoten zurück.

Beispiel

Im folgenden Beispiel wird ein neuer untergeordneter Knoten am Anfang der Liste des im Baumdiagramm ausgewählten Baumknotens hinzugefügt.

TreeView1->Items->AddChildFirst(TreeView1->Selected,'SubItem1');


TTreeNodes::AddChildObject

TTreeNodes	Siehe auch

Die Methode AddChildObject fügt einem Baumdiagramm einen neuen Baumknoten mit Daten hinzu.

TTreeNode* __fastcall AddChildObject(TTreeNode* Node, const System::AnsiString S, void * Ptr);

Beschreibung

AddChildObject fügt einen neuen untergeordneten Knoten am Ende der Liste des mit Node angegebenen Baumknotens hinzu. Mit dem Parameter S wird der Wert der Eigenschaft Text und mit Ptr der Wert der Eigenschaft Data des neuen Knotens übergeben. Nach der Operation gibt AddChildObject den hinzugefügten Knoten zurück.


TTreeNodes::AddChildObjectFirst

TTreeNodes	Siehe auch

Die Methode AddChildObjectsFirst fügt einem Baumdiagramm einen neuen Baumknoten mit Daten hinzu.

TTreeNode* __fastcall AddChildObjectFirst(TTreeNode* Node, const System::AnsiString S, void * Ptr);

Beschreibung

AddChildObjectsFirst fügt einen neuen untergeordneten Knoten am Anfang der Liste des mit Node angegebenen Baumknotens hinzu. Die Baumknoten nach dem hinzugefügten Knoten werden dadurch um eine Zeile nach unten verschoben und neu indiziert. Mit dem Parameter S wird der Wert der Eigenschaft Text und mit Ptr der Wert der Eigenschaft Data des neuen Knotens übergeben. Nach der Operation gibt die Methode den hinzugefügten Knoten zurück.


TTreeNodes::AddFirst

TTreeNodes	Siehe auch

Die Methode AddFirst fügt einem Baumdiagramm einen neuen Baumknoten hinzu.

TTreeNode* __fastcall AddFirst(TTreeNode* Node, const System::AnsiString S);

Beschreibung

Der neue Knoten wird am Anfang der Liste hinzugefügt, zu der Node gehört. Die Baumknoten nach dem hinzugefügten Knoten werden dadurch um eine Zeile nach unten verschoben und neu indiziert. Mit dem Parameter S wird der Wert der Eigenschaft Text des neuen Knotens übergeben. Nach der Operation gibt die Methode den hinzugefügten Knoten zurück.


TTreeNodes::AddObject

TTreeNodes	Siehe auch

Die Methode AddObject fügt einem Baumdiagramm einen neuen Baumknoten mit Daten hinzu.

TTreeNode* __fastcall AddObject(TTreeNode* Node, const System::AnsiString S, void * Ptr);

Beschreibung

Der neue Knoten wird am Ende der Liste hinzugefügt, zu der Node gehört. Mit dem Parameter S wird der Wert der Eigenschaft Text und mit Ptr der Wert der Eigenschaft Data des neuen Knotens übergeben. Nach der Operation gibt die Methode den hinzugefügten Knoten zurück. Beim Freigeben des Knotenobjekts wird der Zeiger Ptr nicht automatisch mit freigegeben.


TTreeNodes::AddObjectFirst

TTreeNodes	Siehe auch

Die Methode AddObjectFirst fügt einem Baumdiagramm einen neuen Knoten mit Daten hinzu.

TTreeNode* __fastcall AddObjectFirst(TTreeNode* Node, const System::AnsiString S, void * Ptr);

Beschreibung

Der neue Knoten wird am Anfang der Liste hinzugefügt, zu der Node gehört. Die Baumknoten nach dem hinzugefügten Knoten werden dadurch um eine Zeile nach unten verschoben und neu indiziert. Mit dem Parameter S wird der Wert der Eigenschaft Text und mit Ptr der Wert der Eigenschaft Data des neuen Knotens übergeben. Nach der Operation gibt die Methode den hinzugefügten Knoten zurück.


TTreeNodes::Assign

TTreeNodes	Siehe auch

Mit der Methode Assign können Informationen von einem Baumknoten-Objekt zu einem anderen kopiert werden.

virtual void __fastcall Assign(Classes::TPersistent* Source);

Beschreibung

Gibt Source ein anderes TTreeNodes-Objekt an, werden die aktuellen Eigenschaftsinformationen verworfen und durch die Information aus Source ersetzt. Ist Source ein anderer Objekttyp, ruft Assign dessen geerbte Methode auf.


TTreeNodes::BeginUpdate

TTreeNodes	Siehe auch

Die Methode BeginUpdate verhindert bis zu einem Aufruf der Methode EndUpdate das Aktualisieren des Baumdiagramms.

void __fastcall BeginUpdate(void);

Beschreibung

Mit BeginUpdate kann verhindert werden, daß der Bildschirm beim Hinzufügen, Löschen oder Einfügen von Knoten aktualisiert wird. Die von den Änderungen betroffenen Baumknoten erhalten erst nach dem Aufruf von EndUpdate wieder gültige Index-Werte.

Durch den Aufruf dieser Methode können Sie beim Hinzufügen neuer Knoten das ständige Aktualisieren des Bildschirms vermeiden und die Verarbeitung beschleunigen.

Hinweis:

Aufrufe von BeginUpdate sind kumulativ. Sie müssen daher für jeden Aufruf von BeginUpdate einen entsprechenden EndUpdate-Aufruf ausführen.


TTreeNodes::Clear

TTreeNodes	Siehe auch

Die Methode Clear löscht alle Knoten eines Baumdiagramms.

void __fastcall Clear(void);

Beschreibung

Mit Clear können alle Knoten aus einem Baumdiagramm entfernt werden.


TTreeNodes::Delete

TTreeNodes

Die Methode Delete löscht einen Knoten aus eineListe von Baumknoten.

void __fastcall Delete(TTreeNode* Node);


TTreeNodes::EndUpdate

TTreeNodes	Siehe auch

Die Methode EndUpdate aktiviert nach einer vorherigen Deaktivierung durch BeginUpdate das Aktualisieren des Bildschirms und das erneute Indizieren der Baumknoten.

void __fastcall EndUpdate(void);

Beschreibung

Mit EndUpdate kann nach einem Aufruf von BeginUpdate das Aktualisieren des Bildschirms wieder aktiviert werden.


TTreeNodes::GetFirstNode

TTreeNodes	Siehe auch

Die Methode GetFirstNode gibt den ersten Knoten eines Baumdiagramms zurück.

TTreeNode* __fastcall GetFirstNode(void);

Beschreibung

Mit der Methode GetFirstNode kann der erste Knoten des Baumdiagramms abgerufen werden.


TTreeNodes::GetNode

TTreeNodes	Siehe auch

Die Methode GetNode gibt den in ItemId angegebenen Baumknoten zurück.

TTreeNode* __fastcall GetNode(Commctrl::HTreeItem ItemId);

Beschreibung

ItemId gibt das Handle des Baumknotens an.


TTreeNodes::Insert

TTreeNodes	Siehe auch

Die Methode Insert fügt einen neuen Knoten an der angegebenen Position in ein Baumdiagramm ein.

TTreeNode* __fastcall Insert(TTreeNode* Node, const System::AnsiString S);

Beschreibung

Insert fügt einen neuen Knoten nach dem in Node angegebenen Knoten in das Baumdiagramm ein. Mit dem Parameter S wird der Wert der Eigenschaft Text des neuen Knotens übergeben. Nach dem Einfügen gibt Insert den neuen Knoten zurück.


TTreeNodes::InsertObject

TTreeNodes	Siehe auch

Die Methode InsertObject fügt einen neuen Knoten mit Daten an der angegebenen Position in ein Baumdiagramm ein.

TTreeNode* __fastcall InsertObject(TTreeNode* Node, const System::AnsiString S, void * Ptr);

Beschreibung

Insert fügt einen neuen Knoten nach der mit Node angegebenen Position in das Baumdiagramm ein. Mit dem Parameter S wird der Wert der Eigenschaft Text und mit Ptr der Wert der Eigenschaft Data des neuen Knotens übergeben. Nach dem Einfügen gibt InsertObject den neuen Knoten zurück.


TTreeNodes::TTreeNodes

TTreeNodes	Siehe auch

Die Methode TTreeNodes erzeugt eine Instanz eines TTreeNodes-Objekts.

__fastcall TTreeNodes(TCustomTreeView* AOwner);

TTreeNodes ruft zuerst den Konstruktor des übergeordneten Objekts auf und setzt dann die Eigenschaft Owner des Baumknoten-Objekts auf das in AOwner angegebene Baumdiagramm.


Zugriff

Read-only


Hierarchie

TObject

TPersistent


TTreeNodes Beispiel

TTreeNodes


 TTreeView

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/comctrls.hpp

Ein Baumdiagramm ist ein Steuerelement in Form eines Fensters, das die hierarchische Struktur einer Liste von Elementen darstellt. Solche Elemente können beispielsweise Überschriften eines Textdokuments sein, Einträge in einem Stichwortverzeichnis oder die Dateien und Verzeichnisse auf einer Festplatte.

Beschreibung

Die Knoten in einem Baumdiagramm bestehen aus einer Bezeichnung und einer Anzahl von optionalen Bitmaps. Jedem einzelnen Knoten kann wiederum eine Liste von Unterknoten als weitere Verzweigung zugeordnet werden. Mit einem Mausklick auf einen Knoten lassen sich die davon ausgehenden Verzweigungen ein- und ausblenden. Der Datenbank-Explorer ist ein Beispiel dafür, wie ein Baumdiagramm eingesetzt werden kann.


Eigenschaften von TTreeView

TTreeView	Alphabetisch	Legende

In TTreeView

ReadOnly

Abgeleitet von TCustomTreeView

BorderStyle

DropTarget

HideSelection

Images

Indent

Items

Selected

ShowButtons

ShowLines

ShowRoot

SortType

StateImages

TopItem

Abgeleitet von TWinControl

Brush

ClientOrigin

ClientRect

ControlCount

Controls

Ctl3D

Handle

HelpContext

ParentCtl3D

Showing

TabOrder

TabStop

Abgeleitet von TControl

Align

BoundsRect

ClientHeight

ClientWidth

Color

ControlState

ControlStyle

Cursor

DragCursor

DragMode

Enabled

Font

Height

Hint

Left

Name

Parent

ParentColor

ParentFont

ParentShowHint

PopupMenu

ShowHint

Top

Visible

Width

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TTreeView

TTreeView	Nach Objekten	Legende

Align

BorderStyle

BoundsRect

Brush

ClientHeight

ClientOrigin

ClientRect

ClientWidth

Color

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlCount

ControlState

Controls

ControlStyle

Ctl3D

Cursor

DesignInfo

DragCursor

DragMode

DropTarget

Enabled

Font

Handle

Height

HelpContext

HideSelection

Hint

Images

Indent

Items

Left

Name

Owner

ParentColor

ParentCtl3D

ParentFont

ParentShowHint

Parent

PopupMenu

ReadOnly

Selected

ShowButtons

ShowHint

Showing

ShowLines

ShowRoot

SortType

StateImages

TabOrder

TabStop

Tag

TopItem

Top

Visible

Width


TTreeView::ReadOnly

TTreeView	Siehe auch

Diese Eigenschaft legt fest, ob der Benutzer den Inhalt eines Steuerelements ändern kann.

__property ReadOnly;

Beschreibung

Wenn ReadOnly den Wert True hat, kann der Benutzer den Inhalt nicht ändern, beim Wert False dagegen schon. False ist der Vorgabewert.


Ereignisse von TTreeView

TTreeView	Alphabetisch	Legende

Abgeleitet von TCustomTreeView

OnChange

OnChanging

OnCollapsed

OnCollapsing

OnCompare

OnDeletion

OnEdited

OnEditing

OnExpanded

OnExpanding

OnGetImageIndex

OnGetSelectedIndex

Abgeleitet von TWinControl

OnEnter

OnExit

OnKeyDown

OnKeyPress

OnKeyUp

Abgeleitet von TControl

OnClick

OnDblClick

OnDragDrop

OnDragOver

OnEndDrag

OnMouseDown

OnMouseMove

OnMouseUp

OnStartDrag


Ereignisse von TTreeView

TTreeView	Nach Objekten	Legende

OnChange

OnChanging

OnClick

OnCollapsed

OnCollapsing

OnCompare

OnDblClick

OnDeletion

OnDragDrop

OnDragOver

OnEdited

OnEditing

OnEndDrag

OnEnter

OnExit

OnExpanded

OnExpanding

OnGetImageIndex

OnGetSelectedIndex

OnKeyDown

OnKeyPress

OnKeyUp

OnMouseDown

OnMouseMove

OnMouseUp

OnStartDrag


Methoden von TTreeView

TTreeView	Alphabetisch

In TTreeView

~TTreeView

TTreeView

Abgeleitet von TCustomTreeView

AlphaSort

CustomSort

FullCollapse

FullExpand

GetHitTestInfoAt

GetNodeAt

IsEditing

LoadFromFile

LoadFromStream

SaveToFile

SaveToStream

Abgeleitet von TWinControl

Broadcast

CanFocus

ContainsControl

ControlAtPos

DisableAlign

EnableAlign

Focused

GetTabOrderList

HandleAllocated

HandleNeeded

InsertControl

Invalidate

PaintTo

Realign

RemoveControl

Repaint

ScaleBy

ScrollBy

SetBounds

SetFocus

Update

UpdateControlState

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

GetTextLen

Hide

Perform

Refresh

ScreenToClient

SendToBack

SetTextBuf

Show

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TTreeView

TTreeView	Nach Objekten

~TTreeView

AlphaSort

Assign

BeginDrag

BringToFront

Broadcast

CanFocus

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

ClientToScreen

ContainsControl

ControlAtPos

CustomSort

DefaultHandler

DestroyComponents

Destroying

DisableAlign

Dispatch

DragDrop

Dragging

EnableAlign

EndDrag

FieldAddress

FindComponent

Focused

FreeInstance

FreeNotification

Free

FullCollapse

FullExpand

GetHitTestInfoAt

GetNodeAt

GetParentComponent

GetTabOrderList

GetTextBuf

GetTextLen

HandleAllocated

HandleNeeded

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InsertControl

InstanceSize

Invalidate

IsEditing

LoadFromFile

LoadFromStream

MethodAddress

MethodName

NewInstance

PaintTo

Perform

Realign

Refresh

RemoveComponent

RemoveControl

Repaint

SaveToFile

SaveToStream

ScaleBy

ScreenToClient

ScrollBy

SendToBack

SetBounds

SetFocus

SetTextBuf

Show

TTreeView

UpdateControlState

Update


TTreeView::~TTreeView

TTreeView

Der Destruktor ~TTreeView gibt den Speicher frei, der für das TTreeView-Objekt reserviert war. Rufen Sie ~TTreeView nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TTreeView automatisch aufgerufen wird.

__fastcall virtual ~TTreeView(void);


TTreeView::TTreeView

TTreeView

Der Konstruktor TTreeView erzeugt ein neues TTreeView-Objekt.

__fastcall virtual TTreeView(Classes::TComponent* AOwner);


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TControl

TWinControl

TCustomTreeView


TTreeView Beispiel

TTreeView


 TUpdateSQL

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/dbtables.hpp

Mit einem TUpdateSQL-Objekt können Nur-Lesen-Datenmengen aktualisiert werden, wenn die zwischengespeicherten Aktualisierungen aktiviert wurden.

Beschreibung

Sind die zwischengespeicherten Aktualisierungen aktiviert, können mit einem TUpdateSQL-Objekt die SQL-Anweisungen zum Aktualisieren von Nur-Lesen-Datenmengen (TQuery-Komponenten) angegeben werden. Eine Datenmenge kann während des Entwurfs oder durch bestimmte Umstände als Nur-Lesen-Datenmenge definiert werden. Wird sie als Nur-Lesen-Datenmenge entworfen, verfügt die Anwendung über keine Benutzeroberflächenelemente zum Aktualisieren der Daten, kann aber intern entsprechende Möglichkeiten vorsehen. Ist eine Datenmenge aufgrund der vorliegenden Bedingungen schreibgeschützt, wurde von der BDE (Borland Database Engine) eine Nur-Lesen-Ergebnismenge zurückgegeben. Dies ist normalerweise bei Abfragen über mehrere Tabellen der Fall. Nach SQL-92 sind solche Abfragen als Nur-Lesen-Abfragen definiert.

TUpdateSQL stellt einen Mechanismus zur Umgehung dessen bereit, was manche Entwickler als eine Beschränkung von SQL-92 ansehen. Dadurch können mit INSERT-, UPDATE-, und DELETE-Anweisungen separate Aktualisierungsabfragen durchgeführt werden, die für den Benutzer transparent sind.

In einer Anwendung wird das TUpdateSQL-Objekt in ein Datenmodul oder Formular eingefügt und mit einer TQuery-Komponente über deren Eigenschaft UpdateSQL verbunden. Zeigt UpdateSQL auf ein gültiges TUpdateSQL-Objekt, werden die SQL-Anweisungen des Objekts automatisch ausgeführt, sobald zwischengespeicherte Aktualisierungen geschrieben werden.


Eigenschaften von TUpdateSQL

TUpdateSQL	Alphabetisch	Legende

In TUpdateSQL

DataSet

DeleteSQL

InsertSQL

ModifySQL

Query

SQL

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Name

Owner

Tag


Eigenschaften von TUpdateSQL

TUpdateSQL	Nach Objekten	Legende

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

DataSet

DeleteSQL

DesignInfo

InsertSQL

ModifySQL

Name

Owner

Query

SQL

Tag


TUpdateSQL::DataSet

TUpdateSQL	Siehe auch

Die Eigenschaft DataSet gibt die Datenmenge der TUpdateSQL-Komponente an.

__property DataSet;

Beschreibung

Während des Entwurfs wird DataSet automatisch auf die Datenmenge gesetzt, die verwendet wird, wenn die Datenmengeneigenschaft UpdateSQL auf den Namen des Aktualisierungsobjekts gesetzt wird. In einer Anwendung sollte DataSet nur beim Erstellen einer neuen TUpdateSQL-Komponente zur Laufzeit gesetzt werden.


TUpdateSQL::DeleteSQL

TUpdateSQL	Siehe auch

Die Eigenschaft DeleteSQL gibt die DELETE-Anweisung an, durch die eine zwischengespeicherte Löschoperation eines Datensatzes eingetragen wird.

__property Classes::TStrings* DeleteSQL;

Beschreibung

Geben Sie mit DeleteSQL die DELETE-Anweisung an, die zum Löschen eines Datensatzes verwendet wird. Als Anweisungen sind auch Abfragen mit Parametern möglich. Während des Entwurfs können DELETE-Anweisungen wie die folgende mit dem UpdateSQL-Editor erstellt werden:

delete from "COUNTRY.DB"

where

  Name = :OLD_Name

Zur Laufzeit kann die DELETE-Anweisung direkt in die Eigenschaft geschrieben werden.

Hinweis

Wie im Beispiel zu sehen ist, unterstützt DeleteSQL eine Erweiterung der normalen Parameterzuordnung. Durch Angabe von ‘OLD_’ vor dem Feldnamen kann der Wert abgerufen werden, den das Feld vor Wirksamwerden der zwischengespeicherten Aktualisierungen hatte. Diese Möglichkeit ist besonders beim Vergleichen von Feldern in der WHERE-Klausel hilfreich.


TUpdateSQL::InsertSQL

TUpdateSQL	Siehe auch

Die Eigenschaft v gibt die INSERT-Anweisung an, durch die eine zwischengespeicherte Einfügung eines Datensatzes geschrieben wird.

__property Classes::TStrings* InsertSQL;

Beschreibung

Geben Sie mit InsertSQL die INSERT-Anweisung an, die beim Einfügen eines Datensatzes in eine Datenmenge verwendet wird. Als Anweisungen sind auch Abfragen mit Parametern möglich. Während des Entwurfs können INSERT-Anweisungen wie die folgende mit dem UpdateSQL-Editor erstellt werden:

insert into "COUNTRY.DB"

  (Name, Capital, Continent)

  value (:Name, :Capital, :Continent)

  where :OLD_Name = 'Rangoon'

Zur Laufzeit kann die INSERT-Anweisung direkt in die Eigenschaft geschrieben werden.

Hinweis

Wie im Beispiel zu sehen ist, unterstützt InsertSQL eine Erweiterung der normalen Parameterzuordnung. Durch Angabe von ‘OLD_’ vor dem Feldnamen kann der Wert abgerufen werden, den das Feld vor Wirksamwerden der zwischengespeicherten Aktualisierungen hatte. Diese Möglichkeit ist besonders beim Vergleichen von Feldern in der WHERE-Klausel hilfreich.


TUpdateSQL::ModifySQL

TUpdateSQL	Siehe auch

Die Eigenschaft ModifySQL gibt die UPDATE-Anweisung an, durch die die zwischengespeicherten Änderungen eines Datensatzes geschrieben werden.

__property Classes::TStrings* ModifySQL;

Beschreibung

Geben Sie mit ModifySQL die UPDATE-Anweisung an, die beim Aktualisieren eines Datensatzes verwendet wird. Als Anweisungen sind auch Abfragen mit Parametern möglich. Während des Entwurfs können UPDATE-Anweisungen wie die folgende mit dem UpdateSQL-Editor erstellt werden:

update "COUNTRY.DB"

  set Name = :Name, Capital = :Capital, Continent = :Continent

  where Name = :OLD_Name

Zur Laufzeit kann die UPDATE-Anweisung direkt in die Eigenschaft geschrieben werden.

Hinweis

Wie im Beispiel zu sehen ist, unterstützt ModifySQL eine Erweiterung der normalen Parameterzuordnung. Durch Angabe von ‘OLD_’ vor dem Feldnamen kann der Wert abgerufen werden, den das Feld vor Wirksamwerden der zwischengespeicherten Aktualisierungen hatte. Diese Möglichkeit ist besonders beim Vergleichen von Feldern in der WHERE-Klausel hilfreich.


TUpdateSQL::Query

TUpdateSQL	Siehe auch

Die Eigenschaft Query gibt das für die angegebene Aktualisierungsart verwendete Abfrageobjekt zurück.

__property TQuery* Query[Db::TUpdateKind UpdateKind];

Beschreibung

Mit Query können Sie das TQuery-Objekt abrufen, das für eine bestimmte SQL-Aktualisierungsart verwendet wird. Der Parameter UpdateKind legt fest, welches Abfrageobjekt zurückgegeben werden soll. Er kann einen der folgenden Werte annehmen:

Wert	Beschreibung

ukModify	Das für UPDATE-Anweisungen verwendete Abfrageobjekt wird zurückgegeben.

ukInsert	Das für INSERT-Anweisungen verwendete Abfrageobjekt wird zurückgegeben.

ukDelete	Das für DELETE-Anweisungen verwendete Abfrageobjekt wird zurückgegeben.

Mit jedem Abfrageobjekt kann eine bestimmte Art von SQL-Anweisung ausgeführt werden. Die Eigenschaften ModifySQL, InsertSQL und DeleteSQL ermöglichen den direkten Zugriff auf die von den Objekten verwendeten SQL-Anweisungen.

Die wichtigste Funktion von Query besteht darin, einer Anwendung zu ermöglichen, die Eigenschaften eines Abfrageobjekts festzulegen oder dessen Methoden aufzurufen.

Hinweis

Wird eine bestimmte Aktualisierungsart nicht unterstützt, hat das entsprechende Abfrageobjekt den Wert NULL. Steht in einer Anwendung beispielsweise keine SQL-Anweisung für die Eigenschaft DeleteSQL zur Verfügung, gibt Query[ukDelete] den Wert NULL zurück.


TUpdateSQL::SQL

TUpdateSQL	Siehe auch

Die Eigenschaft SQL gibt die zum Schreiben der zwischengespeicherten Aktualisierungen verwendete SQL-Anweisung zurück.

__property Classes::TStrings* SQL[Db::TUpdateKind UpdateKind];

Beschreibung

Diese Eigenschaft gibt in Abhängigkeit vom Wert des Parameters UpdateKind die SQL-Anweisung in der Eigenschaft ModifySQL, InsertSQL oder DeleteSQL zurück. UpdateKind kann einen der folgenden Werte annehmen:

Wert	Beschreibung

ukModify	Die für das Aktualisieren von Datensätzen verwendete SQL-Anweisung wird zurückgegeben.

ukInsert	Die für das Einfügen von Datensätzen verwendete SQL-Anweisung wird zurückgegeben.

ukDelete	Die für das Löschen von Datensätzen verwendete SQL-Anweisung wird zurückgegeben.


Methoden von TUpdateSQL

TUpdateSQL	Alphabetisch

In TUpdateSQL

~TUpdateSQL

Apply

ExecSQL

SetParams

TUpdateSQL

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TUpdateSQL

TUpdateSQL	Nach Objekten

~TUpdateSQL

Apply

Assign

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

DestroyComponents

Destroying

Dispatch

ExecSQL

FieldAddress

FindComponent

FreeInstance

FreeNotification

Free

GetParentComponent

HasParent

InheritsFrom

InitInstance

InsertComponent

InstanceSize

MethodAddress

MethodName

NewInstance

RemoveComponent

SetParams

TUpdateSQL


TUpdateSQL::~TUpdateSQL

TUpdateSQL

Der Destruktor ~TUpdateSQL gibt den Speicher frei, der für das TUpdateSQL-Objekt reserviert war. Rufen Sie ~TUpdateSQL nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TUpdateSQL automatisch aufgerufen wird.

__fastcall virtual ~TUpdateSQL(void);


TUpdateSQL::Apply

TUpdateSQL	Siehe auch

Die Methode Apply setzt die Parameter für den angegebenen SQL-Anweisungstyp und führt die Anweisung aus.

virtual void __fastcall Apply(Db::TUpdateKind UpdateKind);

Beschreibung

Apply setzt die Parameter einer SQL-Anweisung und verwendet anschließend die Anweisung, um einen Datensatz zu aktualisieren. UpdateKind legt fest, welche SQL-Anweisung zugeordnet und ausgeführt werden soll. Der Parameter kann einen der folgenden Werte annehmen:

Wert	Beschreibung

ukModify	Die SQL-Anweisung in der Eigenschaft ModifySQL wird zugeordnet und ausgeführt.

ukInsert	Die SQL-Anweisung in der Eigenschaft InsertSQL wird zugeordnet und ausgeführt.

ukDelete	Die SQL-Anweisung in der Eigenschaft DeleteSQL wird zugeordnet und ausgeführt.

Apply dient insbesondere der manuellen Ausführung von Aktualisierungsanweisungen in einer Ereignisbehandlungsroutine für OnUpdateRecord.

Hinweis

Bei einer SQL-Anweisung ohne Parameter ist es effizienter, ExecSQL statt Apply aufzurufen.


TUpdateSQL::ExecSQL

TUpdateSQL	Siehe auch

Die Methode ExecSQL führt die angegebene SQL-Anweisung aus, um eine Aktualisierung für eine Nur-Lesen-Ergebnismenge auszuführen.

void __fastcall ExecSQL(Db::TUpdateKind UpdateKind);

Beschreibung

Sind die zwischengespeicherten Aktualisierungen aktiviert, kann mit ExecSQL die SQL-Anweisung ausgeführt werden, die für das Aktualisieren der Datensätze in einer Nur-Lesen-Ergebnismenge erforderlich ist. Der Parameter UpdateKind gibt die auszuführende Anweisung an und kann einen der folgenden Werte annehmen:

Wert	Beschreibung

ukModify	Die zum Aktualisieren von Datensätzen verwendete SQL-Anweisung wird ausgeführt.

ukInsert	Die zum Einfügen neuer Datensätze verwendete SQL-Anweisung wird ausgeführt.

ukDelete	Die zum Löschen von Datensätzen verwendete SQL-Anweisung wird ausgeführt.

Enthält die auszuführende Anweisung Parameter, müssen diese vor dem Aufruf von ExecSQL mit SetParams zugeordnet werden. Anhand der Eigenschaft ModifySQL, InsertSQL oder DeleteSQL (je nach Anweisungstyp) kann festgestellt werden, ob eine Anweisung über Parameter verfügt.

Hinweis

Mit der Methode Apply können in einem Aufruf die Parameter zugeordnet und die Anweisung ausgeführt werden.


TUpdateSQL::SetParams

TUpdateSQL	Siehe auch

Die Methode SetParams ordnet die Parameter vor der Ausführung einer SQL-Anweisung zu.

void __fastcall SetParams(Db::TUpdateKind UpdateKind);

Beschreibung

Mit SetParams können die Parameter einer mit dem Aktualisierungsobjekt verbundenen SQL-Anweisung zugeordnet werden, bevor die Anweisung ausgeführt wird. UpdateKind gibt den Typ der Anweisung an und kann einen der folgenden Werte annehmen:

Wert	Beschreibung

ukModify	Die Parameter der für das Aktualisieren von Datensätzen verwendeten SQL-Anweisung werden zugeordnet.

ukInsert	Die Parameter der für das Einfügen neuer Datensätze verwendeten SQL-Anweisung werden zugeordnet.

ukDelete	Die Parameter der für das Löschen von Datensätzen verwendeten SQL-Anweisung werden zugeordnet.

Den Parametern einer SQL-Anweisung wird ein Doppelpunkt vorangestellt. Abgesehen von diesem Doppelpunkt muß der Parametername genau mit dem Namen eines vorhandenen Feldes in der Datenmenge übereinstimmen.

Hinweis

Parameternamen kann auch die Angabe ‘OLD_’ vorangestellt werden. In diesem Fall wird die Aktualisierung nicht mit den zwischengespeicherten Änderungen sondern mit dem ursprünglichen Feldwert durchgeführt.


TUpdateSQL::TUpdateSQL

TUpdateSQL

Der Konstruktor TUpdateSQL erzeugt ein neues TUpdateSQL-Objekt.

__fastcall virtual TUpdateSQL(Classes::TComponent* AOwner);


Gültigkeitsbereich

Published

Zugriff

Read-only


Hierarchie

TObject

TPersistent

TComponent


TUpdateSQL Beispiel

TUpdateSQL


 TUpDown

Hierarchie	Eigenschaften	Methoden	Ereignisse

Header

vcl/comctrls.hpp

TUpDown ist eine visuelle Komponente mit zwei Schaltflächen, auf denen je ein Pfeil abgebildet ist. Die Komponente ermöglicht es einer Anwendung, inkrementelle numerische Eingaben abzufangen.

Beschreibung

TUpDown besteht aus zwei Schaltflächen mit Pfeilen, die in entgegengesetzte Richtungen zeigen. Wenn der Benutzer auf eine dieser Schaltflächen klickt, wird ein numerischer Wert erhöht oder erniedrigt, der in der Eigenschaft Position gespeichert ist.

TUpDown-Objekte werden normalerweise zusammen mit einem Begleitfenster verwendet, das in der Eigenschaft Associate festgelegt wird. Wenn das Objekt mit einem Eingabefeld verknüpft ist, wird der Wert von Position als formatierter String in diesem Eingabefeld angezeigt. Diese Kombination zweier Komponenten erfüllt einen ähnlichen Zweck wie ein TSpinButton-Objekt oder ein Drehregler und eignet sich besonders für numerische Benutzereingaben.

Wenn die Eigenschaft Associate nicht gesetzt ist, kann Position einer numerischen Variable zugewiesen werden.


Eigenschaften von TUpDown

TUpDown	Alphabetisch	Legende

Abgeleitet von TCustomUpDown

AlignButton

ArrowKeys

Associate

Increment

Max

Min

Orientation

Position

Thousands

Wrap

Abgeleitet von TWinControl

Brush

ClientOrigin

ClientRect

ControlCount

Controls

Handle

HelpContext

Showing

TabOrder

TabStop

Abgeleitet von TControl

Align

BoundsRect

ClientHeight

ClientWidth

ControlState

ControlStyle

Cursor

Enabled

Height

Hint

Left

Name

Parent

ParentShowHint

PopupMenu

ShowHint

Top

Visible

Width

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TUpDown

TUpDown	Nach Objekten	Legende

AlignButton

Align

ArrowKeys

Associate

BoundsRect

Brush

ClientHeight

ClientOrigin

ClientRect

ClientWidth

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlCount

ControlState

Controls

ControlStyle

Cursor

DesignInfo

Enabled

Handle

Height

HelpContext

Hint

Increment

Left

Max

Min

Name

Orientation

Owner

ParentShowHint

Parent

PopupMenu

Position

ShowHint

Showing

TabOrder

TabStop

Tag

Thousands

Top

Visible

Width

Wrap


Ereignisse von TUpDown

TUpDown	Alphabetisch	Legende

Abgeleitet von TCustomUpDown

OnChanging

OnClick

Abgeleitet von TWinControl

OnEnter

OnExit

Abgeleitet von TControl

OnMouseDown

OnMouseMove

OnMouseUp


Ereignisse von TUpDown

TUpDown	Nach Objekten	Legende

OnChanging

OnClick

OnEnter

OnExit

OnMouseDown

OnMouseMove

OnMouseUp


Methoden von TUpDown

TUpDown	Alphabetisch

In TUpDown

~TUpDown

TUpDown

Abgeleitet von TWinControl

Broadcast

CanFocus

ContainsControl

ControlAtPos

DisableAlign

EnableAlign

Focused

GetTabOrderList

HandleAllocated

HandleNeeded

InsertControl

Invalidate

PaintTo

Realign

RemoveControl

Repaint

ScaleBy

ScrollBy

SetBounds

SetFocus

Update

UpdateControlState

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

GetTextLen

Hide

Perform

Refresh

ScreenToClient

SendToBack

SetTextBuf

Show

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TUpDown

TUpDown	Nach Objekten

~TUpDown

Assign

BeginDrag

BringToFront

Broadcast

CanFocus

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

ClientToScreen

ContainsControl

ControlAtPos

DefaultHandler

DestroyComponents

Destroying

DisableAlign

Dispatch

DragDrop

Dragging

EnableAlign

EndDrag

FieldAddress

FindComponent

Focused

FreeInstance

FreeNotification

Free

GetParentComponent

GetTabOrderList

GetTextBuf

GetTextLen

HandleAllocated

HandleNeeded

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InsertControl

InstanceSize

Invalidate

MethodAddress

MethodName

NewInstance

PaintTo

Perform

Realign

Refresh

RemoveComponent

RemoveControl

Repaint

ScaleBy

ScreenToClient

ScrollBy

SendToBack

SetBounds

SetFocus

SetTextBuf

Show

TUpDown

UpdateControlState

Update


TUpDown::~TUpDown

TUpDown

Der Destruktor ~TUpDown gibt den Speicher frei, der für das TUpDown-Objekt reserviert war. Rufen Sie ~TUpDown nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TUpDown automatisch aufgerufen wird.

__fastcall virtual ~TUpDown(void);


TUpDown::TUpDown

TUpDown

Der Konstruktor TUpDown erzeugt ein neues TUpDown-Objekt.

__fastcall virtual TUpDown(Classes::TComponent* AOwner);


Gültigkeitsbereich

Published

Zugriff

Read-only


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TControl

TWinControl

TCustomUpDown


TUpDown Beispiel

TUpDown


TVarBytesField

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/dbtables.hpp

Ein TVarBytesField-Objekt repräsentiert ein untypisiertes binäres Feld in einer Datenmenge.

Beschreibung

Ein variabler Byte-Feldwert besteht aus einer veränderlichen Anzahl von Bytes. Die tatsächliche Länge des Wertes wird in den ersten beiden Bytes gespeichert.

TVarBytesField unterscheidet sich von seinem direkten Vorfahren TBytesField nur im Datentyp, der repräsentiert wird. Mit Ausnahme des Konstruktors und der Eigenschaft DataSize sind alle Eigenschaften, Methoden und Ereignisse mit denen von TBytesField identisch. Dies gilt auch für die Funktionalität, die sich für die Verwaltung von unformatierten binären Datenfeldern in einer Datenmenge eignen.


Eigenschaften von TVarBytesField

TVarBytesField	Alphabetisch	Legende

Abgeleitet von TField

Alignment

AsBoolean

AsCurrency

AsDateTime

AsFloat

AsInteger

AsString

AsVariant

AttributeSet

read-only	BDECalcField

Calculated

read-only	CanModify

DataSet

read-only	DataSize

read-only	DataType

DisplayLabel

read-only	DisplayName

read-only	DisplayText

DisplayWidth

EditMask

read-only	EditMaskPtr

FieldKind

FieldName

read-only	FieldNo

Index

read-only	IsIndexField

read-only	IsNull

KeyFields

Lookup

LookupDataSet

LookupKeyFields

LookupResultField

NewValue

read-only	OldValue

ReadOnly

Required

Size

Text

Value

Visible

Abgeleitet von TComponent

read-only	ComponentCount

ComponentIndex

read-only	Components

read-only	ComponentState

read-only	ComponentStyle

DesignInfo

Name

read-only	Owner

Tag


Eigenschaften von TVarBytesField

TVarBytesField	Nach Objekten	Legende

read-only	BDECalcField

read-only	CanModify

read-only	DataSize

read-only	DataType

read-only	DisplayName

read-only	DisplayText

read-only	EditMaskPtr

read-only	FieldNo

read-only	IsIndexField

read-only	IsNull

read-only	OldValue

read-only	ComponentCount

read-only	Components

read-only	ComponentState

read-only	ComponentStyle

read-only	Owner

Alignment

AsBoolean

AsCurrency

AsDateTime

AsFloat

AsInteger

AsString

AsVariant

AttributeSet

Calculated

ComponentIndex

DataSet

DesignInfo

DisplayLabel

DisplayWidth

EditMask

FieldKind

FieldName

Index

KeyFields

LookupDataSet

LookupKeyFields

LookupResultField

Lookup

Name

NewValue

ReadOnly

Required

Size

Tag

Text

Value

Visible


Ereignisse von TVarBytesField

TVarBytesField	Alphabetisch	Legende

Abgeleitet von TField

OnChange

OnGetText

OnSetText

OnValidate


Ereignisse von TVarBytesField

TVarBytesField	Nach Objekten	Legende

OnChange

OnGetText

OnSetText

OnValidate


Methoden von TVarBytesField

TVarBytesField	Alphabetisch

In TVarBytesField

~TVarBytesField

TVarBytesField

Abgeleitet von TField

Assign

AssignValue

Clear

FocusControl

GetData

IsValidChar

SetData

SetFieldType

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TVarBytesField

TVarBytesField	Nach Objekten

~TVarBytesField

Assign

AssignValue

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

Clear

DefaultHandler

DestroyComponents

Destroying

Dispatch

FieldAddress

FindComponent

FocusControl

FreeInstance

FreeNotification

Free

GetData

GetParentComponent

HasParent

InheritsFrom

InitInstance

InsertComponent

InstanceSize

IsValidChar

MethodAddress

MethodName

NewInstance

RemoveComponent

SetData

SetFieldType

TVarBytesField


TVarBytesField::~TVarBytesField

TVarBytesField

Der Destruktor ~TVarBytesField gibt den Speicher frei, der für das TVarBytesField-Objekt reserviert war. Rufen Sie ~TVarBytesField nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TVarBytesField automatisch aufgerufen wird.

__fastcall virtual ~TVarBytesField(void);


TVarBytesField::TVarBytesField

TVarBytesField

Die Methode TVarBytesField erstellt eine Instanz von TVarBytesField.

__fastcall virtual TVarBytesField(Classes::TComponent* AOwner);

Beschreibung

Es ist nur selten notwendig, TVarBytesField direkt aufzurufen, da für alle variablen Byte-Felder in einer Datenmenge automatisch ein VarBytes-Objekt instantiiert wird.

Nach dem Aufruf des Konstruktors des übergeordneten Objekts setzt TVarBytesField die Eigenschaft DataType auf ftVarBytes und initialisiert die Eigenschaft Size mit dem Wert 16.


Gültigkeitsbereich

Published


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TField

TBinaryField

TBytesField


TVarBytesField Beispiel

TVarBytesField


TWinControl

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/controls.hpp

TWinControl ist die abstrakte Basisklasse für alle fensterorientierten Steuerelemente.

Beschreibung

Fensterorientierte Steuerelemente verfügen über folgende Merkmale:

•	Sie können zur Laufzeit der Anwendung den Fokus erhalten.

Nur mit fensterorientierten Steuerelementen kann der Benutzer mit Hilfe der Tastatur interagieren. In anderen Steuerelementen können lediglich Daten angezeigt werden.

•	Sie können andere Steuerelemente enthalten.

Ein Steuerelement, das andere Komponenten enthält, ist das übergeordnete Element. Nur fensterorientierte Steuerelemente können eine oder mehrere untergeordnete Komponenten besitzen.

•	Sie haben ein Fenster-Handle.

Neue Komponenten werden äußerst selten direkt von TWinControl abgeleitet. Als Basis für neue Steuerelemente dient meistens TCustomControl oder eine der spezialisierteren Komponenten wie TButtonControl, TCustomComboBox, TCustomEdit oder TCustomListBox. Diese Klassen stellen eine Zeichenfläche zur Verfügung und behandeln Paint-Botschaften.


Eigenschaften von TWinControl

TWinControl	Alphabetisch	Legende

In TWinControl

Brush

ClientOrigin

ClientRect

ControlCount

Controls

Ctl3D

DefWndProc

Handle

HelpContext

ImeMode

ImeName

ParentCtl3D

ParentWindow

Showing

TabOrder

TabStop

WindowHandle

Abgeleitet von TControl

Align

BoundsRect

ClientHeight

ClientWidth

ControlState

ControlStyle

Cursor

Enabled

Height

Hint

Hint

Left

Name

Parent

Top

Visible

Width

Abgeleitet von TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Owner

Tag


Eigenschaften von TWinControl

TWinControl	Nach Objekten	Legende

Align

BoundsRect

Brush

ClientHeight

ClientOrigin

ClientRect

ClientWidth

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

ControlCount

ControlState

Controls

ControlStyle

Ctl3D

Cursor

DefWndProc

DesignInfo

Enabled

Handle

Height

HelpContext

Hint

ImeMode

ImeName

Left

Name

Owner

ParentCtl3D

Parent

ParentWindow

Showing

TabOrder

TabStop

Tag

Top

Visible

Width

WindowHandle


TWinControl::Brush

TWinControl	Siehe auch 	Beispiel

Die Eigenschaft Brush ermittelt die Farbe und das Zeichenmuster, die für den Hintergrund des Steuerelements verwendet werden.

__property Graphics::TBrush* Brush;

Beschreibung

Mit Brush können Sie feststellen, welche Farbe und welches Füllmuster für den Hintergrund des Steuerelements verwendet werden. Brush ist schreibgeschützt, da ein fensterorientiertes Steuerelement ein einziges Brush-Objekt für das Zeichnen seines Hintergrunds besitzt. Die Attribute des Pinsels können jedoch mit den Eigenschaften Color und Style des TBrush-Objekts geändert werden. Außerdem können mit der Methode Assign alle Attribute von einem anderen Pinsel übernommen werden.


TWinControl::ClientOrigin

TWinControl	Siehe auch 	Beispiel

Die Eigenschaft ClientOrigin gibt die Bildschirmkoordinaten (in Pixel) der linken oberen Ecke eines Steuerelements an.

Beschreibung

Mit ClientOrigin können Sie feststellen, an welcher Bildschirmposition sich die linke obere Ecke des Steuerelements befindet. Die X- und Y-Koordinate werden in einem Objekt des Typs TPoint zurückgegeben. TPoint-Objekte definieren die Position eines Pixels auf dem Bildschirm. X gibt die horizontale und Y die vertikale Koordinate des Pixels an.


TWinControl::ClientRect

TWinControl	Siehe auch 	Beispiel

Die Eigenschaft ClientRect gibt die Größe (in Pixel) des Client-Bereichs eines Steuerelements an.

Beschreibung

Mit ClientRect können Sie feststellen, wie groß der Client-Bereich eines fensterorientierten Steuerelements ist. Dies entspricht Rect(0, 0, ClientWidth, ClientHeight). ClientRect gibt ein Rechteck in einem Record des Typs TRect zurück.


TWinControl::ControlCount

TWinControl	Siehe auch 	Beispiel

Die Eigenschaft ControlCount gibt die Anzahl der untergeordneten Komponenten eines Steuerelements an.

__property int ControlCount;

Beschreibung

Mit ControlCount können Sie feststellen, wieviele untergeordnete Komponenten in einem Steuerelement enthalten sind. Diese Informationen sind hilfreich, wenn die untergeordneten Steuerelemente in einer Schleife verarbeitet werden sollen. Die einzelnen untergeordneten Elemente sind im Array der Eigenschaft Controls gespeichert.

Die Eigenschaft ControlCount kann nur gelesen werden.

Hinweis

Der Wert von ControlCount ist immer um 1 größer als der höchste Index im Array Controls, da die Indizierung des Arrays bei 0 beginnt.


TWinControl::Controls

TWinControl	Siehe auch 	Beispiel

Die Eigenschaft Controls ist ein Array mit den untergeordneten Komponenten eines Steuerelements.

__property TControl* Controls[int Index];

Beschreibung

Im Array Controls sind alle untergeordneten Komponenten des fensterorientierten Steuerelements gespeichert. Die Eigenschaft Parent dieser Komponenten enthält als Wert das fensterorientierte Steuerelement. Controls ist hilfreich, wenn auf die untergeordneten Steuerelemente mit einer Zahl und nicht mit ihrem Namen Bezug genommen werden soll. So kann Controls beispielsweise verwendet werden, um alle untergeordneten Steuerelemente in einer Schleife zu verarbeiten.

Verwechseln Sie Controls nicht mit der Eigenschaft Components. Erstere enthält die untergeordneten Fenster des Steuerelements, während Components alle im Steuerelement enthaltenen Komponenten angibt. Alle in einem Formular plazierten Komponenten sind im Formular enthalten und erscheinen daher selbst dann in der Eigenschaft Components des Formulars, wenn sie einem Steuerelement des Formulars zugeordnet sind.

Controls kann nur gelesen werden. Mit den Methoden InsertControl und RemoveControl können aber jederzeit untergeordnete Steuerelemente hinzugefügt oder entfernt werden. Soll ein untergeordnetes Fenster einem anderen Steuerelement zugeordnet werden, setzen Sie seine Eigenschaft Parent auf die betreffende Komponente. Dadurch wird die Methode RemoveControl für das ursprünglich übergeordnete Fenster und die Methode InsertControl für das neue übergeordnete Steuerelement aufgerufen.


TWinControl::Ctl3D

TWinControl	Siehe auch	Beispiel

Die Eigenschaft Ctl3D bestimmt, ob ein Steuerelement dreidimensional (3D) oder zweidimensional angezeigt wird.

__property bool Ctl3D;

Beschreibung

Mit Ctl3D können Sie das räumliche Erscheinungsbild eines Steuerelements festlegen. Ist Ctl3D auf True (Standardwert) gesetzt, wird das Steuerelement dreidimensional angezeigt, andernfalls zweidimensional.

Hat die Eigenschaft ParentCtl3D eines Steuerelements den Wert True, erhält seine Eigenschaft Ctl3D automatisch den Wert der Eigenschaft Ctl3D des übergeordneten Fensters. Wird der Eigenschaft Ctl3D des Steuerelements direkt ein Wert zugewiesen, wird ParentCtl3D automatisch auf False gesetzt.

Hinweis

Damit Sie Optionsfeldern, Schaltfeldern und den anderen gängigen Steuerelementen unter Windows NT 3.51 mit Ctl3D ein dreidimensionales Aussehen verleihen können, muß die DLL CTL3D32.DLL im Verzeichnis SYSTEM32 installiert sein. Unter Windows 95 und NT 4.0 wird diese Bibliothek nicht benötigt.


TWinControl::DefWndProc

TWinControl	Siehe auch

Die Eigenschaft DefWndProc gibt die Standard-Fensterprozedur für ein Steuerelement an.

__property void * DefWndProc;

Beschreibung

Die Windows-API-Funktion CallWindowProc kann zusammen mit DefWndProc verwendet werden, um die Standardbehandlung für eine Fensterbotschaft aufzurufen. Wird DefWndProc anstelle von WndProc verwendet, kann die von der Methode WndProc durchgeführte Botschaftsbehandlung umgangen werden.

DefWndProc übernimmt für fensterorientierte Steuerelemente die Aufgaben, die von DefaultHandler für alle Objekte durchgeführt werden. DefaultHandler für TWinControl verwendet DefWndProc, um Botschaften zur Bearbeitung an Windows zu übergeben.

Bei fensterorientierten Steuerelementen wird DefWndProc anfangs auf die im Parameter Params der Methode CreateParams angegebene Fensterprozedur der Fensterklasse gesetzt. Durch Ändern von DefWndProc kann die Fensterklasse eines fensterorientierten Steuerelements unterklassifiziert werden.


TWinControl::Handle

TWinControl	Siehe auch	Beispiel

Die Eigenschaft Handle gibt das Fenster-Handle eines Steuerelements zurück.

__property HWND Handle;

Beschreibung

Mit Handle können Sie das Fenster-Handle eines Steuerelements abrufen. Das Handle wird als Parameter für bestimmte Windows-API-Funktionen benötigt.

Ist kein Fenster-Handle für das Steuerelement vorhanden, wird es automatisch durch einen Aufruf der Methode HandleNeeded erstellt, sobald die Eigenschaft Handle gelesen wird. Verwenden Sie daher auf keinen Fall Handle, während Komponenten erstellt oder aus einem Stream gelesen bzw. in diesen geschrieben werden.

Handle kann nur gelesen werden.


TWinControl::HelpContext

TWinControl	Siehe auch

Die Eigenschaft HelpContext ist eine Kontextnummer, die beim Aufrufen der kontextsensitiven Hilfe verwendet wird.

__property Classes::THelpContext HelpContext;

Beschreibung

Mit HelpContext können Sie festlegen, welcher Hilfebildschirm beim Drücken der Taste F1 angezeigt wird.

Sobald ein Steuerelement in der Anwendung markiert und die Taste F1 gedrückt wird, erscheint ein Hilfebildschirm. Welcher Bildschirm jeweils angezeigt wird, kann mit dem Wert der Eigenschaft HelpContext festgelegt werden. Jeder Bildschirm im Hilfesystem sollte eine eindeutige Kontextnummer haben.

Hat HelpContext den Wert Null, erbt das Steuerelement den Kontext des übergeordneten Fensters. Befindet sich beispielsweise ein Schalter, dessen Eigenschaft HelpContext den Wert Null hat, in einem Formular mit einem Hilfekontext ungleich null, wird beim Drücken von F1 der Hilfebildschirm des Formulars angezeigt.


TWinControl::ImeMode

TWinControl	See also

Die Eigenschaft ImeMode gibt den IME-Modus (IME = Input Method Editor) des Steuerelements an.

enum TImeMode { imDisable, imClose, imOpen, imDontCare, imSAlpha, imAlpha, imHira, imSKata, imKata, imChinese, imSHanguel, imHanguel };

__property TImeMode ImeMode;

Beschreibung

Der Input Method Editor (IME), der Bestandteil asiatischer Versionen von Microsoft Windows ist, unterstützt den Benutzer bei der Eingabe von Unicode- und Double-Byte-Zeichen.


TWinControl::ImeName

TWinControl	See also

Die Eigenschaft ImeName gibt den Namen des IME (Input Method Editor) des Steuerelements an.

__property System::AnsiString ImeName;

Beschreibung

Der Input Method Editor (IME), der Bestandteil asiatischer Versionen von Microsoft Windows ist, unterstützt den Benutzer bei der Eingabe von Unicode- und Double-Byte-Zeichen.


TWinControl::ParentCtl3D

TWinControl	Siehe auch	Beispiel

Die Eigenschaft ParentCtl3D bestimmt, wie ein Steuerelement ermittelt, ob es dreidimensional angezeigt wird.

__property bool ParentCtl3D;

Beschreibung

Mit ParentCtl3D können Sie sicherstellen, daß alle Komponenten in einem Formular ein einheitliches Erscheinungsbild haben. Sollen beispielsweise alle Steuerelemente dreidimensional angezeigt werden, setzen Sie die Eigenschaft Ctl3D des Formulars und die Eigenschaft ParentCtl3D der einzelnen Komponenten auf True. Diese Vorgehensweise hat nicht nur den Vorteil, daß alle Komponenten räumlich angezeigt werden. Sie können auch jederzeit wieder ein einheitliches zweidimensionales Aussehen festlegen, indem Sie die Eigenschaft Ctl3D des Formulars auf False setzen.

Hat ParentCtl3D den Wert True, verwendet die Komponente den Wert der Eigenschaft Ctl3D des übergeordneten Fensters. Ist ParentCtl3D auf False gesetzt, verwendet die Komponente ihren eigenen Ctl3D-Wert. Die Standardeinstellung ist True.

Soll das Aussehen eines bestimmten Steuerelements festgelegt werden, setzen Sie Ctl3D auf True (3D) oder False (2D). Dabei erhält die Eigenschaft ParentCtl3D automatisch den Wert False.


TWinControl::ParentWindow

TWinControl

Die Eigenschaft ParentWindow ist das Handle auf das übergeordnete Fenster.

__property HWND ParentWindow;


TWinControl::Showing

TWinControl	Siehe auch

Die Eigenschaft Showing gibt an, ob ein Steuerelement auf dem Bildschirm angezeigt wird.

__property bool Showing;

Beschreibung

Mit Showing können Sie zur Laufzeit feststellen, ob das Steuerelement auf dem Bildschirm angezeigt wird (vorausgesetzt, es wird nicht von einem anderen Fenster verdeckt).

Ist die Eigenschaft Visible eines Steuerelements und aller in der Hierarchie übergeordneten Komponenten auf True gesetzt, hat Showing den Wert True. Ist bei einem der übergeordneten Fenster Visible auf False gesetzt, hat auch Showing den Wert False.

Die Eigenschaft Showing kann nur gelesen werden.


TWinControl::TabOrder

TWinControl	Siehe auch	Beispiel

Die Eigenschaft TabOrder gibt die Position eines Steuerelements in der Tabulatorreihenfolge seines übergeordneten Fensters an.

__property TTabOrder TabOrder;

Beschreibung

Die Tabulatorreihenfolge ist die Reihenfolge, in der die untergeordneten Komponenten beim Drücken der Tabulatortaste den Fokus erhalten. Wenn ein Formular erstmalig geöffnet wird, hat das Steuerelement mit dem TabOrder-Wert 0 den Fokus.

Zunächst entspricht die Tabulatorreihenfolge der Reihenfolge, in der die Steuerelemente dem Formular hinzugefügt wurden. Das erste im Formular plazierte Steuerelement erhält den TabOrder-Wert 0, das zweite den Wert 1 usw. Soll diese Anordnung später geändert werden, verwenden Sie die Eigenschaft TabOrder. Hat ein Steuerelement den Wert -1, befindet es sich außerhalb der Tabulatorreihenfolge und kann mit der Tabulatortaste nicht erreicht werden.

Jedes in einer Komponente enthaltene Steuerelement hat eine eindeutige Position in der Tabulatorreihenfolge. Wenn dem TabOrder-Wert eines Steuerelements der Wert eines anderen Elements zugewiesen wird, werden die restlichen Komponenten automatisch neu durchnumeriert. Wird beispielsweise die Eigenschaft TabOrder des sechsten Steuerelements in 3 geändert (es wird dadurch zum vierten Element in der Tabulatorreihenfolge), wird das ursprünglich vierte Steuerelement zum fünften und das fünfte zum sechsten Element.

Wenn Sie TabOrder einen Wert zuweisen, der größer als die Anzahl der untergeordneten Steuerelemente ist, wird das Element an das Ende der Tabulatorreihenfolge verschoben. Der Wert der Eigenschaft wird dann automatisch so geändert, daß die Komponente die letzte in der Reihenfolge ist.

Hinweis

Der Wert von TabOrder ist nur von Bedeutung, wenn die Eigenschaft TabStop auf True gesetzt ist und das Steuerelement ein übergeordnetes Fenster hat. TabOrder wird für ein Formular nur verwendet, wenn dieses ein anderes Formular als übergeordnetes Fenster hat.


TWinControl::TabStop

TWinControl	Siehe auch	Beispiel

Die Eigenschaft TabStop bestimmt, ob der Benutzer mit der Tabulatortaste zu einem Steuerelement wechseln kann.

__property bool TabStop;

Beschreibung

Mit TabStop können Sie festlegen, ob mit der Tabulatortaste zu dem Steuerelement gewechselt werden kann.

Hat TabStop den Wert True, befindet sich das Steuerelement in der Tabulatorreihenfolge. Wird TabStop auf False gesetzt, ist das Element nicht in der Reihenfolge und kann mit der Tabulatortaste nicht erreicht werden.

Hinweis

TabStop ist für ein Formular nur von Bedeutung, wenn dieses ein anderes Formular als übergeordnetes Fenster hat.


TWinControl::WindowHandle

TWinControl	Siehe auch

Die Eigenschaft WindowHandle gibt das Fenster-Handle eines Steuerelements zurück.

__property HWND WindowHandle;

Beschreibung

Mit WindowHandle können Sie ebenso wie mit Handle auf das Fenster-Handle eines Steuerelements zugreifen. WindowHandle ist jedoch als protected deklariert. Daher kann nur im Code innerhalb des Steuerelements auf diese Eigenschaft zugegriffen werden.

Der Vorteil von WindowHandle besteht darin, daß diese Eigenschaft den Schreibzugriff gestattet, während Handle nur gelesen werden kann. WindowHandle kann in Methoden verwendet werden, in denen der Wert des Fenster-Handles eines Steuerelements geändert werden muß. Im Gegensatz zu Handle wird nicht automatisch ein gültiges Handle erstellt, wenn der Wert von WindowHandle gelesen wird. Beim Lesen von WindowHandle kann ein Nullwert zurückgegeben werden.


Ereignisse von TWinControl

TWinControl	Alphabetisch	Legende

In TWinControl

OnEnter

OnExit

OnKeyDown

OnKeyPress

OnKeyUp


Ereignisse von TWinControl

TWinControl	Nach Objekten	Legende

OnEnter

OnExit

OnKeyDown

OnKeyPress

OnKeyUp


TWinControl::OnEnter

TWinControl	Siehe auch	Beispiel

Das Ereignis OnEnter wird ausgelöst, sobald ein Steuerelement den Eingabefokus erhält.

typedef void __fastcall (__closure *TNotifyEvent)(System::TObject* Sender);

__property Classes::TNotifyEvent OnEnter;

Beschreibung

Mit einer Ereignisbehandlungsroutine für OnEnter können bestimmte Aktionen beim Aktivieren eines Steuerelements durchgeführt werden.

OnEnter wird nicht ausgelöst, wenn zwischen verschiedenen Formularen oder Windows-Anwendungen gewechselt wird.

Wird zwischen Steuerelementen in getrennten Container-Objekten (z.B. TPanel und TGroupBox) gewechselt, wird das Ereignis OnEnter des Containers vor dem des zugeordneten Steuerelements ausgelöst.

Entsprechend tritt das Ereignis OnExit des Containers erst nach dem Ereignis des untergeordneten Steuerelements auf, wenn der Fokus zu einer anderen Komponente außerhalb des Containers wechselt.

Angenommen, in einem Formular befindet sich der Schalter OK sowie ein Gruppenfeld mit drei Optionsfeldern. Der Schalter besitzt den aktuellen Eingabefokus. Sobald der Benutzer auf eines der Optionsfelder klickt, wird zuerst das Ereignis OnExit des Schalters, danach das Ereignis OnEnter des Gruppenfeldes und zum Schluß das Ereignis v des angeklickten Felds ausgelöst. Klickt der Benutzer anschließend auf OK, wird zuerst das Ereignis OnExit des Optionsfeldes, dann das Ereignis OnExit des Gruppenfeldes und zum Schluß das Ereignis OnEnter des Schalters ausgelöst.


TWinControl::OnExit

TWinControl	Siehe auch	Beispiel

Das Ereignis OnExit wird ausgelöst, sobald der Fokus von einem Steuerelement zu einem anderen wechselt.

typedef void __fastcall (__closure *TNotifyEvent)(System::TObject* Sender);

__property Classes::TNotifyEvent OnExit;

Beschreibung

Mit einer Ereignisbehandlungsroutine für OnExit können Sie Aktionen durchführen, sobald der Fokus zu einem anderen Steuerelement wechselt.

OnExit wird nicht beim Wechseln zwischen verschiedenen Formularen oder Windows-Anwendungen ausgelöst.

Wird zwischen Steuerelementen in getrennten Container-Objekten (z.B. TPanel und TGroupBox) gewechselt, wird das Ereignis OnExit des untergeordneten Steuerelements vor dem des Containers ausgelöst.

Entsprechend tritt das Ereignis OnEnter des Containers vor dem Ereignis des untergeordneten Steuerelements ein, wenn der Fokus zu einer anderen Komponente außerhalb des Containers wechselt.

Angenommen, in einem Formular befindet sich der Schalter OK sowie ein Gruppenfeld mit drei Optionsfeldern. Der Schalter besitzt den aktuellen Eingabefokus. Sobald der Benutzer eines der Optionsfelder anklickt, wird zuerst das Ereignis OnExit des Schalters, danach das Ereignis OnEnter des Gruppenfeldes und zum Schluß das Ereignis OnEnter des angeklickten Feldes ausgelöst. Klickt der Benutzer anschließend auf OK, wird zuerst das Ereignis OnExit des Optionsfeldes, dann das Ereignis OnExit des Gruppenfeldes und zum Schluß das Ereignis OnEnter des Schalters ausgelöst.

Hinweis

Der Wert der Eigenschaft ActiveControl wird aktualisiert, bevor das Ereignis OnExit eintritt.


TWinControl::OnKeyDown

TWinControl	Siehe auch

Das Ereignis OnKeyDown wird ausgelöst, sobald der Benutzer eine Taste drückt.

typedef Set<Classes_1, ssShift, ssDouble>  TShiftState;

typedef void __fastcall (__closure *TKeyEvent)(System::TObject* Sender, unsigned short &Key,  Classes::TShiftState Shift);

__property TKeyEvent OnKeyDown;

Beschreibung

Mit einer Ereignisbehandlungsroutine für OnKeyDown können beim Drükken einer Taste bestimmte Aktionen durchgeführt werden. In dieser Routine kann auf alle Tasten einschließlich Funktionstasten und Tastenkombinationen mit UMSCHALT-, ALT- und STRG-Taste sowie auf gedrückte Maustasten reagiert werden.

Der Typ TKeyEvent zeigt auf eine Methode, die Tastaturereignisse behandelt. Der Parameter Key gibt die gedrückte Taste an. Bei nicht alphanumerischen Tasten können Sie die gedrückte Taste mit den virtuellen Tastencodes der Windows-API feststellen. Weitere Informationen finden Sie in der Hilfedatei WIN32.HLP unter VkKeyScan und VkKeyScanEx.

Der Parameter Shift ist eine Menge mit den folgenden Konstanten:

Status	Bedeutung

ssShift	Die UMSCHALT-Taste ist gedrückt.

ssAlt	Die Taste ALT ist gedrückt.

ssCtrl	Die Taste STRG ist gedrückt.

ssLeft	Die linke Maustaste ist gedrückt.

ssMiddle	Die mittlere Maustaste ist gedrückt.

ssDouble	Die rechte und die linke Maustaste sind gedrückt.


TWinControl::OnKeyPress

TWinControl	Siehe auch	Beispiel

Das Ereignis OnKeyPress wird ausgelöst, sobald der Benutzer eine einzelne Zeichentaste drückt.

typedef void __fastcall (__closure *TKeyPressEvent)(System::TObject* Sender, char &Key);

__property TKeyPressEvent OnKeyPress;

Beschreibung

Mit einer Ereignisbehandlungsroutine für OnKeyPress können bestimmte Aktionen durchgeführt werden, wenn eine einzelne Zeichentaste gedrückt wird.

Da der Parameter Key den Datentyp Char hat, registriert das Ereignis OnKeyPress das ASCII-Zeichen der gedrückten Taste. Tasten, die keinem ASCII-Char-Wert entsprechen (z.B. UMSCHALT oder F1), generieren kein Ereignis OnKeyPress. Tastenkombinationen (z.B. UMSCHALT+A) führen nur zu einem Ereignis OnKeyPress (in diesem Beispiel ergibt UMSCHALT+A den Key-Wert "A", wenn die Feststelltaste deaktiviert ist). Soll auf Nicht-ASCII-Tasten oder Tastenkombinationen reagiert werden, verwenden Sie die Ereignisbehandlungsroutine für OnKeyDown oder OnKeyUp.


TWinControl::OnKeyUp

TWinControl	Siehe auch	Beispiel

Das Ereignis OnKeyUp wird ausgelöst, sobald der Benutzer eine gedrückte Taste losläßt.

typedef Set<Classes_1, ssShift, ssDouble>  TShiftState;

typedef void __fastcall (__closure *TKeyEvent)(System::TObject* Sender, unsigned short &Key,  Classes::TShiftState Shift);

__property TKeyEvent OnKeyUp;

Beschreibung

Mit einer Ereignisbehandlungsroutine für OnKeyUp können beim Loslassen einer Taste bestimmte Aktionen durchgeführt werden. In dieser Behandlungsroutine kann auf alle Tasten einschließlich Funktionstasten und Tastenkombinationen mit der UMSCHALT-, ALT- und STRG-Taste reagiert werden.

Der Typ TKeyEvent zeigt auf eine Methode, die Tastaturereignisse behandelt. Der Parameter Key gibt die losgelassene Taste an. Bei nicht alphanumerischen Tasten können Sie die gedrückte Taste mit den virtuellen Tastencodes der Windows-API feststellen. Weitere Informationen finden Sie in der Hilfedatei WIN32.HLP (Win32 Developer's Reference) unter VkKeyScan und VkKeyScanEx.

Der Parameter Shift ist eine Menge mit den folgenden Konstanten:

Status	Bedeutung

ssShift	Die UMSCHALT-Taste ist gedrückt.

ssAlt	Die Taste ALT ist gedrückt.

ssCtrl	Die Taste STRG ist gedrückt.

ssLeft	Die linke Maustaste ist gedrückt.

ssMiddle	Die mittlere Maustaste ist gedrückt.

ssDouble	Die rechte und die linke Maustaste sind gedrückt.


Methoden von TWinControl

TWinControl	Alphabetisch	Legende

In TWinControl

~TWinControl

AlignControls

Broadcast

CanFocus

ChangeScale

ContainsControl

ControlAtPos

CreateHandle

CreateParams

CreateSubClass

CreateWindowHandle

CreateWnd

DefaultHandler

DestroyHandle

DestroyWindowHandle

DestroyWnd

DisableAlign

DoEnter

DoExit

DoKeyDown

DoKeyPress

DoKeyUp

EnableAlign

FindNextControl

FixupTabList

Focused

GetChildren

GetClientOrigin

GetClientRect

GetDeviceContext

GetTabOrderList

HandleAllocated

HandleNeeded

InsertControl

Invalidate

IsControlMouseMsg

KeyDown

KeyPress

KeyUp

MainWndProc

NotifyControls

PaintControls

PaintHandler

PaintTo

PaintWindow

PaletteChanged

ReadState

Realign

RecreateWnd

RemoveControl

Repaint

ScaleBy

ScaleControls

ScrollBy

SelectFirst

SelectNext

SetBounds

SetChildOrder

SetFocus

SetZOrder

ShowControl

TWinControl

Update

UpdateControlState

WndProc

Abgeleitet von TControl

BeginDrag

BringToFront

ClientToScreen

DragDrop

Dragging

EndDrag

GetTextBuf

GetTextLen

Hide

Perform

Refresh

ScreenToClient

SendToBack

SetTextBuf

Show

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TPersistent

Assign

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TWinControl

TWinControl	Nach Objekten	Legende

~TWinControl

AlignControls

Assign

BeginDrag

BringToFront

Broadcast

CanFocus

ChangeScale

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

ClientToScreen

ContainsControl

ControlAtPos

CreateHandle

CreateParams

CreateSubClass

CreateWindowHandle

CreateWnd

DefaultHandler

DestroyComponents

DestroyHandle

Destroying

DestroyWindowHandle

DestroyWnd

DisableAlign

Dispatch

DoEnter

DoExit

DoKeyDown

DoKeyPress

DoKeyUp

DragDrop

Dragging

EnableAlign

EndDrag

FieldAddress

FindComponent

FindNextControl

FixupTabList

Focused

FreeInstance

FreeNotification

Free

GetChildren

GetClientOrigin

GetClientRect

GetDeviceContext

GetParentComponent

GetTabOrderList

GetTextBuf

GetTextLen

HandleAllocated

HandleNeeded

HasParent

Hide

InheritsFrom

InitInstance

InsertComponent

InsertControl

InstanceSize

Invalidate

IsControlMouseMsg

KeyDown

KeyPress

KeyUp

MainWndProc

MethodAddress

MethodName

NewInstance

NotifyControls

PaintControls

PaintHandler

PaintTo

PaintWindow

PaletteChanged

Perform

ReadState

Realign

RecreateWnd

Refresh

RemoveComponent

RemoveControl

Repaint

ScaleBy

ScaleControls

ScreenToClient

ScrollBy

SelectFirst

SelectNext

SendToBack

SetBounds

SetChildOrder

SetFocus

SetTextBuf

SetZOrder

ShowControl

Show

TWinControl

UpdateControlState

Update

WndProc


TWinControl::~TWinControl

TWinControl	Siehe auch

Der Destruktor ~TWinControl gibt den Speicher frei, der für das TWinControl-Objekt reserviert war. Rufen Sie ~TWinControl nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TWinControl automatisch aufgerufen wird.

__fastcall virtual ~TWinControl(void);


TWinControl::AlignControls

TWinControl	Siehe auch

Die Methode AlignControls richtet die untergeordneten Komponenten eines Steuerelements innerhalb eines bestimmten Bereichs aus.

virtual void __fastcall AlignControls(TControl* AControl, Windows::TRect &Rect);

Beschreibung

Mit AlignControls können alle in einem fensterorientierten Steuerelement (Formular, Beschriftung, Gruppenfeld usw.) enthaltenen Komponenten innerhalb des mit Rect angegebenen Rechtecks ausgerichtet werden.

Jede untergeordnete Komponente wird entsprechend dem Wert der Eigenschaft Align angeordnet. Der Parameter AControl kann auch den Wert NULL annehmen. Wird mit AControl ein Steuerelement angegeben, hat dieses bei der Ausrichtung Vorrang vor anderen ähnlich angeordneten Komponenten.


TWinControl::Broadcast

TWinControl	Siehe auch

Die Methode Broadcast sendet an jede untergeordnete Komponente eines Steuerelements eine Botschaft.

void __fastcall Broadcast(void *Message);

Beschreibung

Mit Broadcast kann die im Parameter Message angegebene Botschaft an jede in einem fensterorientierten Steuerelement enthaltene Komponente gesendet werden.


TWinControl::CanFocus

TWinControl	Siehe auch	Beispiel

Die Methode CanFocus prüft, ob ein Steuerelement den Fokus erhalten kann.

bool __fastcall CanFocus(void);

Beschreibung

Mit CanFocus können Sie feststellen, ob das Steuerelement Benutzereingaben entgegennehmen kann.

CanFocus gibt True zurück, wenn die Eigenschaften Visible und Enabled des Steuerelements und des übergeordneten Fensters auf True gesetzt sind. Hat eine dieser Eigenschaften (des Steuerelements oder der übergeordneten Komponente) nicht den Wert True, gibt die Methode False zurück. In abgeleiteten Objekten kann CanFocus überschrieben werden, um die Bedingungen festzulegen, unter denen das Steuerelement den Fokus erhalten kann.


TWinControl::ChangeScale

TWinControl	Siehe auch

Die Methode ChangeScale ändert Größe und Position eines Steuerelements und seiner untergeordneten Komponenten.

virtual void __fastcall ChangeScale(int Z, int N);

Beschreibung

Mit ChangeScale können Sie ein Formular und die in ihm enthaltenen Steuerelemente entsprechend verschiedener Bildschirmauflösungen skalieren. Dabei werden die Eigenschaften Top, Left, Width und Height des Steuerelements geändert und sowohl die Position als auch die Größe des Fensters und seiner untergeordneten Komponenten angepaßt.

Die Skalierung wird im Parameterverhältnis Z/N (Zähler/Nenner) durchgeführt. Sollen beispielsweise ein Steuerelement und seine untergeordneten Komponenten auf 75 % der ursprünglichen Größe verkleinert werden, geben Sie für den Parameter Z den Wert 75 und für N den Wert 100 an (75/100). Alternativ dazu kann auch für Z der Wert 3 und für N der Wert 4 verwendet werden (3/4). Beide Angaben sind identisch und führen zu einer Verkleinerung um 75 %.

Soll eine Vergrößerung um 33 % erreicht werden, geben Sie für Z den Wert 133 und für N den Wert 100 (133/100) oder wie oben beschrieben die Werte 4 und 3 an (4/3).

Hinweis

Die Größen- und Positionsangaben eines Steuerelements sind Integer-Werte. Daher führt eine Skalierung im Verhältnis Z/N zu Rundungsfehlern. Wird ChangeScale wiederholt aufgerufen, kann es passieren, daß das Steuerelement verschwindet (wenn es durch die Rundungsfehler kleiner wird) oder sich nicht mehr innerhalb des Formulars befindet (wenn seine Position durch die Rundungsfehler verändert wird). Wenn Sie ein Formular mehrmals skalieren, sollten Sie es daher nach einer bestimmten Anzahl Skalierungen freigeben und erneut laden, damit sich die Rundungsfehler nicht summieren.


TWinControl::ContainsControl

TWinControl	Siehe auch

Die Methode ContainsControl gibt an, ob eine bestimmte Komponente in einem Steuerelement enthalten ist.

bool __fastcall ContainsControl(TControl* Control);

Beschreibung

Mit ContainsControl können Sie feststellen, ob eine bestimmte Komponente innerhalb des Steuerelements vorhanden ist. Enthält das fensterorientierte Steuerelement die in Control angegebene Komponente, gibt ContainsControl den Wert True zurück. Der Parameter Control muß kein direkt untergeordnetes Steuerelement (d.h. im Array Controls enthalten) sein, es kann auch beliebig tief in der Hierarchie der untergeordneten Steuerelemente verborgen sein.

Wird der Wert False zurückgegeben, befindet sich die angegebene Komponente nicht innerhalb des Steuerelements.


TWinControl::ControlAtPos

TWinControl	Siehe auch

Die Methode ControlAtPos gibt die untergeordnete Komponente zurück, die sich an einer bestimmten Position innerhalb des Steuerelements befindet.

TControl* __fastcall ControlAtPos(const POINT &Pos, bool AllowDisabled);

Beschreibung

Mit ControlAtPos kann festgestellt werden, welche Komponente sich innerhalb des Steuerelements an der mit Pos angegebenen Position befindet. Die Methode gibt eine direkt untergeordnete Komponente zurück, d.h. ein Element der Eigenschaft Controls, bei dem in der Eigenschaft Parent das fensterorientierte Steuerelement als Wert angegeben ist.

Mit dem Parameter Pos wird die gewünschte Position in Client-Koordinaten angegeben. Dieser Wert kann kann ein beliebiger Bereich des untergeordneten Steuerelements sein, nicht nur die obere linke Ecke.

Befindet sich an der angegebenen Position kein Steuerelement, gibt ControlAtPos den Wert NULL zurück. Mit dem Parameter AllowDisabled kann festgelegt werden, ob auch deaktivierte Steuerelemente berücksichtigt werden.


TWinControl::CreateHandle

TWinControl	Siehe auch

Die Methode CreateHandle erzeugt für die Eigenschaft Handle eines Steuerelements ein Handle, falls noch keines vorhanden ist.

virtual void __fastcall CreateHandle(void);

Beschreibung

CreateHandle ruft die Methode CreateWnd auf, um das Fenster-Handle zu erzeugen, wenn das Steuerelement ein übergeordnetes Fenster hat. CreateHandle erzeugt erst ein Handle in der übergeordneten Komponente, bevor das Handle für das Steuerelement selbst erzeugt wird.


TWinControl::CreateParams

TWinControl	Siehe auch

Die Methode CreateParams initialiert den mit Params angegebenen Parameter-Record, der zum Erzeugen eines Steuerelements benötigt wird.

virtual void __fastcall CreateParams(TCreateParams &Params);

Beschreibung

CreateParams wird von der Methode CreateWnd aufgerufen, um die Parameter zu initialisieren, die an CreateWindowHandle übergeben werden. Durch Überschreiben von CreateParams können Sie festlegen, wie sich eine Komponente Windows gegenüber darstellt. Rufen Sie immer zuerst die geerbte Methode auf, um die Standardwerte zu initialisieren, bevor sie die gewünschten Änderungen vornehmen.

Der Parameter-Record wird in Params übergegeben. Der Typ TCreateParams ist eine Datenstruktur mit Informationen, die von Windows für das Erzeugen eines Fenster-Handles benötigt werden. Die Felder des Records TCreateParams werden anschließend als Parameter an die API-Funktion CreateWindowEx übergeben.

TWinControl implementiert CreateParams, indem alle Felder von Params auf generische Grundwerte gesetzt werden. Einige Standard-Steuerelemente überschreiben CreateParams, um einen oder mehrere Standardwerte in Params zu ändern.


TWinControl::CreateSubClass

TWinControl	Siehe auch

Die Methode CreateSubClass erzeugt ein Borland C++Builder-Steuerelement, das von einer vorhandenen Windows-Fensterklasse abgeleitet ist.

void __fastcall CreateSubClass(TCreateParams &Params, char * ControlClassName);

Beschreibung

Mit CreateSubClass können Sie einen TCreateParams-Record erzeugen, der anschließend als Parameter an die API-Funktion CreateWindowEx übergeben wird. Der Typ TCreateParams ist eine Datenstruktur mit Informationen, die von Windows für das Erzeugen eines Fenster-Handles benötigt werden.

Rufen Sie in der Methode CreateParams eines abgeleiteten Steuerelements zuerst die geerbte Methode und danach CreateSubClass auf. Übergeben Sie dabei in Params den gewünschten Parameter-Record. CreateSubClass ermöglicht VCL-Steuerelementen das Erzeugen von Windows-Standardkomponenten.


TWinControl::CreateWindowHandle

TWinControl	Siehe auch

Die Methode CreateWindowHandle erzeugt ein Fenster-Handle für ein Steuerelement.

virtual void __fastcall CreateWindowHandle(const TCreateParams &Params);

Beschreibung

Mit CreateWindowHandle können Sie für das Steuerelement ein Fenster-Handle erzeugen. Dazu wird die API-Funktion CreateWindowEx mit dem in Params angegebenen Parameter-Record aufgerufen.

Der Typ TCreateParams ist eine Datenstruktur mit Informationen, die von Windows für das Erzeugen eines Fenster-Handles benötigt werden.


TWinControl::CreateWnd

TWinControl	Siehe auch

Die Methode CreateWnd erzeugt eine dem Steuerelement entsprechende Windows-Komponente.

virtual void __fastcall CreateWnd(void);

Beschreibung

CreateWnd ruft zuerst die Methode CreateParams auf, um die Parameter für die Fenstererzeugung zu initialisieren, und anschließend CreateWindowHandle, um ein Fenster-Handle für das Steuerelement zu erzeugen. Danach wird die Größe des neuen Steuerelements angepaßt und die Schrift festgelegt, indem die Methode Perform mit der Botschaft WM_SETFONT aufgerufen wird.


TWinControl::DefaultHandler

TWinControl	Siehe auch

Die Methode DefaultHandler stellt eine Standardverarbeitung für alle Botschaften bereit, die von einem Steuerelement nicht selbst bearbeitet werden.

virtual void __fastcall DefaultHandler(void *Message);

Beschreibung

Überschreiben Sie DefaultHandler, wenn Sie die Standard-Botschaftsverarbeitung für das Steuerelement ändern wollen.

Durch den Aufruf von Inherited in einer Botschaftsverarbeitungsmethode wird die Methode DefaultHandler des Vorfahrs aufgerufen, sofern in diesem keine Behandlungsroutine für die Botschaft festgelegt ist.

TWinControl überschreibt TControl::DefaultHandler, um Botschaften für alle abgeleiteten Typen zu verarbeiten. DefaultHandler übergibt alle nicht anderweitig bearbeiteten Botschaften durch einen Aufruf der API-Funktion CallWindowProc an die Fensterprozedur des Steuerelements.


TWinControl::DestroyHandle

TWinControl	Siehe auch

Die Methode DestroyHandle gibt das Fenster-Handle eines Steuerelements frei.

void __fastcall DestroyHandle(void);

Beschreibung

Mit DestroyHandle können Sie das Handle eines Steuerelements freigeben, ohne die Komponente selbst zu entfernen. Das Handle kann später jederzeit neu erzeugt werden. DestroyHandle ist das Gegenstück zu CreateHandle. Verwenden Sie nach Möglichkeit die High-Level-Methoden CreateHandle und DestroyHandle und nicht die Low-Level-Methoden CreateWnd und DestroyWnd.

Enthält die Komponente untergeordnete fensterorientierte Steuerelemente, ruft DestroyHandle zuerst deren Methode DestroyHandle auf, bevor mit DestroyWnd das eigene Handle freigegeben wird.


TWinControl::DestroyWindowHandle

TWinControl	Siehe auch

Die Methode DestroyWindowHandle ruft die Windows-API-Funktion DestroyWindow auf, um ein zuvor in der Methode CreateWindowHandle erzeugtes Fenster-Handle freizugeben.

virtual void __fastcall DestroyWindowHandle(void);

Beschreibung

Mit DestroyWindowHandle können Sie das Fenster-Handle des Steuerelements freigeben.

Die Methode TWinControl ruft DestroyWindowHandle auf, um vor dem Entfernen des Steuerelements alle zugeordneten Fenster-Handles freizugeben. DestroyWindowHandle wird auch von der Methode DestroyWnd aufgerufen.


TWinControl::DestroyWnd

TWinControl	Siehe auch

Die Methode DestroyWnd gibt das Fenster-Handle eines Steuerelements frei.

virtual void __fastcall DestroyWnd(void);

Beschreibung

Vor dem Freigeben des Fenster-Handles speichert DestroyWnd intern eine Kopie des im Steuerelement enthaltenen Textes, gibt alle Gerätekontexte frei und ruft zum Schluß DestroyWindowHandle auf.


TWinControl::DisableAlign

TWinControl	Siehe auch

Die Methode DisableAlign deaktiviert vorübergehend das erneute Ausrichten der Komponenten in einem Steuerelement.

void __fastcall DisableAlign(void);

Beschreibung

Mit DisableAlign können Sie verhindern, daß die untergeordneten Steuerelemente erneut ausgerichtet werden. Diese Operation ist ratsam, wenn mehrere Bearbeitungsschritte mit einem Steuerelement durchgeführt werden müssen (z.B. Lesen aus einer Formulardatei oder Skalieren). Für jeden Aufruf von DisableAlign muß ein entsprechender Aufruf der Methode EnableAlign durchgeführt werden.

DisableAlign erhöht einen Referenzzähler, der später von EnableAlign wieder dekrementiert wird. Erreicht der Zähler den Wert 0, werden von EnableAlign die erforderlichen Ausrichtungen vorgenommen.


TWinControl::DoEnter

TWinControl	Siehe auch

Die Methode DoEnter ist eine geschützte Methode, die das OnEnter-Ereignis eines Steuerelements implementiert.

virtual void __fastcall DoEnter(void);

Beschreibung

DoEnter ruft lediglich die mit dem Ereignis OnEnter verbundene Ereignisbehandlungsroutine auf. Sollen zusätzlich zum geerbten Aufruf weitere Aktionen durchgeführt werden, überschreiben Sie DoEnter.


TWinControl::DoExit

TWinControl	Siehe auch

Die Methode DoExit ist eine geschützte Methode, die das Ereignis OnExit eines Steuerelements implementiert.

virtual void __fastcall DoExit(void);

Beschreibung

Die Methode DoExit ruft lediglich die mit dem Ereignis OnExit verbundene Ereignisbehandlungsroutine auf. Sollen zusätzlich zum Aufruf der geerbten Behandlungsroutine weitere Aktionen durchgeführt werden, überschreiben Sie DoExit.


TWinControl::DoKeyDown

TWinControl	Siehe auch

Die Methode DoKeyDown ist eine als protected deklarierte Methode, die vor dem Aufruf von KeyDown (implementiert das Ereignis OnKeyDown) bestimmte Vorverarbeitungen durchführt.

bool __fastcall DoKeyDown(Messages::TWMKey &Message);

Beschreibung

Mit DoKeyDown können Sie bestimmen, ob die Anwendung weiterhin die im Parameter Message übergebene Botschaft „Taste gedrückt“ verarbeitet. Der Rückgabewert True gibt an, daß die Botschaft vollständig behandelt wurde und keine weitere Verarbeitung nötig ist. Wird False zurückgegeben, gibt die Anwendung die Botschaft durch die geerbten Verarbeitungsroutinen weiter.

DoKeyDown ermöglicht übergeordneten Formularen, deren Eigenschaft KeyPreview auf True gesetzt ist, die Botschaft präemptiv zu bearbeiten. Behandelt das Formular die Botschaft nicht, wandelt DoKeyDown die Botschaftsparameter in entsprechende Typen um und ruft die Methode KeyDown auf, die ihrerseits die Ereignisbehandlungsroutine für OnKeyDown aufruft (falls vorhanden).

Der Typ TWMKey wird für alle Windows-Tastaturbotschaften verwendet.


TWinControl::DoKeyPress

TWinControl	Siehe auch

Die Methode DoKeyPress ist eine als protected deklarierte Methode, die vor dem Aufruf von KeyPress (implementiert das Ereignis OnKeyPress) bestimmte Vorverarbeitungen durchführt.

bool __fastcall DoKeyPress(Messages::TWMKey &Message);

Beschreibung

Mit DoKeyPress können Sie bestimmen, ob die Anwendung weiterhin die im Parameter Message übergebene Tastendruckbotschaft verarbeitet. Der Rückgabewert True gibt an, daß die Botschaft vollständig behandelt wurde und keine weitere Verarbeitung nötig ist. Bei False wird die Botschaft an die geerbten Verarbeitungsroutinen weitergegeben.

DoKeyPress ermöglicht übergeordneten Formularen, deren Eigenschaft KeyPreview auf True gesetzt ist, die Botschaft präemptiv zu bearbeiten. Behandelt das Formular die Botschaft nicht, wandelt DoKeyDown die Botschaftsparameter in entsprechende Typen um und ruft die Methode KeyPress auf, die ihrerseits die Ereignisbehandlungsroutine für OnKeyPress aufruft (falls vorhanden).

Der Typ TWMKey wird für alle Windows-Tastaturbotschaften verwendet.


TWinControl::DoKeyUp

TWinControl	Siehe auch

Die Methode DoKeyUp ist eine als protected deklarierte Methode, die vor dem Aufruf von KeyUp (implementiert das Ereignis OnKeyUp) bestimmte Vorverarbeitungen durchführt.

bool __fastcall DoKeyUp(Messages::TWMKey &Message);

Beschreibung

Mit DoKeyUp können Sie bestimmen, ob die Anwendung weiterhin die im Parameter Message übergebene Botschaft „Taste losgelassen“ verarbeitet. Der Rückgabewert True gibt an, daß die Botschaft vollständig behandelt wurde und keine weitere Verarbeitung nötig ist. Bei False wird die Botschaft an die geerbten Verarbeitungsroutinen weitergegeben.

DoKeyUp ermöglicht übergeordneten Formularen, deren Eigenschaft KeyPreview auf True gesetzt ist, die Botschaft präemptiv zu bearbeiten. Behandelt das Formular die Botschaft nicht, wandelt DoKeyUp die Botschaftsparameter in entsprechende Typen um und ruft die Methode KeyUp auf, die ihrerseits die Ereignisbehandlungsroutine für OnKeyUp aufruft (falls vorhanden).

Der Typ TWMKey wird für alle Windows-Tastaturbotschaften verwendet.


TWinControl::EnableAlign

TWinControl	Siehe auch

Die Methode EnableAlign dekrementiert den zuvor von DisableAlign erhöhten Referenzzähler und richtet gegebenenfalls die untergeordneten Komponenten eines Steuerelements neu aus.

void __fastcall EnableAlign(void);

Beschreibung

Mit EnableAlign können die untergeordneten Komponenten eines Steuerelements neu ausgerichtet werden.

Durch jeden Aufruf der Methode DisableAlign wird ein Referenzzähler erhöht, den EnableAlign wieder dekrementiert. Erreicht der Zähler den Wert 0, ruft EnableAlign die Methode Realign auf, um die anstehende Ausrichtung durchzuführen.

Vergewissern Sie sich, daß Sie für jeden Aufruf von DisableAlign auch die Methode EnableAlign aufrufen.


TWinControl::FindNextControl

TWinControl	Siehe auch

Die Methode FindNextControl gibt die nächste untergeordnete Komponente in der Tabulatorreihenfolge eines Steuerelements zurück.

TWinControl* __fastcall FindNextControl(TWinControl* CurControl, bool GoForward, bool CheckTabStop,  bool CheckParent);

Beschreibung

Mit FindNextControl können Sie das in der Tabulatorreihenfolge auf CurControl folgende untergeordnete Steuerelement ermitteln. Ist CurControl keine untergeordnete Komponente des fensterorientierten Steuerelements, wird das erste Element in der Tabulatorreihenfolge zurückgegeben.

Mit dem Parameter GoForward kann die Suchrichtung festgelegt werden. Hat GoForward den Wert True, werden die Komponenten vorwärts durchlaufen, andernfalls rückwärts.

Die Parameter CheckTabStop und CheckParent geben an, ob mit den gefundenen Komponenten bestimmte Prüfungen durchgeführt werden. Ist CheckTabStop True, muß die Eigenschaft TabStop der zurückgelieferten Komponente True sein. Ist CheckParent True, muß die Eigenschaft Parent der zurückgelieferten Komponente das fensterorientierte Steuerelement enthalten.

FindNextControl ruft die Methode GetTabOrderList auf, die eine Liste der möglichen „nächsten“ Komponenten erzeugt.


TWinControl::FixupTabList

TWinControl	Siehe auch

Die Methode FixupTabList sortiert die untergeordneten Komponenten eines Steuerelements nach ihrer Tabulatorreihenfolge.

void __fastcall FixupTabList(void);

Beschreibung

Diese Methode sollte nicht direkt in einer Anwendung aufgerufen werden. Borland C++Builder verwendet FixupTabList in der Implementierung der Methode ReadState, die die Liste der Tabulatorreihenfolge anhand der Eigenschaft TabOrder der aus dem Stream gelesenen untergeordneten Komponenten initialisiert.


TWinControl::Focused

TWinControl	Siehe auch

Die Methode Focused prüft, ob ein Steuerelement den Eingabefokus hat.

bool __fastcall Focused(void);

Beschreibung

Mit Focused können Sie feststellen, ob das Steuerelement aktiv ist. Gibt Focused den Wert True zurück, hat das Steuerelement den Eingabefokus. Wird False zurückgegeben, ist das Steuerelement nicht aktiv.


TWinControl::GetChildren

TWinControl	Siehe auch

Die Methode GetChildren ruft für jede untergeordnete Komponente eines Steuerelements eine bestimmte Methode auf.

virtual void __fastcall GetChildren(Classes::TGetChildProc Proc);

Beschreibung

GetChildren wird vom Streaming-System der Komponentenbibliothek aufgerufen und wird in einer Anwendung kaum direkte Verwendung finden. In manchen spezialisierten Komponentenklassen kann GetChildren überschrieben werden, um festzulegen, welche untergeordneten Steuerelemente in den Stream geschrieben werden sollen.

Der Parameter TGetChildProc ist ein Methodenzeiger.


TWinControl::GetClientOrigin

TWinControl	Siehe auch

Die Methode GetClientOrigin ist eine als protected deklarierte Zugriffsmethode für die Eigenschaft ClientOrigin.

virtual POINT __fastcall GetClientOrigin(void);

Beschreibung

Mit GetClientOrigin können Sie den Ursprung des Client-Bereichs eines Steuerelements ermitteln.

GetClientOrigin gibt einen Punkt zurück, der die Position der oberen linken Ecke des Steuerelements in Bildschirmkoordinaten enthält. GetClientOrigin ruft die Windows-API-Funktion ClientToScreen auf, um diese Informationen abzurufen.


TWinControl::GetClientRect

TWinControl	Siehe auch

Die Methode GetClientRect ist eine als protected deklarierte Zugriffsmethode für die Eigenschaft ClientRect.

virtual Windows::TRect __fastcall GetClientRect(void);

Beschreibung

GetClientRect gibt ein Rechteck zurück, das den Client-Bereich des Steuerelements definiert. Die Felder Top und Left sind auf 0, die Felder Bottom und Right auf ClientHeight bzw. ClientWidth des Steuerelements gesetzt. Die Methode GetClientRect ruft die Windows-API-Funktion GetClientRect auf.


TWinControl::GetDeviceContext

TWinControl	Siehe auch

Die Methode GetDeviceContext gibt einen Gerätekontext für ein Steuerelement zurück.

virtual HDC __fastcall GetDeviceContext(HWND &WindowHandle);

Beschreibung

Mit GetDeviceContext erhalten Sie einen Gerätekontext für das Steuerelement.

GetDeviceContext ruft die Windows-API-Funktion GetDC auf, übergibt dabei die Eigenschaft Handle des Steuerelements und setzt die Eigenschaft WindowHandle auf Handle. Schlägt der Aufruf fehl, wird eine EOutOfResources-Exception ausgelöst.


TWinControl::GetTabOrderList

TWinControl	Siehe auch

Die Methode GetTabOrderList erzeugt eine Liste mit den Steuerelementen in der Tabulatorreihenfolge.

virtual void __fastcall GetTabOrderList(Classes::TList* List);

Beschreibung

Mit GetTabOrder kann eine Liste mit den Steuerelementen in der Tabulatorreihenfolge erzeugt werden.

GetTabOrder durchläuft die interne Liste der Tabulatorreihenfolge und fügt jede Komponente (einschließlich untergeordneter Komponenten) zu der im Parameter List übergegebenen Liste hinzu. Dadurch wird eine Liste mit allen Steuerelementen und ihren zugeordneten Elementen in Tabulatorreihenfolge erzeugt.

Die Methode FindNextControl ruft GetTabOrderList auf, um eine vollständige Liste der Steuerelemente zu erzeugen. Anhand dieser Liste lokalisiert FindNextControl das nächste Steuerelement in der Tabulatorreihenfolge.


TWinControl::HandleAllocated

TWinControl	Siehe auch 	Beispiel

Die Methode HandleAllocated prüft, ob ein Fenster-Handle für das Steuerelement vorhanden ist.

bool __fastcall HandleAllocated(void);

Beschreibung

Mit HandleAllocated können Sie feststellen, ob ein Fenster-Handle für das Steuerelement vorhanden ist.

Im Erfolgsfall gibt HandleAllocated True zurück. Ist kein Handle vorhanden, wird False zurückgegeben. Wenn Sie die Eigenschaft Handle direkt abfragen, wird ein Handle erzeugt, wenn es noch nicht existiert. Durch einen Aufruf der Methode HandleAllocated können Sie prüfen, ob ein Handle vorhanden ist, ohne daß als Nebeneffekt automatisch ein Handle erzeugt wird.


TWinControl::HandleNeeded

TWinControl	Siehe auch 	Beispiel

Die Methode HandleNeeded erzeugt für das Steuerelement ein Fenster-Handle, falls noch keines existiert.

void __fastcall HandleNeeded(void);

Beschreibung

Mit HandleNeeded können Sie ein Fenster-Handle für das Steuerelement erzeugen.

Ist kein Handle vorhanden, ruft HandleNeeded zuerst die Methode HandleNeeded des übergeordneten Fensters auf und erzeugt anschließend ein Fenster-Handle für das Steuerelement.


TWinControl::InsertControl

TWinControl	Siehe auch	Beispiel

Die Methode InsertControl fügt eine Komponente in das Array der Eigenschaft Controls des Steuerelements ein.

void __fastcall InsertControl(TControl* AControl);

Beschreibung

Steuerelemente werden automatisch in das Array Controls aufgenommen bzw. aus ihm entfernt, wenn sie zur Entwurfszeit hinzugefügt oder gelöscht werden. Mit der Methode InsertControl kann dieser Eigenschaft zur Laufzeit eine Komponente hinzugefügt werden.

InsertControl macht das eingefügte Steuerelement zum untergeordneten und den Container zum übergeordneten Objekt. Übergeben Sie das gewünschte Steuerelement im Parameter AControl. Ist die untergeordnete Komponente bereits in einem anderen fensterorientierten Steuerelement enthalten, setzen Sie statt dessen ihre Eigenschaft Parent. Dadurch erreichen Sie, daß die untergeordnete Komponente aus dem Array der Eigenschaft Controls des ursprünglichen Containers entfernt wird.


TWinControl::Invalidate

TWinControl	Siehe auch	Beispiel

Die Methode Invalidate zeichnet ein Steuerelement neu, nachdem andere wichtige Windows-Botschaften verarbeitet wurden.

virtual void __fastcall Invalidate(void);

Beschreibung

Mit Invalidate kann das gesamte Steuerelement neu gezeichnet werden. Wenn mehrere Bereiche des Steuerelements aktualisiert werden müssen, wird das gesamte Fenster neu gezeichnet, um Bildschirmflackern zu vermeiden. Es wirkt sich nicht negativ auf die Geschwindigkeit der Anwendung aus, wenn Invalidate vor dem eigentlichen Aktualisieren des Steuerelements mehrmals aufgerufen wird.

Invalidate ruft die Windows-API-Funktion InvalidateRect auf.


TWinControl::IsControlMouseMsg

TWinControl	Siehe auch

Die Methode IsControlMouseMsg prüft, ob eine bestimmte Mausbotschaft für eine untergeordnete Komponente des Steuerelements bestimmt ist.

bool __fastcall IsControlMouseMsg(Messages::TWMMouse &Message);

Beschreibung

Mit IsControlMouseMsg können Sie feststellen, ob die in Message angegebene Mausbotschaft an eine untergeordnete Komponente des Steuerelements gerichtet ist. In diesem Fall gibt die Methode True zurück.

Windows sorgt dafür, daß die Botschaften zu den betreffenden untergeordneten fensterorientierten Steuerelementen gelangen. Bei anderen Steuerelementen werden die Botschaften jedoch an das übergeordnete Fenster gesendet. Dieses entscheidet darüber, welches seiner untergeordneten Steuerelemente die Botschaft empfangen soll.

Die Methode WndProc eines fensterorientierten Steuerelements ruft IsControlMouseMsg auf, um alle entgegengenommenen Mausbotschaften zu verarbeiten.


TWinControl::KeyDown

TWinControl	Siehe auch

Die Methode KeyDown ist eine als protected deklarierte Methode, die das Ereignis OnKeyDown eines Steuerelements implementiert.

virtual void __fastcall KeyDown(unsigned short &Key,  Classes::TShiftState Shift);

Beschreibung

Die von TWinControl geerbte Methode KeyDown ruft lediglich die mit dem Ereignis OnKeyDown verbundene Behandlungsroutine  auf. Sollen zusätzlich zu diesem Aufruf weitere Aktionen durchgeführt werden, überschreiben Sie KeyDown.

Der Parameter Key gibt die Taste an. Bei nicht alphanumerischen Tasten können Sie die gedrückte Taste mit den virtuellen Tastencodes der Windows-API feststellen. Weitere Informationen finden Sie in der Hilfedatei WIN32.HLP (Win32 Developer's Reference) unter VkKeyScan und VkKeyScanEx.

Ein fensterorientiertes Steuerelement ruft KeyDown als Reaktion auf die Windows-Botschaft WM_KEYDOWN („Taste gedrückt“) auf. Der eigentliche Ablauf sieht so aus, daß die Botschaft zunächst an eine als private deklarierte Bearbeitungsroutine weitergegeben wird, die dann DoKeyDown aufruft. Stellt DoKeyDown fest, daß das Steuerelement das Zeichen bearbeiten soll, konvertiert sie die Botschaftsparameter und übergibt KeyDown den Tastencode und den Sondertastenstatus in den Parametern Key und Shift.

Die weitere Verarbeitung einer Taste kann verhindert werden, indem in der Methode KeyDown oder in der Ereignisbehandlungsroutine für OnKeyDown der Parameter Key auf Null gesetzt wird.

Der Parameter Shift ist eine Menge mit folgenden Konstanten:

Status	Bedeutung

ssShift	Die UMSCHALT-Taste ist gedrückt.

ssAlt	Die Taste ALT ist gedrückt.

ssCtrl	Die Taste STRG ist gedrückt.

ssLeft	Die linke Maustaste ist gedrückt.

ssMiddle	Die mittlere Maustaste ist gedrückt.

ssDouble	Die rechte und die linke Maustaste sind gedrückt.


TWinControl::KeyPress

TWinControl	Siehe auch

Die Methode KeyPress ist eine als protected deklarierte Methode, die das Ereignis OnKeyPress eines Steuerelements implementiert.

virtual void __fastcall KeyPress(char &Key);

Beschreibung

Die von TWinControl geerbte Methode KeyPress ruft lediglich die mit dem Ereignis OnKeyPress verbundene Behandlungsroutine auf. Sollen zusätzlich zu diesem Aufruf weitere Aktionen durchgeführt werden, überschreiben Sie KeyPress.

Ein Fenster-Steuerelement ruft KeyPress als Reaktion auf die Windows-Botschaft WM_CHAR („Zeichen“) auf. Der eigentliche Ablauf sieht so aus, daß die Botschaft zunächst an eine als private deklarierte Bearbeitungsroutine weitergegeben wird, die dann DoKeyPress aufruft. Stellt DoKeyPress fest, daß das Steuerelement das Zeichen bearbeiten soll, konvertiert sie die Botschaftsparameter und übergibt KeyPress den Tastencode im Parameter Key.

Der Parameter Key gibt die Taste an. Bei nicht alphanumerischen Tasten können Sie die gedrückte Taste mit den virtuellen Tastencodes der Windows-API feststellen. Weitere Informationen finden Sie in der Hilfedatei WIN32.HLP (Win32 Developer's Reference) unter VkKeyScan und VkKeyScanEx.

Die weitere Verarbeitung einer Taste kann verhindert werden, indem in der Methode KeyPress oder in der Ereignisbehandlungsroutine für OnKeyPress der Parameter Key auf Null gesetzt wird.


TWinControl::KeyUp

TWinControl	Siehe auch

Die Methode KeyUp ist eine als protected deklarierte Methode, die das Ereignis OnKeyUp eines Steuerelements implementiert.

virtual void __fastcall KeyUp(unsigned short &Key,  Classes::TShiftState Shift);

Beschreibung

Die Methode KeyUp ruft lediglich die mit dem Ereignis OnKeyUp verbundene Behandlungsroutine auf. Sollen zusätzlich zu diesem Aufruf weitere Aktionen durchgeführt werden, überschreiben Sie KeyUp.

Ein Fenster-Steuerelement ruft KeyUp als Reaktion auf die Windows-Botschaft WM_KEYUP („Taste losgelassen“) auf. Der eigentliche Ablauf gestaltet sich folgendermaßen:

1	Die Methode DoKeyUp prüft, ob das Steuerelement das Zeichen bearbeiten soll.

2	Soll das Zeichen bearbeitet werden, konvertiert DoKeyUp die Parameter der Botschaft und übergibt den Tastencode und den Sondertastenstatus in den Parametern Key und Shift an KeyUp.

3	Die weitere Verarbeitung der Taste kann verhindert werden, indem in der Methode KeyUp oder in der Ereignisbehandlungsroutine für OnKeyUp der Parameter Key auf Null gesetzt wird.

Der Parameter Key gibt die Taste an. Bei nicht alphanumerischen Tasten können Sie die gedrückte Taste mit den virtuellen Tastencodes der Windows-API feststellen. Weitere Informationen finden Sie in der Hilfedatei WIN32.HLP (Win32 Developer's Reference) unter VkKeyScan und VkKeyScanEx.

Der Parameter Shift ist eine Menge mit folgenden Konstanten:

Status	Bedeutung

ssShift	Die UMSCHALT-Taste ist gedrückt.

ssAlt	Die Taste ALT ist gedrückt.

ssCtrl	Die Taste STRG ist gedrückt.

ssLeft	Die linke Maustaste ist gedrückt.

ssMiddle	Die mittlere Maustaste ist gedrückt.

ssDouble	Die rechte und die linke Maustaste sind gedrückt.


TWinControl::MainWndProc

TWinControl	Siehe auch

Die Methode MainWndProc wird von Windows aufgerufen, wenn Botschaften für ein Steuerelement vorliegen.

void __fastcall MainWndProc(Messages::TMessage &Message);

Beschreibung

Mit MainWndProc kann eine Botschaft an das Steuerelement gesendet werden.

MainWndProc bearbeitet die Botschaft nicht selbst, sondern ruft die Methode WndProc in einem Exception-Behandlungsblock auf. Dadurch ist sichergestellt, daß alle Exceptions, die während der Botschaftsverarbeitung nicht behandelt wurden, an die Methode HandleException der Anwendung gesendet werden.


TWinControl::NotifyControls

TWinControl	Siehe auch

Die Methode NotifyControls sendet eine Botschaft an alle untergeordneten Komponenten eines Steuerelements.

void __fastcall NotifyControls(unsigned short Msg);

Beschreibung

NotifyControls sendet die Botschaft mit der in Msg angegebenen ID an alle Komponenten im Array der Eigenschaft Controls des Steuerelements. Borland C++Builder verwendet NotifyControls, um die Steuerelemente in einem Formular bei bestimmten Operationen (z.B. Farb- oder Schriftänderungen im übergeordneten Fenster) zu aktualisieren.

NotifyControls erzeugt einen generischen Botschafts-Record und setzt das Feld mit der Botschafts-ID auf den Wert von Msg und die Parameter und Ergebnisfelder auf Null. Anschließend wird die Methode Broadcast aufgerufen, um die Botschaft an die untergeordneten Steuerelemente zu senden.


TWinControl::PaintControls

TWinControl	Siehe auch

Die Methode PaintControls zeichnet alle untergeordneten Komponenten eines Steuerelements.

void __fastcall PaintControls(HDC DC, TControl* First);

Beschreibung

Mit PaintControls können die untergeordneten Komponenten eines Steuerelements gezeichnet werden. Der Gerätekontext wird dabei im Parameter DC übergeben. In First wird das Element in der Liste der untergeordneten Komponenten angegeben, mit dem die Operation beginnt. Enthält First den Wert NULL oder ein Element, das nicht in der Liste vorhanden ist, werden alle untergeordneten Komponenten gezeichnet.

Die Methode Repaint ruft PaintControls für das übergeordnete Fenster des Steuerelements auf und übergibt das Steuerelement im Parameter First, wodurch das Steuerelement und alle von ihm verdeckten Komponenten gezeichnet werden. Nach dem Aufruf von PaintWindow ruft PaintHandler die Methode PaintControls auf.


TWinControl::PaintHandler

TWinControl	Siehe auch

Die Methode PaintHandler ist eine Behandlungsroutine, die auf WM_PAINT-Botschaften reagiert.

void __fastcall PaintHandler(Messages::TWMPaint &Message);

Beschreibung

PaintHandler ruft die API-Funktionen BeginPaint und EndPaint API auf. Zwischen diesen Funktionsaufrufen zeichnet PaintWindow den Hintergrund des Steuerelements und PaintControls die verschiedenen untergeordneten Komponenten.


TWinControl::PaintTo

TWinControl	Siehe auch

Die Methode PaintTo zeichnet ein Steuerelement in einem Gerätekontext.

void __fastcall PaintTo(HDC DC, int X, int Y);

Beschreibung

Mit PaintTo können Sie das Steuerelement in einem Gerätekontext zeichnen. Dabei werden mit DC der Kontext und mit X und Y die Koordinaten im Gerätekontext angegeben, an denen die linke obere Ecke des Steuerelements gezeichnet werden soll. Bei der Operation wird zuerst der Hintergrund des Kontextes gelöscht und anschließend das Steuerelement gezeichnet.

PaintTo ist hilfreich, wenn ein Steuerelement in einem Bitmap-Kontext gezeichnet werden soll.


TWinControl::PaintWindow

TWinControl	Siehe auch

Die Methode PaintWindow zeichnet ein Steuerelement neu.

virtual void __fastcall PaintWindow(HDC DC);

Beschreibung

Mit PaintWindow kann ein Steuerelement neu gezeichnet werden. PaintWindow sendet eine WM_PAINT-Botschaft an die Methode DefaultHandler des Steuerelements und setzt das Feld WParam des Botschafts-Record auf den Wert von DC und die anderen Parameter und die Ergebnisfelder auf Null.


TWinControl::PaletteChanged

TWinControl	Siehe auch

Die Methode PaletteChanged reagiert auf Änderungen der Sytempalette, indem die Paletten des Steuerelements und seiner untergeordneten Komponenten realisiert werden.

virtual bool __fastcall PaletteChanged(bool Foreground);

Beschreibung

Indem Sie PaletteChanged überschreiben, können Sie darauf Einfluß nehmen, wie das Steuerelement auf Windows-Benachrichtigungen über Änderungen der Systempalette reagiert. TWinControl-Objekte reagieren auf diese Benachrichtigungen, indem sie versuchen, die Palette des Steuerelements im aktuellen Gerätekontext zu realisieren und dann die PaletteChanged-Benachrichtigung der Reihe nach an die untergeordneten Komponenten zu senden. Führt die Änderung der Systempalette dazu, daß sich die Palette des Steuerelements ändert, wird das Steuerelement mit der neuen Palette neu gezeichnet.

Windows zeichnet das oberste Fenster mit einer Vordergrund- und die anderen Fenster mit Hintergrundpaletten. Hintergrundpaletten ähneln der logischen Palette des Steuerelements mit den Einschränkungen, die sich aus der Implementierung der Vordergrundpalette ergeben. Unter Windows ist nur eine einzige Vordergrundpalette zulässig.

PaletteChanged ermöglicht dem Steuerelement, bei Änderungen der Systempalette seine Palette neu zu realisieren. Hat ForeGround den Wert True, ist das Formular aktiviert und gibt die neue Vordergrundpalette an. Ist ForeGround False, wurde die Vordergrundpalette von einer anderen Anwendung geändert. Die Steuerelemente, die von der verfügbaren Palette abhängig sind, sollten dann neue Hintergrundpaletten realisieren, die ihren logischen Paletten am nächsten kommen.

Hat das Steuerelement keine logische Palette, die im aktuellen Gerätekontext realisiert werden kann, gibt GetPalette False zurück. PaletteChanged versucht in diesem fall nicht, eine Palette für das Steuerelement zu realisieren, sondern gibt einfach die Benachrichtigung an die untergeordneten Komponenten weiter. Realisiert das fensterorientierte Steuerelement oder eines seiner untergeordneten Fenster als Reaktion auf PaletteChanged eine Palette im aktuellen Gerätekontext, gibt die Methode True zurück.

Indem Sie PaletteChanged überschreiben, können Sie festlegen, wie Steuerelemente bei Änderungen der Systempalette eine neue Palette realisieren. Sie können beispielsweise die Reihenfolge ändern, in der die untergeordneten Fenster ihre Paletten realisieren, indem Sie einem bestimmten Steuerelement bei der Aktivierung des Formulars die Vordergrundpalette übergeben. Sie können auch Benachrichtigungen über Palettenänderungen an benutzerdefinierte Steuerelemente außerhalb von Borland C++Builder (z.B. in einer DLL) übergeben. Wenn Sie statt dessen GetPalette überschreiben, können Sie steuern, ob das Steuerelement tatsächlich eine zu realisierende Palette hat, oder Sie können den Wert der logischen Palette des Fensters ändern.

Hinweis

PaletteChanged wird nur aufgerufen, wenn der Grafikmodus zur Laufzeit die Unterstützung von Paletten erfordert, beispielsweise im 256-Farben-Modus, nicht jedoch bei 16 Millionen Farben.


TWinControl::ReadState

TWinControl	Siehe auch

Die Methode ReadState bereitet das Steuerelement dafür vor, seine Eigenschaften mit Werten aus einem Stream zu füllen.

virtual void __fastcall ReadState(Classes::TReader* Reader);

Beschreibung

Durch das Überschreiben von ReadState können Sie die Vorbereitungen des Steuerelements ändern, um Werte aus einem Stream in seine Eigenschaften einzulesen. So könnte das Steuerelement beispielsweise temporäre interne Datenstrukturen und Objekte freigeben, bevor neue Instanzen aus dem Stream gelesen werden. Sie müssen jedoch die von TControl geerbte Methode ReadState in der überschriebenen Methode aufrufen.

ReadState deaktiviert die Ausrichtung der Steuerelemente, bis alle untergeordneten Komponenten aus dem Stream gelesen sind, ruft dann die geerbte Methode ReadState auf und aktiviert anschließend wieder die Ausrichtung der Komponenten. Zum Schluß erzeugt die Methode die Tabulatorreihenfolgeliste der Komponenten und synchronisiert deren Eigenschaft Ctl3D sowie deren Sichtbarkeit mit dem übergeordneten Steuerelement.


TWinControl::Realign

TWinControl	Siehe auch

Die Methode Realign veranlaßt ein Steuerelement, seine untergeordneten Komponenten neu auszurichten.

void __fastcall Realign(void);

Beschreibung

Mit Realign können die untergeordneten Komponenten des Steuerelements neu ausgerichtet werden, nachdem sie durch eine andere Operation umgestellt wurden.

Wenn bei allen untergeordneten Komponenten die Eigenschaft Align auf alNone gesetzt ist, bleibt der Aufruf ohne Wirkung.

Realign wird von der Methode EnableAlign aufgerufen, wenn ihr Referenzzähler den Wert 0 erreicht hat.


TWinControl::RecreateWnd

TWinControl	Siehe auch

Die Methode RecreateWnd gibt das Fenster-Handle eines Steuerelements frei und erzeugt anschließend entsprechend dem aktuellen Komponentenstatus ein neues Handle.

void __fastcall RecreateWnd(void);

Beschreibung

Mit RecreateWnd kann das Steuerelement erneut erzeugt werden.

Bestimmte Änderungen eines Steuerelements werden unter Windows nur wiedergegeben, wenn das Fenster freigegeben und neu erzeugt wird. Damit beispielsweise eine Änderung am Rahmenstil eines Eingabefelds zu sehen ist, muß das Steuerelement erneut erzeugt werden.

RecreateWnd ruft DestroyHandle auf, um das Fenster-Handle freizugeben, und erzeugt das Handle neu, wenn das Steuerelement wieder angezeigt wird.


TWinControl::RemoveControl

TWinControl	Siehe auch 	Beispiel

Die Methode RemoveControl entfernt eine bestimmte Komponente aus dem Array der Eigenschaft Controls eines Steuerelements.

void __fastcall RemoveControl(TControl* AControl);

Beschreibung

Mit RemoveControl kann die in AControl übergebene Komponente aus der Eigenschaft Controls des Steuerelements entfernt werden. Danach ist das Steuerelement nicht mehr das übergeordnete Fenster der entfernten Komponente.

Steuerelemente werden automatisch in das Array Controls aufgenommen bzw. aus ihm entfernt, wenn sie während des Entwurfs hinzugefügt oder gelöscht werden. Mit der Methode RemoveControl kann eine Komponente zur Laufzeit aus Controls entfernt werden.


TWinControl::Repaint

TWinControl	Siehe auch

Die Methode Repaint zeichnet ein Steuerelement neu.

virtual void __fastcall Repaint(void);

Beschreibung

Mit Repaint kann ein Steuerelement neu gezeichnet werden.

Repaint ruft zuerst Invalidate und dann Update auf, um das Steuerelement neu zu zeichnen.


TWinControl::ScaleBy

TWinControl	Siehe auch	Beispiel

Die Methode ScaleBy skaliert ein Steuerelement und seine untergeordneten Komponenten auf einen bestimmten Prozentsatz ihrer vorherigen Größe.

void __fastcall ScaleBy(int Z, int N);

Beschreibung

Mit ScaleBy können Sie das Steuerelement und die in ihm enthaltenen Komponenten skalieren. Dabei werden lediglich die Eigenschaften Width und Height der Steuerelemente geändert, jedoch nicht Top und Left. Daher ändert sich nur die Größe der Steuerelemente, nicht ihre Position.

Die Skalierung wird im Parameterverhältnis Z/N (Zähler/Nenner) durchgeführt. Um beispielsweise ein Steuerelement und seine untergeordneten Komponenten auf 75 % ihrer ursprünglichen Größe zu verkleinern, geben Sie für den Parameter Z den Wert 75 und für N den Wert 100 an (75/100). Alternativ dazu kann auch für Z der Wert 3 und für N der Wert 4 verwendet werden (3/4). Beide Angaben sind identisch und führen zu einer Verkleinerung auf 75 %.

Um eine Vergrößerung um 33 % zu erreichen, geben Sie für Z 133 und für N 100 (133/100) oder wie oben beschrieben 4 und 3 an (4/3).

Hinweis

Die Größen- und Positionsangaben eines Steuerelements sind Integer-Werte. Daher führt eine Skalierung im Verhältnis Z/N zu Rundungsfehlern. Wenn Sie ChangeScale wiederholt aufrufen, kann das Steuerelement durch die Rundungsfehler zu klein werden und verschwinden. Wenn Sie ein Formular mehrmals skalieren, sollten Sie es daher nach einer bestimmten Anzahl Skalierungen freigeben und neu laden, damit sich die Rundungsfehler nicht summieren.


TWinControl::ScaleControls

TWinControl	Siehe auch

Die Methode ScaleControls skaliert die untergeordneten Komponenten eines Steuerelements.

void __fastcall ScaleControls(int Z, int N);

Beschreibung

Mit ScaleControls können Sie untergeordnete Steuerelemente ohne Auswirkung auf ihren Container skalieren.

ScaleControls ruft für jedes untergeordnete Steuerelement die Methode ChangeScale auf und übergibt den Skalierungsfaktor in den Parametern Z und N (Zähler und Nenner). Die Operation wird im Verhältnis Z/N durchgeführt. Sollen beispielsweise die untergeordneten Komponenten auf 75 % der ursprünglichen Größe verkleinert werden, geben Sie für Z den Wert 75 und für N den Wert 100 an (75/100). Alternativ dazu kann auch für Z der Wert 3 und für N der Wert 4 verwendet werden (3/4). Beide Angaben sind identisch und führen zu einer Verkleinerung auf 75 %.

Hinweis

Die Größen- und Positionsangaben eines Steuerelements sind Integer-Werte. Daher führt eine Skalierung im Verhältnis Z/N zu Rundungsfehlern. Wenn Sie ChangeScale wiederholt aufrufen, kann es passieren, daß das Steuerelement verschwindet (wenn es durch die Rundungsfehler zu klein wird) oder sich nicht mehr innerhalb des Formulars befindet (wenn sich durch die Rundungsfehler seine Position verändert). Wenn Sie ein Formular mehrmals skalieren, sollten Sie es daher nach einer bestimmten Anzahl Skalierungen freigeben und neu laden, damit sich die Rundungsfehler nicht summieren.


TWinControl::ScrollBy

TWinControl	Siehe auch	Beispiel

Die Methode ScrollBy verschiebt den Bildausschnitt eines Steuerelements.

void __fastcall ScrollBy(int DeltaX, int DeltaY);

Beschreibung

Mit ScrollBy kann der Bildausschnitt eines Steuerelements verschoben werden. Diese Methode kann zwar für alle fensterorientierten Steuerelement verwendet werden, am sinnvollsten ist sie aber bei Klassen, die von TScrollingWinControl abgeleitet sind.

ScrollBy braucht normalerweise nur aufgerufen zu werden, wenn Sie anstelle einer Bildlaufleiste eine eigene Bildlauflogik implementieren.

Der Parameter DeltaX gibt die Änderung in Pixel entlang der X-Achse an. Bei einem positiven Wert wird der Bildausschnitt nach rechts, bei einem negativen Wert nach links verschoben. DeltaY enthält die Änderung in Pixel längs der Y-Achse. Bei einem positiven Wert wird der Bildausschnitt nach unten, bei einem negativen Wert nach oben verschoben.


TWinControl::SelectFirst

TWinControl	Siehe auch

Die Methode SelectFirst sucht nach der ersten untergeordnete Komponente in der Tabulatorreihenfolge eines Steuerelements, die auswählbar ist.

void __fastcall SelectFirst(void);

Beschreibung

Mit SelectFirst können Sie die erste untergeordnete Komponente in der Tabulatorreihenfolge des Steuerelements auswählen. SelectFirst ruft die Methode FindNextControl auf und übergibt NULL als aktuelle Komponente. Sobald das erste auswählbare Steuerelement gefunden ist, macht SelectFirst es zur aktiven Komponente im Formular.


TWinControl::SelectNext

TWinControl	Siehe auch

Die Methode SelectNext übergibt den Eingabefokus vom aktuellen untergeordneten Steuerelement an das nächste Element in der Tabulatorreihenfolge.

void __fastcall SelectNext(TWinControl* CurControl, bool GoForward, bool CheckTabStop);

Beschreibung

Mit SelectNext können Sie die nächste untergeordnete Komponente in der Tabulatorreihenfolge des Steuerelements auswählen. Im Parameter CurControl wird die Komponente übergeben, mit der die Suche beginnt. Der Parameter GoForward steuert die Richtung der Suchoperation. Hat GoForward den Wert True, werden die Komponenten vorwärts durchlaufen, andernfalls rückwärts.

Der Parameter CheckTabStop bestimmt, ob sich die Komponente in der Tabulatorreihenfolge befinden muß. Hat CheckTabStop den Wert True, muß die Eigenschaft TabStop der zurückgegebenen Komponente auf True gesetzt sein. Ist das nicht der Fall, wird die Suche beim nächsten Steuerelement fortgesetzt.

Wenn SelectNext kein entsprechendes Steuerelement findet, erhält CurControl den Eingabefokus zurück.


TWinControl::SetBounds

TWinControl	Siehe auch	Beispiel

Die Methode SetBounds setzt alle Eigenschaften des umgebenden Rechtecks eines Steuerelements in einem Schritt.

virtual void __fastcall SetBounds(int ALeft, int ATop, int AWidth, int AHeight);

Beschreibung

Mit SetBounds können in einem Aufruf alle Begrenzungseigenschaften eines Steuerelements gesetzt werden. Sie können die Eigenschaften Left, Top, Width und Height auch einzeln ändern. Durch die Vewendung von SetBounds ist jedoch sichergestellt, daß das Steuerelement zwischen den Wertänderungen nicht neu gezeichnet wird.

Übergeben Sie die Werte der Eigenschaften Left, Top, Width und Height in den Parametern ALeft, ATop, AWidth und AHeight.


TWinControl::SetChildOrder

TWinControl	Siehe auch

Die Methode SetChildOrder ändert die Reihenfolge der untergeordneten Komponenten in der von der Methode GetChildren zurückgegebenen Liste.

virtual void __fastcall SetChildOrder(Classes::TComponent* Child, int Order);

Beschreibung

Mit SetChildOrder können Sie die Reihenfolge ändern, in der untergeordnete Komponenten aus dem Stream gelesen werden. Der Parameter Child gibt das Steuerelement an, dessen Position in der Liste geändert werden soll. Der Parameter Order legt die neue Position fest.

Durch den Aufruf von SetChildOrder werden Elemente, die sich zuvor unterhalb der alten Position der Komponente befanden, nach oben, und Elemente, die sich unterhalb der neuen Position befanden, nach unten verschoben.


TWinControl::SetFocus

TWinControl	Siehe auch	Beispiel

Die Methode SetFocus übergibt einem Steuerelement den Eingabefokus.

virtual void __fastcall SetFocus(void);

Beschreibung

Mit SetFocus können Sie den Eingabefokus an ein anderes Steuerelement übergeben.


TWinControl::SetZOrder

TWinControl	Siehe auch

Die Methode SetZOrder verschiebt ein Steuerelement in der Liste der untergeordneten Komponenten an die erste oder letzte Position. Ist kein übergeordnetes Fenster vorhanden, wird das Steuerelement zum obersten oder untersten Fenster auf dem Bildschirm.

virtual void __fastcall SetZOrder(bool TopMost);

Beschreibung

Mit SetZOrder können Sie überlappende Komponenten innerhalb eines übergeordneten Steuerelements oder überlappende Fenster auf dem Bildschirm neu anordnen. Hat der Parameter TopMost den Wert True, wird das Steuerelement zum obersten, andernfalls zum untersten Steuerelement.

Fensterorientierte Steuerelemente liegen immer über nicht fensterorientierten Steuerelementen. Wenn also das übergeordnete Fenster nicht fensterorientierte Steuerelemente enthält und SetZOrder mit dem Parameter False aufgerufen wird, bleibt das fensterorientierte Steuerelement dennnoch über allen nicht fensterorientierten Steuerelementen.

Nach der Änderung wird das Steuerelement entsprechend der veränderten Reihenfolge neu gezeichnet.


TWinControl::ShowControl

TWinControl	Siehe auch

Die Methode ShowControl stellt sicher, daß ein bestimmtes untergeordnetes Steuerelement sichtbar ist.

virtual void __fastcall ShowControl(TControl* AControl);

Beschreibung

Mit ShowControl kann sichergestellt werden, daß das in AControl übergebene Steuerelement sichtbar ist.

Die TWinControl-Methode ShowControl ruft einfach die Methode ShowControl des übergeordneten Fensters der Komponente auf. In abgeleiteten Klassen sollte ShowControl überschrieben werden und die Aktionen enthalten, die erforderlich sind, um die untergeordnete Komponente auch wirklich sichtbar zu machen. So könnte beispielsweise der Bildausschnitt verschoben oder die entsprechende Registerkarte aktiviert werden, um das untergeordnete Element anzuzeigen.

ShowControl ist eine als protected daklarierte Methode, die in der Implementierung von Show verwendet wird.


TWinControl::TWinControl

TWinControl	Siehe auch

Der Konstruktor TWinControl erzeugt ein neues TWinControl-Objekt.

__fastcall virtual TWinControl(Classes::TComponent* AOwner);

-oder-

__fastcall TWinControl(HWND ParentWindow);

Beschreibung

Mit TWinControl können Sie ein neues fensterorientiertes Steuerelement erzeugen und initialisieren. Die neue Komponente wird in das mit AOwner angegebene Fenster (Eigentümer) eingefügt, indem dessen Methode InsertComponent aufgerufen wird.

Nach dem Aufruf des geerbten Konstruktors führt TWinControl folgende Aktionen durch:

•	Das Brush-Objekt wird erzeugt und initialisiert.

•	Die Eigenschaft ParentCtl3D wird mit True initialisiert.

•	Die Eigenschaft TabOrder wird auf -1 gesetzt.

Die meisten Steuerelemente überschreiben TWinControl, um spezielle Eigenschaften zu initialisieren. In diesem Fall muß immer die geerbte Methode TWinControl aufgerufen werden, bevor die komponentenspezifischen Aktionen durchgeführt werden.

Wenn ein abgeleitetes Objekt Ressourcen oder Speicher reserviert, muß die Methode ~TWinControl überschrieben werden, um die Ressourcen und den Speicher wieder freizugeben.


TWinControl::Update

TWinControl	Siehe auch	Beispiel

Die Methode Update verarbeitet umgehend alle anstehenden Botschaften, die mit dem Zeichnen des Objekts zu tun haben.

virtual void __fastcall Update(void);

Beschreibung

Mit Update kann das Steuerelement vor zeitaufwendigen Operationen neu gezeichnet werden. Die Methode erlaubt eine sofortige Rückmeldung an den Benutzer, ohne daß dieser auf die entsprechende Windows-Botschaft zu warten braucht. Update veranlaßt einfach ein erneutes Zeichnen aller Bereiche, die bereits invalidiert wurden. Soll auch das Steuerelement invalidiert werden, verwenden Sie statt dessen Repaint.

Update ruft die Windows-API-Funktion UpdateWindow auf. Diese verarbeitet alle anstehenden Botschaften, die mit dem Zeichnen des Objekts zu tun haben. Weitere Informationen hierzu finden Sie in der Hilfedatei WIN32.HLP (Win32 Developer's Reference).


TWinControl::UpdateControlState

TWinControl	Siehe auch

Die Methode UpdateControlState zeigt ein Steuerelement an und bewirkt, daß alle übergeordneten Objekte die entsprechenden Anpassungen vornehmen.

void __fastcall UpdateControlState(void);

Beschreibung

UpdateControlState wird intern verwendet, um Steuerelemente anzuzeigen und Handles für sie zu erzeugen. UpdateControlState ruft die Methode Show auf, die das fensterorientierte Steuerelement anzeigt. Außerdem erzeugt sie das Fenster-Handle für das Objekt (und für alle übergeordneten Fenster, die kein Handle haben) und ruft anschließend die Methode ShowControl aller übergeordneten Steuerelemente auf, um das Steuerelement sichtbar zu machen.

UpdateControlState zeigt das Steuerelement nur an, wenn dessen Eigenschaft Visible True ist und auch das übergeordnete Fenster sichtbar ist.


TWinControl::WndProc

TWinControl	Siehe auch

Die Methode WndProc stellt spezielle Botschaftsverarbeitungen für ein Steuerelement bereit.

virtual void __fastcall WndProc(Messages::TMessage &Message);

Beschreibung

Durch Überschreiben von WndProc können Sie festlegen, wie das Steuerelement auf Windows-Botschaften reagiert. WndProc ist die erste Methode, die für ein Steuerelement Botschaften erhält.

In TWinControl überschreibt WndProc die TControl-Methode WndProc, um Reaktionen auf Fokus-, Maus- und Tastaturbotschaften zu definieren. Alle anderen Botschaften werden an die geerbte Methode WndProc gesendet.

Wenn Sie WndProc überschreiben, müssen Sie nach der komponentenspezifischen Verarbeitung die geerbte Methode aufrufen, um die anderen Botschaften zu behandeln.


Gültigkeitsbereich

Protected

Published

Zugriff

Read-only


Gültigkeitsbereich

Protected


Gültigkeitsbereich

Protected


Hierarchie

TObject

TPersistent

TComponent

TControl


TWinControl Beispiel

TWinControl


TWordField

Hierarchie	Eigenschaften	Methoden	Ereignisse	Siehe auch

Header

vcl/dbtables.hpp

Ein TWordField-Objekt repräsentiert ein vorzeichenloses 16-Bit-Integer-Feld in einer Datenmenge.

Beschreibung

Felder des Typs Word können Werte im Bereich von 0 bis 65535 speichern, also vorzeichenlose ganze Zahlen mit einer Breite von 16 Bit.

TWordField unterscheidet sich von seinem direkten Vorfahren TIntegerField nur im Datentyp, der repräsentiert wird. Mit Ausnahme des Konstruktors sind alle Eigenschaften, Methoden und Ereignisse dieselben wie die von TIntegerField. Deren Funktionalität eignet sich für die Verwaltung von Werten und Eigenschaften eines integralen numerischen Feldes in einer Datenbank.


Eigenschaften von TWordField

TWordField	Alphabetisch	Legende

Abgeleitet von TIntegerField

MaxValue

MinValue

Value

Derived from TNumericField

DisplayFormat

EditFormat

Derived from TField

Alignment

AsBoolean

AsCurrency

AsDateTime

AsFloat

AsInteger

AsString

AsVariant

AttributeSet

BDECalcField

Calculated

CanModify

DataSet

DataSize

DataType

DisplayLabel

DisplayName

DisplayText

DisplayWidth

EditMask

EditMaskPtr

FieldKind

FieldName

FieldNo

Index

IsIndexField

IsNull

KeyFields

Lookup

LookupDataSet

LookupKeyFields

LookupResultField

NewValue

OldValue

ReadOnly

Required

Size

Text

Visible

Derived from TComponent

ComponentCount

ComponentIndex

Components

ComponentState

ComponentStyle

DesignInfo

Name

Owner

Tag


Eigenschaften von TWordField

TWordField	Nach Objekten	Legende

Alignment

AsBoolean

AsCurrency

AsDateTime

AsFloat

AsInteger

AsString

AsVariant

AttributeSet

BDECalcField

Calculated

CanModify

ComponentCount

ComponentIndex

ComponentState

Components

ComponentStyle

DataSet

DataSize

DataType

DesignInfo

DisplayFormat

DisplayLabel

DisplayName

DisplayText

DisplayWidth

EditFormat

EditMaskPtr

EditMask

FieldKind

FieldName

FieldNo

Index

IsIndexField

IsNull

KeyFields

LookupDataSet

LookupKeyFields

LookupResultField

Lookup

MaxValue

MinValue

Name

NewValue

OldValue

Owner

ReadOnly

Required

Size

Tag

Text

Value

Visible


Ereignisse von TWordField

TWordField	Alphabetisch	Legende

Abgeleitet von TField

OnChange

OnGetText

OnSetText

OnValidate


Ereignisse von TWordField

TWordField	Nach Objekten	Legende

OnChange

OnGetText

OnSetText

OnValidate


Methoden von TWordField

TWordField	Alphabetisch

In TWordField

~TWordField

TWordField

Abgeleitet von TIntegerField

IsValidChar

Abgeleitet von TField

Assign

AssignValue

Clear

FocusControl

GetData

SetData

SetFieldType

Abgeleitet von TComponent

DestroyComponents

Destroying

FindComponent

FreeNotification

GetParentComponent

HasParent

InsertComponent

RemoveComponent

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TWordField

TWordField	Nach Objekten

~TWordField

Assign

AssignValue

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

Clear

DefaultHandler

DestroyComponents

Destroying

Dispatch

FieldAddress

FindComponent

FocusControl

FreeInstance

FreeNotification

Free

GetData

GetParentComponent

HasParent

InheritsFrom

InitInstance

InsertComponent

InstanceSize

IsValidChar

MethodAddress

MethodName

NewInstance

RemoveComponent

SetData

SetFieldType

TWordField


TWordField::~TWordField

TWordField

Der Destruktor ~TWordField gibt den Speicher frei, der für das TWordField-Objekt reserviert war. Rufen Sie ~TWordField nicht direkt auf. Verwenden Sie statt dessen das Schlüsselwort delete, womit ~TWordField automatisch aufgerufen wird.

__fastcall virtual ~TWordField(void);


TWordField::TWordField

TWordField

Die Methode TWordField erzeugt eine Instanz von TWordField.

__fastcall virtual TWordField(Classes::TComponent* AOwner);

Beschreibung

Es ist nur selten notwendig, TWordField direkt aufzurufen, da eine Feldkomponente des Typs Word automatisch für alle Felder instantiiert wird, die ausschließlich Word-Werte in einer Datenmenge enthalten.

Nach dem Aufruf des geerbten Konstruktors nimmt TWordField die folgenden Zuweisungen vor:

•	DataType wird auf ftWord gesetzt.

•	MinValue wird auf 0 gesetzt.

•	MaxValue wird auf 65535 gesetzt.


Gültigkeitsbereich

Published


Gültigkeitsbereich

Published


Hierarchie

TObject

TPersistent

TComponent

TField

TNumericField

TIntegerField


TWordField Beispiel

TWordField


TWriter

Hierarchie	Eigenschaften	Methoden	Siehe auch

Header

vcl/classes.hpp

TWriter ist ein spezialisiertes Filer-Objekt, das Daten in den verbundenen Stream schreibt.

Beschreibung

TWriter wird intern vom VCL-Streaming-System verwendet, um unterschiedliche Elemente einer Komponente (z.B. Komponenteneigenschaften, die als public deklariert sind, oder benutzerdefinierte Eigenschaftsdaten) in einen Stream zu schreiben. Als Hilfsobjekt für Streams steuert TWriter anstelle des Stream-Objekts das Schreiben von Komponentendaten in den Stream. Dazu werden Methoden für die folgenden Operationen bereitgestellt:

•	Schreiben unterschiedlicher Elemente in den verbundenen Stream.

•	Schreiben von Eigenschaftsdeltas, die geerbte Formulare und Eigenschaften mit Standardwerten in den Stream stellen.

•	Schreiben von verschachtelten Gruppen von Elementen oder Kollektionen in den Stream.

Andere Methoden und Eigenschaften von TWriter werden für die Zusammenarbeit mit Stream- und Komponentenobjekten verwendet.

Writer-Objekte werden vom Benutzer nicht direkt erstellt. Der Konstruktor von TWriter verwendet einen Stream als Parameter. Writer-Objekte werden von den Methoden der Stream-Objekte oder in globalen Routinen verwendet, die das Streamen initiieren:

•	Aufrufen der globalen Prozedur ObjectBinaryToText, die ein Writer-Objekt direkt erstellt.

•	Aufrufen der globalen Funktion ReadComponentResFile, die ein Datei-Stream-Objekt erstellt, das seinerseits ein Writer-Objekt erstellt.

•	Aufrufen der Methode TStream::WriteDescendent, die ein Writer-Objekt erstellt.

Der Stream, der dem Konstruktor des Writer-Objekts als Parameter übergeben wurde, repräsentiert den verbundenen Stream. Sobald die Streaming-Operation läuft, muß der Benutzer die Reader-Objekte nicht direkt bearbeiten. Die Methoden der Reader-, Writer- und Komponentenobjekte rufen sich automatisch gegenseitig auf.


Eigenschaften von TWriter

TWriter	Alphabetisch

In TWriter

Position

RootAncestor

Abgeleitet von TFiler

Ancestor

IgnoreChildren

Root


Eigenschaften von TWriter

TWriter	Nach Objekten

Ancestor

IgnoreChildren

Position

RootAncestor

Root


TWriter::Position

TWriter	Siehe auch	Beispiel

Die Eigenschaft Position repräsentiert die aktuelle Schreibposition im verbundenen Stream.

__property long Position;

Beschreibung

Position wird intern von Writer-Objekten verwendet, um die aktuelle Schreibposition im Stream anzugeben.

Der Wert von Position befindet sich im zuletzt gelesenen Pufferblock oder im nächsten Block, der geschrieben werden soll. Für Schreiboperationen ist Position daher im allgemeinen kleiner als die Eigenschaft Position des Stream-Objekts. Wenn Position auf eine Position außerhalb des aktuellen Puffers verweist, wird der Puffer des Writer-Objekts in den Stream übertragen.


TWriter::RootAncestor

TWriter	Siehe auch

Die Eigenschaft RootAncestor repräsentiert den Vorfahr der Komponente in der Eigenschaft Root.

__property TComponent* RootAncestor;

Beschreibung

RootAncestor wird intern von Writer-Objekten für die Formularvererbung verwendet. Mit ihr kann über die Vorfahren iteriert werden, wenn Eigenschaften in geerbten Formularen geschrieben werden.

RootAncestor ist immer das Vorfahrformular. Für jede Komponente in Root, dem geerbten Formular, verfolgt die Eigenschaft Ancestor eine entsprechende Komponente in RootAncestor.

Das Writer-Objekt iteriert über alle untergeordneten Komponenten des Formulars in Root und vergleicht sie mit den entsprechenden Komponenten im RootAncestor-Formular. Dann schreibt es nur die Eigenschaften in die aktuelle Komponente, die sich von denen in der Ancestor-Komponente unterscheiden.


Methoden von TWriter

TWriter	Alphabetisch

In TWriter

~TWriter

DefineBinaryProperty

DefineProperty

FlushBuffer

TWriter

Write

WriteBoolean

WriteChar

WriteCollection

WriteComponent

WriteDescendent

WriteFloat

WriteIdent

WriteInteger

WriteListBegin

WriteListEnd

WriteRootComponent

WriteSignature

WriteStr

WriteString

Abgeleitet von TObject

ClassInfo

ClassName

ClassNameIs

ClassParent

ClassType

CleanupInstance

DefaultHandler

Dispatch

FieldAddress

Free

FreeInstance

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance


Methoden von TWriter

TWriter	Nach Objekten

~TWriter

ClassInfo

ClassNameIs

ClassName

ClassParent

ClassType

CleanupInstance

DefaultHandler

DefineBinaryProperty

DefineProperty

Dispatch

FieldAddress

FlushBuffer

FreeInstance

Free

InheritsFrom

InitInstance

InstanceSize

MethodAddress

MethodName

NewInstance

TWriter

WriteBoolean

WriteChar

WriteCollection

WriteComponent

WriteDescendent

WriteFloat

WriteIdent

WriteInteger

WriteListBegin

WriteListEnd

WriteRootComponent

WriteSignature

WriteString

WriteStr

Write


TWriter::~TWriter

TWriter	Siehe auch

Die Methode ~TWriter gibt eine Instanz eines Writer-Objekts frei.

__fastcall virtual ~TWriter(void);

Beschreibung

Rufen Sie in einer Anwendung ~TWriter nicht direkt auf. Verwenden Sie statt Free. Free überprüft, ob das Listenfeld-Objekt bereits freigegeben wurde, bevor ~TWriter aufgerufen wird.

~TWriter schreibt den Puffer, bevor die geerbte Methode ~TWriter zum Freigeben des Puffers aufgerufen wird.


TWriter::DefineBinaryProperty

TWriter	Siehe auch

Die Methode DefineBinaryProperty definiert binäre Daten wie eine Eigenschaft und schreibt sie direkt in einen Speicher-Stream.

virtual void __fastcall DefineBinaryProperty(const System::AnsiString Name, TStreamProc ReadData, TStreamProc  WriteData, bool HasData);

Beschreibung

DefineBinaryProperty wird intern von der Methode DefineProperties eines Objekts aufgerufen, das Daten enthält, die gespeichert werden müssen. DefineProperties verwendet ein generisches Filer-Objekt als Parameter.

Wenn binäre Daten geschrieben werden sollen, erhält DefineProperties ein TWriter-Objekt als Parameter und ruft dann die Methode DefineBinaryProperties des Writer-Objekts auf. Wenn der Parameter HasData True enthält, schreibt DefineBinaryProperty den Namen und die Daten der Eigenschaft. Andernfalls geschieht nichts.

Im Parameter Name wird der Name der benutzerdefinierten Eigenschaft angegeben, die in den Stream geschrieben werden soll. Diese Eigenschaft wurde nicht als public deklariert und existiert nur im Quelltext der Methode DefineBinaryProperty. Beispiele für Eigenschaften dieses Typs sind die Eigenschaften Top und Left einer nicht-visuellen Komponente. Sie werden auch als benutzerdefinierte Eigenschaften bezeichnet.

Der TStreamProc-Typ ist der Typ der Parameter ReadData und WriteData. Es handelt sich um den Methodenzeiger, der auf eine im Speicherobjekt definierte Prozedur zeigt, die eine binäre Repräsentation der Objektdaten direkt in den oder aus dem im Parameter Stream angegebenen Stream schreibt oder liest. Für TWriter-Objekte wird der Parameter ReadData nicht berücksichtigt.

Der Parameter HasData bestimmt zur Laufzeit, ob die Eigenschaft Daten enthält, die gespeichert (geschrieben) werden müssen. HasData wird also nur von Writer-Objekten beim Schreiben von Daten verwendet.

Definierte binäre Eigenschaften sind relativ selten. Die häufigste Verwendung von Filer-Objekten zum Speichern und Abrufen von Daten sind VCL-Objekte, die Grafiken als binäre Daten speichern. Gebräuchlichere Objekte verwenden die Methode DefineProperty. Der Unterschied zwischen DefineBinaryProperty und DefineProperty besteht darin, daß die Komponente die binäre Eigenschaft direkt in ein oder aus einem Speicher-Stream-Objekt schreibt bzw. liest, anstatt ein Filer-Objekt zu verwenden.

Hinweis

Von TPersistent abgeleitete Objekte, die in einen Stream gestellt werden können, erben die Methode DefineProperties. Die Methode DefineProperties des Komponentenobjekts ruft die Methode DefineBinaryProperty des Writer-Objekts auf, wenn binäre Daten geschrieben werden.


TWriter::DefineProperty

TWriter	Siehe auch

Die Methode DefineProperty definiert Daten, die das Writer-Objekt wie eine Eigenschaft schreibt.

virtual void __fastcall DefineProperty(const System::AnsiString Name, TReaderProc ReadData, TWriterProc  WriteData, bool HasData);

Beschreibung

DefineProperty wird intern von der Methode DefineProperties eines Objekts aufgerufen, das Daten enthält, die gespeichert werden müssen. DefineProperties verwendet ein generisches Filer-Objekt als Parameter. Wenn Daten geschrieben werden sollen, verwendet DefineProperties ein TWriter-Objekt als Parameter und ruft die Methode DefineProperties des Writer-Objekts auf. Enthält der Parameter HasData den Wert True, schreibt DefineProperty den Namen und die Daten der Eigenschaft. Andernfalls geschieht nichts.

Im Parameter Name wird der Name der benutzerdefinierten Eigenschaft angegeben, die in den Stream geschrieben werden soll.

Der TWriterProc-Typ ist der Typ des Parameters WriteData. Es handelt sich um den Methodenzeiger, der auf eine im Komponentenobjekt definierte Prozedur zeigt, die die einen Eigenschaftswert repräsentierenden Objektdaten in das Writer-Objekt schreibt. Für TWriter-Objekte wird der Parameter ReadData nicht berücksichtigt.

Der Parameter HasData bestimmt zur Laufzeit, ob die Eigenschaft Daten enthält, die gespeichert (geschrieben) werden müssen. HasData wird also nur von Writer-Objekten zum Schreiben von Daten verwendet.

Der Unterschied zwischen DefineBinaryProperty und DefineProperty besteht darin, daß die binäre Eigenschaft direkt in ein Stream-Objekt geschrieben wird, ohne daß ein Filer-Objekt zum Einsatz kommt.

Beim Schreiben einer Komponente mit hohem Datenspeicherungsbedarf kann die Methode DefineProperties der Komponente überschrieben werden. Rufen Sie für jedes Eigenschaftselement die Methode Filer::DefineProperty oder Filer::DefineBinaryProperty auf. Übergeben Sie die Parameter ReadData und WriteData an die Komponente, die für die Verarbeitung des jeweiligen Datentyps geeignet ist. Beim Lesen wird ReadData, beim Schreiben WriteData aufgerufen.

Hinweis

Beim Definieren von Eigenschaften muß eine Komponente die Eigenschaft Ancestor berücksichtigen, die mit einem Wert ungleich NULL angibt, daß die Komponente nur Werte von Eigenschaften schreiben darf, die sich von den von Ancestor geerbten unterscheiden.


TWriter::FlushBuffer

TWriter

Die Methode FlushBuffer synchronisiert den Puffer des Writer-Objekts mit dem verbundenen Stream, indem der aktuelle Puffer geschrieben wird.

virtual void __fastcall FlushBuffer(void);

Beschreibung

FlushBuffer wird nur für interne Implementierungen in Borland C++Builder verwendet.

FlushBuffer schreibt den aktuellen Puffer in den Stream und setzt dann einen internen Zeiger auf die richtige Position.


TWriter::TWriter

TWriter	Siehe auch

Der Konstruktor TWriter erzeugt ein neues TWriter-Objekt.

__fastcall TWriter(TStream* Stream, int BufSize);


TWriter::Write

TWriter	Siehe auch

Die Methode Write schreibt die in Count angegebene Anzahl Bytes aus Buf in den mit dem Writer-Objekt verbundenen Stream.

void __fastcall Write(const void *Buf, long Count);

Beschreibung

Rufen Sie Write nicht direkt auf. Diese Methode wird nur intern verwendet, um Daten in den Stream zu schreiben. Viele Methoden von Writer-Objekten rufen Write auf, normalerweise nach dem Einstellen geeigneter Werte oder dem Überprüfen von Datentypen.


TWriter::WriteBoolean

TWriter	Siehe auch

Die Methode WriteBoolean schreibt den in Value übergebenen booleschen Wert in den Stream des Writer-Objekts.

void __fastcall WriteBoolean(bool Value);

Beschreibung

WriteBoolean wird intern vom Borland C++Builder-Streaming-System verwendet, um Komponenteneigenschaften in einen Stream zu schreiben. Mit WriteBoolean können Sie boolesche Komponenteneigenschaften in einen Stream schreiben.

WriteBoolean überprüft, ob Value den richtigen Typ enthält, bevor die Methode Write aufgerufen wird, die den booleschen Wert und seinen Typ in den Stream schreibt.


TWriter::WriteChar

TWriter	Siehe auch

Die Methode WriteChar schreibt das in Value übergebene Zeichen in den Stream des Writer-Objekts.

void __fastcall WriteChar(char Value);

Beschreibung

WriteChar wird intern vom Borland C++Builder-Streaming-System benutzt, um Komponenteneigenschaften in einen Stream zu schreiben. Mit WriteChar können Sie die Zeicheneigenschaften von Komponenten in einen Stream schreiben.

WriteChar ruft die Methode WriteString auf, die überprüft, ob Value den richtigen Typ enthält, bevor die Methode Write aufgerufen wird, die das Zeichen und seinen Typ in den Stream schreibt.

Hinweis

WriteChar ruft StringChar auf, um das Schreiben von Zeicheneigenschaften zu ermöglichen, die mit Stringeigenschaften aufwärtskompatibel sind.


TWriter::WriteCollection

TWriter	Siehe auch

Die Methode WriteCollection schreibt die in Value übergebene Kollektion von Objekten in den Stream des Writer-Objekts.

void __fastcall WriteCollection(TCollection* Value);

Beschreibung

WriteCollection wird intern vom Borland C++Builder-Streaming-System verwendet, um Komponenteneigenschaften in einen Stream zu schreiben. Mit WriteCollection können Sie Komponenteneigenschaften, die Kollektionen repräsentieren, in einen Stream schreiben.

WriteCollection überprüft, ob Value den richtigen Typ enthält, bevor die Methode Write aufgerufen wird, die die Kollektion und ihren Typ in den Stream schreibt. WriteCollection beschränkt die Kollektion mit Markierungen für den Listenanfang und das Listenende.


TWriter::WriteComponent

TWriter	Siehe auch

Die Methode WriteComponent schreibt die in Component angegebene Komponente in einen Stream.

void __fastcall WriteComponent(TComponent* Component);

Beschreibung

Rufen Sie WriteComponent nicht direkt auf. WriteComponent wird für jede untergeordnete Komponente in Root rekursiv aufgerufen.

WriteComponent weist der Eigenschaft ComponentState von Component den Status csWriting zu, bevor die Methode WriteState von Component aufgerufen wird, und löscht das Flag csWriting, sobald WriteState die Steuerung zurückgibt.

Hinweis

Die Methode WriteComponent des Writer-Objekts ruft die Methode WriteState der Komponente auf, die ihrerseits die Methode WriteData des Writer-Objekts aufruft. Diese Methode schreibt die Eigenschaften für jede untergeordnete Komponente und ruft dann WriteComponent auf.

Da die Methode WriteState der Komponente eine virtuelle Methode ist, stellt sie die einzige Möglichkeit der Komponente dar, sich auf das Schreiben in den Stream vorzubereiten.


TWriter::WriteDescendent

TWriter	Siehe auch

Die Methode WriteDescendent wird intern aufgerufen, um das Schreiben untergeordneter Komponenten in geerbten Formularen zu starten.

void __fastcall WriteDescendent(TComponent* Root, TComponent* AAncestor);

Beschreibung

Rufen Sie WriteDescendent nicht direkt auf. Diese Methode ist Teil einer Folge von Aufrufen für Stream-Operationen abgeleiteter Komponenten in geerbten Formularen.

WriteDescendent weist den Eigenschaften Ancestor und RootAncestor des Writer-Objekts die in AAncestor übergebenen Werte zu, setzt die Eigenschaft Root auf den in Root übergebenen Wert und ruft dann WriteSignature und WriteComponent auf, um Root und dessen Komponenten in den Stream des Writer-Objekts zu schreiben.

WriteDescendent unterscheidet sich von WriteComponent darin, daß die Methode durch das Setzen von Ancestor dessen Eigenschaftswerte anstelle der im Root-Typ definierten als Voreinstellungen verwendet.


TWriter::WriteFloat

TWriter	Siehe auch

Die Methode WriteFloat schreibt den in Value übergebenen Gleitkommawert in den Stream des Writer-Objekts.

void __fastcall WriteFloat(long double Value);

Beschreibung

WriteFloat wird intern vom Borland C++Builder-Streaming-System verwendet, um Komponenteneigenschaften in einen Stream zu schreiben. Mit WriteFloat können Sie Gleitkommadaten in einen Stream schreiben.

WriteFloat überprüft, ob Value den richtigen Typ enthält, bevor die Methode Write aufgerufen wird, die den Gleitkommawert und seinen Typ in den Stream schreibt.


TWriter::WriteIdent

TWriter	Siehe auch

Die Methode WriteIdent schreibt den in Ident übergebenen Bezeichner in den Stream des Writer-Objekts.

void __fastcall WriteIdent(const System::AnsiString Ident);

Beschreibung

WriteIdent wird intern vom Borland C++Builder-Streaming-System verwendet, um Komponenteneigenschaften in einen Stream zu schreiben. Mit WriteIdent können Sie Komponentenbezeichner-Eigenschaften in einen Stream schreiben. Komponentennamen und Aufzählungstypen sind Beispiele für Strings, in denen die Pascal-Bezeichnersyntax verwendet werden muß.

WriteFloat überprüft, ob Value den richtigen Typ enthält, bevor die Methode Write aufgerufen wird, die den Bezeichner und seinen Typ in den Stream schreibt.


TWriter::WriteInteger

TWriter	Siehe auch

WriteInteger schreibt den in Value übergebenen Integer in den Stream des Writer-Objekts.

void __fastcall WriteInteger(long Value);

Beschreibung

WriteInteger wird intern vom Borland C++Builder-Streaming-System verwendet, um Komponenteneigenschaften in einen Stream zu schreiben. Mit WriteInteger können Sie Integer-Eigenschaften von Komponenten in einen Stream schreiben.

WriteInteger überprüft, ob Value den richtigen Typ enthält, bevor die Methode Write aufgerufen wird, die den Integer und seinen Typ in den Stream schreibt. WriteInteger kann Integer unterschiedlicher Größe verarbeiten.


TWriter::WriteListBegin

TWriter	Siehe auch

Die Methode WriteListBegin schreibt eine Listenanfangsmarkierung in den mit dem Writer-Objekt verbundenen Stream.

void __fastcall WriteListBegin(void);

Beschreibung

WriteListBegin wird von anderen Methoden verwendet, die über Elemente iterieren, die in den Stream geschrieben werden sollen. WriteListBegin schreibt eine Listenanfangsmarkierung in den mit dem Writer-Objekt verbundenen Stream. Nach jedem Aufruf von WriteListBegin muß ein entsprechender Aufruf von WriteListEnd erfolgen.


TWriter::WriteListEnd

TWriter	Siehe auch

Die Methode WriteEndList schreibt eine Listenendemarkierung in den mit dem Writer-Objekt verbundenen Stream.

void __fastcall WriteListEnd(void);

Beschreibung

WriteListEnd wird von anderen Methoden verwendet, die über Elemente iterieren, die in den Stream geschrieben werden sollen.

Ein Aufruf von WriteListEnd folgt normalerweise auf eine Schreibschleife. Ein Aufruf von WriteListEnd muß einem vorangegangenen Aufruf von WriteListBegin entsprechen.


TWriter::WriteRootComponent

TWriter	Siehe auch

Die Methode WriteRootComponent dient der Abwärtskompatibilität.

void __fastcall WriteRootComponent(TComponent* Root);

Beschreibung

WriteRootComponent ruft WriteDescendent auf.


TWriter::WriteSignature

TWriter

Die Methode WriteSignature schreibt eine Borland C++Builder-Filer-Signatur in den mit dem Writer-Objekt verbundenen Stream.

void __fastcall WriteSignature(void);

Beschreibung

WriteSignature wird intern von verschiedenen Methoden aufgerufen, die die Filer-Signatur schreiben, bevor sie eine Operation durchführen. Die Methode WriteRootComponent beispielsweise ruft WriteSignature auf, bevor sie ihre Komponente in den Stream schreibt. Durch Überprüfen der Signatur vor dem Laden von Objekten schützen Reader-Objekte sich davor, unbeabsichtigt ungültige oder beschädigte Daten zu lesen.

Die Filer-Signatur besteht aus vier Zeichen. In dieser Version von Borland C++Builder lautet die Signatur 'TPF0'.


TWriter::WriteStr

TWriter	Siehe auch

Die Methode WriteStr schreibt unformatierte Daten in den Stream des Writer-Objekts.

void __fastcall WriteStr(const System::AnsiString Value);

Beschreibung

Rufen Sie WriteStr nicht direkt auf. Die Methode WriteStr wird intern von verschiedenen VCL-Komponenten genutzt. Sie schreibt den in Value übergebenen String in den Stream des Writer-Objekts.

Achtung

Verwenden Sie zum Schreiben von Komponentenstrings in Streams stets WriteString. Mit der Methode WriteStr können Daten beschädigt werden, wenn sie nicht richtig eingesetzt wird.


TWriter::WriteString

TWriter	Siehe auch

Die Methode WriteString schreibt formatierte Daten in den Stream des Writer-Objekts.

void __fastcall WriteString(const System::AnsiString Value);

Beschreibung

WriteString wird intern vom Borland C++Builder-Streaming-System verwendet, um Komponenteneigenschaften in einen Stream zu schreiben. Außerdem wird WriteString von Writer-Objekten für Komponenten in den Prozeduren DefineProperties und WriteData eingesetzt.

WriteString schreibt den in Value übergebenen String in den Stream des Writer-Objekts. WriteString prüft, ob Value den richtigen Typ enthält, bevor die Methode Write aufgerufen wird, die den String und seinen Typ in den Stream schreibt.

Achtung

Verwenden Sie stets WriteString, um Komponentenstrings in Streams zu schreiben. Die ähnlich benannte Methode WriteStr dient dem internen Einsatz durch verschiedene VCL-Komponenten. Ein fehlerhafter Einsatz dieser Methode kann zu Beschädigungen der Daten führen.


Hierarchie

TObject

TFiler


TWriter Beispiel

TWriter


Application (Variable)

Siehe auch

Mit Application wird für ein Projekt die Instanz einer Anwendung deklariert.

extern TApplication* Application;

Header

vcl\forms.hpp

Beschreibung

Bei der Erstellung eines neuen Projekts erzeugt Delphi standardmäßig ein Anwendungsobjekt und weist es Application zu. Application besitzt verschiedene Eigenschaften, mit denen Informationen über eine laufende Anwendung abgerufen werden können. Eine Liste dieser Eigenschaften finden Sie bei der Beschreibung der Komponente TApplication.

Beispiel

Der folgende Code zeigt den Namen Ihres Projekts in einem Eingabefeld an:

void __fastcall TForm1::Button1Click(TObject *Sender)

{

Edit1->Text = Application->Title;

}


Automation (Variable)

Siehe auch

Automation ist eine globale Instanz der Klasse TAutomationManager.

extern TAutomation* Automation;

Header

vcl\oleauto.hpp

Beschreibung

Die Variable Automation fungiert als Automatisierungs-Manager eines in Delphi programmierten OLE-Automatisierungs-Servers.

Bei der Erstellung eines OLE-Automatisierungsobjekts (ein von TAutoObject abgeleitetes Objekt) muß die definierende Unit Automation.RegisterClass aufrufen und einen Datensatz des Typs TAutoClassInfo übergeben. Der Automatisierungs-Manager verwaltet dann alle Interaktionen zwischen dem Automatisierungsobjekt und der OLE-Automatisierungs-API.


CmdShow (Variable)

Siehe auch

CmdShow wird an die Windows-API-Funktion ShowWindow übergeben.

extern int CmdShow;

Header

vcl\system.hpp

Beschreibung

In einem Programm enthält die Variable CmdShow den Parameterwert, den Windows für die Übergabe an ShowWindow erwartet, wenn das Hauptfenster der Anwendung erzeugt wird.

In einer Bibliothek hat CmdShow immer den Wert Null.


Formatvariablen für Währungs- und Datums-/Zeitangaben

Es handelt sich dabei um eine Gruppe von Variablen, mit denen das Format für Datums- und Zeit-Strings festgelegt werden kann.

extern System::AnsiString CurrencyString;

extern Byte CurrencyFormat;

extern Byte NegCurrFormat;

extern char ThousandSeparator;

extern char DecimalSeparator;

extern Byte CurrencyDecimals;

extern char DateSeparator;

extern System::AnsiString ShortDateFormat;

extern System::AnsiString LongDateFormat;

extern char TimeSeparator;

extern System::AnsiString TimeAMString;

extern System::AnsiString TimePMString;

extern System::AnsiString ShortTimeFormat;

extern System::AnsiString LongTimeFormat;

extern System::AnsiString ShortMonthNames[12];

extern System::AnsiString LongMonthNames[12];

extern System::AnsiString ShortDayNames[7];

extern System::AnsiString LongDayNames[7];

Header

vcl\sysdefs.hpp

Beschreibung

Die Unit SysUtils enthält eine Anzahl von Variablen, die von Datums- und Zeitroutinen verwendet werden. Durch die Zuweisung von Werten an diese Variablen wird das Format von Datums- und Zeit-Strings festgelegt. Die Anfangswerte der Variablen werden aus der Registrierdatenbank ermittelt. Dies geschieht mit Hilfe der Funktion GetLocaleInfo in der Win32-API. Delphi VCL-Anwendungen (dies sind keine Konsolenanwendungen) aktualisieren diese Formatvariablen automatisch als Antwort auf WM_WININICHANGE-Botschaften. Über Application.UpdateFormatSettings kann eine Änderung der Systemeinstellungen erlaubt oder verhindert werden. Die Voreinstellung für UpdateFormatSettings lautet True. Wenn diese Eigenschaft auf False gesetzt wird, können die Systemeinstellungen nicht verändert werden.

In der nachstehenden Beschreibung der einzelnen Variablen ist die LOCALE_XXXX-Konstante angegeben, über die der Anfangswert (unter Verwendung der Funktion GetLocaleInfo der Win32-API) abgerufen werden kann.

Typisierte Konstante	Beschreibung

CurrencyString	CurrencyString legt das Währungssymbol (bzw. die Zeichen für die Währung) fest, das bei der Umwandlung von Gleitkomma- in Dezimalwerte verwendet wird. Der Anfangswert wird aus LOCALE_SCURRENCY abgerufen.

CurrencyFormat	CurrencyFormat legt die Plazierung und das Trennzeichen für das Währungssymbol fest, das bei der Umwandlung von Gleitkomma- in Dezimalwerte verwendet wird. Folgende Werte sind möglich:

0 = '$1'

1 = '1$'

2 = '$ 1'

3 = '1 $'

Der Anfangswert wird aus LOCALE_ICURRENCY abgerufen.

NegCurrFormat	NegCurrFormat legt das Währungsformat fest, das bei der Umwandlung negativer Gleitkommawerte in Dezimalwerte verwendet wird. Folgende Werte sind möglich:

0 = ($1)    4 = (1$)    8 = -1 $    12 = $ -1

1 = -$1     5 = -1$     9 = -$ 1    13 = 1- $

2 = $-1     6 = 1-$    10 = 1 $-    14 = ($ 1)

3 = $1-     7 = 1$-    11 = $ 1-    15 = (1 $)

Der Anfangswert wird aus LOCALE_INEGCURR abgerufen.

ThousandSeparator	ThousandSeparator ist das Zeichen, das in Zahlen, die links vom Dezimaltrennzeichen mehr als drei Stellen aufweisen, zur Abtrennung der Tausenderstellen benutzt wird. Der Anfangswert wird aus LOCALE_STHOUSAND abgerufen.

DecimalSeparator	DecimalSeparator ist das Zeichen, das in einer Zahl den ganzzahligen Teil vom Bruch abtrennt. Der Anfangswert wird aus LOCALE_SDECIMAL abgerufen.

CurrencyDecimals	CurrencyDecimals legt die Anzahl der Stellen rechts neben dem Dezimaltrennzeichen in einem Währungsbetrag fest. Der Anfangswert wird aus LOCALE_ICURRDIGITS abgerufen.

DateSeparator	DateSeparator ist das Zeichen, das zur Trennung der Jahres-, Monats- und Tageskomponenten eines Datumswertes verwendet wird. Der Anfangswert wird aus LOCATE_SDATE abgerufen.

ShortDateFormat	ShortDateFormat ist der Format-String, mit dem ein Datumswert in einen kurzen String umgewandelt wird, der dann bearbeitet werden kann. Ausführliche Informationen über Format-Strings für Datums- und Zeitangaben finden Sie in der Beschreibung der Funktion FormatDateTime. Im kurzen Datumsformat werden nur das Datumstrennzeichen und die Formatbezeichner m, mm, d, dd, yy und yyyy benutzt. Der Anfangswert wird aus LOCALE_SSHORTDATE abgerufen.

TimeSeparator	TimeSeparator ist das Zeichen, das zur Trennung der Stunden-, Minuten- und Sekundenkomponenten einer Zeitangabe verwendet wird. Der Anfangswert wird aus LOCALE_STIME abgerufen.

TimeAMString	TimeAMString ist der Suffix-String, der im 12-Stundenformat für Zeitangaben zwischen 00:00 und 11:59 verwendet wird. Der Anfangswert wird aus LOCALE_S1159 abgerufen.

TimePMString	TimeAMString ist der Suffix-String, der im 12-Stundenformat für Zeitangaben zwischen 12:00 und 23:59 verwendet wird. Der Anfangswert wird aus LOCALE_S2359 abgerufen.

ShortTimeFormat	ShortTimeFormat ist der Format-String, mit dem eine Zeitangabe in einen kurzen String umgewandelt wird, der nur die Stunden und Minuten enthält. Der vorgegebene Wert wird aus LOCALE_ITIME und LOCALE_ITLZERO berechnet.

LongTimeFormat	LongTimeFormat ist der Format-String, mit dem eine Zeitangabe in einen langen String umgewandelt wird, der die Stunden, Minuten und Sekunden enthält. Der vorgegebene Wert wird aus LOCALE_ITIME und LOCALE_ITLZERO berechnet.

ShortMonthNames	ShortMonthNames ist das String-Array, das die kurzen Monatsnamen enthält. Der in einem Format-String an FormatDateTime übergebene Formatbezeichner mmm sorgt für die Ersetzung eines kurzen Monatsnamens. Die vorgegebenen Werte werden aus den Einträgen der System-Sprachtreiberstruktur LOCALE_SABBREVMONTHNAME abgerufen.

LongMonthNames	LongMonthNames ist das String-Array, das die langen Monatsnamen enthält. Der in einem Format-String an FormatDateTime übergebene Formatbezeichner mmmm sorgt für die Ersetzung eines langen Monatsnamens. Die vorgegebenen Werte werden aus den Einträgen der System-Sprachtreiberstruktur LOCALE_SMONTHNAME abgerufen.

ShortDayNames	ShortDayNames ist das String-Array, das die kurzen Tagesnamen enthält. Der in einem Format-String an FormatDateTime übergebene Formatbezeichner ddd sorgt für die Ersetzung eines kurzen Tagesnamens. Die vorgegebenen Werte werden aus den Einträgen der System-Sprachtreiberstruktur LOCALE_SABBREVDAYNAME abgerufen.

LongDayNames	LongDayNames ist das String-Array, das die langen Tagesnamen enthält. Der in einem Format-String an FormatDateTime übergebene Formatbezeichner dddd sorgt für die Ersetzung eines langen Tagesnamens. Die vorgegebenen Werte werden aus den Einträgen der System-Sprachtreiberstruktur LOCALE_SDAYNAME abgerufen.

Beispiel

In diesem Beispiel wird ein Formular mit einer Beschriftung und einer Schaltfläche verwendet. Wenn der Benutzer auf die Schaltfläche klickt, wird im Titel der Beschriftung das aktuelle Datum angezeigt. Das Format des Datums in der Beschriftung ändert sich, da einigen Datumsvariablen neue Werte zugewiesen werden. So wird das Datum 15.9.94 folgendermaßen angezeigt: 15-09-1994.

void __fastcall TForm1::Button1Click(TObject *Sender)

{

TDateTime Date;

DateSeparator = '-';

Label1->Caption = DateToStr(Date);

}


DLLProc (Variable)

Siehe auch

DLLProc ist ein Zeiger auf eine Prozedur, die durch einen DLL-Eintrittspunkt aufgerufen wird.

extern void *DllProc;

Header

vcl\system.hpp

Beschreibung

Mit der Variablen DLLProc geben Sie eine Prozedur an, die aktiviert wird, sobald der Eintrittspunkt einer DLL aufgerufen wird. Eine Prozedur, die DLLProc zugewiesen wird, muß einen Parameter des Typs Integer übernehmen, z.B.:

void __fastcall DllProcedure(int Reason);

Beim Aufruf der Prozedur enthält der Parameter einen Wert zwischen 0 und 3. Dieser Wert ist in der folgenden Gruppe von Konstanten in der Unit Windows definiert:

DLL_PROCESS_DETACH = 0;

DLL_PROCESS_ATTACH = 1;

DLL_THREAD_ATTACH  = 2;

DLL_THREAD_DETACH  = 3;


Dateimodus-Konstanten

Dateimodus-Konstanten werden zum Öffnen und Schließen von Dateien auf dem Datenträger verwendet.

#define fmClosed (int)(55216)

#define fmInput (int)(55217)

#define fmOutput (int)(55218)

#define fmInOut (int)(55219)

Header

vcl\sysutils.hpp

Beschreibung

Verwenden Sie die Dateimodus-Konstanten zum Öffnen und Schließen von Festplattendateien. Das Feld Mode von TFileRec und TTextRec enthält einen dieser Werte.


Zugriffsmodus-Konstanten

Die folgenden Konstanten steuern den Zugriffsmodus für Dateien und Streams.

#define fmOpenRead (Byte)(0)

#define fmOpenWrite (Byte)(1)

#define fmOpenReadWrite (Byte)(2)

#define fmShareCompat (Byte)(0)

#define fmShareExclusive (Byte)(16)

#define fmShareDenyWrite (Byte)(32)

#define fmShareDenyRead (Byte)(48)

#define fmShareDenyNone (Byte)(64)

Header

vcl\sysutils.hpp

Beschreibung

Über die Dateiöffnungsmodus-Konstanten kann die Möglichkeit zur gemeinsamen Nutzung einer geöffneten Datei bzw. eines geöffneten Streams gesteuert werden.

TFileStream.Create verfügt über einen Mode-Parameter, der auf eine der folgenden Konstanten gesetzt werden kann.

Constant	Definition

fmOpenRead	Nur Lesezugriff.

fmOpenWrite	Nur Schreibzugriff.

fmOpenReadWrite	Lese- und Schreibzugriff.

fmShareCompat	Kompatibel zu dem Verfahren, mit dem FCBs geöffnet werden.

fmShareExclusive	lese- und Schreibzugriff verweigert.

fmShareDenyWrite	Schreibzugriff verweigert.

fmShareDenyRead	Lesezugriff verweigert.

fmShareDenyNone	Andere haben uneingeschränkten Zugriff.


FileMode (Variable)

Siehe auch

FileMode gibt den Zugriffsmodus für typisierte und nicht typisierte Dateien an, die mit Reset geöffnet wurden.

extern Byte FileMode;

Header

vcl\system.hpp

Beschreibung

Die Variable FileMode legt den Zugriffsmodus fest, wenn typisierte und nicht typisierte Dateien (keine Textdateien) mit der Reset-Prozedur geöffnet werden.

Der Vorgabewert für FileMode lautet 2. Wenn Sie dieser Variablen einen anderen Wert zuweisen, wird der betreffende Modus für alle folgenden Reset-Prozeduren verwendet.

FileMode kann folgende Werte annehmen:

0	Nur Lesen

1	Nur Schreiben

2	Lesen/Schreiben


HInstance (Variable)

HInstance ist ein Handle, das von Windows für eine Anwendung oder eine Bibliothek zur Verfügung gestellt wird.

extern HINSTANCE HInstance;

Header

vcl\system.hpp

Beschreibung

Die Variable HInstance enthält das von der Windows-Umgebung bereitgestellte Instanz-Handle der Anwendung oder Bibliothek.


IsLibrary (Variable)

IsLibrary ist eine boolesche Variable mit dem Wert True, wenn das Modul eine DLL ist.

extern bool IsLibrary;

Header

vcl\system.hpp

Beschreibung

Die Variable IsLibrary hat den Wert True, wenn es sich bei dem Modul um eine DLL handelt.


IsMultiThread (Variable)

IsMultiThread ist eine boolesche Variable, die von BeginThread auf True gesetzt wird.

extern bool IsMultiThread;

Header

vcl\system.hpp

Beschreibung

IsMultiThread wird von BeginThread auf True gesetzt, damit der Speicher-Manager auch in einer Delphi-Anwendung mit mehreren Threads korrekt ausgeführt wird. Der Versuch eines zweiten Thread, Speicher zu belegen, wird so lange blockiert, bis der erste Thread den Speicher-Manager nicht mehr benötigt.


LongRec (Typ)

LongReg speichert höher- und niederwertige Bytes für die angegebene Variable als Word.

struct LongRec {

Word Lo;

Word Hi; };

Header

vcl\sysutils.hpp

Beschreibung

LongRec deklariert einen Hilfsdatensatz, in dem die höher- und niederwertigen Bytes der angegebenen Variable im Typ Word gespeichert werden.

LongRec ist bei der Typumwandlung von 4-Byte-Datentypen (Zeigern, Integern usw.) hilfreich, da damit separat auf die nieder- und höherwertigen Words zugegriffen werden kann.


MSecsPerDay (Konstante)

MSecsPerDay enthält die Anzahl der Millisekunden pro Tag.

#define MSecsPerDay (int)(86400000)

Header

vcl\sysutils.hpp

Beschreibung

Die Variable MSecsPerDay deklariert die Anzahl der Millisekunden pro Tag.


SecsPerDay (Konstante)

SecsPerDay enthält die Anzahl der Sekunden pro Tag.

#define SecsPerDay (int)(86400)

Header

vcl\sysutils.hpp

Beschreibung

Die Variable SecsPerDay deklariert die Anzahl der Sekunden pro Tag.


Null (Konstante)

Die Konstante Null kennzeichnet eine Variante, die nicht mit einem Wert initialisiert wurde.

extern Variant Null;

Header

vcl\system.hpp

Beschreibung

Mit der Konstante Null kann eine Variante markiert werden, der noch kein Wert zugewiesen wurde, die aber bereits initialisiert ist (und daher nicht den Status Unassigned hat). Null wird in Datenbankanwendungen zum Anzeigen von fehlenden oder unbekannten Daten verwendet.

Null-Werte werden über Ausdrücke weitergegeben. Bei der Verwendung in einem Ausdruck mit Variant-Werten führt eine Null-Variable dazu, daß das Ergebnis des gesamten Ausdrucks Null ist.

Um eine Variantenvariable auf Null zu setzen, muß ihr nur die Null-Konstante zugewiesen werden. Durch einen Vergleich eines Variantenwertes mit Null oder mit Hilfe der Standardfunktion VarIsNull kann festgestellt werden, ob der Variantenwert Null ist. Wenn die Standardfunktion VarType für eine leere Variante eingesetzt wird, liefert sie varNull zurück.

Die Zuweisung von Null an eine Variable, die nicht vom Typ Variant ist, führt zu einer EVariantError-Exception. Der Versuch, eine leere (Null)-Variante (mit VarAsTyp oder VarCast) in einen anderen Typ umzuwandeln, führt ebenfalls zu einer EVariantError-Exception.


NullStr (Konstante)

NullStr deklariert einen Zeiger auf EmptyStr.

extern System::AnsiString *NullStr;

Header

vcl\sysutils.hpp

Beschreibung

NullStr ist der Rückgabewert vieler Routinen zur String-Verarbeitung, wenn der String leer ist.


Screen (Variable)

Screen ist eine TScreen-Komponente. Normalerweise repräsentiert sie ein Bildschirmgerät.

extern TScreen* Screen;

Header

vcl\forms.hpp

Die Variable Screen ist eine TScreen-Komponente, die in der Regel ein Bildschirmgerät repräsentiert. Eine Anwendung erzeugt standardmäßig eine Bildschirmkomponente basierend auf den Informationen, die Windows über das aktuelle Bildschirmgerät bereithält, und weist diese Komponente an Screen zu.

Beispiel

Der folgende Code stellt die Breite des Formulars Form1 auf die halbe Bildschirmbreite ein:

Form1->Width = Screen->Width/2;


Session (Variable)

Session verwaltet die von der Anwendung benutzten Datenbankkomponenten.

Declaration

extern TSession* Session;

Header

vcl\db.hpp

Beschreibung

Die Variable Session ist für die Verwaltung aller Datenbankkomponenten verantwortlich, die eine Anwendung verwendet. Sie wird automatisch während der Initialisierung der Anwendung erzeugt und bei der Beendigung der Anwendung wieder freigegeben. Die Session-Variable muß jederzeit aktiv sein. Sie darf nicht freigegeben und dann neu erzeugt werden.


Sessions (Variable)

Sessions ermöglicht den Zugriff auf die Methoden und Eigenschaften von TSessionList.

Declaration

extern TSessionList* Sessions;

Header

vcl\db.hpp

Beschreibung

Die Variable Sessions bietet eine Möglichkeit für den Zugriff auf die Methoden und Eigenschaften von TSessionList, die zur Verwaltung von Arbeitssitzungen dienen. Da die Unit DB die Variable Sessions automatisch erzeugt und auch wieder freigibt, brauchen Sie die Variable nur einzusetzen.

Verwechseln Sie die Sessions-Variable nicht mit der Variablen Session. Letztere ist für die Verwaltung aller Datenbankkomponenten verantwortlich, die eine Anwendung verwendet. Die Session-Variable wird automatisch während der Initialisierung der Anwendung erzeugt und bei der Beendigung der Anwendung wieder freigegeben. Die Session-Variable muß jederzeit aktiv sein. Sie darf nicht freigegeben und dann erneut erzeugt werden.


TAlign (Typ)

TAlign definiert Werte für die Eigenschaft Align.

enum TAlign { alNone, alTop, alBottom, alLeft, alRight, alClient };

Header

vcl\controls.hpp

Beschreibung

Mit TAlign werden die zulässigen Werte für die Eigenschaft Align festgelegt.


TAlignment (Typ)

TAlignment definiert Werte für die Eigenschaft Alignment.

enum TAlignment { taLeftJustify, taRightJustify, taCenter };

Header

vcl\classes.hpp

Beschreibung

TAlignment ist der Typ für die Eigenschaft Alignment.


TAttachMode (Typ)

TAttachMode legt die Möglichkeiten fest, mit denen ein Element in einem Gliederungsdiagramm an eine neue Position verschoben werden kann.

enum TAttachMode { oaAdd, oaAddChild, oaInsert };

Header

vcl\outline.hpp

Beschreibung

TAttachMode ist der Typ des AttachMode-Parameters für eine MoveTo-Methode. TAttachMode legt die Möglichkeiten fest, mit denen ein Element in einem Gliederungsdiagramm an einer neuen Position plaziert wird, wenn es in innerhalb des Diagramms verschoben wird.


TAutoClass (Typ)

TAutoClass ist der Klassenreferenztyp für OLE-Automatisierungsobjekte.

typedef System::TMetaClass*TAutoClass;

Header

vcl\oleauto.hpp

Beschreibung

Der Typ TAutoClass ist der Klassenreferenztyp für OLE-Automatisierungsobjekte.


TAutoClassInfo (Typ)

Siehe auch

Mit dem Record TAutoClassInfo werden OLE-Automatisierungsobjekte registriert.

struct TAutoClassInfo {

System::TMetaClass*AutoClass;

System::AnsiString ProgID;

System::AnsiString ClassID;

System::AnsiString Description;

TAutoClassInstancing Instancing; };

Header

vcl\oleauto.hpp

Beschreibung

Der Typ TAutoClassInfo ist der Informationsdatensatz, der für die Registrierung von OLE-Automatisierungsobjekten benutzt wird.


TAutoClassInstancing (Typ)

Siehe auch

TAutoClassInstancing definiert die Instantiierungsmodi, die für lokale Server-Automatisierungsklassen verfügbar sind.

enum TAutoClassInstancing { acInternal, acSingleInstance, acMultiInstance };

Header

vcl\oleauto.hpp

Beschreibung

Der Typ TAutoClassInstancing legt die Instantiierungsmodi fest, die für lokale Server-Automatisierungsklassen verfügbar sind.


TBatchMode (Typ)

TBatchMode-Werte werden an die Methode BatchMove für eine TTable-Komponente oder die Eigenschaft Mode einer TBatchMove-Komponente übergeben.

enum TBatchMode { batAppend, batUpdate, batAppendUpdate, batDelete, batCopy };

Header

vcl\dbtables.hpp

Beschreibung

Der Typ TBatchMode besteht aus der Menge der Werte, die an die BatchMove-Methode einer TTable-Komponente bzw. die Mode-Eigenschaft einer TBatchMove-Komponente übergeben werden. Mit batAppend werden alle Datensätze angefügt. (Im Ziel darf kein Datensatz vorhanden sein, der denselben Schlüssel wie ein Datensatz in der Quelle aufweist.) batUpdate ersetzt alle vorhandenen Datensätze durch die neuen Versionen. (Für jeden Datensatz in der Quelle muß im Ziel ein Datensatz mit einem identischen Schlüssel existieren.) batAppendUpdate fügt Datensätze an, die noch nicht existieren, und ersetzt diejenigen, die bereits vorhanden sind. batDelete löscht die Quelldatensätze aus dem Ziel. (Dabei muß jeder Quelldatensatz einen Schlüssel aufweisen, der auch im Ziel existiert.) batCopy erstellt ein exaktes Duplikat von der Quelltabelle.


TBevelShape (Typ)

TBevelShape definiert die zulässigen Werte für die Shape-Eigenschaft von TBevel.

enum TBevelShape { bsBox, bsFrame, bsTopLine, bsBottomLine, bsLeftLine, bsRightLine };

Header

vcl\extctrls.hpp

Beschreibung

Der Typ TBevelShape definiert die Werte, die für die Shape-Eigenschaft der Komponente TBevel zulässig sind.


TBevelStyle (Typ)

TBevelStyle definiert die zulässigen Werte für die Style-Eigenschaft von TBevel.

enum TBevelStyle { bsLowered, bsRaised };

Header

vcl\extctrls.hpp

Beschreibung

Der Typ TBevelStyle definiert die Werte, die für die Style-Eigenschaft der Komponente TBevel zulässig sind.


TBevelWidth (Typ)

TBevelWidth definiert die zulässigen Werte für die BevelWidth-Eigenschaft von TPanel.

 typedef int TBevelWidth;

Header

vcl\extctrls.hpp

Beschreibung

Der Typ TBevelWidth definiert die Werte, die für die BevelWidth-Eigenschaft einer Tafel (TPanel) zulässig sind.


TBitBtnKind (Typ)

TBitBtnKind enthält die zulässigen Werte für die Kind-Eigenschaft von TBitBtn.

enum TBitBtnKind { bkCustom, bkOK, bkCancel, bkHelp, bkYes, bkNo, bkClose, bkAbort, bkRetry, bkIgnore, bkAll };

Header

vcl\buttons.hpp

Beschreibung

Der Typ TBitBtnKind enthält die Werte, die die Eigenschaft Kind einer TBitBtn-Bitmap-Schaltfläche annehmen kann.


TBlobStreamMode (Typ)

TBlobStreamModen übergibt Werte an die Methode Create eines TBlobStream-Objekts.

enum TBlobStreamMode { bmRead, bmWrite, bmReadWrite };

Header

vcl\dbtables.hpp

Beschreibung

Der Typ TBlobStreamMode enthält die Menge der Werte, die an die Methode Create eines TBlobStream-Objekts übergeben werden. Mit bmRead kann auf vorhandene TBlobField-, TMemoField- und TGraphicField-Objekte zugegriffen werden. Zum Löschen des Feldinhalts und Zuweisen eines neuen Wertes verwenden Sie bmWrite. Mit bmReadWrite kann ein existierender Wert geändert werden.


TBlobType (Typ)

TBlobType definiert die BlobType-Eigenschaft für TBlobField-Komponenten.

typedef TFieldType TBlobType;

Header

vcl\dbtables.hpp

Beschreibung

Der Typ TBlobType besteht aus einer Untermenge der Werte des Typs TFieldType und umfaßt BLOB-Felder. TBlobType ist der Typ der BlobType-Eigenschaft für TBlobField-Komponenten.


TBookmark (Typ)

Siehe auch

TBookmark ist ein Zeiger, der an die Methoden GetBookmark, GotoBookmark und FreeBookmark übergeben wird.

typedef void *TBookmark;

Header

vcl\db.hpp

Beschreibung

Der Typ TBookmark bezeichnet den Typ des Bookmark-Parameters, der bei Aufrufen der Methoden GetBookmark, GotoBookmark und FreeBookmark einer Datenmengenkomponente übergeben wird.


TBorderIcons (Typ)

TBorderIcons definiert die Symbole, die in der Titelleiste eines Formulars angezeigt werden.

typedef Set<TBorderIcon, biSystemMenu, biHelp> TBorderIcons;

Header

vcl\forms.hpp

Beschreibung

Der Typ TBorderIcons legt die Symbole fest, die in der Titelleiste eines Formulars angezeigt werden. TBorderIcons ist der Typ für die Eigenschaft BorderIcons.


TBorderStyle (Typ)

TBorderStyle wird für die BorderStyle-Eigenschaft von Formularen und Fenstern verwendet.

typedef TFormBorderStyle TBorderStyle;

TBorderStyle ist der Typ der BorderStyle-Eigenschaft für Steuerelemente.

Header

vcl\forms.hpp

Beschreibung

Die Eigenschaft BorderStyle von Formularen und Fenstern verwendet den Typ TFormBorderStyle.


TBorderWidth (Typ)

TBorderWidth definiert die zulässigen Werte für die BorderWidth-Eigenschaft von TPanel.

typedef int TBorderWidth;

Header

vcl\extctrls.hpp

Beschreibung

Der Typ TBorderWidth definiert die Werte, die für die BorderWidth-Eigenschaft einer Tafelkomponente (TPanel) zulässig sind.


TBrushStyle (Typ)

TBrushStyle wird bei der Definition eines TBrush-Objekts für die Style-Eigenschaft verwendet.

enum TBrushStyle { bsSolid, bsClear, bsHorizontal, bsVertical, bsFDiagonal, bsBDiagonal, bsCross, bsDiagCross };

Header

vcl\graphics.hpp

Beschreibung

Der Typ TBrushStyle wird von der Style-Eigenschaft zur Bestimmung des Füllmusters für ein TBrush-Objekt benutzt.


TButtonLayout (Typ)

TButtonLayout definiert die Werte für die Layout-Eigenschaft von TBitBtn- und TSpeedButton-Objekten.

enum TButtonLayout { blGlyphLeft, blGlyphRight, blGlyphTop, blGlyphBottom};

Header

vcl\buttons.hpp

Beschreibung

Der Typ TButtonLayout definiert die Werte der Eigenschaft Layout, die eine Bitmap-Schaltfläche (TBitBtn) oder ein Mauspalettenschalter (TSpeedButton) annehmen kann.


TButtonSet (Typ)

TButtonSet besteht aus einer Menge von Schaltflächen für eine TMediaPlayer-Komponente.

typedef Set<TNavigateBtn, nbFirst, nbRefresh> TButtonSet;

Header

vcl\mplayer und dbctrls.hpp

Beschreibung

Der Typ TButtonSet enthält eine Menge von Schaltflächen, die zu der TMediaPlayer-Komponente gehören. Diese Menge wird eingesetzt, wenn Sie mit den Eigenschaften ColoredButtons, EnabledButtons und VisibleButtons festlegen, wie die Schaltflächen angezeigt werden sollen. Der Typ TButtonSet definiert die Werte, die für die VisibleButtons-Eigenschaft eines Datenbanknavigators zulässig sind.


TButtonStyle (Typ)

TButtonStyle definiert die Werte für die Style-Eigenschaft von TBitBtn- und TSpeedButton-Objekten.

enum TButtonStyle { bsAutoDetect, bsWin31, bsNew };

Header

vcl\buttons.hpp

Beschreibung

Der Typ TButtonStyle enthält die Werte der Eigenschaft Style, die eine Bitmap-Schaltfläche (TBitBtn) oder ein Mauspalettenschalter (TSpeedButton) annehmen kann.


TByteArray (Typ)

TByteArray ist ein allgemeines Array des Typs Byte.

typedef TByteArray *PByteArray;

Header

vcl\sysutils.hpp

Beschreibung

TByteArray deklariert ein allgemeines Array des Typs Byte, das für die Typumwandlung eingesetzt werden kann.


TCaption (Typ)

TCaption definiert den String-Typ, der für die Titel von Steuerelementen benutzt wird.

typedef System::AnsiString TCaption;

Header

vcl\controls.hpp

Beschreibung

Der Typ TCaption definiert den String-Typ, der für die Titel von Steuerelementen verwendet wird. TCaption ist der Typ für die Eigenschaften Caption und Text.


TChangeRange (Typ)

ChangeRange legt die gültigen Werte für die Methode ChangeLevelBy fest.

typedef Shortint TChangeRange;

Header

vcl\outline.hpp

Beschreibung

Der Typ TChangeRange definiert die zulässigen Werte, die an die Methode ChangeLevelBy übergeben werden können. Der Wert -1 verschiebt ein Element im Gliederungsdiagramm um eine Ebene nach oben, der Wert 1 verschiebt das Element um eine Ebene nach unten. Der Wert 0 hat keine Auswirkungen.


TCheckBoxState (Typ)

TCheckBoxState definiert die State-Eigenschaft von TCheckBox-Komponenten.

enum TCheckBoxState { cbUnchecked, cbChecked, cbGrayed };

Header

vcl\stdctrls.hpp

Beschreibung

Der Typ TCheckBoxState definiert die Statusarten, die für ein Kontrollfeld zulässig sind. TCheckBoxState ist der Typ für die State-Eigenschaft eines TCheckBox-Steuerelements.


TColor (Typ)

Mit TColor kann die Farbe eines Objekts festgelegt werden.

enum TColor {clMin=-0x7fffffff-1, clMax=0x7fffffff};

Header

vcl\graphics.hpp

Beschreibung

Mit dem Typ TColor wird die Farbe eines Objekts festgelegt. Dieser Typ wird von der Color-Eigenschaft vieler Komponenten und von der BackgroundColor-Eigenschaft für Registersätze (TTabSet) verwendet.

In der Unit Graphics sind Konstanten für TColor definiert. Diese Konstanten werden entweder direkt auf die ähnlichste Farbe in der Systempalette abgebildet (z.B. clBlue auf die Farbe Blau) oder aber auf die entsprechende Systemfarbe für Bildschirmelemente, die im Dialogfeld Farben der Windows-Systemsteuerung definiert ist (z.B. clBtnFace auf die Systemfarbe für Schaltflächen).

Folgende Konstanten werden auf die ähnlichsten Systemfarben abgebildet: clAqua, clBlack, clBlue, clDkGray, clFuchsia, clGray, clGreen, clLime, clLtGray, clMaroon, clNavy, clOlive, clPurple, clRed, clSilver, clTeal, clWhite und clYellow.

Bei den folgenden Konstanten erfolgt eine Abbildung auf die entsprechende Systemfarbe für Bildschirmelemente: clActiveBorder, clActiveCaption, clAppWorkSpace, clBackground, clBtnFace, clBtnHighlight, clBtnShadow, clBtnText, clCaptionText, clGrayText, clHighlight, clHighlightText, clInactiveBorder, clInactiveCaption, clInactiveCaptionText, clMenu, clMenuText, clScrollBar, clWindow, clWindowFrame und clWindowText.

Wenn Sie zur Festlegung von TColor nicht die Konstanten der Graphics-Unit, sondern eine 4-Byte-Hexadezimalzahl verwenden, repräsentierten die drei niederwertigen Bytes die RGB-Farbintensität für Blau, Grün und Rot. Der Wert $00FF0000 steht für ein reines Blau mit voller Intensität, der Wert $0000FF00 für reines Grün und der Wert $000000FF für reines Rot. $00000000 steht für Schwarz und $00FFFFFF für Weiß.

Wenn das höchstwertige Byte Null ($00) ist, erhalten Sie eine Farbe, die derjenigen in der Systempalette am ähnlichsten ist. Ist das höchstwertige Byte Eins ($01), ergibt das eine Farbe, die derjenigen in der aktuell realisierten Palette am ähnlichsten ist. Wenn Sie das höchstwertige Byte auf Zwei ($02) setzen, wird der Wert an die ähnlichste Farbe in der logischen Palette des aktuellen Gerätekontexts angepaßt.


TColorDialogOptions (Typ)

TColorDialogOptions deklariert Optionen, die von der Eigenschaft Options der Komponente TColorDialog benutzt werden.

typedef Set<TColorDialogOption, cdFullOpen, cdAnyColor>  TColorDialogOptions;

Header

vcl\dialogs.hpp

Beschreibung

Der Typ TColorDialogOptions deklariert drei im Typ TColorDialogOption als Elemente einer Menge enthaltenen Optionen, die von der Options-Eigenschaft der Komponente TColorDialog verwendet werden.


TColumnButtonStyle (Typ)

TColumnButtonStyle definiert die zulässigen Werte für die ButtonStyle-Eigenschaft von TColumn.

enum TColumnButtonStyle { cbsAuto, cbsEllipsis, cbsNone };

Header

vcl\dbgrids.hpp

Beschreibung

Der Typ TColumnButtonStyle definiert die Werte, die für die ButtonStyle-Eigenschaft einer TColumn-Komponente zulässig sind. Damit können die Möglichkeiten festgelegt werden, die der Benutzer zur Auswahl von Werten für die betreffende Spalte hat. Die folgende Tabelle enthält eine Beschreibung der möglichen Werte:

Wert	Beschreibung

cbsAuto	Ist das Feld der Spalte ein Lookup-Feld oder ist ihm eine Auswahlliste zugewiesen, zeigt TDBGrid ein Kombinationsfeld in der Spalte an. Der Benutzer kann die Liste dann öffnen und einen Wert auswählen.

cbsEllipsis	In der Spalte wird immer eine Ellipsen-Schaltfläche angezeigt, über die der Benutzer per Mausklick einen Wert auswählen kann. Beim Klicken auf die Ellipsen-Schaltfläche wird ein OnEditButtonClick-Ereignis ausgelöst.

cbsNone	Es wird weder ein Kombinationsfeld noch eine Ellipsen-Schaltfläche angezeigt, die dem Benutzer eine Auswahl aus der Liste ermöglicht. Dies gilt auch dann, wenn das Feld der Spalte ein Lookup-Feld ist oder ihm eine Auswahlliste zugewiesen ist.


TColumnValues (Typ)

TColumnValues definiert die zulässigen Werte für die AssignedValues-Eigenschaft von TColumn.

typedef Set<TColumnValue, cvColor, cvTitleFont>  TColumnValues;

Header

vcl\dbgrids.hpp

Beschreibung

Der Typ TColumnValues listet die Werte auf, die für die Spalte und ihren Titel (Objekt TColumnTitle) festgelegt werden können. Diese Werte und ihre Bedeutung sind in der folgenden Tabelle aufgeführt:

Wert	Beschreibung

cvColor	Wenn cvColor in AssignedValues enthalten ist, hat die Color-Eigenschaft der Spalte nicht mehr den voreingestellten Wert.

cvWidth	Wenn cvWidth in AssignedValues enthalten ist, hat die Width-Eigenschaft der Spalte nicht mehr den voreingestellten Wert.

cvFont	Wenn cvFont in AssignedValues enthalten ist, hat die Font-Eigenschaft der Spalte nicht mehr den voreingestellten Wert.

cvAlignment	Wenn cvAlignment in AssignedValues enthalten ist, hat die Alignment-Eigenschaft der Spalte nicht mehr den voreingestellten Wert.

cvReadOnly	Wenn cvReadOnly in AssignedValues enthalten ist, hat die ReadOnly-Eigenschaft der Spalte nicht mehr den voreingestellten Wert.

cvTitleColor	Wenn cvTitleColor in AssignedValues enthalten ist, hat die Color-Eigenschaft des Spaltentitels nicht mehr den voreingestellten Wert.

cvTitleCaption	Wenn cvTitleCaption in AssignedValues enthalten ist, hat die Caption-Eigenschaft des Spaltentitels nicht mehr den voreingestellten Wert.

cvTitleAlignment	Wenn cvTitleAlignment in AssignedValues enthalten ist, hat die Alignment-Eigenschaft des Spaltentitels nicht mehr den voreingestellten Wert.

cvTitleFont	Wenn cvTitleFont in AssignedValues enthalten ist, hat die Font-Eigenschaft des Spaltentitels nicht mehr den voreingestellten Wert.


TComboBoxStyle (Typ)

TComboBoxStyle definiert die Stile von Kombinationsfeldern.

enum TComboBoxStyle { csDropDown, csSimple, csDropDownList, csOwnerDrawFixed, csOwnerDrawVariable };

Header

vcl\stdctrls.hpp

Beschreibung

TComboBoxStyle ist der Typ für die Eigenschaft Style von Kombinationsfeldern.


TComponentName (Typ)

TComponentName ist der Typ für die Name-Eigenschaft aller Komponenten.

typedef System::AnsiString TComponentName;

Header

vcl\classes.hpp

Beschreibung

TComponentName dient als Typ für die Eigenschaft Name aller Komponenten.


TConfigMode (Typ)

TConfigMode definiert die zulässigen Werte für die Eigenschaft ConfigMode von TSession und TDatabase.

enum TConfigMode { cmPersistent, cmSession, cmAll };

Header

vcl\db.hpp

Beschreibung

Der Typ TConfigMode legt die zulässigen Werte für die Eigenschaft ConfigMode der Komponenten TSession und TDatabase fest. Diese Werte und ihre Bedeutung sind in der folgenden Tabelle aufgeführt:

Wert	Beschreibung

cmPersistent	Hinzugefügte Aliase sind global. (Durch einen Aufruf von SaveConfigFile werden sie dauerhaft gespeichert.) GetAliasNames gibt nur globale Aliase zurück.

cmSession	Hinzugefügte Aliase sind lokal und können nicht gespeichert werden. (Lokale Aliase gehen bei Beendigung der Arbeitssitzung verloren. GetAliasNames gibt nur lokale Aliase zurück.

cmAll	Hinzugefügte Aliase sind global. (Durch einen Aufruf von SaveConfigFile werden sie dauerhaft gespeichert.) GetAliasNames liefert sowohl globale als auch lokale Aliasnamen zurück.


TConsistentAttributes (Typ)

TConsistentAttributes definiert die zulässigen Werte für die ConsistentAttribute-Eigenschaft von TTextAttributes-Objekten.

enum TConsistentAttribute { caBold, caColor, caFace, caItalic, caSize, caStrikeOut, caUnderline, caProtected};

typedef Set<TConsistentAttribute, caBold, caProtected>  TConsistentAttributes;

Header

vcl\comctrls.hpp

Beschreibung

Der Typ TConsistentAttributes definiert die Werte, die für die ConsistentAttributes-Eigenschaft des TTextAttributes-Objekts zulässig sind. Er enthält Informationen zur Formatierung von Zeichen für den markierten Text eines RTF-Eingabefeldes.

TTextAttributes ist der Typ für die Eigenschaften DefAttributes und SelAttributes der Komponente TRichEdit.


TConversionClass (Typ)

Siehe auch

TConversionClass ist eine Klassenreferenz auf TConversion.

typedef System::TMetaClass* TConversionClass;

Header

vcl\comctrls.hpp

Beschreibung

TConversionClass wird in der Methode RegisterConversionFormat und in der Eigenschaft DefaultConverter von TRichEdit-Komponenten verwendet.


TCopyMode (Typ)

TCopyMode ist der Typ für die Eigenschaft CopyMode eines TCanvas-Objekts.

typedef long TCopyMode;

Header

vcl\graphics.hpp

Beschreibung

TCopyMode ist der Typ für die CopyMode-Eigenschaft eines TCanvas-Objekts.


TCreateInfo (Typ)

Siehe auch

Der Datensatz TCreateInfo wird von der CreateObjectFromInfo-Methode von TOleContainer-Objekten verwendet.

struct TCreateInfo {

TCreateType CreateType;

bool ShowAsIcon;

int IconMetaPict;

GUID ClassID;

System::AnsiString FileName;

Ole2::IDataObject* DataObject; };

Header

vcl\olectnrs.hpp

Beschreibung

Der Typ TCreateInfo ist ein Datensatz, der von der CreateObjectFromInfo-Methode von TOleContainer-Objekten benutzt wird. Die folgende Tabelle enthält eine Beschreibung der Felder von TCreateInfo:

Felder	Beschreibung

CreateType	Ein TCreateType-Wert, der die Quelle des Objekts beschreibt. Weitere Informationen finden Sie unter TCreateType.

ShowAsIcon	Gibt an, ob das Objekt als Symbol (True) angezeigt wird, oder ob die Anzeigeform verwendet wird, die das Objekt in der Server-Anwendung besitzt (False).

IconMetaPict	Definiert ein globales Speicher-Handle für ein Metadateibild (TMetaFilePict), das anstelle des Standardsymbols für das OLE-Objekt angezeigt werden soll. Die Angabe von IconMetaPict ist optional. Wenn Sie dieses Feld auf 0 setzen, wird das Standardsymbol des Objekts benutzt (vorausgesetzt, ShowAsIcon hat den Wert True).

ClassID	Der Klassenbezeichner des zu erstellenden OLE-Objekts. ClassID wird nur dann benutzt, wenn CreateType auf ctNewObject gesetzt ist. Mit Hilfe der Funktion ProgIDToClassID können Sie den Klassenbezeichner für den Klassennamen (bzw. den programminternen Bezeichner) eines OLE-Objekts ermitteln.

FileName	Der Name einer Datei, die als OLE-Objekt verknüpft oder eingebettet werden soll. FileName wird nur benutzt, wenn CreateType auf ctFromFile oder ctLinkToFile gesetzt ist.

DataObject	Ein OLE-Datentransferobjekt. DataObject wird nur benutzt, wenn CreateType auf ctFromData oder ctLinkToData gesetzt ist.


TCreateType (Typ)

Siehe auch

Der Aufzählungstyp TCreateType definiert die Werte für das CreateType-Feld von TCreateInfo.

enum TCreateType { ctNewObject, ctFromFile, ctLinkToFile, ctFromData, ctLinkFromData };

Header

vcl\olectnrs.hpp

Beschreibung

Im Aufzählungstyp TCreateType werden die zulässigen Werte für das CreateType-Feld von TCreateInfo definiert. Dieses Feld wird an die CreateObjectFromInfo-Methode von TOleContainer übergeben. Die folgende Tabelle enthält eine Beschreibung dieser Werte:

Wert	Beschreibung

ctNewObject	Erzeugt ein eingebettetes OLE-Objekt, dessen Klassenbezeichner (TCreateInfo.ClassID) angegeben ist.

ctFromFile	Erzeugt aus dem Inhalt der angegebenen Datei (TCreateInfo.FileName) ein eingebettetes OLE-Objekt.

ctLinkToFile	Erzeugt aus dem Inhalt der angegebenen Datei (TCreateInfo.FileName) ein verknüpftes OLE-Objekt.

ctFromData	Erzeugt aus dem angegebenen Datentransferobjekt (TCreateInfo.DataObject) ein eingebettetes OLE-Objekt.

ctLinkFromData	Erzeugt aus dem angegebenen Datentransferobjekt (TCreateInfo.DataObject) ein verknüpftes OLE-Objekt.


TCursor (Typ)

TCursor definiert verschiedene Standard-Cursor für eine Komponente.

enum TCursor {crMin=-0x7FFF-1, crMax=0x7FFF};

Header

vcl\controls.hpp

Beschreibung

Der Typ TCursor definiert die verschiedenen Arten von Standard-Cursorformen, die für eine Komponente gültig sind. TCursor ist der Typ für die Eigenschaften Cursor und DragCursor.


TCustomColors (Typ)

Das Array TCustomColors definiert die Farbwerte für selbstdefinierte Farben.

typedef long TCustomColors[16];

Header

vcl\dialogs.hpp

Beschreibung

Der Typ TCustomColors ist ein Array mit den Farbwerten für die selbstdefinierten Farben, die ein Benutzer im Dialogfeld Farbe (Komponente TColorDialog) erzeugen kann. Die Konstante MaxCustomColors hat den Wert 16.


TDataAction (Typ)

TDataAction definiert die Werte für den Action-Parameter der Ereignisse OnDeleteError, OnEditError und OnPostError.

enum TDataAction { daFail, daAbort, daRetry };

Header

vcl\db.hpp

Beschreibung

Der Typ TDataAction definiert die Werte, die dem Action-Parameter in den Ereignissen OnDeleteError, OnEditError und OnPostError zugewiesen werden kann. Die folgende Tabelle enthält eine Beschreibung dieser Werte:

Wert	Beschreibung

daFail	(Dies ist der vorgegebene Wert von Action.) Der Fehler wird als Exception gemeldet, wie dies normalerweise der Fall ist.

daAbort	Der Fehler wird durch Auslösen einer “stillen” EAbort-Exception verworfen.

daRetry	Die Anwendung startet eine Schleife, in der die Löschen-, Bearbeiten- oder Eintragen-Operation so lange wiederholt wird, bis sie erfolgreich ausgeführt werden kann oder bis daFail bzw. daAbort an Action zugewiesen wird.


TDataMode (Typ)

TDataMode definiert die Typen der gültigen Verbindungsmodi einer DDE-Verbindung.

enum TDataMode { ddeAutomatic, ddeManual };

Header

vcl\ddeman.hpp

Beschreibung

Der Typ TDataMode enthält die Typen der Verbindungsmodi, die beim Start einer DDE-Konversation verwendet werden. Der Verbindungsmodus wird in der Eigenschaft ConnectMode angegeben.


TDataSetNotifyEvent (Typ)

TDataSetNotifyEvent ist ein Zeiger auf die Methode, mit der einer Datenmengenkomponente mitgeteilt wird, daß ein Ereignis aufgetreten ist.

typedef void __fastcall (__closure *TDataSetNotifyEvent)(TDataSet* DataSet);

Header

vcl\db.hpp

Beschreibung

Der Typ TDataSetNotifyEvent zeigt auf die Methode, die einer Datenmengenkomponente mitteilt, daß ein Ereignis eingetreten ist. Alle Ereignisse von Tabellen, Abfragen und gespeicherten Prozeduren (die Komponenten TTable, TQuery und TStoredProc) benutzen diesen Typ.


TDataSetState (Typ)

TDataSetState definiert die Werte für die State-Eigenschaft einer Datenmengenkomponente.

enum TDataSetState { dsInactive, dsBrowse, dsEdit, dsInsert, dsSetKey, dsCalcFields, dsUpdateNew, dsUpdateOld, dsFilter };

Header

vcl\db.hpp

Beschreibung

Der Typ TDataSetState enthält die Wertemenge für die State-Eigenschaft einer Datenmengenkomponente. Die folgende Tabelle enthält eine Beschreibung dieser Werte:

Wert	Beschreibung

dsInactive	Datenmenge ist nicht geöffnet.

dsBrowse	Bewegung zwischen Datensätzen.

dsEdit	Ein Datensatz wird bearbeitet.

dsInsert	Ein neuer Datensatz wird eingefügt bzw. angefügt.

dsSetKey	Durch die Bearbeitung von Feldern werden Schlüsselwerte zum Auffinden von Datensätzen festgelegt oder ein Bereich definiert.

dsCalcFields	Berechnete Feldwerte werden berechnet.

dsUpdateNew	Interner Status. Wird beim Zugriff auf die NewValue-Eigenschaft eines Feldes verwendet.

dsUpdateOld	Interner Status. Wird beim Zugriff auf die OldValue-Eigenschaft eines Feldes verwendet.

dsFilter	Datenmenge verarbeitet ein OnFilterRecord-Ereignis.


TDateTime (Typ)

TDateTime wird von Datums- und Zeitroutinen zur Aufnahme der Datums- bzw. Zeitangaben verwendet.

Header

vcl\system.hpp

Beschreibung

Delphi speichert Datums- und Zeitangaben im Typ TDateTime. Der ganzzahlige Teil eines TDateTime-Wertes besteht aus der Anzahl der Tage, die seit dem 30.12.1899 vergangen sind. Der Bruchteil eines TDateTime-Wertes gibt die Tageszeit wieder.

Nachstehend sehen Sie einige Beispiele für TDateTime-Werte und die zugehörigen Datums- und Zeitangaben:

0	12/30/1899 12:00 am

2.75	1/1/1900 6:00 pm

-1.25	12/29/1899 6:00 am

35065	1/1/1996 12:00 am

Zur Ermittlung des Bruchteils der Tage zwischen zwei Datumsangaben müssen die beiden Werte voneinander subtrahiert werden. Um eine Datums- und Zeitangabe um eine bestimmte Anzahl von Tagen zu erhöhen, addieren Sie einfach die Anzahl zur Datums- und Zeitangabe hinzu.


TDBCtrlGridBorder (Typ)

TDBCtrlGridBorder definiert die zulässigen Werte für die Eigenschaft PanelBorder der TDBCtrlGrid-Komponente.

enum TDBCtrlGridBorder { gbNone, gbRaised };

Header

vcl\dbcgrids.hpp

Beschreibung

Der Typ TDBCtrlGridBorder legt die zulässigen Werte für die PanelBorder-Eigenschaft der Komponente TDBCtrlGrid fest. In der folgenden Tabelle finden Sie eine Übersicht über diese Werte:

Wert	Beschreibung

gbNone	Kein Rahmen.

gbRaised	Erhabener Rahmen.


TDBCtrlGridKey (Typ)

TDBCtrlGridKey definiert die Werte für den Parameter Key der DoKey-Methode von TDBCtrlGrid.

enum TDBCtrlGridKey { gkNull, gkEditMode, gkPriorTab, gkNextTab, gkLeft, gkRight, gkUp, gkDown, gkScrollUp, gkScrollDown, gkPageUp, gkPageDown, gkHome, gkEnd, gkInsert, gkAppend, gkDelete, gkCancel };

Header

vcl\dbcgrids.hpp

Beschreibung

Der Typ TDBCtrlGridKey legt die zulässigen Werte für den Key-Parameter fest, der an die DoKey-Methode der Komponente TDBCtrlGrid übergeben wird. In der folgenden Tabelle finden Sie eine Übersicht über diese Werte:

Wert	Beschreibung

gkNull	Keine Aktion.

gkEditMode	Schaltet EditMode um.

gkPriorTab	Übergibt den Fokus an das vorherige Steuerelement in der Tabulatorreihenfolge.

gkNextTab	Übergibt den Fokus an das nächste Steuerelement in der Tabulatorreihenfolge.

gkLeft	Verschiebt die aktuelle Position um eine Spalte nach links und führt bei Bedarf einen Bildlauf aus.

gkRight	Verschiebt die aktuelle Position um eine Spalte nach rechts und führt bei Bedarf einen Bildlauf aus.

gkUp	Positioniert auf die vorherige Zeile und führt bei Bedarf einen Bildlauf aus.

gkDown	Positioniert auf die nächste Zeile und führt bei Bedarf einen Bildlauf aus.

gkScrollUp	Macht den Datensatz in der vorherigen Zeile zum aktuellen Datensatz, ohne die Position im Gitter zu ändern.

gkScrollDown	Macht den Datensatz in der nächsten Zeile zum aktuellen Datensatz, ohne die Position im Gitter zu ändern.

gkPageUp	Positioniert auf die vorherige Seite im Gitter.

gkPageDown	Positioniert auf die nächste Seite im Gitter.

gkHome	Positioniert auf den ersten Datensatz.

gkEnd	Positioniert auf den letzten Datensatz.

gkInsert	Fügt einen neuen Datensatz ein (wenn AllowInsert True ist).

gkAppend	Fügt einen neuen Datensatz an (wenn AllowInsert True ist).

gkDelete	Löscht den aktuellen Datensatz (wenn AllowDelete True ist).

gkCancel	Verwirft alle anstehenden Änderungen an einem vorhandenen oder neuen Datensatz.


TDBCtrlGridOrientation (Typ)

TDBCtrlGridOrientation definiert die Werte für die Eigenschaft Orientation der TDBCtrlGrid-Komponente.

enum TDBCtrlGridOrientation { goVertical, goHorizontal };

Header

vcl\dbctrls.hpp

Beschreibung

Der Typ TDBCtrlGridOrientation legt die zulässigen Werte für die Orientation-Eigenschaft der Komponente TDBCtrlGrid fest. In der folgenden Tabelle finden Sie eine Übersicht über diese Werte:

Wert	Beschreibung

goVertical	Tafeln verlaufen nach unten und dann in horizontaler Richtung (Spalten).

goHorizontal	Tafeln verlaufen in horizontaler Richtung und dann nach unten (Zeilen).


TDBGridColumnsState (Typ)

TDBGridColumnsState definiert die Werte für die Eigenschaft State der Komponente TDBGridColumns.

enum TDBGridColumnsState { csDefault, csCustomized };

Header

vcl\dbgrids.hpp

Beschreibung

Der Typ TDBGridColumnsState legt die zulässigen Werte für die State-Eigenschaft der Komponente TDBGridColumns fest. Die folgende Tabelle enthält eine Beschreibung dieser Werte:

Wert	Beschreibung

csDefault	Für die Spaltenobjekte des Gitters werden die Standard-Spaltenobjekte verwendet, die mit den Eigenschaften für die Feldobjekte der Datenmenge erzeugt wurden. Änderungen an den Spaltenobjekten werden in den Feldobjekten widergespiegelt (und umgekehrt).

csCustomized	Die Spaltenobjekte des Gitters sind persistent, d.h. sie werden getrennt von den Feldeigenschaften der Datenmenge erzeugt. (Änderungen, die an dauerhaften Spalten vorgenommen werden, haben keine Auswirkungen auf die entsprechenden Felder.)


TDBGridOptions (Typ)

TDBGridOptions definiert die Werte für die Eigenschaft Options der Komponente TDBGrid.

enum TDBGridOption { dgEditing, dgAlwaysShowEditor, dgTitles, dgIndicator, dgColumnResize, dgColLines, dgRowLines, dgTabs, dgRowSelect, dgAlwaysShowSelection, dgConfirmDelete, dgCancelOnExit, dgMultiSelect };

typedef Set<TDBGridOption, dgEditing, dgMultiSelect>  TDBGridOptions;

Header

vcl\dbgrids.hpp

Beschreibung

Der Typ TDBGridOptions definiert die Menge der zulässigen Werte für die Eigenschaft Options eines Datengitters (TDBGrid).


TDBLookupComboStyle (Typ)

TDBLookupComboStyle definiert den Typ eines Kombinationsfeldes.

enum TDBLookupComboStyle { csDropDown, csDropDownList };

Header

vcl\dblookup.hpp

Beschreibung

Der Typ TDBLookupComboStyle legt die Art eines Kombinationsfeldes fest. Er ist der Typ für die Style-Eigenschaft eines Lookup-Kombinationsfeldes (TDBLookupCombo).


TDBLookupListOptions (Typ)

TDBLookupListOptions definiert die Werte, die in der Menge Options der TDBLookupCombo- oder TDBLookupList-Komponente enthalten sind.

enum TDBLookupListOption { loColLines, loRowLines, loTitles };

typedef Set<TDBLookupListOption, loColLines, loTitles> TDBLookupListOptions;

Header

vcl\dblookup.hpp

Beschreibung

Der Typ TDBLookupListOptions legt die Werte fest, die in der Menge Options eines Lookup-Kombinationsfeldes (TDBLookupCombo) oder eines Lookup-Listenfeldes (TDBLookupList) enthalten sind.


TDisplayCode (Typ)

TDisplayCode legt den Anzeigetyp für die Methode DisplayRect fest.

enum TDisplayCode { drBounds, drIcon, drLabel, drSelectBounds };

Header

vcl\comctrls.hpp

Beschreibung

Mit dem Typ TDisplayCode kann der Anzeigetyp bestimmt werden, der beim Einsatz der Methode DisplayRect zur Anzeige des umgebenden Rechtecks für einen Eintrag (bzw. einen Teil davon) in der aktuellen Listenansicht verwendet wird.


TDragMode (Typ)

TDragMode definiert die Werte für die Eigenschaft DragMode.

enum TDragMode { dmManual, dmAutomatic };

Header

vcl\controls.hpp

Beschreibung

Der Typ TDragMode definiert die Werte für die Eigenschaft DragMode von Steuerelementen.


TDragState (Typ)

Siehe auch

TDragState definiert den Ziehen-Status (Drag) eines gezogenen Steuerelements relativ zu einem anderen Steuerelement.

enum TDragState { dsDragEnter, dsDragLeave, dsDragMove };

Header

vcl\controls.hpp

Beschreibung

Der Typ TDragState legt den Ziehen-Status eines gezogenen Steuerelements relativ zu einem anderen Steuerelement fest. TDragState ist der Typ für den Parameter State, der in Ereignisbehandlungsroutinen für OnDragOver verwendet wird. Folgende Werte können für den Status angegeben werden:

Wert	Bedeutung

dsDragEnter	Der Status, in dem sich das gezogene Objekt befindet, wenn es in ein Steuerelement eintritt, auf dem es abgelegt werden kann. dsDragEnter ist der vorgegebene Status.

dsDragMove	Der Status, in dem sich das gezogene Objekt befindet, wenn es innerhalb eines Steuerelements verschoben wird, auf dem es abgelegt werden kann.

dsDragLeave	Der Status, in dem sich das gezogene Objekt befindet, wenn ein Steuerelement verläßt, auf dem es abgelegt werden könnte.


TDuplicates (Typ)

TDuplicates definiert die zulässigen Werte für die Duplicates-Eigenschaft einer TStringList-Komponente.

enum TDuplicates { dupIgnore, dupAccept, dupError };

Header

vcl\classes.hpp

Beschreibung

Der Typ TDuplicates legt die Werte fest, die für die Duplicates-Eigenschaft eines String-Listenobjekts (TStringList) zulässig sind.


TEditCharCase (Typ)

TEditCharCase definiert die Werte für die Eigenschaft CharCase einer TEdit-Komponente.

enum TEditCharCase { ecNormal, ecUpperCase, ecLowerCase };

Header

vcl\stdctrls.hpp

Beschreibung

Der Typ TEditCharCase legt die zulässigen Werte für die Eigenschaft CharCase eines Eingabefeldes (TEdit) fest.


TFieldClass (Typ)

TFieldClass dient zur Erzeugung einer Objektreferenz für TField.

typedef System::TMetaClass* TFieldClass;

Header

vcl\db.hpp

Beschreibung

TFieldClass ist der Objekttyp für TField. Verwenden Sie diesen Typ zur Erzeugung einer Objektreferenz für TField.


TFieldKind (Typ)

TFieldKind definiert eine Wertemenge für die Eigenschaft FieldKind einer TField-Komponente.

enum TFieldKind { fkData, fkCalculated, fkLookup };

Header

vcl\db.hpp

Beschreibung

Der Typ TFieldKind enthält die Menge der zulässigen Werte für die Eigenschaft FieldKind einer TField-Komponente. Die folgende Tabelle enthält eine Beschreibung dieser Werte:

Wert	Beschreibung

fkData	Das Feld repräsentiert ein physikalisches Feld in einer Datenbanktabelle.

fkCalculated	Das Feld ist ein berechnetes Feld.

fkLookup	Das Feld ist ein Lookup-Feld.


TFieldType (Typ)

TFieldType definiert eine Wertemenge für die Eigenschaft DataType einer TField- oder TFieldDef-Komponente.

enum TFieldType { ftUnknown, ftString, ftSmallint, ftInteger, ftWord, ftBoolean, ftFloat, ftCurrency, ftBCD, ftDate, ftTime, ftDateTime, ftBytes, ftVarBytes, ftAutoInc, ftBlob, ftMemo, ftGraphic, ftFmtMemo, ftParadoxOle, ftDBaseOle, ftTypedBinary };

Header

vcl\db.hpp

Beschreibung

Der Typ TFieldType enthält die Menge der zulässigen Werte für die Eigenschaft DataTyp einer TField- oder TFieldDef-Komponente. Die folgende Tabelle enthält eine Beschreibung dieser Werte:

Wert	Beschreibung

ftUnkown	Unbekannt oder nicht festgelegt

ftString	Zeichen- oder String-Feld

ftSmallint	16-Bit-Integerfeld

ftInteger	32-Bit-Integerfeld

ftWord	16-Bit-Integerfeld ohne Vorzeichen

ftBoolean	Boolesches Feld

ftFloat	Numerisches Gleitkommafeld

ftCurrency	Währungsfeld

ftBCD	Binärcodiertes Dezimalfeld

ftDate	Datumsfeld

ftTime	Zeitfeld

ftDateTime	Datums-/Zeitfeld

ftBytes	Feste Anzahl von Bytes (binäre Speicherung)

ftVarBytes	Variable Anzalh von Bytes (binare Speicherung)

ftAutoInc	32-Bit-Integer-Zählerfeld, das sich selbst inkrementiert.

ftBlob	Binary Large OBject-Feld (BLOB-Feld)

ftMemo	Text-Memofeld

ftGraphic	Bitmap-Feld

ftFmtMemo	Formatiertes Memofeld

ftParadoxOle	Paradox-OLE-Feld

ftDBaseOle	dBASE-OLE-Feld

ftTypedBinary	Typisiertes Binärfeld


TFileEditStyle (Typ)

TFileEditStyle enthält die Werte für die Eigenschaft FileEditStyle von TOpenDialog- und TSaveDialog-Komponenten.

enum TFileEditStyle { fsEdit, fsComboBox };

Header

vcl\dialogs.hpp

Beschreibung

Der Typ TFileEditStyle enthält die zulässigen Werte für die FileEditStyle-Eigenschaft, die von Dialogfeldern zum Öffnen (TOpenDialog) und Speichern (TSaveDialog) verwendet wird.


TFileName (Typ)

TFileName definiert die FileName-Eigenschaft der Dialogfelder zum Öffnen (TOpenDialog) und Speichern (TSaveDialog).

typedef System::AnsiString TFileName;

Header

vcl\sysutils.hpp

Beschreibung

TFileName ist der Typ für die FileName-Eigenschaft für die Dialogfelder zum Öffnen und Speichern.


TFileType (Typ)

TFileTyp enthält eine Menge von Dateiattributen.

enum TFileAttr { ftReadOnly, ftHidden, ftSystem, ftVolumeID, ftDirectory, ftArchive, ftNormal };

typedef Set<TFileAttr, ftReadOnly, ftNormal> TFileType;

Header

vcl\filectrl.hpp

Beschreibung

Der Typ TFileType besteht aus einer Menge von Dateiattributen. Er wird von der FileType-Eigenschaft eines Dateilistenfeldes (TFileListBox) benutzt.


TFillStyle (Typ)

TFillStyle legt das Füllmuster für die FloodFill-Methode einer TCanvas-Komponente fest.

enum TFillStyle { fsSurface, fsBorder };

Header

vcl\graphics.hpp

Beschreibung

Der Typ TFillStyle legt das Füllmuster fest, das die FloodFill-Methode einer Zeichenfläche (TCanvas-Objekt) benutzt.


TFilterOptions (Typ)

TFilterOptions definiert die Werte der Eigenschaft FilterOptions für TTable-, TQuery- und TStoredProc-Komponenten.

typedef Set<TFilterOption, foCaseInsensitive, foNoPartialCompare> TFilterOptions;

Header

vcl\db.hpp

Beschreibung

Der Typ TFilterOptions legt die zulässigen Werte für die FilterOptions-Eigenschaft der Komponenten TTable, TQuery und TStoredProc fest. Diese Werte und ihre Bedeutung sind in der folgenden Tabelle aufgeführt:

Wert	Beschreibung

foCaseInsensitive	Der Filter unterscheidet in den Daten der Datenmenge nicht zwischen Groß- und Kleinschreibung.

foNoPartialCompare	Bei String-Vergleichen wird die Länge der Daten in der Datenmenge berücksichtigt. Teilvergleiche sind nicht zulässig.


TFilterRecordEvent (Typ)

TFilterRecordEvent zeigt auf eine Methode, die auf ein OnFilterRecord-Ereignis antwortet.

typedef void __fastcall (__closure *TFilterRecordEvent)(TDataSet* DataSet, bool &Accept);

Header

vcl\db.hpp

Beschreibung

Der Typ TFilterRecordEvent ist ein Zeiger auf eine Methode, die auf ein OnFilterRecord-Ereignis antwortet und festlegt, ob Datensätze in einer Datenmenge sichtbar sind oder nicht.


TFindItemKind (Typ)

TFindItemKind definiert die Werte für den Kind-Parameter der Methode FindItem.

enum TFindItemKind { fkCommand, fkHandle, fkShortCut };

Header

vcl\menus.hpp

Beschreibung

Der Typ TFindItemKind legt die zulässigen Werte für den Kind-Parameter der Methode FindItem einer Menükomponente fest.


TFindOptions (Typ)

TFindOptions definiert die Werte für die Eigenschaft Options von TFindDialog- und TReplaceDialog-Komponenten.

enum TFindOption { frDown, frFindNext, frHideMatchCase, frHideWholeWord, frHideUpDown, frMatchCase, frDisableMatchCase, frDisableUpDown, frDisableWholeWord, frReplace, frReplaceAll, frWholeWord, frShowHelp };

typedef Set<TFindOption, frDown, frShowHelp> TFindOptions;

Header

vcl\dialogs.hpp

Beschreibung

Der Typ TFindOptions definiert die Menge der zulässigen Werte für die Options-Eigenschaft, die von Dialogfeldern zum Öffnen und Ersetzen (Komponenten TFindDialog und TReplaceDialog) verwendet wird.


TFloatRec (Typ)

TFloatRec ist der Ergebnisdatensatz von FloatToDecimal.

#pragma pack(push, 1)

struct TFloatRec

{ short Exponent;

bool Negative;

char Digits[21]; } ;

#pragma pack(pop)

Header

vcl\sysutils.hpp

Beschreibung

TFloatRec ist der Datensatz, der aus FloatToDecimal resultiert.


TFloatValue (Typ)

TFloatValue ist der ValueType-Parameter für FloatToText, FloatToTextFmt, TextToFloat und FloatToDecimal.

enum TFloatValue { fvExtended, fvCurrency };

Header

vcl\sysutils.hpp

Beschreibung

TFloatValue ist der Typ des Parameters ValueType für die Funktionen FloatToText, FloatToTextFmt und TextToFloat sowie für die Prozedur FloatToDecimal. Über den Parameter ValueType wird festgelegt, ob der an die Funktion bzw. die Prozedur übergebene Wert ein Währungswert oder ein normaler Gleitkommawert ist.

Wert	Bedeutung

fvExtended	Der Wert ist ein normaler Gleitkommawert.

fvCurrency	Der Wert ist ein Währungswert.


TFontDialogDevice (Typ)

TFontDialogDevice listet die Werte für die Device-Eigenschaft von TFontDialog auf.

enum TFontDialogDevice { fdScreen, fdPrinter, fdBoth };

Header

vcl\dialogs.hpp

Beschreibung

Der Typ TFontDialogDevice listet die Werte auf, die die Device-Eigenschaft des Dialogfeldes Schrift (TFontDialog) annehmen kann.


TFontDialogOptions (Typ)

TFontDialogOptions definiert die Werte für die Eigenschaft Options der Komponente TFontDialog.

enum TFontDialogOption { fdAnsiOnly, fdTrueTypeOnly, fdEffects, fdFixedPitchOnly, fdForceFontExist, fdNoFaceSel, fdNoOEMFonts, fdNoSimulations, fdNoSizeSel, fdNoStyleSel, fdNoVectorFonts, fdShowHelp, fdWysiwyg, fdLimitSize, fdScalableOnly, fdApplyButton };

typedef Set<TFontDialogOption, fdAnsiOnly, fdApplyButton>  TFontDialogOptions;

Header

vcl\dialogs.hpp

Beschreibung

Der Typ TFontDialogOptions enthält die Werte, die die Options-Eigenschaft des Dialogfeldes Schrift (TFontDialog) annehmen kann.


TFontName (Typ)

TFontName wird von der Name-Eigenschaft von TFont verwendet.

typedef SmallString<31> TFontName;

Header

vcl\graphics.hpp

Beschreibung

Der Typ TFontName wird von der Eigenschaft Name eines Schriftobjekts (TFont) verwendet. Die maximale Länge beträgt 32 Zeichen. Schriftnamen, die länger als 32 Zeichen sind, werden abgeschnitten.


TFontPitch (Typ)

TFontPitch wird von der Pitch-Eigenschaft von TFont verwendet.

enum TFontPitch { fpDefault, fpVariable, fpFixed };

Header

vcl\graphics.hpp

Beschreibung

Der Typ TFontPitch wird von der Eigenschaft Pitch eines Schriftobjekts (TFont) verwendet.


TFontStyles (Typ)

TFontStyles enthält die Stile für die Style-Eigenschaft von TFont.

enum TFontStyle { fsBold, fsItalic, fsUnderline, fsStrikeOut };

typedef DummySet<TFontStyle, fsBold, fsStrikeOut>  TDummyFontStyles;

Header

vcl\graphics.hpp

Beschreibung

Der Typ TFontStyles besteht aus einer Menge von Schriftstilen, die die Style-Eigenschaft eines Schriftobjekts (TFont) annehmen kann.


TFormBorderStyle (Typ)

TFormBorderStyle definiert die Rahmenstile für die BorderStyle-Eigenschaft eines Formulars.

enum TFormBorderStyle { bsNone, bsSingle, bsSizeable, bsDialog, bsToolWindow, bsSizeToolWin };

Header

vcl\forms.hpp

Beschreibung

Der Typ TFormBorderStyle definiert die zulässigen Rahmenstile eines Formulars. TFormBorderStyle ist der Typ für die Eigenschaft BorderStyle des Formulars.


TFormStyle (Typ)

TFormStyle definiert die Werte für die Eigenschaft FormStyle von TForm.

enum TFormStyle { fsNormal, fsMDIChild, fsMDIForm, fsStayOnTop };

Header

vcl\forms.hpp

Beschreibung

Der Typ TFormStyle definiert die Werte, die für die FormStyle-Eigenschaft eines Formulars (TForm) zulässig sind.


TGridDrawState (Typ)

TGridDrawState definiert die zulässigen Statuswerte für das Zeichnen einer Zelle.

typedef Set<Grids_3, gdSelected, gdFixed> TGridDrawState;

Header

vcl\grids.hpp

Beschreibung

Der Typ TGridDrawState definiert die Statuswerte, die für das Zeichnen einer Zelle zulässig sind. TGridDrawState ist der Typ des AState-Parameters, der im TDrawCellEvent-Methodenzeiger verwendet wird.


TGridOptions (Typ)

TGridOptions enthält die Werte für die Options-Eigenschaft der Komponenten TDrawGrid und TStringGrid.

enum TGridOption { goFixedVertLine, goFixedHorzLine, goVertLine, goHorzLine, goRangeSelect, goDrawFocusSelected, goRowSizing, goColSizing, goRowMoving, goColMoving, goEditing, goTabs, goRowSelect, goAlwaysShowEditor, goThumbTracking };

typedef Set<TGridOption, goFixedVertLine, goThumbTracking> TGridOptions;

Header

vcl\grids.hpp

Beschreibung

TGridOptions ist ein Menge von Werten, die die Options-Eigenschaft einer TDrawGrid- oder TStringGrid-Komponente annehmen kann.


TGridRect (Typ)

TGridRect definiert den rechteckigen Bereich innerhalb eines Gitter-Steuerelements.

struct TGridRect {

 union {

struct {

TGridCoord TopLeft;

TGridCoord BottomRight; };

struct {

long Left;

long Top;

long Right;

long Bottom; };

} ;

};

Header

vcl\grids.hpp

Beschreibung

Der Typ TGridRect legt den rechteckigen Bereich innerhalb eines Gitter-Steuerelements fest. Es handelt sich hier um den Typ der Selection-Eigenschaft der Komponenten TDrawGrid und TStringGrid.


THeaderSectionStyle (Typ)

THeaderSectionStyle definiert die zulässigen Werte für die Style-Eigenschaft von THeaderSection.

enum THeaderSectionStyle { hsText, hsOwnerDraw };

Header

vcl\comctrls.hpp

Beschreibung

Der Typ THeaderSectionStyle definiert die Werte, die für die Style-Eigenschaft des THeaderSection-Objekts zulässig sind. THeaderSection-Objekte umfassen die Kopfzeilen (dies sind selbständige Einheiten) von THeaderControl-Komponenten.


THelpContext (Typ)

THelpContext dient zur Definition von Hilfekontextnummern.

typedef int THelpContext;

Header

vcl\classes.hpp

Beschreibung

Mit dem Typ THelpContext werden Hilfekontextnummern festgelegt.


THintInfo (Typ)

Mit THintInfo wird das Aussehen und das Verhalten des Hilfefensters festgelegt.

struct THintInfo {

Controls::TControl* HintControl;

POINT HintPos;

int HintMaxWidth;

Graphics::TColor HintColor;

Windows::TRect CursorRect;

POINT CursorPos; };

Header

vcl\forms.hpp

Beschreibung

Mit THintInfo läßt sich das Aussehen und Verhalten des Hilfefensters in einer OnShowHint-Ereignisbehandlungsroutine für den Typ TShowHintEvent definieren.


THitTests (Typ)

THitTests bestimmt die Position eines Punktes relativ zum Client-Bereich eines Baumdiagramms.

enum THitTest { htAbove, htBelow, htNowhere, htOnItem, htOnButton, htOnIcon, htOnIndent, htOnLabel, htOnRight, htOnStateIcon, htToLeft, htToRight };

typedef Set<THitTest, htAbove, htToRight> THitTests;

Header

vcl\comctrls.hpp

Beschreibung

Der Typ THitTests legt die Position des angegebenen Punktes relativ zum Client-Bereich eines Baumdiagramm-Steuerelements fest. Er definiert die Menge der zulässigen Werte, die von der GetHitTestInfoAt-Methode der Komponente TTreeView zurückgeliefert werden.


THKInvalidKeys (Typ)

THKInvalidKeys definiert die Werte für die Eigenschaft InvalidKeys der Komponente THotKey.

enum THKInvalidKey { hcNone, hcShift, hcCtrl, hcAlt, hcShiftCtrl, hcShiftAlt, hcCtrlAlt, hcShiftCtrlAlt };

typedef Set<THKInvalidKey, hcNone, hcShiftCtrlAlt>  THKInvalidKeys;

Header

vcl\comctrls.hpp

Beschreibung

Der Typ THKInvalidKeys legt die Menge der Werte fest, die die Eigenschaft InvalidKeys der Komponente THotKey annehmen kann.


THKModifiers (Typ)

THKModifiers definiert die Werte für die Eigenschaft Modifiers der Komponente THotKey.

enum THKModifier { hkShift, hkCtrl, hkAlt, hkExt };

typedef Set<THKModifier, hkShift, hkExt> THKModifiers;

Header

vcl\comctrls.hpp

Beschreibung

Der Typ THKModifiers legt die Menge der Werte für die Eigenschaft Modifiers der Komponente THotKey fest.


TIconArrangement (Typ)

Mit TIconArrangement wird die Art und Weise angegeben, in der die Einträge in der Listenansicht angeordnet werden.

enum TIconArrangement { iaTop, iaLeft };

Header

vcl\comctrls.hpp

Beschreibung

Über die Eigenschaft Arrangement des IconOptions-Objekts für die Listenansicht kann ein TIconArrangement-Wert festgelegt werden. Der Anzeigestil (ViewStyle) der Listenansicht muß auf vsIcon oder vsSmallIcon gesetzt sein, damit die Ausrichtung für die Symbole wirksam wird.


TImageType (Typ)

TImageType enthält die zulässigen Werte für die Eigenschaft ImageType.

enum TImageType { itImage, itMask };

Header

vcl\controls.hpp

Beschreibung

Der Typ TImageType enthält die zulässigen Werte für die Eigenschaft ImageType. Die ImageType-Einstellung wird von ImageList benutzt, wenn ein Bild oder die zugehörige Maske gezeichnet werden muß.


TIndexOptions (Typ)

TIndexOptions definiert Werte, die zur Erzeugung eines neuen Index benutzt werden können.

enum DBTables_1 { ixPrimary, ixUnique, ixDescending, ixCaseInsensitive, ixExpression };

typedef Set<DBTables_1, ixPrimary, ixExpression>  TIndexOptions;

Header

vcl\dbtables.hpp

Beschreibung

Der Typ TIndexOptions enthält eine Menge von Werten, die zur Erzeugung eines neuen Index verwendet werden können. Er wird von der Methode AddIndex einer Datenmengenkomponente benutzt.

Hinweis

Für dBASE-Tabellen wird ixCaseInsensitive nicht unterstützt.


TItemStates (Typ)

TItemStates definiert die Statuswerte, die das Aussehen und die Funktion eines Listeneintrags festlegen.

enum TItemState { isNone, isCut, isDropHilited, isFocused, isSelected };

typedef Set<TItemState, isNone, isSelected>  TItemStates;

Header

vcl\comctrls.hpp

Beschreibung

Der Typ TItemStates enthält die Menge der möglichen Statuswerte, die das Aussehen und die Funktionsweise eines Listeneintrags festlegen. Ein Parameter dieses Typs wird an die GetNextItem-Methode der Listenansicht übergeben, wenn der nächste Listeneintrag mit dem betreffenden Status ermittelt werden soll.


TLastReleaseEvent (Typ)

Siehe auch

TLastReleaseEvent ist ein Zeiger auf ein OnLastRelease-Ereignis.

typedef void __fastcall (__closure *TLastReleaseEvent)(bool &Shutdown);

Header

vcl\oleauto.hpp

Beschreibung

TLastReleaseEvent ist ein Methodenzeigertyp, der für OnLastRelease-Ereignisse verwendet wird. Über den Variablenparameter Shutdown kann das Standardverhalten der Anwendung bei der Freigabe aller Instanzen außer Kraft gesetzt werden. (Das Standardverhalten legt fest, ob die Server-Anwendung geschlossen wird.)


TLeftRight (Typ)

TLeftRight definiert die Werte der Eigenschaft Alignment für Kontroll- und Schaltfelder.

enum TAlignment { taLeftJustify, taRightJustify, taCenter };

typedef TAlignment TLeftRight;

Header

vcl\classes.hpp

Beschreibung

TLeftRight ist der Typ für die Alignment-Eigenschaft von Kontrollfeldern und Schaltfeldern.


TListArrangement (Typ)

TListArrangement definiert Werte für den Code-Parameter der Arrange-Methode für die Komponente TListView.

enum TListArrangement { arAlignBottom, arAlignLeft, arAlignRight, arAlignTop, arDefault, arSnapToGrid };

Header

vcl\comctrls.hpp

Beschreibung

Der Typ TListArrangement definiert die Werte, die der Code-Parameter der Arrange-Methode für die Komponente TListView annehmen kann. Diese Werte legen fest, wie die Einträge in einer Listenansicht angeordnet werden.


TListBoxStyle (Typ)

TListBoxStyle definiert die Style-Eigenschaft für TListBox-Komponenten.

enum TListBoxStyle { lbStandard, lbOwnerDrawFixed, lbOwnerDrawVariable };

Header

vcl\stdcrtls.hpp

Beschreibung

TListBoxStyle ist der Typ für die Style-Eigenschaft eines Listenfeldes (Komponente TListBox).


TLoadResource (Typ)

TLoadResource dient zur Angabe der Ressourcen-Flags für die Methode GetResource.

enum TLoadResource { lrDefaultColor, lrDefaultSize, lrFromFile, lrMap3DColors, lrTransparent, lrMonoChrome };

Header

vcl\controls.hpp

Beschreibung

Mit dem Typ TLoadResource werden die Ressourcen-Flags für die Methode GetResource festgelegt.


TLocale (Typ)

TLocale ist der Typ für die Eigenschaften Locale und DBLocale und wird für direkte Aufrufe der BDE verwendet.

typedef void *TLocale;

Header

vcl\db.hpp

Beschreibung

TLocal ist der Typ für die Eigenschaften Locale und DBLocale. Diese Eigenschaften werden nur für direkte Aufrufe der Borland Database Engine (BDE) benötigt.


TLocateOptions (Typ)

TLocateOptions definiert die Werte für den Options-Parameter der Locate-Methode von TTable-, TQuery- und TStoredProc-Komponenten.

enum TLocateOption { loCaseInsensitive, loPartialKey };

typedef Set<TLocateOption, loCaseInsensitive, loPartialKey>  TLocateOptions;

Header

vcl\db.hpp

Beschreibung

Der Typ TLocateOptions legt die zulässigen Werte für den Options-Parameter fest, der an die Methode Locate der Komponenten TTable, TQuery und TStoredProc übergeben wird. Die folgende Tabelle enthält eine Beschreibung dieser Werte:

Wert	Beschreibung

loCaseInsensitive	Beim Vergleich von Schlüsselfeldern und Schlüsselwerten wird die Groß-/Kleinschreibung nicht berücksichtigt.

loPartialKey	Die Schlüsselwerte können nur einen Teil des entsprechenden Feldwertes enthalten. Beispielsweise würde ‘HAMMER’ sowohl mit ‘HAM’ als auch mit ‘HAMM’ gefunden.


TLockType (Typ)

Siehe auch

TLockType definiert die Parameter für die Methoden LockTable und UnlockTable der Komponente TTable.

enum TLockType { ltReadLock, ltWriteLock };

Header

vcl\dbtables.hpp

Beschreibung

TLockType legt die Werte fest, die als Parameter an die Methoden LockTable und UnlockTable von TTable-Komponenten übergeben werden können. Folgende Werte sind zulässig:

Werte	Beschreibung

ltReadLock	Andere Prozesse können die Tabelle nicht mit einer Schreibsperre belegen. Bei dBASE- und SQL-Tabellen ist ltReadLock mit ltWriteLock identisch.

ltWriteLock	Andere Prozesse können die Tabelle mit keinerlei Sperren belegen.


TMenuBreak (Typ)

TMenuBreak definiert die Werte für die Break-Eigenschaft eines Menüeintrags.

enum TMenuBreak { mbNone, mbBreak, mbBarBreak };

Header

vcl\menus.hpp

Beschreibung

Im Typ TMenuBreak sind die Werte definiert, die die Eigenschaft Break eines Menüeintrags annehmen kann.


TMethod (Typ)

In einem TMethod-Datensatz werden die Felder Code und Data als Zeiger (Typ Pointer) gespeichert.

struct TMethod {

void *Code;

void *Data; } ;

Header

vcl\sysutils.hpp

Beschreibung

Der Typ TMethod deklariert einen Datensatz, der die Felder Code und Data als Zeiger speichert.

Dieser Typ kann in der Typumwandlung eines Methodenzeigers benutzt werden, um auf die Code- und Datenbestandteile des Methodenzeigers zuzugreifen.


TModalResult (Typ)

TModalResult enthält das Ergebnis von ModalResult.

typedef int TModalResult;

Header

vcl\forms.hpp

Beschreibung

TModalResult ist der Typ für die Eigenschaft ModalResult.


TMouseButton (Typ)

Siehe auch

TMouseButton definiert die Maustastenkonstanten, die von Behandlungsroutinen für Mausereignisse benutzt werden.

enum TMouseButton { mbLeft, mbRight, mbMiddle };

Header

vcl\controls.hpp

Beschreibung

Im Typ TMouseButton sind die Mausschaltflächen-Konstanten definiert, mit deren Hilfe Behandlungsroutinen für Mausereignisse feststellen, welche Schaltfläche das Ereignis ausgelöst hat.


TMPBtnType (Typ)

TMPBtnType definiert die Schaltflächen für eine TMediaPlayer-Komponente.

enum TMPBtnType { btPlay, btPause, btStop, btNext, btPrev, btStep, btBack, btRecord, btEject };

Header

vcl\mplayer.hpp

Beschreibung

Die Schaltflächen sind Bestandteil einer Menge des Typs TButtonSet für die Eigenschaften ColoredButtons, EnabledButtons und VisibleButtons. TMPBtnType wird auch für den Button-Parameter der Ereignisse OnClick und OnPostClick eines Multimedia-Geräts benutzt.


TMPDevCapsSet (Typ)

TMPDevCapsSet enthält die Fähigkeiten eines geöffneten Multimedia-Geräts, das mit einer TMediaPlayer-Komponente eingesetzt wird.

enum TMPDevCaps { mpCanStep, mpCanEject, mpCanPlay, mpCanRecord, mpUsesWindow };

typedef Set<TMPDevCaps, mpCanStep, mpUsesWindow>  TMPDevCapsSet;

Header

vcl\mplayer.hpp

Beschreibung

Der Typ TMPDevCapsSet enthält die Menge der Fähigkeiten für ein geöffnetes Multimedia-Gerät, das mit einer TMediaPlayer-Komponente eingesetzt wird. TMPDevCapsSet ist der Typ für die Eigenschaft Capabilities.


TMPDeviceTypes (Typ)

TMPDeviceTypes enthält die Multimedia-Gerätetypen für eine TMediaPlayer-Komponente.

enum TMPDeviceTypes { dtAutoSelect, dtAVIVideo, dtCDAudio, dtDAT, dtDigitalVideo, dtMMMovie, dtOther, 	dtOverlay, dtScanner, dtSequencer, dtVCR, dtVideodisc, dtWaveAudio };

Header

vcl\mplayer.hpp

Beschreibung

Im Typ TMPDeviceTypes sind die Multimedia-Gerätetypen enthalten, die von einer TMediaPlayer-Komponente geöffnet werden können. TMPDeviceTypes ist der Typ für die Eigenschaft DeviceType.


TMPModes (Typ)

TMPModes definiert die Modi für ein mit der TMediaPlayer-Komponente eingesetztes Gerät.

enum TMPModes { mpNotReady, mpStopped, mpPlaying, mpRecording, mpSeeking, mpPaused, mpOpen };

Header

vcl\mplayer.hpp

Beschreibung

Der Typ TMPModes legt die Modi für ein Multimedia-Gerät fest, das mit einer TMediaPlayer-Komponente verwendet wird. TMPModes ist der Typ für die Eigenschaft Mode.


TMPNotifyValues (Typ)

TMPNotifyValues definiert die Benachrichtigungswerte für ein mit der TMediaPlayer-Komponente eingesetztes Gerät.

TMPNotifyValues = (nvSuccessful, nvSuperseded, nvAborted, nvFailure);

Header

vcl\mplayer.hpp

Beschreibung

Der Typ TMPNotifyValues legt die Benachrichtigungswerte für ein Multimedia-Gerät fest, das mit einer TMediaPlayer-Komponente verwendet wird. TMPNotifyValues ist der Typ für die Eigenschaft NotifyValue.


TMPTimeFormats (Typ)

TMPTimeFormats definiert die Zeitformate für ein mit der TMediaPlayer-Komponente eingesetztes Gerät.

enum TMPTimeFormats { tfMilliseconds, tfHMS, tfMSF, tfFrames, tfSMPTE24, tfSMPTE25, tfSMPTE30, tfSMPTE30Drop, tfBytes, tfSamples, tfTMSF };

Header

vcl\mplayer.hpp

Beschreibung

Der Typ TMPTimeFormats legt die Zeitformate für ein Multimedia-Gerät fest, das mit einer TMediaPlayer-Komponente verwendet wird. TMPTimeFormats ist der Typ für die Eigenschaft TimeFormat.


TMsgDlgButtons (Typ)

TMsgDlgButtons definiert die Menge der von den Funktionen MessageDlg und MessageDlgPos verwendeten Werte.

enum TMsgDlgBtn { mbYes, mbNo, mbOK, mbCancel, mbAbort, mbRetry, mbIgnore, mbAll, mbHelp };

typedef Set<TMsgDlgBtn, mbYes, mbHelp>  TMsgDlgButtons;

Header

vcl\dialogs.hpp

Beschreibung

Im Typ TMsgDlgButtons sind die Werte festgelegt, die eine Schaltfläche in einem Meldungsfeld annehmen kann. TMsgDlgButtons wird von den Funktionen MessageDlg und MessageDlgPos benutzt.


TMsgDlgType (Typ)

TMsgDlgType definiert Werte, die den Typ eines Meldungsfeldes beschreiben.

enum TMsgDlgType { mtWarning, mtError, mtInformation, mtConfirmation, mtCustom };

Header

vcl\dialogs.hpp

Beschreibung

Der Typ TMsgDlgType legt die Werte fest, die den Typ eines Meldungsfeldes beschreiben. TMsgDlgType wird von den Funktionen MessageDlg und MessageDlgPos benutzt.


TNavigateBtn (Typ)

TNavigateBtn definiert die Werte für die Typen TButtonSet und ENavClick sowie für die Methode Click.

enum TNavigateBtn { nbFirst, nbPrior, nbNext, nbLast, nbInsert, nbDelete, nbEdit, nbPost, nbCancel, nbRefresh };

Header

vcl\dbctrls.hpp

Beschreibung

Im Typ TNavigateBtn sind die zulässigen Werte für den Typ TButtonSet definiert. Er wird außerdem in der Methode Click und dem Typ ENavClick verwendet.


TNodeAttachMode (Typ)

TNodeAttachMode wird an die Methode MoveTo übergeben, um die Neuverbindung eines Elements festzulegen.

enum TNodeAttachMode { naAdd, naAddFirst, naAddChild, naAddChildFirst, naInsert };

Header

vcl\comctrls.hpp

Beschreibung

Der Typ TNodeAttachMode legt die Möglichkeiten fest, mit denen ein Element mit einen Baumdiagramm verbunden werden kann. Eine Variable dieses Typs wird an die MoveTo-Methode des Baumdiagramms übergeben. Sie legt fest, wie ein verschobenes Element im Verhältnis zum Zielknoten wieder mit dem Baumdiagramm verbunden wird.


TNotifyEvent (Typ)

TNotifyEvent wird für Ereignisse verwendet, die keine Parameter erfordern.

typedef void __fastcall (__closure *TNotifyEvent)(System::TObject* Sender);

Header

vcl\classes.hpp

Beschreibung

TNotifyEvent ist der Typ für Ereignisse, die keine Parameter erfordern. Diese Ereignisse benachrichtigen die Komponente nur davon, daß ein bestimmtes Ereignis eingetreten ist. Beispielsweise teilt OnClick (Typ TNotifyEvent) dem Steuerelement mit, daß auf dem Steuerelement ein Klick-Ereignis stattgefunden hat.


TNumberingStyle (Typ)

TNumberingStyle definiert die Werte für die Numbering-Eigenschaft von TParaAttributes.

enum TNumberingStyle { nsNone, nsBullet };

Header

vcl\comctrls.hpp

Beschreibung

Der Typ TNumberingStyle definiert die Werte, die für die Numbering-Eigenschaft des TParaAttributes-Objekts zulässig sind. TParaAttributes ist der Typ für die Eigenschaft Paragraph der Komponente TRichEdit.


TNumGlyphs (Typ)

TNumGlyphs definiert die Werte für die NumGlyphs-Eigenschaft von TBitBtn- und TSpeedButton-Objekten.

typedef Shortint TNumGlyphs;

Header

vcl\buttons.hpp

Beschreibung

Der Typ TNumGlyphs definiert den Bereich der Werte (1-4), den die Eigenschaft NumGlyphs einer Bitmap-Schaltfläche (TBitBtn) oder eines Mauspalettenschalters (TSpeedButton) annehmen kann.


TObjectState (Typ)

Siehe auch

TObjectState definiert die Werte für die Eigenschaft State einer TOleContainer-Komponente.

enum TObjectState { osEmpty, osLoaded, osRunning, osOpen, osInPlaceActive, osUIActive };

Header

vcl\olectnrs.hpp

Beschreibung

Der Aufzählungstyp TObjectState definiert die möglichen Werte für die State-Eigenschaft von TOleContainer. Die folgende Tabelle faßt diese Werte zusammen:

Werte	Beschreibung

osEmpty	Der Container enthält kein OLE-Objekt.

osLoaded	Der Container enthält zwar ein OLE-Objekt, die Server-Anwendung wird aber momentan nicht ausgeführt.

osRunning	Die Server-Anwendung des OLE-Objekts wird ausgeführt.

osOpen	Das OLE-Objekt ist in einem separaten Fenster geöffnet.

osInPlaceActive	Das OLE-Objekt ist zwar inplace aktiviert, die zugehörigen Menüs bzw. Werkzeugleisten wurden aber noch nicht kombiniert. Es handelt sich hier um eine Zwischenstufe. Die State-Eigenschaft ändert sich in osUIActive, sobald die Menüs und Werkzeugleisten kombiniert wurden.

osUIActive	Das OLE-Objekt ist inplace aktiviert, und die Menüs und Werkzeugleisten wurden miteinander kombiniert.


TOpenOptions (Typ)

TOpenOptions definiert die Werte für die Eigenschaft Options der Komponente TOpenDialog.

enum TOpenOption { ofReadOnly, ofOverwritePrompt, ofHideReadOnly, ofNoChangeDir, ofShowHelp, ofNoValidate, ofAllowMultiSelect, ofExtensionDifferent, ofPathMustExist, ofFileMustExist, ofCreatePrompt, ofShareAware, ofNoReadOnlyReturn, ofNoTestFileCreate, ofNoNetworkButton, ofNoLongNames, ofOldStyleDialog, ofNoDereferenceLinks };

typedef Set<TOpenOption, ofReadOnly, ofNoDereferenceLinks>  TOpenOptions;

Header

vcl\dialogs.hpp

Beschreibung

Der Typ TOpenOptions enthält die Werte, die die Options-Eigenschaft des Dialogfeldes Öffnen (TOpenDialog) annehmen kann.


TOutlineOptions (Typ)

TOutlineOptions definiert die Anzeigeoptionen für eine TOutline-Komponente.

enum TOutlineOption { ooDrawTreeRoot, ooDrawFocusRect, ooStretchBitmaps };

typedef Set<TOutlineOption, ooDrawTreeRoot, ooStretchBitmaps>  TOutlineOptions;

Header

vcl\outline.hpp

Beschreibung

Im Typ TOutlineOptions sind die Anzeigeoptionen einer TOutline-Komponente festgelegt. TOutlineStyle ist der Typ für die Eigenschaft Options.


TOutlineStyle (Typ)

TOutlineStyle legt den Zeichnungsstil einer TOutline-Komponente fest, wenn Style auf osStandard gesetzt ist.

enum TOutlineStyle { osText, osPlusMinusText, osPictureText, osPlusMinusPictureText, osTreeText, osTreePictureText };

Header

vcl\outline.hpp

Beschreibung

Der Typ TOutlineStyle legt fest, wie die Elemente einer TOutline-Komponente gezeichnet werden, wenn die Style-Eigenschaft auf osStandard gesetzt ist. TOutlineStyle ist der Typ für die Eigenschaft OutlineStyle.


TOutlineType (Typ)

TOutlineType definiert die Style-Eigenschaft für TOutline-Komponenten.

enum TOutlineType { otStandard, otOwnerDraw };

Header

vcl\outline.hpp

Beschreibung

Der Typ TOutlineType legt fest, ob sich eine TOutline-Komponente in der üblichen Weise selbst zeichnet oder ob ein Code erstellt wird, der für das Zeichnen der enthaltenen Elemente sorgt. TOutlineType ist der Typ für die Eigenschaft Style.


TOwnerDrawState (Typ)

TOwnerDrawState definiert die Werte für den State-Parameter von TDrawItemEvent.

enum StdCtrls_9 { odSelected, odGrayed, odDisabled, odChecked, odFocused };

typedef Set<StdCtrls_9, odSelected, odFocused>  TOwnerDrawState;

Header

vcl\stdctrls.hpp

Beschreibung

Der Typ TOwnerDrawState legt die Werte fest, die der State-Parameter im TDrawItemEvent-Methodenzeiger eines vom Eigentümer gezeichneten Listenfeldes annehmen kann.


TPanelBevel (Typ)

TPanelBevel definiert die Werte für die Eigenschaften BevelInner und BevelOuter.

enum TPanelBevel { bvNone, bvLowered, bvRaised };

Header

vcl\extctrls.hpp

Beschreibung

Der Typ TPanelBevel enthält die Werte, die die Eigenschaften BevelInner und BevelOuter annehmen können.


TParamBindMode (Typ)

TParamBindMode definiert die Werte für die ParamBindMode-Eigenschaft einer TStoredProc-Komponente.

enum TParamBindMode { pbByName, pbByNumber };

Header

vcl\dbtables.hpp

Beschreibung

Der Typ TParamBindMode definiert die Werte, die für die ParamBindMode-Eigenschaft einer gespeicherten Prozedur (TStoredProc) zulässig sind.


TParamType (Typ)

TParamType legt die Werte für die ParamType-Eigenschaft eines TParam-Objekts fest.

enum TParamType { ptUnknown, ptInput, ptOutput, ptInputOutput, ptResult };

Header

vcl\dbtables.hpp

Beschreibung

Der Typ TParamType enthält die Menge der Werte, die für die Eigenschaft ParamType eines TParam-Objekts zulässig sind.


TPaymentTime (Typ)

Der Aufzählungstyp TPaymentTime wird als Parameter in Finanzfunktionen eingesetzt.

enum TPaymentTime { ptEndOfPeriod, ptStartOfPeriod };

Header

vcl\math.hpp

Beschreibung

TPaymentTime ist ein Aufzählungstyp, der als Parameter in vielen Finanzfunktionen Verwendung findet.


TPenMode (Typ)

TPenMode definiert die Werte für die Mode-Eigenschaft von TPen.

enum TPenMode { pmBlack, pmWhite, pmNop, pmNot, pmCopy, pmNotCopy, pmMergePenNot, pmMaskPenNot, pmMergeNotPen, pmMaskNotPen, pmMerge, pmNotMerge, pmMask, pmNotMask, pmXor, pmNotXor };

Header

vcl\graphics.hpp

Beschreibung

Der Typ TPenMode legt die Werte fest, die die Eigenschaft Mode eines Stiftobjekts (TPen) annehmen kann.


TPenStyle (Typ)

TPenStyle definiert die Werte für die Style-Eigenschaft von TPen.

enum TPenStyle { psSolid, psDash, psDot, psDashDot, psDashDotDot, psClear, psInsideFrame };

Header

vcl\graphics.hpp

Beschreibung

Der Typ TPenStyle legt die Werte fest, die die Eigenschaft Style eines Stiftobjekts (TPen) annehmen kann.


TPoint (Typ)

TPoint definiert die Pixel-Position auf dem Bildschirm.

typedef tagPOINT  TPoint;

Header

vcl\windows.hpp

Beschreibung

Der Typ TPoint legt eine Pixel-Position auf dem Bildschirm fest, wobei der Ursprungspunkt in der linken oberen Ecke liegt. X stellt die horizontale Koordinate des Punktes dar, Y die vertikale Koordinate.


TPopupAlignment (Typ)

PopupAlignment legt die Position fest, an der TPopupMenu angezeigt wird.

enum TPopupAlignment { paLeft, paRight, paCenter };

Header

vcl\menus.hpp

Beschreibung

Der Typ PopupAlignment bestimmt, wo ein Popup-Menü (TPopupMenu) angezeigt wird. Die Alignment-Eigenschaft eines Popup-Menüs ist vom Typ TPopupAlignment.


TPosition (Typ)

TPosition enthält die Werte für die Position-Eigenschaft eines Formulars.

enum TPosition { poDesigned, poDefault, poDefaultPosOnly, poDefaultSizeOnly, poScreenCenter };

Header

vcl\forms.hpp

Beschreibung

Im Aufzählungstyp TPosition sind die Werte enthalten, die die Position-Eigenschaft eines Formulars annehmen kann.


TPrintDialogOptions (Typ)

TPrintDialogOptions definiert die Werte für die Eigenschaft Options der Komponente TPrintDialog.

enum TPrintDialogOption { poPrintToFile, poPageNums, poSelection, poWarning, poHelp, poDisablePrintToFile };

typedef Set<TPrintDialogOption, poPrintToFile, poDisablePrintToFile>  TPrintDialogOptions;

Header

vcl\dialogs.hpp

Beschreibung

Der Typ TPrintDialogOptions enthält die Menge der Werte, die die Options-Eigenschaft des Dialogfeldes Drucken (TPrintDialog) annehmen kann.


TPrinterOrientation (Typ)

TPrinterOrientation definiert die Werte für die Orientation-Eigenschaft von TPrinter.

enum TPrinterOrientation { poPortrait, poLandscape };

Header

vcl\printers.hpp

Beschreibung

Der Typ TPrinterOrientation definiert die Werte, die für die Orientation-Eigenschaft des Druckerobjekts (TPrinter) zulässig sind.


TPrintRange (Typ)

TPrintRange definiert die Werte für die Eigenschaft PrintRange der Komponente TPrintDialog.

enum TPrintRange { prAllPages, prSelection, prPageNums };

Header

vcl\dialogs.hpp

Beschreibung

Der Typ TPrintRange legt die Werte fest, die die PrintRange-Eigenschaft des Dialogfeldes Drucken (TPrintDialog) annehmen kann.


TPrintScale (Typ)

TPrintScale definiert die Werte für die PrintScale-Eigenschaft eines Formulars.

enum TPrintScale { poNone, poProportional, poPrintToFit };

Header

vcl\forms.hpp

Beschreibung

Der Typ TPrintScale enthält die zulässigen Werte für die PrintScale-Eigenschaft des Formulars.


TRect (Typ)

Der Typ TRect definiert ein Rechteck.

struct TRect

{

TRect() { }

TRect(RECT& r) {

Left = r.left;

Top = r.top;

Right = r.right;

Bottom = r.bottom;

}

operator RECT() {

RECT r;

r.left = Left;

r.top = Top;

r.right = Right;

r.bottom = Bottom;

return r;

}

union

{

struct

{

POINT TopLeft;

POINT BottomRight;

};

struct

{

int Left;

int Top;

int Right;

int Bottom;

};

};

} ;

Header

vcl\windows.hpp

Beschreibung

Die Koordinaten werden entweder als vier einzelne Integerzahlen angegeben, die die Pixel-Positionen des linken, oberen, rechten und unteren Randes bestimmen, oder als zwei Punkte, die die Pixel-Positionen der oberen linken und der unteren rechten Ecke kennzeichnen. Der Ursprung des Pixel-Koordinatensystems liegt in der oberen linken Ecke des Bildschirms.


TResType (Typ)

TResType definiert den Typ einer grafischen Ressource für TImageList.

enum TResType { rtBitmap, rtCursor, rtIcon };

Header

vcl\controls.hpp

Beschreibung

TResType wird von den Bilderlistenmethoden ResourceLoad, GetResource und FileLoad zur Angabe des Typs der grafischen Ressource verwendet, die aus der Bilderliste (TImageList) geladen bzw. abgerufen werden soll. Die folgende Tabelle enthält eine Beschreibung dieser Werte:

Wert	Bedeutung

rtBitmap	Lädt oder ermittelt ein Bitmap.

rtCursor	Lädt oder ermittelt einen Cursor.

rtIcon	Lädt oder ermittelt ein Symbol.


TScrollBarInc (Typ)

TScrollBarInc definiert die Werte für die Eigenschaften SmallChange und LargeChange von TScrollBar.

typedef Word TScrollBarInc;

Header

vcl\forms.hpp

Beschreibung

Der Typ TScrollBarInc legt die zulässigen Werte für die Eigenschaften SmallChange und LargeChange einer Bildlaufleiste (TScrollBar) fest.


TScrollBarKind (Typ)

TScrollBarKind definiert die Kind-Eigenschaft einer Bildlaufleiste.

enum TScrollBarKind { sbHorizontal, sbVertical };

Header

vcl\forms.hpp

Beschreibung

Mit dem Typ TScrollBarKind wird die Ausrichtung für eine Bildlaufleiste festgelegt: horizontal oder vertikal. TScrollBarKind ist der Typ für die Eigenschaft Kind von Bildlaufleisten.


TScrollCode (Typ)

TScrollCode wird von TScrollEvent zur Definition des Status einer Bildlaufleiste verwendet.

enum TScrollCode { scLineUp, scLineDown, scPageUp, scPageDown, scPosition, scTrack, scTop, scBottom, scEndScroll };

Header

vcl\stdctrls.hpp

Beschreibung

Der Typ TScrollCode definiert möglichen Werte für den Status einer Bildlaufleiste. Er wird vom TScrollEvent-Methodenzeiger benutzt.


TScrollStyle (Typ)

TScrollStyle definiert die ScrollBars-Eigenschaft für TMemo, TDBMemo, TDrawGrid und TStringGrid.

enum TScrollStyle { ssNone, ssHorizontal, ssVertical, ssBoth };

Header

vcl\stdctrls.hpp

Beschreibung

Im Typ TScrollStyle sind die verschiedenen Bildlaufleistenkombinationen festgelegt, die ein Memo- oder Gittersteuerelement enthalten kann. TScrollStyle ist der Typ für die ScrollBars-Eigenschaft von TMemo, TDBMemo, TDrawGrid und TStringGrid.


TSearchDirection (Typ)

TSearchDirection bestimmt die Suchrichtung für GetNexItem und GetNearestItem.

enum TSearchDirection { sdLeft, sdRight, sdAbove, sdBelow, sdAll };

Header

vcl\comctrls.hpp

Beschreibung

Mit dem Typ TSearchDirection wird festgelegt, in welcher Richtung die Methoden GetNexItem und GetNearestItem nach einem Listeneintrag suchen.

Wert	Bedeutung

sdLeft	Es wird nach einem Listeneintrag links vom angegebenen Eintrag gesucht.

sdRight	Es wird nach einem Listeneintrag rechts vom angegebenen Eintrag gesucht.

sdAbove	Es wird nach einem Listeneintrag über dem angegebenen Eintrag gesucht.

sdBelow	Es wird nach einem Listeneintrag unter dem angegebenen Eintrag gesucht.

sdAll	Ein nachfolgender Listeneintrag wird über seinen Index gesucht (dies ist die Voreinstellung).


TSearchRec (Typ)

TSearchRec definiert die Dateiinformationen, nach denen mit FindFirst oder FindNext gesucht wird.

struct TSearchRec {

int Time;

int Size;

int Attr;

System::AnsiString Name;

int ExcludeAttr;

int FindHandle;

WIN32_FIND_DATAA FindData; };

Header

vcl\sysutils.hpp

Beschreibung

Der Typ TSearchRec legt die Dateiinformationen fest, nach denen durch einen Aufruf der Funktion FindFirst oder FindNext gesucht wird. Wenn eine Datei gefunden wird, werden die Felder des TSearchRect-Parameters entsprechend der gefundenen Datei geändert.

Attr steht für die Dateiattribute der Datei. Durch einen Test von Attr auf die folgenden Attributkonstanten oder Werte kann festgestellt werden, ob die Datei ein bestimmtes Attribut aufweist:

Konstante	Wert	Beschreibung

faReadOnly	00000001	Schreibgeschützte Dateien

faHidden	00000002	Verborgene Dateien

faSysFile	00000004	Systemdateien

faVolumeID	00000008	Laufwerk-ID-Dateien

faDirectory	00000010	Verzeichnisdateien

faArchive	00000020	Archivdateien

faAnyFile	0000003F	Beliebige Dateien

Wenn Sie auf ein Attribut testen wollen, verknüpfen Sie den Feldwert über den Operator AND mit der Attributkonstanten. Besitzt die Datei das betreffende Attribut, ist der zurückgegebene Wert größer als 0. Wurde beispielsweise eine verborgene Datei gefunden, ergibt der folgende Ausdruck True: (SearchRec.Attr AND faHidden > 0).

Time enthält den Zeitstempel der Datei. In Size wird die Größe der Datei in Byte angegeben. Name enthält den DOS-Dateinamen und die zugehörige Namenserweiterung.


TSearchTypes (Typ)

TSearchTypes definiert die Werte für den Options-Parameter der Methode FindText von TRichEdit-Komponenten.

enum TSearchType { stWholeWord, stMatchCase };

typedef Set<TSearchType, stWholeWord, stMatchCase>  TSearchTypes;

Header

vcl\comctrls.hpp

Beschreibung

Der Typ TSearchTypes definiert die Werte, die der Options-Parameter der FindNext-Methode für die Komponente TRichEdit annehmen kann.


TSelectDirOpts (Typ)

TSelectDirOpts definiert die Werte für den Parameter Options der Funktion SelectDirectory.

enum TSelectDirOpt { sdAllowCreate, sdPerformCreate, sdPrompt };

typedef Set<TSelectDirOpt, sdAllowCreate, sdPrompt>  TSelectDirOpts;

Header

vcl\filectrl.hpp

Beschreibung

Der Typ TSelectDirOpts definiert die zulässigen Werte für den Parameter Options in der Funktion SelectDirectory.


TShapeType (Typ)

TShapeType definiert die Eigenschaft Shape für eine TShape-Komponente.

enum TShapeType { stRectangle, stSquare, stRoundRect, stRoundSquare, stEllipse, stCircle };

Header

vcl\extctrls.hpp

Beschreibung

Mit dem Typ TShapeType legt die Eigenschaft Shape der TShape-Komponente fest, ob diese als Rechteck, Quadrat, abgerundetes Rechteck, abgerundetes Quadrat, Ellipse oder Kreis angezeigt wird.


TShiftState (Typ)

Siehe auch

Mit TShiftState wird der Status der Tasten ALT, STRG und UMSCHALT sowie der Maustasten festgelegt.

enum Classes_1 { ssShift, ssAlt, ssCtrl, ssLeft, ssRight, ssMiddle, ssDouble };

typedef Set<Classes_1, ssShift, ssDouble>  TShiftState;

Header

vcl\classes.hpp

Beschreibung

Ereignisbehandlungsroutinen für Tastatur und Maus bestimmen bei Auftreten eines Ereignisses mit Hilfe des Typs TShiftState den Status der Tasten ALT, STRG und UMSCHALT und der Maustasten.


TShortCut (Typ)

TShortCut legt die Menütastenkürzel fest, die von ShortCutToText und ShortCutToKey benutzt werden.

typedef Word TShortCut;

Header

vcl\menus.hpp

Beschreibung

Der Typ TShortCut definiert die Tastenkürzel, die in den Menüs angezeigt werden. Diese Tastenkürzel ermöglichen es dem Benutzer, Menübefehle mit der Tastatur auszuwählen. Die Eigenschaft ShortCut ist vom Typ TShortCut. Parameter des Typs TShortCut werden von den Routinen ShortCutToText und ShortCutToKey benutzt.


TSizeMode (Typ)

Siehe auch

TSizeMode enthält die Werte für die Eigenschaft SizeMode von TOleContainer-Komponenten.

enum TSizeMode { smClip, smCenter, smScale, smStretch, smAutoSize };

Header

vcl\olectnrs.hpp

Beschreibung

Im Aufzählungstyp TSizeMode sind die möglichen Werte für die Eigenschaft SizeMode von TOleContainer definiert. Die folgende Tabelle beschreibt diese Werte.

Werte

smClip	Zeigt das OLE-Objekt in seiner normalen Größe an. Teile, die nicht im Container Platz finden, werden abgeschnitten. (Dies ist die Voreinstellung.)

SmCenter	Zeigt das OLE-Objekt in seiner normalen Größe an und zentriert es im Container.

SmScale	Skaliert oder verkleinert die Ansicht des OLE-Objekts so, daß es in den Container paßt. Höhe und Breite werden proportional angepaßt.

SmStretch	Skaliert oder verkleinert die Ansicht des OLE-Objekts so, daß es den OLE-Container ausfüllt. Auf die Proportionen des Objekts wird dabei keine Rücksicht genommen.

SmAutoSize	Entspricht smClip, paßt aber den Container automatisch an, wenn sich die Größe des OLE-Objekts ändert.


TSortType (Typ)

TSortType definiert die Eigenschaft SortType von Listenansicht- und Baumdiagramm-Komponenten.

enum TSortType { stNone, stData, stText, stBoth };

Header

vcl\comctrls.hpp

Beschreibung

Der Typ TSortType legt die Sortierfolgen für Einträge in Baumdiagramm- und Listenansicht-Komponenten fest. Die Eigenschaft SortType von Baumdiagrammen und Listenansichten benutzt diesen Typ.


TStartMode (Typ)

Siehe auch

TStartMode legt die Werte für die Eigenschaft StartMode fest, die auf den Grund für den Start eines OLE-Automation-Servers verweist.

enum TStartMode { smStandalone, smAutomation, smRegServer, smUnregServer };

Header

vcl\oleauto.hpp

Beschreibung

Der Typ TStartMode bestimmt die zulässigen Werte für die Eigenschaft StartMode. Diese gibt die verschiedenen Gründe für den Start eines OLE-Automation-Servers an.

Die folgende Tabelle enthält die Werte für diese Startmodi und die zugehörigen Kommandozeilen-Schalter.

Startmodus	Schalter	Bedeutung

smAutomation	embedding	Die Anwendung wurde von Windows als Antwort auf die Anforderung eines Automation-Controllers gestartet.

smRegServer	regserver	Die Anwendung wurde nur gestartet, um den Server der Registrierung hinzuzufügen.

smStandalone	---	Die Anwendung wurde vom Benutzer als selbständige Anwendung gestartet.

smUnregServer	unregserver	Die Anwendung wurde nur gestartet, um den Server aus der Registrierung zu entfernen.


TStatusPanelBevel (Typ)

TStatusPanelBevel definiert die Werte für die Eigenschaft Bevel von TStatusPanel.

venum TStatusPanelBevel { pbNone, pbLowered, pbRaised };

Header

vcl\comctrls.hpp

Beschreibung

Im Typ TStatusPanelBevel sind die Werte für die Eigenschaft Bevel des TStatusPanel-Objekts festgelegt. Zu den TStatusPanel-Objekten gehören die Tafeln von TStatusBar-Komponenten.


TStatusPanelStyle (Typ)

Siehe auch

TStatusPanelStyle definiert die Eigenschaft Style für TStatusPanel-Komponenten.

enum TStatusPanelStyle { psText, psOwnerDraw };

Header

vcl\comctrls.hpp

Beschreibung

Der Typ TStatusPanelStyle definiert die verschiedenen Typen für die Eigenschaft Style des TStatusPanel-Objekts. Zu den TStatusPanel-Objekten gehören die Tafeln von TStatusBar-Komponenten. In der Eigenschaft Text kann der Text einer Tafel mit dem Stil psText festgelegt werden. Für Tafeln mit dem Stil psOwnerDraw muß eine Ereignisbehandlungsroutine für OnDrawPanel geschrieben werden.


TTableType (Typ)

TTableType enthält die Werte für die Eigenschaft TableType einer TTable-Komponente.

enum TTableType { ttDefault, ttParadox, ttDBase, ttASCII };

Header

vcl\dbtables.hpp

Beschreibung

Der Typ TTableType enthält die Menge der Werte für die Eigenschaft TableType einer TTable-Komponente.


TTabOrder (Typ)

TTabOrder definiert die Integer-Werte, die als Werte für TabOrder benutzt werden.

typedef short TTabOrder;

Header

vcl\controls.hpp

Beschreibung

Der Typ TTabOrder legt einen Unterbereich mit Integern fest, die als Werte für die Eigenschaft TabOrder verwendet werden können.


TTabStyle (Typ)

TTabStyle definiert den Stil der Register in einem Registerkarten-Steuerelement.

enum TTabStyle { tsStandard, tsOwnerDraw };

Header

vcl\tabs.hpp

Beschreibung

Im Typ TTabStyle ist der Stil der Register in einem Registerkarten-Steuerelement festgelegt. TTabStyle ist der Typ für die Eigenschaft Style eines Registerkarten-Steuerelements.


TTextCase (Typ)

TTextCase definiert die Werte für die Eigenschaft Text einer TDriveComboBox-Komponente.

enum TTextCase { tcLowerCase, tcUpperCase };

Header

vcl\filectrl.hpp

Beschreibung

Der Typ TTextCase legt die Werte fest, die für die Eigenschaft Text eines Laufwerk-Kombinationsfeldes (TDriveComboBox) verfügbar sind.


TThreadPriority (Typ)

Siehe auch

TThreadPriority definiert die Werte für die Eigenschaft Priority von TThread.

enum TThreadPriority { tpIdle, tpLowest, tpLower, tpNormal, tpHigher, tpHighest, tpTimeCritical };

Header

vcl\classes.hpp

Beschreibung

TThreadPriority definiert die zulässigen Werte für die Eigenschaft Priority der TThread-Komponente. Eine Erläuterung dieser Werte finden Sie in der nachstehenden Tabelle. Windows koordiniert Threads auf der Basis einer Prioritätsskala. Mit Hilfe der Eigenschaft Priority kann die Priorität eines Thread auf der Skala nach oben oder unten verschoben werden.

Werte	Beschreibung

tpIdle	Der Thread wird nur ausgeführt, wenn das System im Leerlauf ist. Windows unterbricht zur Ausführung von Threads mit der Priorität tpIdle keine anderen Threads.

tpLowest	Die Priorität des Thread liegt zwei Punkte unter Normal.

tpLower	Die Priorität des Thread liegt einen Punkt unter Normal.

tpNormal	Der Thread hat normale Priorität.

tpHigher	Die Priorität des Thread liegt einen Punkt über Normal.

tpHighest	Die Priorität des Thread liegt zwei Punkte über Normal.

tpTimeCritical	Der Thread erhält die höchste Priorität.


TTickMark (Typ)

TTickMark definiert die Werte für die Eigenschaft TickMarks einer TTrackBar-Komponente.

enum TTickMark { tmBottomRight, tmTopLeft, tmBoth };

Header

vcl\comctrls.hpp

Beschreibung

Der Typ TTickMark legt die zulässigen Werte für die Eigenschaft TickMarks der TTrackBar-Komponente fest.


TTickStyle (Typ)

Der Typ TTickMark definiert die zulässigen Werte für die Eigenschaft TickMarks der TTrackBar-Komponente.

enum TTickStyle { tsNone, tsAuto, tsManual };

Header

vcl\comctrls.hpp


TTileMode (Typ)

TTileMode definiert die Werte für die Eigenschaft TileMode eines Formulars.

enum TTileMode { tbHorizontal, tbVertical };

Header

vcl\forms.hpp

Beschreibung

Der Typ TTileMode legt die Werte fest, welche die Eigenschaft TileMode eines Formulars annehmen kann.


TTrackBarOrientation (Typ)

TTrackBarOrientation definiert die Werte für die Eigenschaft Orientation von TTrackBar.

enum TTrackBarOrientation { trHorizontal, trVertical };

Header

vcl\comctrls.hpp

Beschreibung

Der Typ TTrackBarOrientation legt die Werte für die Eigenschaft Orientation der TTrackBar-Komponente fest.


TTransIsolation (Typ)

Der Typ TTransIsolation wird von der Eigenschaft TransIsolation benutzt. Er enthält die Menge der Werte, die zum Starten einer Transaktion verwendet werden.

enum TTransIsolation { tiDirtyRead, tiReadCommitted, tiRepeatableRead };

Header

vcl\db.hpp

Beschreibung

Der Typ TTransIsolation wird von der Eigenschaft TransIsolation benutzt und besteht aus den Werten, die zum Starten einer Transaktion verwendet werden. Diese Werte steuern, wie der Server Datensätze an Ihre Anwendung zurückgibt, die von einer anderen Anwendung geändert wurden.


TUDAlignButton (Typ)

TUDAlignButton definiert die Werte für die Eigenschaft AlignButton von TUpDown.

enum TUDAlignButton { udLeft, udRight };

Header

vcl\comctrls.hpp

Beschreibung

Der Typ TUDAlignButton legt die Werte für die Eigenschaft AlignButton der TUpDown-Komponente fest.


TUDBtnType (Typ)

TUDBtnType definiert die Werte für den Parameter Button von TUDClickEvent.

enum TUDBtnType { btNext, btPrev };

Header

vcl\comctrls.hpp

Beschreibung

Der Typ TUDBtnType enthält die Werte, die der Parameter Button für den Typ TUDClickEvent annehmen kann. TUDClickEvent ist der Rückgabetyp des OnClick-Ereignisses für eine TUpDown-Komponente. Der Wert btNext gibt an, daß auf den Rechts- oder Aufwärtspfeil geklickt wurde. Der Wert btPrev gibt an, daß auf den Links- oder Abwärtspfeil geklickt wurde.


TUDOrientation (Typ)

TUDOrientation definiert die Werte für die Eigenschaft Orientation von TUpDown.

enum TUDOrientation { udHorizontal, udVertical };

Header

vcl\comctrls.hpp

Beschreibung

Der Typ TUDOrientation legt die Werte für die Eigenschaft Orientation der TUpDown-Komponente fest.


TUpdateAction (Typ)

TUpdateAction definiert die Werte für den Parameter UpdateAction der Ereignisse OnUpdateError und OnUpdateRecord für TTable-, TQuery- und TStoredProc-Komponenten.

enum TUpdateAction { uaFail, uaAbort, uaSkip, uaRetry, uaApplied };

Header

vcl\db.hpp

Beschreibung

Der Typ TUpdateAction legt die zulässigen Werte für den Parameter UpdateAction der Ereignisse OnUpdateError und OnUpdateRecord für TTable-, TQuery- und TStoredProc-Komponenten fest. Diese Werte und ihre Bedeutung sind in der folgenden Tabelle aufgeführt:

Wert	Beschreibung

uaFail	Es wird eine Exception ausgelöst, die das Schreiben zwischengespeicherter Aktualisierungen fehlschlagen läßt.

uaAbort	Es wird eine EAbort-Exception ausgelöst, die das Schreiben zwischengespeicherter Aktualisierungen abbricht.

uaSkip	Die vorliegende zwischengespeicherte Aktualisierung wird übersprungen, alle anderen werden weiter verarbeitet.

uaRetry	Der Versuch, die zwischengespeicherte Aktualisierung für diesen Datensatz zu schreiben, wird wiederholt.

uaApplied	Die Aktualisierung wurde während des Ereignisses OnUpdateRecord geschrieben.


TUpdateKind (Typ)

TUpdateKind definiert die Werte, die der Parameter UpdateKind der Ereignisse OnUpdateError und OnUpdateRecord für TTable-, TQuery- und TStoredProc-Komponenten annehmen kann.

enum TUpdateKind { ukModify, ukInsert, ukDelete };

Header

vcl\db.hpp

Beschreibung

Der Typ TUpdateKind legt die zulässigen Werte für den Parameter UpdateKind der Ereignisse OnUpdateError und OnUpdateRecord für TTable-, TQuery- und TStoredProc-Komponenten fest. Diese Werte und ihre Bedeutung sind in der folgenden Tabelle aufgeführt:

Wert	Beschreibung

ukModify	Die zwischengespeicherte Aktualisierung für den Datensatz besteht aus einer Änderung des Datensatzinhalts.

ukInsert	Die zwischengespeicherte Aktualisierung besteht im Einfügen eines neuen Datensatzes.

ukDelete	Die zwischengespeicherte Aktualisierung besteht aus dem Löschen eines Datensatzes.


TUpdateRecordTypes (Typ)

TUpdateRecordTypes ist der Rückgabewert für die Eigenschaft UpdateRecordTypes von Datenmengenkomponenten.

enum DB_41 { rtModified, rtInserted, rtDeleted, rtUnmodified };

typedef Set<DB_41, rtModified, rtUnmodified>  TUpdateRecordTypes;

Header

vcl\db.hpp

Beschreibung

Der Typ TUpdateRecordTypes ist der Rückgabewert für die Eigenschaft UpdateRecordTypes von Datenmengenkomponenten. Die folgende Tabelle enthält eine Beschreibung dieser Werte:

Wert	Beschreibung

rtModified	Geänderte Datensätze

rtInserted	Eingefügte Datensätze

rtDeleted	Gelöschte Datensätze

rtUnmodified	Unveränderte Datensätze


TUpdateStatus (Typ)

TUpdateStatus ist der Rückgabewert der Methode UpdateStatus von Datenmengenkomponenten.

enum TUpdateStatus { usUnmodified, usModified, usInserted, usDeleted };

Header

vcl\db.hpp

Beschreibung

Der Typ TUpdateStatus ist der Rückgabewert für die Methode UpdateStatus von Datenmengenkomponenten. Die folgende Tabelle enthält eine Beschreibung dieser Werte:

Wert	Beschreibung

usUnmodified	Der Datensatzinhalt wurde nicht verändert.

usModified	Der Datensatzinhalt wurde verändert.

usInserted	Der Datensatz wurde eingefügt.

usDeleted	Der Datensatz wurde gelöscht.


TVarRec (Typ)

TVarRec wird in einer Prozedur mit dem Parametertyp array of const benutzt.

class TVarRec;

typedef TVarRec* PVarRec;

class TVarRec

{

  public:

    union

    {

      Integer      VInteger;

      Boolean      VBoolean;

      Char         VChar;

      PExtended    VExtended;

      PShortString VString;

      Pointer      VPointer;

      PChar        VPChar;

      TObject*     VObject;

      TClass       VClass;

      WideChar     VWideChar;

      PWideChar    VPWideChar;

      Pointer      VAnsiString;

      PCurrency    VCurrency;

      PVariant     VVariant;

    };

    union

    {

      Byte VType;

      long ForceAlignment; //!JK should be removed, if alignment set to 4

                           //!JK we don't need this

    };

Header

vcl\sysdefs.h

Beschreibung

Der Typ TVarRec wird in einer Prozedur mit dem Parametertyp array of const verwendet. Das Feld VType teilt der Prozedur den Typ jedes Parameters mit, der im Array Open übergeben wird.

Die Variablentypkonstanten repräsentieren die Werte, die im Tag der TVarRec-Struktur übergeben werden.


TViewStyle (Typ)

ViewStyle enthält die Werte für die Anzeige der Elemente in einer Listenansicht.

enum TViewStyle { vsIcon, vsSmallIcon, vsList, vsReport };

Header

vcl\comctrls.hpp

Beschreibung

Der Typ TViewStyle enthält die zulässigen Werte für die Anzeige der Elemente in einer Listenansicht. vsIcon zeigt jedes Element als großes Symbol an. vsList ordnet die Elemente in Spaltenform an und zeigt für jedes Element ein kleines Symbol und die Beschriftung rechts daneben an. vsReport zeigt jedes Element in einer gesonderten Zeile an. Die Elementinformationen werden in Spalten gruppiert, wobei in der Spalte ganz links ein kleines Symbol und die Beschriftung erscheint, während die nachfolgenden Spalten die untergeordneten Elemente enthalten.


TWidth (Typ)

TWidth definiert die Eigenschaften Width und WidthType, mit denen die Breite des Spaltenkopfes in einer Listenansicht festgelegt wird.

typedef int TWidth;

Header

vcl\comctrls.hpp

Beschreibung

TWidth ist der Typ der Eigenschaften Width und WidhtType. Diese bestimmen die Breite des Spaltenkopfes in der Listenansicht.


TWindowState (Typ)

TWindowState definiert die drei möglichen Stati der Eigenschaft WindowState eines Formulars.

enum TWindowState { wsNormal, wsMinimized, wsMaximized };

Header

vcl\forms.hpp

Beschreibung

Der Typ TWindowState definiert die drei Stati, die ein Formular annehmen kann: normal, zum Symbol verkleinert oder zum Vollbild vergrößert. TWindowState ist der Typ für die Eigenschaft WindowState eines Formulars.


TWordArray (Typ)

TWordArray deklariert ein allgemeines Array des Typs Word.

typedef Word TWordArray[16384];

Header

vcl\sysutils.hpp

Beschreibung

TWordArray deklariert ein allgemeines Array des Typs Word, das für die Typumwandlung eingesetzt werden kann.


Unassigned (Konstante)

Die Konstante Unassigned wird für eine variante Variable verwendet, der noch kein Wert zugewiesen wurde.

extern Variant Unassigned;

Header

vcl\system.hpp

Beschreibung

Mit der Konstante Unassigned wird eine variante Variable gekennzeichnet, der noch kein Wert zugewiesen wurde. Der Anfangswert jeder varianten Variablen ist Unassigned. Sobald aber eine Wertzuweisung an die variante Variable erfolgt, ist nicht mehr der Wert Unassigned zugewiesen. Dies gilt auch dann, wenn der Variablen der Wert 0, ein String mit der Länge Null oder der Wert NULL zugewiesen wird.

Die Verwendung einer Variante mit dem Wert Unassigned in einem Ausdruck hat eine EVariantError-Exception zur Folge. Der Versuch, eine Variante mit dem Wert Unassigned (mit VarAsTyp oder VarCast) in einen anderen Typ umzuwandeln, führt ebenfalls zu einer EVariantError-Exception.

Sie können einer varianten Variable den Status Nicht zugewiesen zuordnen, indem Sie ihr die Konstante Unassigned zuweisen. Dies ist sinnvoll, wenn eine Variante eine Referenz auf ein OLE-Automation-Objekt enthält, da damit das Objekt "am Leben erhalten" wird, bis der Varianten wieder ein Wert zugewiesen wird. Im nachstehenden Quelltextfragment sorgt die Anweisung, die der Variablen MSWord Unassigned zuweist, für die Freigabe des OLE-Automation-Objekts, das eine Schnittstelle zu Word herstellt.

var

  MSWord: Variant;

begin

  ...

  MSWord := CreateOleObject('Word.Basic');

  ...

  MSWord := Unassigned;

  ...

end;

Durch einen Vergleich einer Varianten mit der Konstanten Unassigned oder mit Hilfe der Standardfunktion VarIsEmpty kann festgestellt werden, ob eine Variante den Wert Unassigned hat. Wenn die Standardfunktion VarType für eine nicht zugewiesene Variante eingesetzt wird, liefert sie varEmpty zurück.


WordRec (Typ)

WordRec deklariert einen Hilfsdatensatz, in dem die höher- und niederwertigen Bytes einer Variablen gespeichert werden.

#pragma pack(push, 1)

struct WordRec {

Byte Lo;

Byte Hi; };

#pragma pack(pop)

Header

vcl\sysdefs.h

vcl\description.hpp

Der Typ WordRec deklariert einen Hilfsdatensatz, in dem die höher- und niederwertigen Bytes der angegebenen Variablen im Typ Byte gespeichert werden. WordRec wird hauptsächlich für die Typumwandlung verwendet.


Alignment-Beispiel

Dieser Quelltext plaziert das Markierungsfeld des TCheckBox-Steuerelements links vom seinem Bezeichnungsfeld:

void __fastcall TForm1::Button1Click(TObject *Sender)

{

CheckBox1->Ctl3D = false;

CheckBox1->Alignment = taLeftJustify;

}

Dieser Quelltext richtet als Reaktion auf einen Klick auf ein Schaltfläche mit der Bezeichnung RightAlign, Text in einem Label mit der Bezeichnung Label1 auf der rechten Seite aus:

void __fastcall TForm1::RightAlignClick(TObject *Sender)

{

Label1->Alignment = taRightJustify;

}


AllowGrayed-Beispiel

Dieses Beispiel verwendet ein Markierungsfeld auf einem Formular. Wenn die Anwendung ausgeführt wird, ist das Markierungsfeld anfangs markiert. Die Markierung wird aufgehoben, wenn der Benutzer das Markierungsfeld anklickt. Nochmaliges Anklicken bewirkt eine graue Anzeige des Markierungsfelds.

void __fastcall TForm1::FormCreate(TObject *Sender)

{

CheckBox1->AllowGrayed = true;

CheckBox1->State = cbChecked;

}


AutoSelect-Beispiel

Dieses Beispiel verwendet ein Editierfeld und ein Markierungsfeld auf einem Formular. Setzen Sie den Titel des Markierungsfeld auf 'AutoSelect Text'. Wenn der Benutzer das Markierungsfeld markiert, wird Text automatisch ausgewählt, wenn das Editierfeld über die Tabulatortaste angesteuert wird. Entsprechend wird Text nicht automatisch ausgewählt, wenn die Markierung aus dem Markierungsfeld entfernt wird.

void __fastcall TForm1::CheckBox1Click(TObject *Sender)

{

if (CheckBox1->Checked)

Edit1->AutoSelect = true;

else

Edit1->AutoSelect = false;

}


AutoSize-Beispiel

Dieses Beispiel verwendet ein Editierfeld, ein Label und eine Schaltfläche auf einem Formular. Wenn der Benutzer die Schaltfläche anklickt, wird die Schrift im Editierfeld vergrößert, und das Editierfeld wird ebenfalls vergrößert, um die größere Schrifthöhe aufzunehmen.

void __fastcall TForm1::Button1Click(TObject *Sender)

{

Edit1->AutoSize = true;

Edit1->Font->Size = 20;

Label1->Caption = "The edit box is bigger now";

}

Dieses Beispiel verwendet ein Image-Steuerelement und eine Schaltfläche. Verkleinern Sie die Bildkomponente, so daß sie zu klein ist, um die Bitmap vollständig anzuzeigen. Wenn der Anwender die Schaltfläche anklickt, wird die Bitmap in die Bildkomponente geladen; die Bildkomponente ändert ihre Größe und zeigt die Bitmap vollständig an.

void __fastcall TForm1::Button1Click(TObject *Sender)

{

Image1->AutoSize = true;

Image1->Picture->LoadFromFile("BITMAP.BMP");

}


BevelInner-Beispiel

Dieses Beispiel verwendet eine Bedienfeldkomponente und eine Schaltfläche mit dem Namen CreateStatusLine auf einem Formular. Der Quelltext verschiebt das Bedienfeld an die Unterkante des Formulars, wenn der Anwender die Schaltfläche anklickt, und gibt dem Bedienfeld das Aussehen einer Statuszeile, indem er die Werte der Eigenschaften BevelInner, BevelOuter, BevelWidth und BorderWidth ändert.

void __fastcall TForm1::CreateStatusLineClick(TObject *Sender)

{

Panel1->Align = alBottom;

    	Panel1->BevelInner = bvLowered;

    	Panel1->BevelOuter = bvRaised;

    	Panel1->BorderWidth = 1;

    	Panel1->BevelWidth = 1;

}


BevelOuter-Beispiel

Dieser Quelltext erzeugt einen abgesenkten Rahmen von 10 Pixeln Breite um eine Bedienfeldkomponente mit dem Namen Panel1:

Panel1->BorderWidth = 10;

Panel1->BevelInner = bvRaised;

Panel1->BevelOuter = bvLowered;


BevelWidth-Beispiel

Dieser Quelltext schaltet beim Anklicken der Schaltfläche Button1 zwischen der Anzeige eines Bedienfelds mit und ohne Schrägen um:

void __fastcall TForm1::Button1Click(TObject *Sender)

{

Panel1->BevelInner = bvLowered;

Panel1->BevelOuter = bvRaised;

if (Panel1->BevelWidth == 0)

Panel1->BevelWidth = 2;

else

Panel1->BevelWidth = 0;

}


BorderStyle-Beispiel

Dieses Beispiel umgibt das Editierfeld Edit1 mit einer einfachen Rahmenlinie:

Edit1->BorderStyle = bsSingle;


BorderWidth-Beispiel

Dieses Beispiel verwendet eine Bedienfeldkomponente und eine Schaltfläche mit dem Namen CreateStatusLine auf einem Formular. Wenn der Benutzer die Schaltfläche anklickt, verschiebt der Quelltext das Bedienfeld an die Unterkante des Formulars und verleiht ihm das Aussehen einer Statuszeile, indem er die Werte der Eigenschaften BevelInner, BevelOuter, BevelWidth und BorderWidth ändert:

void __fastcall TForm1::CreateStatusLineClick(TObject *Sender)

{

Panel1->Align = alBottom;

Panel1->BevelInner = bvLowered;

Panel1->BevelOuter = bvRaised;

Panel1->BorderWidth = 1;

Panel1->BevelWidth = 1;

}


BoundsRect-Beispiel

Dieser Quelltext ändert die Größe eines Schaltflächen-Steuerelements auf die doppelte Breite und die halbe Höhe:

void __fastcall TForm1::Button1Click(TObject *Sender)

{

TRect MyRect;

MyRect = Button1->BoundsRect;

MyRect.Right = MyRect.Left + 2 * (MyRect.Right - MyRect.Left);

MyRect.Bottom = MyRect.Top + (MyRect.Bottom - MyRect.Top) / 2;

Button1->BoundsRect = MyRect;

}


Cancel-Beispiel

Dieser Quelltext kennzeichnet die Schaltfläche Button1 als Abbruchschaltfläche:

Button1->Cancel = true;


CanFocus-Beispiel

Dieses Beispiel verwendet ein Gruppenfeld, ein Label und eine Schaltfläche auf einem Formular. Das Gruppenfeld enthält ein Markierungsfeld. Wenn die Anwendung ausgeführt wird, ist das Gruppenfeld deaktiviert (Enabled ist auf False gesetzt). Da das Gruppenfeld das übergeordnete Steuerelement des Markierungsfeldes ist, kann der Anwender das Markierungsfeld über den Tabulator nicht erreichen. Wenn der Anwender daraufhin die Schaltfläche anklickt, teilt der Titel des Labels mit, daß das Markierungsfeld den Eingabefokus nicht erhalten kann:

void __fastcall TForm1::Button1Click(TObject *Sender)

{

if (CheckBox1->CanFocus())

Label1->Caption = "The check box can focus";

else

Label1->Caption = "The check box cannot focus";

}

void __fastcall TForm1::FormCreate(TObject *Sender)

{

GroupBox1->Enabled = true;

}


Caption-Beispiel

Dieser Quelltext ändert den Titel eines Gruppenfeldes:

void __fastcall TForm1::Button1Click(TObject *Sender)

{

GroupBox1->Caption = "Fancy options";

}


CharCase-Beispiel

Dieses Beispiel verwendet ein Editierfeld und ein Gruppenfeld, das drei Optionsfelder enthält. Wenn der Benutzer das erste Optionsfeld auswählt, wird der Text im Editierfeld in Kleinbuchstaben angezeigt, und alle weiteren Benutzereingaben werden ebenfalls in Kleinbuchstaben ausgegeben. Wird das zweite Optionsfeld ausgewählt, erscheint der Text im Editierfeld im Großbuchstaben, ebenso auch alle Eingaben, die der Benutzer anschließend noch vornimmt. Wenn der Benutzer das dritte Optionsfeld anwählt, bleibt der Text im Editierfeld unverändert, aber es können sowohl Groß- als auch Kleinbuchstaben eingegeben werden:

void __fastcall TForm1::RadioButton1Click(TObject *Sender)

{

Edit1->CharCase = ecLowerCase;

}

void __fastcall TForm1::RadioButton2Click(TObject *Sender)

{

Edit1->CharCase = ecUpperCase;

}

void __fastcall TForm1::RadioButton3Click(TObject *Sender)

{

Edit1->CharCase = ecNormal;

}


Checked-Beispiel

Dieses Beispiel markiert ein Optionsfeld zur Laufzeit:

RadioButton1->Checked = true;

Dieses Beispiel enthält eine Hauptmenükomponente, die ein Menüelement SnapToGrid1 auf einem Formular enthält. Wenn der Benutzer den Befehl Snap To Grid (am Raster ausrichten) auswählt, erscheint neben dem Befehl ein Markierungszeichen. Wird der Befehl Snap To Grid ein zweites Mal ausgewählt, verschwindet das Markierungszeichen:

void __fastcall TForm1::SnapToGrid11Click(TObject *Sender)

{

SnapToGrid11->Checked = !SnapToGrid11->Checked;

}


ClearSelection-Beispiel

Dieser Quelltext verwendet ein Memo-Steuerelement mit dem Namen MyMemo und eine Schaltfläche auf einem Formular. Wenn der Anwender die Schaltfläche anklickt, wird der ausgewählte Text im Memo-Steuerelement gelöscht.

void __fastcall TForm1::Button1Click(TObject *Sender)

{

MyMemo->ClearSelection();

}


ClientToScreen-Beispiel

Dieses Beispiel verwendet zwei Editierfelder auf einem Formular. Wenn der Anwender einen Punkt auf dem Formular anklickt, erscheint die X-Bildschirmkoordinate in Editierfeld Edit1 und die Y-Bildschirmkoordinate in Edit2.

void __fastcall TForm1::FormMouseDown(TObject *Sender, TMouseButton Button,	TShiftState Shift, int X, int Y)

{

TPoint P, Q;

P.x = X;	// P ist der TPoint-Datensatz des Formulars

P.y = Y;

Q = ClientToScreen(P);	// Q ist der TPoint für den Bildschirm

char xCoord[40];

char yCoord[40];

itoa(Q.x, xCoord, 10);	//Integerwerte in Strings umwandeln

itoa(Q.y, yCoord, 10);

AnsiString xString(xCoord);

AnsiString yString(yCoord);

Edit1->Text = xString + " is the X screen coordinate";

Edit2->Text = yString + " is the Y screen coordinate";

}


ComponentIndex-Beispiel

Der folgende Quelltext verwendet eine Schaltfläche und ein breites Editierfeld auf einem Formular. Wenn der Anwender die Schaltfläche anklickt, zeigt das Editierfeld den Indexwert der Schaltflächenkomponente an:

void __fastcall TForm1::Button1Click(TObject *Sender)

{

char index[10];

char *string = new char[strlen("The index of the button is ")];

itoa(Button1->ComponentIndex, index, 10);

strcpy(string, "The index of the button is ");

strcat(string, index);

Edit1->Text = string;

delete string;

}


ContainsControl-Beispiel

Dieses Beispiel verwendet ein Label, ein Listenfeld und eine Schaltfläche auf einem Formular. Wenn der Benutzer die Schaltfläche klickt teilt das Textfeld des Labels mit, daß das Formular das Listenfeld enthält:

void __fastcall TForm1::Button1Click(TObject *Sender)

{

if(Form1->ContainsControl(ListBox1))

Label1->Caption = "The form contains ListBox1";

}


CopyToClipboard-Beispiel

Die folgende Methode kopiert den ausgewählten Text aus dem Memo-Steuerelement namens Memo1 in die Zwischenablage und fügt ihn in ein Editierfenster namens Edit1 ein, wenn der Anwender die Schaltfläche Button1 anklickt:

void __fastcall TForm1::Button1Click(TObject *Sender)

{

Memo1->CopyToClipboard();

Edit1->PasteFromClipboard();

}


Ctl3D-Beispiel

Der folgende Quelltext schaltet das 3-D-Aussehen eines Memosteuerelements um, wenn der Anwender eine Schaltfläche namens Toggle anklickt:

void __fastcall TForm1::ToggleClick(TObject *Sender)

{

Memo1->Ctl3D = !Memo1->Ctl3D;	//Schaltet die Ctl3d-Eigenschaft...

 	//...von Memo1 an/aus

}


CutToClipboard-Beispiel

Die folgende Methode schneidet den Text, den der Anwender in Memo1 auswählt, aus, und stellt ihn in die Zwischenablage. Aus der Zwischenablage wird er in ein Editierfenster eingefügt, wenn der Anwender die Schaltfläche anklickt:

void __fastcall TForm1::Button1Click(TObject *Sender)

{

Memo1->CutToClipboard();

Edit1->PasteFromClipboard();

}


DragCursor-Beispiel

Der folgende Quelltext ändert den DragCursor von Memo1 in crIBeam.

Memo1->DragCursor = crDrag;


Dragging-Beispiel

Dieses Beispiel verwendet drei Markierungsfelder auf einem Formular. Sobald der Anwender beginnt, eines der Markierungsfelder zu ziehen, ändert sich die Farbe des Formulars:

void __fastcall TForm1::FormActivate(TObject *Sender)

{

CheckBox1->DragMode = dmAutomatic;

CheckBox2->DragMode = dmAutomatic;

CheckBox3->DragMode = dmAutomatic;

}

void __fastcall TForm1::FormDragOver(TObject *Sender, TObject *Source, int X, int Y, TDragState State, bool &Accept)

{

if (CheckBox1->Dragging())

Color = clAqua;

if (CheckBox2->Dragging())

Color = clYellow;

if (CheckBox3->Dragging())

Color = clLime;

}


DragMode-Beispiel

Dieses Beispiel legt fest, ob der Ziehmodus der Schaltfläche auf dem Formular manuell ist. Wenn ja, wird das Ziehen der Schaltfläche möglich.

void __fastcall TForm1::Button1Click(TObject *Sender)

{

if (Button1->DragMode == dmManual)

Button1->BeginDrag(true);

}


DropDownCount-Beispiel

Der folgende Quelltext weist der Eigenschaft DropDownCount von ComboBox1 drei zu. Um mehr als drei Elemente in der Dropdown-Liste zu sehen, muß der Anwender einen Bildlauf durchführen.

ComboBox1->DropDownCount = 3;


Enabled-Beispiel

Die folgende Quelltext-Zeile deaktiviert eine Schaltfläche namens FormatDiskButton:

FormatDiskButton->Enabled = false;


EndDrag-Beispiel

Der folgende Quelltext bricht das Ziehen von Label1 ab, ohne das Objekt abzulegen.

Label1->EndDrag(false);


FindComponent-Beispiel

Für dieses Beispiel plazieren Sie diverse Komponenten einschließlich eines Editierfensters und einer Schaltfläche auf einem Formular. Klickt der Benutzer die Schaltfläche an, so zeigt der Quelltext im Editierfenster den Wert von ComponentIndex des Editierfensters an:

void __fastcall TForm1::Button1Click(TObject *Sender)

{

TComponent * TheComponent;

char buf[10];

TheComponent = FindComponent("Edit3");

wsprintf(buf,"%d",TheComponent->ComponentIndex);

Edit1->Text = buf;

}


GetSelTextBuf-Beispiel

void __fastcall TForm1::Button1Click(TObject *Sender)

{

int Size = Edit1->SelLength;	// Länge des selektierten Textes in Edit1 holen

Size++;                       	// Platz für Nullzeichen schaffen

char *Buffer = new char[Size];	// dynamische Puffervariable erzeugen

Edit1->GetSelTextBuf(Buffer,Size); 	// Edit1->Text in den Puffer geben

Edit2->Text = Buffer;

delete Buffer;

}


GetTextBuf-Beispiel

Dieses Beispiel kopiert den Text aus einem Editierfenster in einen mit einem Nullzeichen terminierten String und setzt diesen in ein anderes Editierfenster, sobald der Benutzer die Schaltfläche auf dem Formular anklickt.

void __fastcall TForm1::Button1Click(TObject *Sender)

{

int Size = Edit1->GetTextLen(); 	// Länge des Strings in Edit1 holen

char *name = new char[++Size];	//Platz für String zuweisen

Edit1->GetTextBuf(name, Size);	//Edit1->Text in den Puffer setzen

Edit2->Text = name;	//Puffer in Edit2->Text setzen

delete name;	//Speicher für Puffer freigeben

}


GetTextLen-Beispiel

Dieses Beispiel verwendet zwei Editierfelder und eine Schaltfläche auf einem Formular. We. When the user clicks the button, the length of the text in the Edit1 is displayed in Edit2.

void __fastcall TForm1::Button1Click(TObject *Sender)

{

int Size;

char sizeString[20];

Size = Edit1->GetTextLen();

itoa(Size, sizeString, 10);

AnsiString textString(sizeString);

Edit2->Text =  textString + " characters in Edit1" ;

}


Handle-Beispiel

Der folgende Quelltext verwendet die Windows-API-Funktion ShowWindow, um Form2 als Symbol anzuzeigen, aber nicht zu aktivieren:

ShowWindow(Form2->Handle, SW_SHOWMINIMIZED);


Height-Beispiel

Der folgende Quelltext verdoppelt die Höhe eines Memo-Steuerelements:

void __fastcall TForm1::Button1Click(TObject *Sender)

{

Memo1->Height = Memo1->Height * 2;

}


Hide-Beispiel

Dieser Quelltext benutzt eine Schaltfläche und einen Timer auf einem Formular. Klickt der Benutzer die Die Schaltfläche an, so verschwindet das Formular für eine in der Eigenschaft Interval des Timer-Steuerelements spezifizierte Dauer und erscheint dann wieder:

void __fastcall TForm1::Button1Click(TObject *Sender)

{

Timer1->Enabled = true;

Hide();

}

void __fastcall TForm1::Timer1Timer(TObject *Sender)

{

Visible = true;

Timer1->Enabled = false;

}


HideSelection-Beispiel

Dieses Beispiel verwendet ein Editierfenster und ein Memo in einem Formular. Wenn der Anwender von einem Steuerelement in ein anderes springt, bleibt der markierte Text in dem Memo markirt, nicht aber im Editierfenster.

void __fastcall TForm1::FormCreate(TObject *Sender)

{

Edit1->HideSelection = true;

Memo1->HideSelection = false;

}


Hint-Beispiel

Dieses Beispiel verwendet in einem Formular ein Editierfeld und ein Listenfeld. Dem Listenfeld werden Elemente hinzugefügt und beiden Steuerelemente wird ein Hilfehinweis zugewiesen. Die letzte Anweisung aktieviert die Hilfehinweise für die gesamte Anwendung.

void __fastcall TForm1::FormCreate(TObject *Sender)

{

Edit1->Hint = "Enter your name";

Edit1->ShowHint = true;

char string[10];

char index[3];

for(int i = 1; i <= 10; i++)

{

itoa(i, string, 10);

strcpy(string, "Item");

itoa(i, index, 10);

strcat(string, index);

ListBox1->Items->Add(string);

}

Hint = "Select an item";

ShowHint = true;

Application->ShowHint = true;

}


InsertControl-Beispiel

Dieses Beispiel verwendet eine Schaltfläche, der sich neben einem Gruppenfeld befindet. Klickt der Benutzer die Schaltfläche an, so wird das Gruppenfeld der Schaltfläche übergeordnet, d.h. die Schaltfläche verschiebt sich in das Gruppenfeld:

void __fastcall TForm1::Button1Click(TObject *Sender)

{

if (Button1->Parent == GroupBox1)

{

GroupBox1->RemoveControl(Button1);

GroupBox2->InsertControl(Button1);

}

else

{

GroupBox2->RemoveControl(Button1);

GroupBox1->InsertControl(Button1);

}

}


IntegralHeight-Beispiel

Dieses Quelltext-Beispiel benutzt ein Listenfeld auf einem Formular. Geben Sie unter Verwendung des Objektinspektors so viele Strings in die Eigenschaft Items ein wie Sie möchten. Läuft dann die Anwendung, so zeigt das Listenfeld nur die Einträge an, die vertikal vollständig hineinpassen und der untere Rand des Listenfelds verschiebt sich, sofern das Formular weniger als 300 Pixel hoch ist, nach oben bis unter den letzten String im Listenfeld:

void __fastcall TForm1::FormCreate(TObject *Sender)

{

if (Height < 300)

ListBox1->IntegralHeight = true;

else

ListBox1->IntegralHeight = false;

}


Invalidate-Beispiel

Der folgende Quelltext macht Form1 ungültig.

Form1->Invalidate();


ItemHeight-Beispiel

In diesem Beispiel werden ein Listenfeld und eine Schaltfläche auf einem Formular benutzt. Geben Sie so viele Strings in das Listenfeld ein, wie Sie möchten, indem Sie den Eigenschaften-Editor der Eigenschaft Items im Objektinspektor verwenden. Wenn der Benutzer die Schaltfläche auf dem Formular anklickt, ändert sich die Größe des vertikalen Platzes, der jedem Eintrag in dem Listenfeld zugeteilt ist:

void __fastcall TForm1::Button1Click(TObject *Sender)

{

ListBox1->Style = lbOwnerDrawFixed;

ListBox1->ItemHeight = 30;

}


ItemIndex-Beispiel

In diesem Beispiel wird ein Kombinationsfeld auf einem Formular benutzt. Wenn der Benutzer in dem Kombinationsfeld ein Laufwerk auswählt, erscheint der Indexwert des ausgewählten Eintrags in der Kopfzeile der Beschriftung:

void __fastcall TForm1::ComboBox1Change(TObject *Sender)

{

char item[5];

itoa(ComboBox1->ItemIndex, item, 10);

AnsiString indexString("Index Value ");

AnsiString itemString(item);

Label1->Caption = indexString + itemString;

}


Kind-Beispiel

Dieses Beispiel verwendet zwei Optionsfelder und eine Bildlaufleiste in einem Formular. Wählt der Anwender eines der Optionsfelder, ändert sich daraufhin die Ausrichtung der Bildlaufleiste.

void __fastcall TForm1::RadioButton1Click(TObject *Sender)

{

ScrollBar1->Kind = sbVertical;

}

void __fastcall TForm1::RadioButton2Click(TObject *Sender)

{

ScrollBar1->Kind = sbHorizontal;

}

This example uses three bitmap buttons on a form. When the application runs, the Kind property for each bitmap button is set, and the BitBtn1 button (the OK button) becomes the default button.

void __fastcall TForm1::FormCreate(TObject *Sender)

{

BitBtn1->Kind = bkOK;

BitBtn2->Kind = bkCancel;

BitBtn3->Kind = bkHelp;

}


LargeChange-Beispiel

Dieser Quelltext sorgt dafür, daß sich der Positionszeiger um 100 Positionen auf der Bildlaufleiste verschiebt, wenn der Benutzer diese außerhalb des Positionszeigers anklickt:

ScrollBar1->LargeChange = 100;


Left-Beispiel

Das folgende Beispiel verschiebt die Schaltfläche bei jedem Anklicken durch den Benutzer um 10 Pixel nach rechts:

void __fastcall TForm1::Button1Click(TObject *Sender)

{

Button1->Left = Button1->Left + 10;

}


MaxLength-Beispiel

Das folgende Beispiel setzt die Höchstzahl der Zeichen für ein Editierfeld auf 80:

Edit1->MaxLength = 80;


ModalResult-Beispiel

Die folgenden Methoden in einem Formular werden als modale Dialogfeld verwendet. Die Methoden sorgen dafür, daß das Dialogfeld beendet wird, sobald der Benutzer entweder den OK- oder die Abbruch- Schaltfläche verwendet, wobei dann von ShowModal mrOK bzw. mrCancel zurückgegeben wird:

void __fastcall TOKRightDlg::OKBtnClick(TObject *Sender)

{

ModalResult = mrOk;

}

void __fastcall TOKRightDlg::CancelBtnClick(TObject *Sender)

{

ModalResult = mrCancel;

}

Um das gleiche Ziel zu erreichen könnten Sie ebensogut den ModalResult-Wert auf mrOK für den Schalter OK und auf mrCancel für den Schalter Abbruch setzen. Wenn der Benutzer einen der beiden Schalter anklickt, wird das Dialogfeld geschlossen.


Modified-Beispiel

void __fastcall TForm1::Button1Click(TObject *Sender)

{

if (Edit1->Modified == true)

{

Application->MessageBox("Edit box text was modified",

"modified",MB_OK);

Edit1->Modified = false;

}

else

Application->MessageBox("Edit box text was not modified",

"not modified",MB_OK);

}


MultiSelect-Beispiel

Diese Quelltextzeile stellt sicher, daß der Benutzer mehrere Einträge in einem Listenfeld auswählen kann:

ListBox1->MultiSelect = true;


Name-Beispiel

Der folgende Quelltext listet die Namen aller Komponenten von Form1 in einem Listenfeld.

for(int i = 0; i < Form1->ComponentCount; i++)

ListBox1->Items->Add(Form1->Components[i]->Name;


OnClick-Beispiel

Der folgende Quelltext verzeichnet die Namen aller Komponenten auf Form1 in einem Listenfeld.

void __fastcall TForm1::FormClick(TObject *Sender)

{

Color = clBlack;

}


OnDblClick-Beispiel

Dieses Beispiel benachrichtigt den Benutzer, daß ein Doppelklick auf das Formular erfolgt ist.

void __fastcall TForm1::FormDblClick(TObject *Sender)

{

Application->MessageBox("You double-clicked the form", "Double-Click Message", MB_OK);

}


OnEnter-Beispiel

Dieses Beispiel verwendet auf einem Formular ein Editierfenster und ein Memo-Steuerelement. Wenn entweder das Editierfenster oder das Memo aktiviert ist, wird es gelb dargestellt. Wenn das aktive Steuerelement deaktiviert wird, wird die Farbe des Steuerelements auf die Windows-Systemfarbe für Fenster zurückgestellt.

void __fastcall TForm1::Edit1Enter(TObject *Sender)

{

Edit1->Color = clYellow;

}

void __fastcall TForm1::Edit1Exit(TObject *Sender)

{

Edit1->Color = clWindow;

}

void __fastcall TForm1::Memo1Enter(TObject *Sender)

{

Memo1->Color = clYellow;

}

void __fastcall TForm1::Memo1Exit(TObject *Sender)

{

Memo1->Color = clWindow;

}


OnExit-Beispiel

Dieses Beispiel verwendet auf einem Formular ein Editierfenster und ein Memo-Steuerelement. Wenn entweder das Editierfenster oder das Memo aktiv ist, wird es gelb dargestellt. Wenn das aktive Steuerelement deaktiviert wird, wird die Farbe des Steuerelements auf die Windows-Systemfarbe für Fenster zurückgesetzt.

void __fastcall TForm1::Edit1Enter(TObject *Sender)

{

Edit1->Color = clYellow;

}

void __fastcall TForm1::Edit1Exit(TObject *Sender)

{

Edit1->Color = clWindow;

}

void __fastcall TForm1::Memo1Enter(TObject *Sender)

{

Memo1->Color = clYellow;

}

void __fastcall TForm1::Memo1Exit(TObject *Sender)

{

Memo1->Color = clWindow;

}


OnKeyPress-Beispiel

Diese Ereignisbehandlungsroutine zeigt in einem Meldungs-Dialogfeld die gedrückte Taste an:

void __fastcall TForm1::FormKeyPress(TObject *Sender, char &Key)

{

char keyString[25];

strcpy(keyString, &Key);

strcat(keyString, " Was Pressed");

Application->MessageBox(keyString , "Message Box", MB_OK);

}


OnKeyUp-Beispiel

Das folgende Beispiel ändert die Farbe des Formulars in aquamarin, wenn eine Taste gedrückt wird. Wenn die Taste losgelassen wird, wird die Farbe des Formulars wieder auf den ursprünglichen Wert zurückgesetzt. Beachten Sie, daß die Eigenschaft KeyPreview des Formulars auf True eingestellt sein muß, um alle gedrückten Tasten zu erfassen. Dies ist selbst dann der Fall, wenn ein Steuerelement den Fokus besitzt:

//In the declarations section of the form

TColor FormColor;

void __fastcall TForm1::FormKeyDown(TObject *Sender, WORD &Key,

TShiftState Shift)

{

FormColor = Form1->Color;

Form1->Color = clAqua;

}

void __fastcall TForm1::FormKeyUp(TObject *Sender, WORD &Key, TShiftState Shift)

{

Form1->Color = FormColor;

}


OnMouseMove-Beispiel

Das folgende Beispiel aktualisiert zwei Label, wenn der Mauszeiger bewegt wird. Es wird angenommen, daß Sie zwei Label, lblHorz und lblVert, auf dem Formular haben. Wenn Sie diesen Quelltext dem Ereignis OnMouseMove eines Formulars zuweisen, zeigt - solange sich der Mauszeiger über dem Formular befindet - lblHorz ständig die horizontale und lblVert die vertikale Position des Mauszeigers an.

void __fastcall TForm1::FormMouseMove(TObject *Sender, TShiftState Shift, int X,

int Y)

{

char xPos[10];

char yPos[10];

itoa(X, xPos, 10);

itoa(Y, yPos, 10);

lbHorz->Caption = xPos;

 	lbVert->Caption = yPos;

}


OnMouseUp-Beispiel

Das folgende Beispiel zeichnet ein Rechteck, wenn der Anwender eine Maustaste drückt, den Mauszeiger bewegt und die Maustaste wieder losläßt. Wenn die Maustaste losgelassen wird, erscheint das Rechteck auf dem Canvas des Formulars. Die linke obere und die rechte untere Ecke werden durch die Positionen des Mauszeigers festgelegt, an denen der Anwender die Maustaste drückt und wieder losläßt.

int StartX, StartY;  //Declare in interface section of form's unit

void __fastcall TForm1::FormMouseDown(TObject *Sender, TMouseButton Button,

TShiftState Shift, int X, int Y)

{

StartX = X;

StartY = Y;

}

void __fastcall TForm1::FormMouseUp(TObject *Sender, TMouseButton Button,

TShiftState Shift, int X, int Y)

{

Form1->Canvas->Rectangle(StartX, StartY, X, Y);

}


OnScroll-Beispiel

Das folgende Beispiel positioniert den Positionszeiger in variablen Abständen neu. Wenn die Bild-auf-Taste gedrückt wurde, bewegt sich der Positionszeiger um eins nach oben. Wenn die Bild-ab-Taste gedrückt wurde, bewegt sich der Positionszeiger um zehn nach unten. Das Beispiel zeigt, wie Sie die Ereignisbehandlungsroutine OnScroll verwenden können, um den Positionszeiger in anderen Abständen als den in den Eigenschaften LargeChange und SmallChange

 angegebenen verschieben können.

void __fastcall TForm1::ScrollBar1Scroll(TObject *Sender,TScrollCode ScrollCode, int &ScrollPos)

{

char scrString[5];

if(ScrollCode == scPageUp)

ScrollPos = ScrollPos - 1;

else if(ScrollCode == scPageDown)

ScrollPos = ScrollPos + 10;

itoa(ScrollPos, scrString, 10);

Label1->Caption = scrString;

}


Parent-Beispiel

Um ein Formular für dieses Beispiel zu erstellen, legen Sie ein Gruppenfeld auf das Formular ab und fügen Sie dem Gruppenfeld ein Optionsfeld hinzu. Legen Sie zwei Label und einen Schalter auf das Formular ab. Der Quelltext zeigt den Namen des übergeordneten Elements des Optionsfeldes und den Klassennamen des Besitzers des Optionsfeldes als Beschriftung der Labels an, wenn der Anwender auf den Schalter klickt.

void __fastcall TForm1::Button1Click(TObject *Sender)

{

Label1->Caption = RadioButton1->Parent->Name + " is the parent";

Label2->Caption = "The Owner is " + RadioButton1->Owner->ClassName();

}

Dieses Beispiel verwendet einen Schalter und ein Gruppenfeld auf dem Formular. Wenn der Anwender auf den Schalter klickt, wird der Schalter in das Gruppenfeld verschoben, weil dann das Gruppenfeld das übergeordnete Element des Schalters ist.

void __fastcall TForm1::Button1Click(TObject *Sender)

{

  	Button1->Parent = GroupBox1;

}


ParentColor-Beispiel

Dieser Quelltext verwendet ein Label-Steuerelement und eine Zeitgeberkomponente auf dem Formular. Wenn das OnTimer-Ereignis eintritt, wird die Farbe des Labels auf rot geändert, falls die Eigenschaft ParentColor des Labels auf True eingestellt ist. Das Label wird also rot blinken, da jedesmal, wenn das OnTimer-Ereignis eintritt, die Labelfarbe in rot geändert wird. Während der anderen Zeit nimmt das Label die Farbe des übergeordneten Elements, also Form1, an.

void __fastcall TForm1::Timer1Timer(TObject *Sender)

{

if(Label1->ParentColor)

Label1->Color = clRed;

else

Label1->ParentColor = true;

}


ParentCtl3D-Beispiel

Dieser Quelltext verwendet auf einem Formular ein Gruppenfeld und eine Schaltfläche. Wenn der Anwender die Schaltfläche klickt, wird das Gruppenfeld zweidimensional dargestellt:

void __fastcall TForm1::Button1Click(TObject *Sender)

{

if (GroupBox1->ParentCtl3D == true)

{

GroupBox1->ParentCtl3D = false;

GroupBox1->Ctl3D = false;

}

}


ParentFont-Beispiel

Dieses Beispiel verwendet eine Timer-Komponente und ein Label-Steuerelement. Wenn ein OnTimer-Ereignis eintritt und das Label die Schriftart des übergeordneten Elements verwendet, ändert das Programm die Eigenschaft ParentFont des Labels auf False und die Schriftgröße des Labels auf 30 Punkte. Wenn ein OnTimer-Ereignis eintritt und das Label nicht die Schriftart des übergeordneten Elements verwendet, wird ParentFont auf True gesetzt. Die Schriftart des Labels wird also jedesmal, wenn ein OnTimer-Ereignis eintritt, im Wechsel vergrößert und verkleinert.

void __fastcall TForm1::Timer1Timer(TObject *Sender)

{

if(Label1->ParentFont == true)

Label1->Font->Size = 30;

else

Label1->ParentFont = true;

}


ParentShowHint-Beispiel

Dieses Beispiel verwendet ein Editierfenster, ein Memo und ein Markierungsfeld auf einem Formular. Für jedes dieser Steuerelemente ist die Eigenschaft ParentShowHint True, also gleich dem Vorgabewert. Beim Abarbeiten des Quelltextes wird die Eigenschaft ShowHint des Formulars auf True gesetzt, und allen Steuerelementen werden Schnellhilfen zugewiesen. Da jedes Steuerelement sich an sein übergeordnetes, also das Formular, wendet, um herauszufinden, ob Schnellhilfen anzuzeigen sind, und da die Eigenschaft ShowHint des Formulars True ist, sind Schnellhilfen verfügbar.

void __fastcall TForm1::FormCreate(TObject *Sender)

{

ShowHint = true;

Edit1->Hint = "Enter text";

Memo1->Hint = "Enter lots of text";

CheckBox1->Hint = "Check or uncheck me";

}


PasswordChar-Beispiel

Der folgende Quelltext zeigt Sternchen für jedes in das Editierfeld eingegebene Zeichen an:

Edit1->PasswordChar = '*';


PasteFromClipboard-Beispiel

Dieses Beispiel verwendet auf einem Formular zwei Editierfelder und eine Schaltfläche. Wenn der Anwender auf die Schaltfläche klickt, wird der Text des Editierfelds Edit1 ausgeschnitten und in das Editierfeld Edit2 eingefügt:

void __fastcall TForm1::Button1Click(TObject *Sender)

{

Edit1->SelectAll();

Edit1->CutToClipboard();

dit2->Clear();

dit2->PasteFromClipboard();

dit1->SetFocus();

}


PopupMenu-Beispiel

Dieses Beispiel weist das Popup-Menü mit dem Namen MyPopupMenu dem Formular zu:

void __fastcall TForm1::FormActivate(TObject *Sender)

{

PopupMenu = MyPopupMenu;

}


Position-Beispiel

Dieser Quelltext plaziert den Positionszeiger in der Mitte der Bildlaufleiste:

ScrollBar1->Max = 1000;

ScrollBar1->Min = 500;

ScrollBar1->Position = 750;


RemoveComponent-Beispiel

Der folgende Quelltext entfernt Button2 aus der Liste Componentsvon Form1.

Form1->RemoveComponent(Button2);


ScaleBy-Beispiel

Dieses Beispiel vergrößert Ihr Formular um 50%:

void __fastcall TForm1::Button1Click(TObject *Sender)

{

caleBy(150, 100);

}


ScreenToClient-Beispiel

Der folgende Quelltext konvertiert den Ursprung des Bildschirms (0, 0) in die Client-Koordinaten von Button2 um.

TPoint ScreenOrgin, ClientPoint;

ScreenOrgin.x = 0;

ScreenOrgin.y = 0;

ClientPoint = Button2->ScreenToClient(ScreenOrgin);


ScrollBars-Beispiel

Das folgende Beispiel fügt eine Bildlaufleiste der unteren Kante des Memo-Steuerelements Memo1 hinzu:

Memo1->ScrollBars = ssHorizontal;


ScrollBy-Beispiel

Diese Beispiel verwendet auf einem Formular einen Zeitgeber und verschiedene Steuerelemente Ihrer Wahl. Wenn die Anwendung ausgeführt wird, wird jedesmal, wenn ein Zeitgeberereignis eintritt, der Inhalt des Formulars um ein Pixel nach unten und nach rechts verschoben, so daß die Steuerelemente auf dem Formular nach unten und nach rechts rutschen:

void __fastcall TForm1::Timer1Timer(TObject *Sender)

{

ScrollBy(1,1);

}

void __fastcall TForm1::FormActivate(TObject *Sender)

{

Timer1->Interval = 1;

}


SelectAll-Beispiel

Der folgende Quelltext wählt den ganzen Text in Memo1 aus.

Memo1->SelectAll();


SelLength-Beispiel

Dieses Beispiel verwendet auf einem Formular ein Editierfeld. Wenn der Anwender Text in dem Editierfeld auswählt, wird die Anzahl der markierten Zeichen als Beschriftung des Labels angezeigt:

void __fastcall TForm1::Edit1MouseUp(TObject *Sender, TMouseButton Button,	TShiftState Shift, int X, int Y)

{

char string[10];

itoa(Edit1->SelLength, string, 10);

Label1->Caption = string;

}


SelText-Beispiel

Dieses Beispiel verwendet auf einem Formular ein Editierfeld und ein Label. Wenn der Anwender in dem Editierfeld Text auswählt, wird der markierte Text als Beschriftung des Labels angezeigt:

void __fastcall TForm1::Edit1MouseUp(TObject *Sender, TMouseButton Button,	TShiftState Shift, int X, int Y)

{

Label1->Caption = "Selected string =  " + Edit1->SelText;

}


SendToBack-Beispiel

Dieses Beispiel verwendet zwei Formulare. Wenn der Anwender auf die Schaltfläche in Form2 klickt, wird es hinter das andere Formular bewegt und ist nicht mehr das aktive Formular:

void __fastcall TForm2::Button1Click(TObject *Sender)

{

SendToBack();

}

In diesem Beispiel ist das übergeordnete Element der beiden Formulare die Anwendung selbst.


SetBounds-Beispiel

Der folgende Quelltext verdoppelt die Größe eines Schaltflächen-Steuerelements, wenn der Anwender es klickt:

void __fastcall TForm1::Button1Click(TObject *Sender)

{

Button1->SetBounds(Left, Top, Height * 2, Width * 2);

}

Beachten Sie, daß Sie stattdessen den folgenden Quelltext verwenden können, aber jedes Klicken hat zum Ergebnis, daß die Schaltfläche zweimal neu gezeichnet wird: einmal zum Ändern der Höhe und einmal zum Ändern der Breite:

void __fastcall TForm1::Button1Click(TObject *Sender)

{

Button1->Height = Button1->Height * 2;

Button1->Width = Button1->Width * 2;

}


SetFocus-Beispiel

Wenn der Anwender die Schaltfläche auf diesem Formular klickt, wird das Listenfeld das aktive Steuerelement und erhält den Eingabefokus:

void __fastcall TForm1::Button1Click(TObject *Sender)

{

ListBox1->SetFocus();

}


SetSelTextBuf-Beispiel

Dieses Beispiel verwendet auf einem Formular eine Schaltfläche und ein Editierfeld. Wenn der Anwender in dem Editierfeld Text auswählt und die Schaltfläche klickt, ersetzt neuer Text den markierten Text.

void __fastcall TForm1::Button1Click(TObject *Sender)

{

Edit1->SetSelTextBuf("You clicked the button");

}

//---------------------------------------------------------------------------

void __fastcall TForm1::FormActivate(TObject *Sender)

{

  Button1->Caption = "Click me";

}


SetTextBuf-Beispiel

Dieses Beispiel verwendet auf einem Formular eine Schaltfläche und ein Editierfeld. Wenn der Anwender die Schaltfläche klickt, erscheint Text in dem Editierfeld.

void __fastcall TForm1::Button1Click(TObject *Sender)

{

Edit1->SetTextBuf("You clicked the button");

}

void __fastcall TForm1::FormActivate(TObject *Sender)

{

Button1->Caption = "Click me";

}


Show-Beispiel

Dieser Quelltext entfernt das gegenwärtige Formular und zeigt ein anderes an:

void __fastcall TForm1::Button1Click(TObject *Sender)

{

Form1->Hide();

Form2->Show();

}

To run this example you must include the header file for Form2.


ShowAccelChar-Beispiel

Dieses Beispiel verwendet zwei Label auf einem Formular. Das erste Label hat eine Beschriftung mit einem Tastenkürzelzeichen. Das zweite Label beinhaltet auch ein Und-Zeichen, aber es erscheint nicht als ein Tastenkürzelzeichen.

void __fastcall TForm1::FormCreate(TObject *Sender)

{

Label1->ShowAccelChar = true;

Label1->Caption = "An &Underlined character appears here";

Label2->ShowAccelChar = false;

Label2->Caption = "An ampersand (&) appears here";

}


SmallChange-Beispiel

Dieser Quelltext bewegt den Positionszeiger um 10 Einheiten auf der Bildlaufleiste, wenn der Anwender auf einen Pfeil auf der Bildlaufleiste klickt:

ScrollBar1->SmallChange = 10;


Sorted-Beispiel

Dieses Beispiel verwendet auf einem Formular ein Editierfeld, ein Listenfeld und zwei Schaltflächen. Die Schaltflächen werden Hinzufügen und Sortieren genannt. Wenn der Anwender die Schaltfläche Hinzufügen klickt, wird der Text in dem Editierfeld der Liste in dem Listenfeld hinzugefügt. Wenn der Anwender die Schaltfläche Sortieren klickt, wird die Liste in dem Listenfeld sortiert und bleibt sortiert, auch wenn weitere Strings hinzugefügt werden:

void __fastcall TForm1::FormCreate(TObject *Sender)

{

ListBox1->Items->Add("Not");

ListBox1->Items->Add("In");

ListBox1->Items->Add("Alphabetical");

ListBox1->Items->Add("Order");

}

void __fastcall TForm1::AddClick(TObject *Sender)

{

ListBox1->Items->Add(Edit1->Text);

}

void __fastcall TForm1::SortClick(TObject *Sender)

{

ListBox1->Sorted = true;

}


State-Beispiel

Dieses Beispiel verwendet auf einem Formular drei Markierungsfelder. Wenn das Formular erzeugt wird, setzt der Quelltext den Anfangszustand jedes Markierungsfelds: das erste Markierungsfeld ist markiert, das zweite Markierungsfeld ist grau dargestellt und das dritte Markierungsfeld ist nicht markiert:

void __fastcall TForm1::FormCreate(TObject *Sender)

{

CheckBox1->State = cbChecked;

CheckBox2->State = cbGrayed;

CheckBox3->State = cbUnchecked;

}


Style-Beispiel

Dieses Beispiel verwendet ein Listen- und ein Markierungsfeld. Wenn der Anwender das Markierungsfeld markiert, verwandelt sich das Listenfeld in ein "fixed owner draw"-Listenfeld. Wenn der Anwender Die Markierung entfernt, wird das Listenfeld zu einem Standard-Listenfeld.

void __fastcall TForm1::CheckBox1Click(TObject *Sender)

{

if (CheckBox1->Checked)

ListBox1->Style = lbOwnerDrawFixed;

else

ListBox1->Style = lbStandard;

}

Dieses Beispiel verwendet einen Bitmap-Schalter und ein Markierungsfeld auf einem Formular. Wenn der Anwender das Markierungsfeld markiert, nimmt der Schalter das "New" Aussehen an, wenn der Anwender die Markierung entfernt, nimmt der Schalter das Win31-Aussehen an.

void __fastcall TForm1::CheckBox1Click(TObject *Sender)

{

if(CheckBox1->Checked)

BitBtn1->Style = bsNew;

else

BitBtn1->Style = bsWin31;

}


TabOrder-Beispiel

Dieses Beispiel stellt ein Formular so ein, daß das erste in der Tabulatorreihenfolge erscheinende Steuerelement das Markierungsfeld ist, und in Folge dessen das aktive Steuerelement bei erstmaliger Anzeige des Formulars, egal wieviele andere Steuerelemente noch auf dem Formular zu finden sind:

void __fastcall TForm1::FormCreate(TObject *Sender)

{

CheckBox1->TabStop = true;

CheckBox1->TabOrder = 0;

}


TabStop-Beispiel

Folgende Zeile entfernt ListBox1 aus der Tabulatorreihenfolge; der Benutzer kann also nicht die Taste Tab dazu verwenden, um auf das Listenfeld zu schalten:

ListBox1->TabStop = false;


Text-Beispiel

Dieses Beispiel benutzt ein Editierfeld, ein Listenfeld und eine Schaltfläche mit Namen Add auf einem Formular. Jedesmal, wenn der Anwender die Schaltfläche Add betätigt, wird der Text im Editierfeld der Liste im Listenfeld hinzugefügt.

void __fastcall TForm1::AddClick(TObject *Sender)

{

ListBox1->Items->Add(Edit1->Text);

}


Top-Beispiel

Der folgende Quelltext verschiebt eine Schaltfläche um 10 Pixel, wenn der Anwender die Schaltfäche anklickt:

void __fastcall TForm1::Button1Click(TObject *Sender)

{

Button1->Top = Button1->Top - 10;

}


Transparent-Beispiel

Die folgende Programmzeile macht ein Label transparent:

Label1->Transparent = True;


Update-Beispiel

Wenn diese Quelltextzeile ausgeführt wird, zeichnet Windows EditBox1 neu:

Edit1->Update();


Visible-Beispiel

Die folgende Programmzeile zeigt, wie eine Schaltfläche unsichtbar gemacht wird:

Button1->Visible = false;


WantReturns-Beispiel

Dieses Beispiel verwendet auf einem Formular ein Memo- und Markierungsfeld. Wenn das Markierungsfeld markiert wird, kann der Anwender Zeilenumbrüche im Text in das Memofeld eingeben. Falls das Markierungsfeld nicht markiert ist, können keine Zeilenumbrüche in das Memofeld eingegeben werden; diese würden den Anwender auf das Formular zurückgehen lassen.

void __fastcall TForm1::CheckBox1Click(TObject *Sender)

{

if (CheckBox1->Checked)

Memo1->WantReturns = true;

else

Memo1->WantReturns = false;

}


WantTabs-Beispiel

Dieses Beispiel verwendet ein Memo- und Markierungsfeld in einem Formular. Wenn das Markierungsfeld markiert wird, kann der Anwender Tabulatoren im Text in das Memofeld eingeben. Falls das Markierungsfeld nicht markiert ist, können keine Tabulatoren in das Memofeld eingegeben werden. Die Taste Tab gibt dann dem Anwender die Möglichkeit, zwischen dem Markierungsfeld und dem Memofeld auswählen zu können.

void __fastcall TForm1::CheckBox1Click(TObject *Sender)

{

if (CheckBox1->Checked)

Memo1->WantTabs = true;

else

Memo1->WantTabs = false;

}


Width-Beispiel

In der folgenden Programmzeile wird die Breite einer Schaltfläche verdoppelt:

Button1->Width = Button1->Width * 2;


WordWrap-Beispiel

Mit der folgenden Programmzeile erreicht man, daß der Text beim Bearbeiten in Memo1 am rechten Rand in die nächste Zeile springt, wenn das Steuerelement groß genug ist, den Text aufzunehmen:

Memo1->WordWrap = true;


AllowAllUp-Beispiel

In diesem Beispiel gibt es drei Mauspalettenschalter auf einem Formular. Sie gehören zur gleichen Gruppe, denn sie haben alle drei einen GroupIndex-Wert von 1. Diese Zeile Quelltext ändert die Eigenschaft AllowAllUp für alle drei Mauspalettenschalter auf True, so daß alle drei Mauspalettenschalter in der Gruppe gleichzeitig im nicht-ausgewählten Zustand sein können:

SpeedButton3->AllowAllUp = true;


Brush-Beispiel

Dieser Quelltext setzt die Farbe des Pinsels, den Form1 zum Füllen von Formen verwendet, auf Rot:

void __fastcall TForm1::MakeRedButtonClick(TObject *Sender)

{

Canvas->Brush->Color = clRed;

}

Dieser Quelltext ändert die Form, die Farbe und das Muster einer Shape-Komponente:

void __fastcall TForm1::ChangeShapeClick(TObject *Sender)

{

Shape1->Shape = stEllipse;

Shape1->Brush->Color = clMaroon;

Shape1->Brush->Style = bsFDiagonal;

}


CellRect-Beispiel

Dieses Beispiel verwendet ein Gitternetz, vier Label und eine Schaltfläche auf einem Formular. Wenn der Anwender die Schaltfläche anklickt, erscheinen die Koordinaten der Zelle in der zweiten Spalte und der ersten Zeile in den Titeln der Label.

void __fastcall TForm1::Button1Click(TObject *Sender)

{

TRect Rectangle;

Rectangle = DrawGrid1->CellRect(3, 2);

Label1->Caption = String(Rectangle.Top) + " is the top";

Label2->Caption = String(Rectangle.Bottom) + " is the bottom";

Label3->Caption = String(Rectangle.Left) + " is the left side";

Label4->Caption = String(Rectangle.Right) + " is the right side";

}


Center-Beispiel

Dieser Quelltext zentriert das Bild in Image1 wenn der Anwender CheckBox1 markiert:

void __fastcall TForm1::CheckBox1Click(TObject *Sender)

{

Image1->Center = CheckBox1->Checked;

}


ClassName-Beispiel

Dieses Beispiel verwendet eine Schaltfläche, ein Label, ein Listenfeld, ein Markierungsfeld und ein Editierfeld auf einem Formular. Wenn der Benutzer eines der Steuerelemente anklickt, wird sein Klassenname im Editierfeld ausgegeben.

void __fastcall TForm1::Button1Click(TObject *Sender)

{

Edit1->Text = String(Button1->ClassName());

}

void __fastcall TForm1::CheckBox1Click(TObject *Sender)

{

Edit1->Text = String(CheckBox1->ClassName());

}

void __fastcall TForm1::Label1Click(TObject *Sender)

{

Edit1->Text = String(Label1->ClassName());

}


ClassParent-Beispiel

Dieses Quelltextbeispiel verwendet eine Schaltfläche und ein Listenfeld auf einem Formular. Wenn der Benutzer die Schaltfläche anklickt, werden im Listenfeld der Klassenname der Schaltfläche und die Namen seiner Vorfahrklassen ausgegeben.

void __fastcall TForm1::Button1Click(TObject *Sender)

{

TClass ClassRef;

ListBox1->Clear();

ClassRef = Sender->ClassType();

while(ClassRef != NULL)

{

ListBox1->Items->Add(ClassRef->ClassName());

ClassRef = ClassRef->ClassParent();

}

}

Nach dem Anklicken des Schalters enthält das Listenfenster die folgenden Strings:

  TButton

  TButtonControl

  TWinControl

  TControl

  TComponent

  TPersistent

  TObject


ClassType-Beispiel

Dieses Beispiel verwendet eine Schaltfläche und ein Label auf einem Formular. Wenn der Benutzer die Schaltfläche anklickt, wird der Typ der Schaltflächenkomponente (TButton) im Titel des Labels angezeigt.

void __fastcall TForm1::Button1Click(TObject *Sender)

{

TClass ButtonClassType;

ButtonClassType = Button1->ClassType();

Label1->Caption = ButtonClassType->ClassName();

}


ClientHeight-Beispiel

Dieses Beispiel verringert die Höhe des Client-Bereichs eines Formulars um die Hälfte, wenn der Benutzer die Schaltfläche auf dem Formular anklickt:

void __fastcall TForm1::Button1Click(TObject *Sender)

{

Form1->ClientHeight = Form1->ClientHeight/2;

}

Beachten Sie, daß nur die Höhe des Client-Bereichs halbiert wird, nicht das gesamte Formular.


ClientOrigin-Beispiel

Dieses Beispiel zeigt die Y-Koordinate der oberen linken Ecke des Client-Bereichs von Schaltfläche Button1 an:

void __fastcall TForm1::Button1Click(TObject *Sender)

{

char buf[10];

itoa(Button1->ClientOrigin.y, buf, 10);

AnsiString aBuf(buf);

Edit1->Text = aBuf;

}


ClientRect-Beispiel

Der folgende Quelltext verwendet ClientRect, um die obere linke und die untere rechte Ecke eines Formulars zu finden und sie mit einer Linie zu verbinden:

void __fastcall TForm1::Button1Click(TObject *Sender)

{

Canvas->MoveTo(ClientRect.Left,ClientRect.Top);

Canvas->LineTo(ClientRect.Right, ClientRect.Bottom);

}


ClientWidth-Beispiel

Dieses Beispiel verwendet eine Schaltfläche auf einem Formular. Immer wenn der Benutzer die Schaltfläche anklickt, wird die Schaltfläche um 10 Pixel größer.

void __fastcall TForm1::Button1Click(TObject *Sender)

{

Button1->ClientWidth = Button1->ClientWidth + 10;

}


Col-Beispiel

Dieses Beispiel verwendet ein Gitternetz und darüber ein Label auf einem Formular. Wenn der Benutzer eine Zelle im Gitter anklickt, wird die Cursorposition im Titel des Labels angezeigt.

void __fastcall TForm1::DrawGrid1Click(TObject *Sender)

{

char rBuf[10];

char cBuf[10];

itoa(DrawGrid1->Col + 1, cBuf, 10);

itoa(DrawGrid1->Row + 1, rBuf, 10);

Label1->Caption = String("The cursor is in column ") + String(cBuf) + String(", row ") + String(rBuf);

}


ColCount-Beispiel

Die folgende Quelltextzeile fügt einer StringGrid-Komponente eine neue Spalte hinzu:

DrawGrid1->ColCount = DrawGrid1->ColCount + 1;


ColWidths-Beispiel

Das folgende Beispiel ändert die Spalte 0 des Rasters StringGrid1 auf den doppelten Standardwert.

DrawGrid1->ColWidths[0] = DrawGrid1->DefaultColWidth * 2;


ComponentCount-Beispiel

Dieser Quelltext verwendet mehrere Steuerelemente auf einem Formular, darunter eine Schaltfläche und ein Editierfeld. Wenn der Anwender die Schaltfläche anklickt, zählt der Quelltext alle Komponenten auf dem Formular und zeigt die Zahl im Editierfeld Edit1 an. Während des Zählvorgangs werden die Komponenten außerdem einzeln überprüft, um festzustellen, ob es sich um eine Schaltflächenkomponente handelt. Handelt es sich um eine Schaltfläche, ändert der Quelltext die Schriftart der Schaltfläche.

void __fastcall TForm1::Button1Click(TObject *Sender)

{

AnsiString nameString("TButton");

char compBuf[10];

TButton * button;

for(int i=0; i < ComponentCount; i++)

{

//prüfen ob Komponente ein  Tbutton ist

if (Components[i]->ClassNameIs(nameString))

{

//Komponente in ein TButton umwandeln*

button = (TButton *)Components[i];

button->Font->Name = "Courier";

itoa(ComponentCount, compBuf, 10);

Edit1->Text = AnsiString(compBuf) + AnsiString(" components");

}

}

}


Components-Beispiel

Dieser Quelltext verwendet mehrere Steuerelemente auf einem Formular, u.a. auch eine Schaltfläche und ein Editierfeld. Wenn der Anwender die Schaltfläche anklickt, zählt der Quelltext alle Komponenten auf dem Formular und gibt die Zahl im Editierfeld Edit1 aus. Während des Zählens wird jede Komponente überprüft, um festzustellen, ob es sich um eine Schaltflächenkomponente handelt. Ist die Komponente eine Schaltfläche, ändert der Quelltext die Schriftart der Schaltfläche.

void __fastcall TForm1::Button1Click(TObject *Sender)

{

AnsiString nameString("TButton");

char compBuf[10];

TButton * button;

for(int i=0; i < ComponentCount; i++)

{

//prüfen, ob Komponente ein TButton ist

if (Components[i]->ClassNameIs(nameString))

{

//Komponente in TButton umwandeln*

button = (TButton *)Components[i];

button->Font->Name = "Courier";

itoa(ComponentCount, compBuf, 10);

Edit1->Text = AnsiString(compBuf) + AnsiString(" components");

}

}

}


ControlCount-Beispiel

Dieses Beispiel verwendet ein Gruppenfeld eines Formulars, das mehrere Optionsfelder enthält. Das Formular verfügt außerdem über ein Editierfeld und eine Schaltfläche außerhalb des Gruppenfeldes. Der Quelltext zählt die untergeordneten Steuerelemente eines Steuerelements und macht sie beim Zählen der Reihe nach unsichtbar. Die Gesamtzahl der gezählten Steuerelemente wird im Editierfeld ausgegeben.

void __fastcall TForm1::Button1Click(TObject *Sender)

{

RadioButton1->Parent = RadioGroup1;

RadioButton2->Parent = RadioGroup1;

RadioButton3->Parent = RadioGroup1;

for(int i=0; i < RadioGroup1->ControlCount; i++)

RadioGroup1->Controls[i]->Visible = false;

Edit1->Text = String(RadioGroup1->ControlCount) + String(" controls");

}


Controls-Beispiel

Dieses Beispiel verwendet ein Gruppenfeld auf einem Formulars, das mehrere Optionsfelder enthält. Das Formular verfügt außerdem über ein Editierfeld und eine Schaltfläche außerhalb des Gruppenfeldes. Der Quelltext zählt die untergeordneten Steuerelemente jedes Steuerelements und macht sie beim Zählen der Reihe nach unsichtbar. Die Gesamtzahl der gezählten Steuerelemente wird im Editierfeld ausgegeben.

void __fastcall TForm1::Button1Click(TObject *Sender)

{

RadioButton1->Parent = RadioGroup1;

RadioButton2->Parent = RadioGroup1;

RadioButton3->Parent = RadioGroup1;

for(int i=0; i < RadioGroup1->ControlCount; i++)

RadioGroup1->Controls[i]->Visible = false;

Edit1->Text = String(RadioGroup1->ControlCount) + String(" controls");

}


DefaultColWidth-Beispiel

Die folgende Quelltext-Zeile ändert die voreingestellte Breite der Spalten in einem StringGrid-Steuerelement auf das Doppelte des ursprünglichen Werts.

DrawGrid1->ColWidths[0] = DrawGrid1->DefaultColWidth * 2;


DefaultDrawing-Beispiel

Der folgende Quelltext setzt DefaultDrawing für DrawGrid1 auf False.

DrawGrid1->DefaultDrawing = false;


DefaultExt-Beispiel

Dieses Beispiel setzt die Standarddateierweiterung auf TXT, zeigt das Dialogfeld Öffnen an und weist anschließend den Dateinamen, den der Anwender im Dialogfeld ausgewählt hat, einer Variablen zu, durch die die Anwendung eine Datei öffnen kann:

void __fastcall TForm1::Button1Click(TObject *Sender)

{

TFileName NameOfFile;

OpenDialog1->DefaultExt = String("TXT");

if(OpenDialog1->Execute())

NameOfFile = OpenDialog1->FileName;

}

Wenn dieser Quelltext ausgeführt wird, und der Anwender im Dialogfeld Öffnen in einen Dateinamen eingibt aber keine Dateierweiterung, wird die Erweiterung TXT an die Datei angehängt und der ganze Dateiname wird in der Variablen NameOfFile gespeichert. Wenn der Anwender zum Beispiel MYNOTES als Dateinamen eingibt, lautet der in der Variablen NameOfFile gespeicherte Wert MYNOTES.TXT.


DefaultRowHeight-Beispiel

Die folgende Quelltextzeile ändert die voreingestellte Höhe der Zeilen in einem String-Gitter-Steuerelement auf 10 Pixel mehr als den ursprünglichen Wert:

StringGrid1->DefaultRowHeight = StringGrid1->DefaultRowHeight + 10;


EditMask-Beispiel

Dieses Beispiel weist dem maskierten Editierfeld auf dem Formular eine Editiermaske zu. Die Editiermaske vereinfacht es, amerikanische Telefonnummern in das Editierfeld einzugeben.

void __fastcall TForm1::FormCreate(TObject *Sender)

{

MaskEdit1->EditMask = "!\(999\)000-0000;1";

MaskEdit1->Text = "";

MaskEdit1->AutoSelect = false;

}


FileName-Beispiel

Dieses Beispiel zeigt ein Dialogfeld Öffnen an und schlägt dem Anwender den Dateinamen LIST.PAS vor. Sobald der Anwender einen Dateinamen ausgewählt hat, wird dieser in einem Label auf dem Formular angezeigt:

void __fastcall TForm1::Button1Click(TObject *Sender)

{

OpenDialog1->FileName = "LIST.CPP";

if(OpenDialog1->Execute())

Label1->Caption = OpenDialog1->FileName;

}


FindNextPage-Beispiel

Der folgende Quelltext erlaubt es Anwendern Registerseiten anzuwählen, indem sie auf eine Schaltfläche klicken, statt auf eine Registerseite:

void __fastcall TForm1::Button1Click(TObject *Sender)

{

PageControl1->ActivePage = PageControl1->FindNextPage(PageControl1->ActivePage,true,true);

}


FixedColor-Beispiel

Dieses Beispiel verwendet ein Zeichengitter und eine Schaltfläche auf einem Formular. Wenn der Anwender die Schaltfläche anklickt, ändert sich im festen Bereichs von Spaltebn und Zeilen des Zeichengitters die Farbe:

void __fastcall TForm1::Button1Click(TObject *Sender)

{

if(DrawGrid1->FixedColor == clBlue)

DrawGrid1->FixedColor = clLime;

else

DrawGrid1->FixedColor = clMaroon;

}


FixedCols-Beispiel

Dieses Beispiel verwendet ein String-Gitter und eine Schaltfläche. Klickt der Benutzer die Schaltfläche an, so erscheint ein Meldungsdialogfeld, das dem Benutzer als Anzahl fixierter Spalten 2 empfiehlt und ihm die Möglichkeit gibt, diese Empfehlung zu akzeptieren, falls die Anzahl fixierter Spalten nicht bereits 2 ist. Entscheidet sich der Benutzer dafür, so ändert sich die Anzahl fixierter Spalten in 2.

void __fastcall TForm1::Button1Click(TObject *Sender)

{

int Check;

if(DrawGrid1->FixedCols != 2)

Check = Application->MessageBox("2 fixed columns are recommended!  Change?", "Incorrect Columns", MB_YESNOCANCEL);

if(Check == IDYES)

DrawGrid1->FixedCols = 2;

}


FixedRows-Beispiel

Dieses Beispiel verwendet in einem Formular ein String-Gitter und drei Optionsfelder. Spezifizieren Sie mit dem Objektinspektor die folgende Ereignisbehandlungsroutine für alle Ereignisse OnClick der drei Optionsfelder. In Abhängigkeit davon, welches Optionsfeld der Benutzer wählt, ändert sich die Anzahl fixierter Zeilen im String-Gitter.

void __fastcall TForm1::RadioButton1Click(TObject *Sender)

{

if(RadioButton1->Checked)

StringGrid1->FixedRows = 1;

else if (RadioButton2->Checked)

StringGrid1->FixedRows = 2;

else if (RadioButton3->Checked)

StringGrid1->FixedRows = 3;

}


Glyph-Beispiel

Dieses Beispiel verwendet eine Bitmap-Schaltfläche auf einem Formular. Wenn die Anwendung läuft und das Formular erzeugt wird, wird die Bitmap auf den Bitmap-Schaltfläche plaziert:

void __fastcall TForm1::FormCreate(TObject *Sender)

{

BitBtn1->Glyph->LoadFromFile("TIME.BMP");

}

Diese Quelltext-Zeilen laden eine Bitmap mit 4 Bildern in die Glyph-Eigenschaft eines Mauspalettenschalters und spezifizieren den entsprechenden Wert für die Eigenschaft NumGlyphs:

SpeedButton1->Glyph->LoadFromFile("MYBITMAP.BMP");

SpeedButton1->NumGlyphs = 4;


GridHeight-Beispiel

Dieses Beispiel verwendet ein Stringgitter und ein Label in einem Formular. Die Höhe des Gitters wird im Titel des Labels angezeigt.

__fastcall TForm1::TForm1(TComponent* Owner) : TForm(Owner)

{

char buf[10];

itoa(StringGrid1->GridHeight, buf, 10);

Label1->Caption = String(buf) + String(" pixels");

}


GridLineWidth-Beispiel

Dieses Beispiel verwendet ein Zeichengitter auf einem Formular. Wenn die Anwendung läuft und das Formular erzeugt wird, ändert sich die Linienbreite des Zeichengitters, sofern der Vorgabewert für die Spaltenbreite des Gitters größer als 90 Pixels ist:

void __fastcall TForm1::FormCreate(TObject *Sender)

{

if(DrawGrid1->DefaultColWidth > 90)

DrawGrid1->GridLineWidth = 2;

else

DrawGrid1->GridLineWidth = 1;

}


GridWidth-Beispiel

Dieses Beispiel verwendet ein Stringgitter und ein Label in einem Formular. Das Label zeigt die Breite des Gitters an.

void __fastcall TForm1::FormCreate(TObject *Sender)

{

for(int ARow = 1; ARow < StringGrid1->RowCount; ARow++)

for(int ACol = 1; ACol < StringGrid1->ColCount; ACol++)

StringGrid1->Cells[ARow][ACol] = "C++Builder";

char buf[10];

itoa(StringGrid1->Width, buf, 10);

Label1->Caption = String(buf) + " pixels";

}


GroupIndex-Beispiel

Dieser Quelltext sorgt dafür, daß die 3 Mauspalettenschalter als Gruppe zusammenarbeiten:

SpeedButton1->GroupIndex = 1;

SpeedButton2->GroupIndex = 1;

SpeedButton3->GroupIndex = 1;


HandleAllocated-Beispiel

Der folgende Quelltext zeigt den Wert des Handles von GroupBox1 an, falls eines existiert; ansonsten wird eine Meldung ausgegeben.

void __fastcall TForm1::Button1Click(TObject *Sender)

{

if(!GroupBox1->HandleAllocated())

Label1->Caption = String("Handle not allocated.");

}


HandleNeeded-Beispiel

Nachstehender Quelltext erzeugt ein Fenster-Handle für Button1:

Button1->HandleNeeded();


Images-Beispiel

Das folgende Beispiel setzt die Eigenschaft Images der Baumansicht auf ImageList1.

TreeView1->Images = ImageList1;


IsMasked-Beispiel

Dieses Beispiel überprüft das maskierte Editierfeld, um zu bestimmen, ob es eine Editiermaske enthält. Wenn es keine hat, wird ihm eine zugewiesen. Die Editiermaske ist für Datumangaben im MM/TT/JJ-Format:

void __fastcall TForm1::Button1Click(TObject *Sender)

{

if(!MaskEdit1->IsMasked)

MaskEdit1->EditMask = "!99/99/00;1;_";

}


Items-Beispiel

Das folgende Beispiel ändert die den Titel des ersten Elements in der Baumansicht.

ListView1->Items->Item[0]->Caption = String("NewItemName");

Das folgende Beispiel veranschaulicht, wie man einer TTreeView-Steuerung Knoten und Unterknoten hinzufügt.

void __fastcall TForm1::Button1Click(TObject *Sender)

{

// Fügt einen Wurzelknoten hinzu

TreeView1->Items->Add(TreeView1->Selected, "RootTreeNode1");

// Setzt MyTreeNode ald ersten Knoten ein

// Baumstruktur und fügt einen Unterknoten ein

TTreeNode *MyTreeNode1 = TreeView1->Items->Item[0];

TreeView1->Items->AddChild(MyTreeNode1,"ChildNode1");

// Fügt einen Wurzelknoten hinzu

TreeView1->Items->Add(TreeView1->Selected, "RootTreeNode2");

// Setzt MyTreeNode als dritten Knoten ein

// Baumstruktur und fügt einen Unterknoten hinzu

TTreeNode *MyTreeNode2 = TreeView1->Items->Item[2];

TreeView1->Items->AddChild(MyTreeNode2,"ChildNode2");

// Setzt MyTreeNode als vierten Knoten ein

// Baumstruktur und fügt einen Unterknoten hinzu

MyTreeNode2=TreeView1->Items->Item[3];

TreeView1->Items->AddChild(MyTreeNode2,"ChildNode2a");

// Setzt MyTreeNode als fünften Knoten ein

// Baumstruktur und fügt einen Unterknoten hinzu

MyTreeNode2 = TreeView1->Items->Item[4];

TreeView1->Items->Add(MyTreeNode2,"ChildNode2b");

// einen weiteren Wurzelknoten hinzufügen

TreeView1->Items->Add(TreeView1->Selected, "RootTreeNode3");

}


LargeImages-Beispiel

Das folgende Beispiel setzt die Eigenschaft LargeImages der Listenanzeige auf ImageList1.

ListView1->LargeImages = ImageList1;


Layout-Beispiel

Dieses Beispiel verwendet eine Bitmap-Schaltfläche auf einem Formular, dessen Bitmap als Wert der Eigenschaft Glyph angegeben wurde. Wenn der Benutzer die Bitmap-Schaltfläche  anklickt, ändert die Bitmap in zufälliger Weise ihre Position auf der Schaltfläche:

void __fastcall TForm1::BitBtn1Click(TObject *Sender)

{

int rNum = rand() % 4;

switch(rNum)

{

case 0:

BitBtn1->Layout = blGlyphLeft;

break;

case 1:

BitBtn1->Layout = blGlyphRight;

break;

case 2:

BitBtn1->Layout = blGlyphTop;

break;

case 3:

BitBtn1->Layout = blGlyphBottom;

break;

default:

ShowMessage("Unhandled case");

}

}


LeftCol-Beispiel

Diese Quelltextzeile plaziert die vierte Spalte eines Gitternetzes an der linken Kante des Gitters:

StringGrid1->LeftCol = 3;


Margin-Beispiel

Dieses Beispiel verwendet einer mittelgroßen Schaltfläche auf einem Formular. Wenn die Anwendung ausgeführt wird, wird eine Bitmap (oder ein Zeichenkörper) in die Schaltfläche geladen; die Bitmap erscheint auf der rechten Seite der Schaltfläche, und zwar 30 Pixel von der rechten Kante der Bitmap-Schaltfläche entfernt.

void __fastcall TForm1::FormCreate(TObject *Sender)

{

BitBtn1->Glyph->LoadFromFile("TIME.BMP");

BitBtn1->Layout = blGlyphRight;

BitBtn1->Margin = 30;

}


NumGlyphs-Beispiel

Dieses Beispiel verwendet einen Mauspalettenschalter und ein Label auf einem Formular. Wenn das Beispiel ausgeführt wird, wird die Anzahl der Bilder in der angegebenen Bitmap im Titel des Labels angezeigt.

void __fastcall TForm1::FormActivate(TObject *Sender)

{

SpeedButton1->Glyph->LoadFromFile("TIME.BMP");

Label1->Caption = String(SpeedButton1->NumGlyphs) + String(" image(s)");

}


OnChanging-Beispiel

Der folgende Quelltext verhindert die Änderung der Auswahl:

void __fastcall TForm1::TabControl1Changing(TObject *Sender, bool &AllowChange)

{

AllowChange = false;

}


OnResizeRequest-Beispiel

Der folgende Quelltext paßt die Größe des RichEdit-Steuerelements der verändernden Anzahl der Zeilen an:

RichEdit1->BoundsRect = Rect;


Paragraph-Beispiel

Das folgende Beispiel setzt die aufzählende Eigenschaft des gerade ausgewählten Absatzes auf RichEdit1. Wenn die Schaltfläche für Aufzählungszeichen gedrückt wurde, wird der Absatz für die Aufzählungszeichen ausreichend eingerückt.

RichEdit1->Paragraph->Numbering = TNumberingStyle(nsBullet);


Picture-Beispiel

Dieses Beispiel verwendet zwei Bildkomponenten. Wenn das Formular erstmalig erscheint, werden zwei Bitmaps in die Bildkomponenten geladen und deren Größe gestreckt, um mit der Größe der Komponenten übereinzustimmen. Testen Sie diesen Quelltext und ersetzen Sie die Bitmaps durch diejenigen, die Ihnen zur Verfügung stehen.

void __fastcall TForm1::FormCreate(TObject *Sender)

{

Image1->Stretch = true;

Image2->Stretch = true;

Image1->Picture->LoadFromFile("BITMAP1.BMP");

Image2->Picture->LoadFromFile("BITMAP2.BMP");

}


ReadOnly-Beispiel

Dieser Quelltext schaltet den Nur-Lesen-Zustand des Editierfeldes bei jedem anklicken auf das Formular an und aus.

void __fastcall TForm1::FormActivate(TObject *Sender)

{

Edit1->Left = 2;

Edit1->Top = 2;

Edit1->ReadOnly = true;

Edit1->Text = "Change Me";

Canvas->TextOut(10, 40, "Double-click form to toggle read-only state");

}

void __fastcall TForm1::FormDblClick(TObject *Sender)

{

Edit1->ReadOnly = !Edit1->ReadOnly;

}


RemoveControl-Beispiel

Dieses Beispiel verwendet einen Schalter, der außerhalb eines Gruppenfeldes angeordnet ist. Wenn der Anwender den Schalter klickt, wird das Gruppenfeld das übergeordnete Element des Schalters und der Schalter wird in das Gruppenfeld verschoben:

void __fastcall TForm1::Button1Click(TObject *Sender)

{

if (Button1->Parent == GroupBox1)

{

GroupBox1->RemoveControl(Button1);

GroupBox2->InsertControl(Button1);

}

else

{

GroupBox2->RemoveControl(Button1);

GroupBox1->InsertControl(Button1);

}

}


Row-Beispiel

Dieses Beispiel verwendet auf einem Formular ein String-Gitter mit einem darüberliegenden Label. Wenn der Anwender in eine Zelle des Gitters klickt, wird die Position des Cursors als Titel des Labels angezeigt.

void __fastcall TForm1::DrawGrid1Click(TObject *Sender)

{

char cBuf[10];

char rBuf[10];

itoa(DrawGrid1->Col, cBuf, 10);

itoa(DrawGrid1->Row, rBuf, 10);

Label1->Caption = String("The cursor is in column ") + String(cBuf) +  ", row " + String(rBuf);

}


RowCount-Beispiel

Dieses Beispiel verwendet ein String-Gitter und eine Schaltfläche. Wenn der Anwender die Schaltfläche klickt, ändert sich die Anzahl der Spalten und Zeilen:

void __fastcall TForm1::Button1Click(TObject *Sender)

{

DrawGrid1->ColCount = 7;

DrawGrid1->RowCount = 11;

}


RowHeights-Beispiel

Dieses Beispiel benutzt ein String-Gitter und einen Button. Wenn der Benutzer auf den Button klickt, ändert sich die Zahl der Zeilen und Spalten und die erste Zeile und Spalte hat andere Maße als die restlichen Zeilen und Spalten:

void __fastcall TForm1::Button1Click(TObject *Sender)

{

DrawGrid1->ColCount = 7;

DrawGrid1->RowCount = 11;

DrawGrid1->RowHeights[0] = 35;

DrawGrid1->ColWidths[0] = 90;

}


Selected-Beispiel

Der folgende Quelltext löscht das gewählte Element in der Baumansicht.

TreeView1->Selected->Delete();


Selection-Beispiel

Der folgende Quelltext wählt ein Rechteck aus, das die Zeilen 1 und 2 sowie die Spalten 3 und 4 umfaßt:

void __fastcall TForm1::Button1Click(TObject *Sender)

{

TGridRect myRect;

myRect.Left = 3;

myRect.Top = 1;

myRect.Right = 2;

myRect.Bottom = 4;

DrawGrid1->Selection = myRect;

}


ShowColumnHeaders-Beispiel

Mit dem folgenden Beispiel werden die Spaltenüberschriften der Listenanzeige verborgen.

ListView1->ShowColumnHeaders = false;


SmallImages-Beispiel

m folgenden Beispiel wird die Eigenschaft SmallImages der Listenanzeige auf ImageList1 gesetzt.

ListView1->SmallImages = ImageList1;


Spacing-Beispiel

Dieses Beispiel lädt eine Bitmap aus einer Datei zu dem Zeitpunkt, an dem das Formular erzeugt wird und plaziert die Bitmap 20 Pixel von der rechten Seite der Schaltfläche:

void __fastcall TForm1::FormCreate(TObject *Sender)

{

BitBtn1->Glyph->LoadFromFile("TIME.BMP");

BitBtn1->Layout = blGlyphLeft;

BitBtn1->Spacing = 20;

}


StateImages-Beispiel

Im folgenden Beispiel wird die Eigenschaft StateImages für Baumansichten auf ImageList1 gesetzt.

TreeView1->StateImages = ImageList1;


Stretch-Beispiel

Dieses Beispiel verwendet auf einem Formular eine Bildkomponente. Wenn das Formular erzeugt wird, wird das spezifizierte Bild geladen und gestreckt, das es die Abgrenzungen der Bildkomponente erreicht.

void __fastcall TForm1::FormCreate(TObject *Sender)

{

Image1->Stretch = true;

Image1->Picture->LoadFromFile("TIME.BMP");

}


Tabs-Beispiel

Folgendes Beispiel verwendet ein Seitenregister- und ein Memo-Steuerelement. Wenn der Benutzer eine Zeile in das Memo eingibt, wird diese als neues Register in das Seitenregister-Steuerelement eingefügt. Jedes Mal, wenn der Benutzer innerhalb des Memos die Eingabetaste drückt, wird ein neues Register im Seitenregister-Steuerelement erzeugt:

void __fastcall TForm1::Memo1Change(TObject *Sender)

{

TabControl1->Tabs = Memo1->Lines;

}


TopItem-Beispiel

Das folgende Beispiel fügt den Titel für das erste Element in dem Listenfeld zu dem Listenfeld hinzu.

ListBox1->Items->Add(ListView1->TopItem->Caption);

Hinweis:  Um dieses Beispiel auszuführen, müssen Sie ViewStyle auf vsReport oder VsList setzen.


TopRow-Beispiel

Die folgende Prozedur benutzt ein Formular mit eine DrawGrid-Komponente und eine Schaltfläche. Mit dem Anklicken der Schaltfläche wird die letzte Zeile der DrawGrid-Komponente zur ersten:

void __fastcall TForm1::Button1Click(TObject *Sender)

{

DrawGrid1->TopRow = DrawGrid1->RowCount;

}


VisibleColCount-Beispiel

Die folgende Prozedur benutzt ein Formular mit einem Zeichengitter, zwei Labels und einer Schaltfläche. Nach Anklicken der Schaltfläche wird die Anzahl der Zeilen und Spalten, mit Ausnahme der teilweise angezeigten und statischen, in den Titelfeldern der beiden Labels angezeigt:

void __fastcall TForm1::Button1Click(TObject *Sender)

{

char rBuf[10];

char cBuf[10];

itoa(DrawGrid1->VisibleRowCount, rBuf, 10);

itoa(DrawGrid1->VisibleColCount, cBuf, 10);

Label1->Caption = String(rBuf) + " rows";

Label2->Caption = String(cBuf) + " columns";

}


VisibleRowCount-Beispiel

Die folgende Prozedur benutzt ein Formular mit einem Zeichengitter, zwei Labels und einer Schaltfläche. Nach Anklicken der Schaltfläche wird die Anzahl der Zeilen und Spalten, mit Ausnahme der teilweise angezeigten und statischen, in den Titelfeldern der beiden Labels angezeigt:

void __fastcall TForm1::Button1Click(TObject *Sender)

{

char rBuf[10];

char cBuf[10];

itoa(DrawGrid1->VisibleRowCount, rBuf, 10);

itoa(DrawGrid1->VisibleColCount, cBuf, 10);

Label1->Caption = String(rBuf) + " rows";

  	Label2->Caption = String(cBuf) + " columns";

}